Cómo leer el log de transacciones de Stock Cuotas

Síntoma

El servicio de Stock Cuotas ejecutó pero no se sabe si generó la OC, la solicitud o la transferencia correctamente. O se sospecha que hubo un error pero no se sabe dónde ni cuál.

Causa probable

El servicio de Stock Cuotas registra cada acción que toma (exitosa o con error) en una tabla de log accesible desde SAP. Este log es la principal herramienta de diagnóstico para entender qué procesó el servicio, cuándo, y si encontró problemas. Sin leerlo, es muy difícil diagnosticar por qué algo no funcionó.

Cómo acceder al log

1. En SAP: Herramientas → Ventanas definidas por el usuario.
2. En la lista de ventanas UDO, buscar la que corresponde al log de Stock Cuotas (nombre aproximado: NX_Cuotas_Log, o similar según la parametrización del proyecto).
3. Hacer doble clic para abrirla.
4. Aparece la lista de transacciones ordenadas por tiempo.

Qué muestra el log

• Timestamp: fecha y hora exacta de cada acción del servicio.
• Tipo de acción: qué procesó (generó OC preliminar, generó solicitud, ejecutó transferencia).
• Cuota involucrada: número de DocEntry de la cuota procesada.
• Resultado: OK o descripción del error.
• Detalles: número de documento generado (número de OC preliminar, número de solicitud, número de transferencia).

Cómo interpretar los mensajes del log

Mensajes de éxito

• "OK - OC preliminar creada: [número]" → el servicio generó el borrador de OC correctamente.
• "OK - Solicitud de traslado creada: [número]" → el servicio generó la solicitud de cuota X.
• "OK - Transferencia ejecutada: cuota [X], cantidad [Y], transfer [número]" → el stock se movió.
• "Procesó correctamente" o mensajes con OK al inicio → todo bien en ese ciclo.

Mensajes de error frecuentes

• "Sin stock disponible" → hay solicitud de traslado activa pero no hay stock en la bodega de importaciones para transferir. El servicio va a reintentar en el próximo ciclo.
• "Artículo sin proveedor: [código]" → ese SKU no tiene proveedor en el maestro. No se puede generar OC.
• "Artículo no encontrado: [código]" → el SKU no existe en SAP. Verificar el código.
• "Error de credenciales" → el usuario del servicio tiene problema de autenticación. Escalar a TI inmediatamente.
• "Bodega no encontrada: [código]" → el almacén configurado en la cuota no existe en SAP.

Patrón normal del log (cuota en proceso)

Para una cuota que se procesa correctamente desde el inicio hasta la transferencia, el log debería mostrar estos mensajes en orden cronológico:

1. "OC preliminar creada" (cuando se pasa a estado O)
2. "Solicitud de traslado creada" (cuando se confirma al 100%)
3. "Transferencia ejecutada" (cuando se recepciona y costea)

Cuándo revisar el log

• Después de cambiar el estado de una cuota a O: verificar que se generó la OC.
• Después de confirmar al 100%: verificar que se generó la solicitud.
• Después de cada recepción de mercadería: verificar que se ejecutó la transferencia.
• Cuando el proceso parece haberse detenido sin razón aparente.
• Semanalmente durante el período de importaciones activo: revisión preventiva.

El log se puede llenar

Si los pasos no resuelven

• Si el log no tiene registros recientes (últimos 2-5 min): el servicio está detenido. Escalar a Victor.
• Si hay errores masivos de credenciales: escalar a TI urgente.
• Si el log tiene OK pero el resultado esperado no se ve en SAP: puede ser un tema de sincronización o caché. Refrescar SAP y buscar el documento generado.

Artículos relacionados

• KB-026 — El servicio de Stock Cuotas
• KB-031 — Transferencia automática post-recepción
• KB-025 — Prerequisitos para activar Stock Cuotas