itca_api_sap_wms/CLAUDE.md

# ITCA_API_SAP_WMS (.NET) — proyecto principal

API de integración WMS ↔ SAP Business One, **ASP.NET Core 3.1**. Para
build/publish/despliegue en IIS ver [`README.md`](./README.md).

Esta carpeta (`backend_octubre`) es **el proyecto vigente**. Antes existía
una copia paralela, `ITCA_API_SAP_WMS`, con la funcionalidad nueva portada
desde la reescritura Python; se portó aquí y esa copia quedó **archivada en un
comprimido (versión antigua)**. No hay `git` en esta carpeta.

## Qué se portó desde `ITCA_API_SAP_WMS` (2026-10-05)

Detalle técnico en `docs/PORTE_FUNCIONALIDAD_NUEVA.md`,
`docs/SOLICITUD_TRANSFERENCIA.md` y `docs/PICKING.md`.

1. **SolicitudTransferencia**: `PATCH /api/SolicitudTransferencia/{docEntry}` y
   `POST /api/SolicitudTransferencia/{docEntry}/cerrar`.
2. **Picking diurno/nocturno**: campo `Notificacion` (early-return en
   `PickingRepository.Create` tras `HelperProcesoPiciking.Set`, **solo para
   `Proceso = "ULTIMA MILLA"`**; DESPACHO/PICKING generan NC sin depender de
   él) y
   `POST /api/Picking/HojaRuta/{docEntry}/Cerrar`.
3. **`ConnectionServiceLayer`**: `PatchNoContentAsync` y `PostActionAsync`
   (métodos nuevos; los existentes no se tocaron).

## Regla Proceso + Notificacion (v2.1.2.0)

`Notificacion = "cierre"` se exige **solo si `Proceso = "ULTIMA MILLA"`**
(si no, solo actualiza estado en HANA). `DESPACHO` y `PICKING` generan NC y
transferencias siempre, sin depender de `Notificacion`. Detalle y tabla en
`docs/PICKING.md`.

## Cambios de configuración y correcciones hechas en esta carpeta

- **Credenciales y esquema HANA en `appsettings.json`**, sección `Hana`
  (`server`, `user`, `password`, `schema` opcional), leída por
  `LocalData.Configure` desde `Startup`. Antes estaban fijas en el código
  (`LocalData.cs`, `Log/B_Log.cs`). El esquema sale de `Hana:schema` o, si no
  está, de `SapServiceLayer:company`; **si falta la sección `Hana` o el
  esquema, la app no arranca** (error claro). Ya no hay `DB_NAME` fijo.
- **Precio promedio solo en entradas** (`TipoMovimiento "01"`) en
  `InventarioRepository.Create` (los dos chequeos: `SubAlmacen` y `Almacen`).
  Si el artículo no tiene stock, se conserva el `PrecioPromedio` del request en
  vez de abortar con *"No existe stock disponible para el articulo X"* (ese
  error bloqueaba ingresos de artículos sin stock previo). En salidas ya no se
  busca el promedio: `PriceAfterVAT` lleva el precio del request. El chequeo de
  stock de la rama de **salida** de `PickingRepository` (~línea 363) no se tocó.
- **Lote de 100 líneas** (`InventarioRepository.Create`): `var Inventario =
  entidad` reutilizaba el mismo objeto, y con más de 100 líneas se generaban N
  documentos iguales con el último bloque. Ahora se crea una copia por bloque y
  la rama de salida lee `entidad_inventario.Detalle`.
- **SQL injection**: parametrizadas las consultas de `HelperProcesoPiciking`,
  `HelperStock`, `HelperInventario`, `HelperInvoice`, `HelperCorrelativo`,
  `HelperHojaRuta` y `HelperProcesoPermitido` (`?` + `HanaParameter`).
  El esquema sigue interpolado (viene de configuración, no del request).
- `ITCA_API_SAP_WMS.xml` ahora se genera también en Release (sin eso Swagger
  revienta con `FileNotFoundException` en un `publish -c Release`).

## Funcionalidad propia de esta carpeta (no existe en la copia antigua)

Hoja de Ruta (`HojaRutaController`, `HRRepository`, `GlobalDataRepository`),
reapertura de facturas (`InvoiceRepository.ReOpen`, `PostReOpen`), notas de
crédito con documentos de referencia, cierre automático de la solicitud de
traslado en `Transferencia` (`PostClose`), `Latitud`/`Longitud` y reproceso en
Picking, columna `HORA` en `B_Log`. Lo que **no** se trajo: `Chatbots` y
`MessageController` (solo existen en la copia archivada).

## Sin verificar

- **Nada se probó contra SAP/HANA reales.** Solo se verificó que compila
  (0 errores) y que el publish se genera.
- La sintaxis `CALL "esquema"."proc"(?, ?)` con parámetros no está probada con
  el driver HANA 2.1; si falla con un error de parámetro, mirar primero ahí.
- Para probar el lote de 100: un inventario de >100 líneas (p. ej. 250) debe
  generar 3 documentos (100/100/50) sin repetir ni perder líneas, tanto en
  entradas como en salidas.

## Bugs conocidos, sin corregir

- `BE_ResultadoTransaccion<T>.NombreEstacion`: setter con recursión infinita
  (bomba de tiempo; hoy nada lo asigna).
- `ConnectionServiceLayer.PatchAsyncSBA<T>`: con un `204` real devuelve `null`
  sin marcar éxito. `Login()`/`LoginPost()` duplicados; `throw` inalcanzable
  tras `return` en varios `catch`.
- `ValidarCertificado` acepta cualquier certificado TLS (siempre `true`).
- `HelperDB.SET(string query)` ejecuta SQL arbitrario; hoy sin llamadores
  (candidato a borrar).
- `appsettings.json` versionado en texto plano con credenciales reales
  (SAP Service Layer, **HANA `B1ADMIN`**, semilla JWT). Rotar la contraseña de
  `B1ADMIN` (estuvo en el código fuente) y evaluar un usuario HANA de mínimos
  permisos.

## Despliegue

Sitio IIS previsto: **`/integracion`** (antes `/integracion_wms`). Publicar con
el comando del README **sin pisar** el `appsettings.json` del servidor; agregar
a ese archivo la sección `Hana` y revisar `SapServiceLayer:company` (determina
contra qué base lee y escribe). El `web.config` generado por `dotnet publish`
usa `processPath=".\ITCA_API_SAP_WMS.exe"`; el del código fuente apunta a
`bin\Debug\...` (solo para sitios que corren desde el código compilado).

## Pendiente

- Probar en QA: endpoints nuevos (SolicitudTransferencia, `Notificacion`,
  `HojaRuta/Cerrar`), un ingreso sin stock previo, el lote de 100 y las
  consultas parametrizadas.
- Verificar que existan en el esquema del sitio los procedimientos `ITCA_*`
  y las tablas `@ITCA_PROWMS`, `@SYP_MOTIVOS`, `@SYP_NUMDOC`.
- Decidir si se corrigen los bugs de la lista de arriba.