Cola local por REST y archivos

Objetivo

Esta guía describe cómo elegir y operar los canales de entrada del cliente local.

Canales soportados

REST local

Recomendado cuando el integrador necesita respuesta inmediata o control síncrono.

Casos típicos:

• sign-cfe con respuesta inmediata
• validación y firma bajo demanda
• aplicaciones que viven en el mismo equipo o en la misma red local

Bandeja de archivos

Recomendada cuando el sistema tercero escribe archivos y no puede consumir una API local.

Casos típicos:

• integración legacy
• carpetas compartidas
• desacople fuerte entre emisor y agente

Criterio de elección

Usar REST cuando:

• importa la respuesta inmediata
• el sistema integrador necesita saber en el acto si el comprobante quedó firmado o rechazado
• se quiere evitar polling de carpetas

Usar archivos cuando:

• el integrador no puede manejar HTTP local
• el flujo ya está modelado por carpetas
• se prioriza simplicidad operativa sobre inmediatez

Guías detalladas

• Integración por bandeja de archivos
• Integración por REST local

Activación por perfil

Los canales deberían poder activarse o desactivarse por punto de emisión:

• REST habilitado o no
• bandeja de archivos habilitada o no

Esto permite evitar consumo innecesario cuando un canal no se usa.

Flujo recomendado para REST

1. Validar el payload en el host.
2. Enviar el request local.
3. Procesar el envelope de respuesta.
4. Si el request fue síncrono, persistir la referencia de negocio.
5. Si el request fue asíncrono, consultar estado luego.

Flujo recomendado para archivos

1. El integrador escribe el archivo en entrada.
2. El daemon lo mueve a temporal.
3. Procesa y genera:
   • salida
   • o error
4. El integrador consume la respuesta y archiva o reintenta.

Riesgos frecuentes

• dejar activos canales que no se usan
• exponer REST local sin control suficiente del entorno
• no definir naming de carpetas por perfil
• mezclar múltiples puntos de emisión sobre la misma bandeja física

Señales mínimas que la UI debería mostrar

• REST habilitado o no
• archivos habilitado o no
• URL REST efectiva
• carpetas activas
• pendientes, procesados y con error
• último error de procesamiento

Criterio de cierre

La cola local está bien resuelta cuando:

• cada perfil usa solo los canales necesarios
• el integrador sabe si el flujo es síncrono o asíncrono
• la UI muestra el estado real de cada canal
• los errores se recuperan sin perder trazabilidad