Limpieza: comentarios en el codigo, if vacio de CreateHojaRuta y documentacion. Versión 2.1.8.0

Sin cambios de comportamiento. Comentarios en Picking, Recibo,
ConnectionServiceLayer, CreditNotesRepository, InvoiceRepository y
RepositoryWrapper.

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

Net.Data/WMS/Recibo/ReciboRepository.cs

@@ -345,6 +345,8 @@ namespace Net.Data.WMS.Recibo
 
                     #endregion
 
+                    // DEVOLUCION: NC (oCreditNotes) con base en la Solicitud de Devolucion (BaseType 234000031).
+                    // Si las lineas de la solicitud vienen de una factura se usan los datos y lotes de la factura; si no, los de la solicitud y el stock de HANA
                     #region PROCESO DE NOTA DE CREDITO
 
                     if (entidad.IdTipo == EnumRecibo.DEVOLUCION)
@@ -401,6 +403,7 @@ namespace Net.Data.WMS.Recibo
 
                         #endregion
                         // Serie segun el TIPO de documento origen (03 = boleta), no segun su serie
+                        // El correlativo sale de @SYP_NUMDOC (HelperCorrelativo)
                         string Serie = U_SYP_MDTO == "03" ? "BC10" : "FC10";
                         string Correlativo = HelperCorrelativo.Get(Serie);
                         creditNotesNotes.DocCurrency = returnRequest.DocCurrency;
@@ -449,6 +452,8 @@ namespace Net.Data.WMS.Recibo
                             }
                         });
 
+                        // Lotes de cada linea: sin factura relacionada, FIFO por vencimiento del stock de HANA; con factura, los lotes de la factura.
+                        // En ambos casos se parte de la lista vacia para que los lotes sumen exactamente la cantidad de la linea
                         if (_Invoice == null)
                         {
                             //=== REALIZA DISTRIBUCION DE STOCK POR LOTE
@@ -532,6 +537,7 @@ namespace Net.Data.WMS.Recibo
                         }
                         else
                         {
+                            // Transferencias por almacen destino (U_ITC_ALMDES). OJO: en Recibo las lineas de la NC no llenan U_ITC_ALMDES, por lo que hoy no se genera ninguna
                             List<string> ListaUnicaAlmacen = creditNotesNotes.DocumentLines.Select(x => x.WarehouseCode).Distinct().ToList();
                             List<int> ListDocEntry = new List<int>();
                             ListaUnicaAlmacen.ForEach(Almacen =>
@@ -594,6 +600,7 @@ namespace Net.Data.WMS.Recibo
                                         //=== CREA INSTANCIA PARA CONECTAR A SAP
                                         StockTransferRepository stockTransferRepository = new StockTransferRepository(_clientFactory, _configuration);
                                         var ResultTransfer = stockTransferRepository.StockTransfer(Transfer).Result;
+                                        // OJO: si la transferencia falla se ignora (la NC ya esta creada)
                                         if (ResultTransfer.StatusCode == -1)
                                         {