Documentar la transferencia desde ALM99 (docs/TRANSFERENCIA_IMPORTACION.md) y comentar el codigo

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Net.Data/WMS/Transferencia/EntradaImportacion.cs

@@ -8,6 +8,9 @@ namespace Net.Data.WMS.Transferencia
     // Elige la Entrada de Mercaderia de una Factura de Reserva que corresponde a una transferencia desde ALM99.
     // WMS recibe por partes: cada entrada tiene su propio juego de articulos/cantidades, y WMS notifica una
     // transferencia por entrada con ese mismo juego (se compara solo ItemCode y cantidad, no el numero de item).
+    // Reglas: coincidencia exacta de articulos y cantidades (sumadas por articulo); entre las que coinciden se toma la mas antigua
+    // (menor DocEntry) sin transferencia; si todas las que coinciden ya estan transferidas se rechaza para no duplicar.
+    // Ver docs/TRANSFERENCIA_IMPORTACION.md.
     public static class EntradaImportacion
     {
         private const decimal Tolerancia = 0.0001m;

Net.Data/WMS/Transferencia/TransferenciaRepository.cs

@@ -112,6 +112,12 @@ namespace Net.Data.WMS.Transferencia
                     });
 
                     //=== SI EL ALMACEN ES ALM99 (almacen de costeo de importaciones), AMARRA CON LA ENTRADA DE MERCANCIA
+                    // Proceso: factura de reserva -> WMS recibe por partes y crea una entrada por recepcion (todas a ALM99) -> costeo en SAP ->
+                    // WMS notifica UNA transferencia por entrada, con numorden = DocNum de la factura de reserva y en el detalle los
+                    // articulos/cantidades de esa entrada. Detalle completo y diagnostico en docs/TRANSFERENCIA_IMPORTACION.md.
+                    // Casos: (1) DocEntryEM informado -> se usa esa entrada; (2) sin DocEntryEM -> se busca la entrada de la factura que
+                    // coincida con el detalle y no tenga transferencia (EntradaImportacion.Elegir); (3) la factura no tiene entradas ->
+                    // como antes, lotes del stock de HANA sin amarre.
                     if (entidad.CodigoSubAlmacenOrigen == "ALM99")
                     {
                         StockTransfer.U_SYP_MDMT = "21";