Emision Inteligente MVP para eFactura
Se agregan endpoints REST para interpretar texto libre o payload parcial y generar una pre-emision asistida de eFactura en UYU.
Endpoints afectados
POST /api/v1/cfe/emitir-inteligentePOST /api/v1/cfe/previsualizar-emision-inteligentePOST /api/v1/cfe/confirmar-emision-inteligenteGET /api/v1/cfe/emision-inteligente/{id}
Migracion recomendada
No rompe integraciones existentes. Los integradores que quieran usar el flujo asistido deben enviar el nuevo contrato y contemplar estados borrador_revisable, requiere_datos, emitido y rechazado.
Que cambia
Se incorpora un flujo nuevo de Emision Inteligente para el caso MVP de eFactura local en UYU.
El integrador puede enviar:
- texto libre
- payload parcial
El sistema:
- interpreta la solicitud con OpenAI
- exige salida JSON estructurada
- resuelve cliente, productos, moneda y forma de pago contra entidades reales del ERP
- devuelve preview, faltantes, advertencias y estado del proceso
- solo emite usando el motor fiscal actual cuando la solicitud queda completa y es confirmada
Impacto para integradores
No modifica ni rompe los endpoints actuales de emision manual o emision API existente.
Se agregan estados nuevos:
borrador_revisablerequiere_datosemitidorechazado
Los clientes integradores deben contemplar que la interpretacion puede requerir datos adicionales antes de emitir.
Migracion recomendada
No hay migracion obligatoria para integraciones existentes.
Si desea adoptar Emision Inteligente:
- Envie texto libre o payload parcial al endpoint nuevo.
- Revise
faltantes,advertenciasypreview. - Confirme la emision solo cuando el estado sea
borrador_revisableo cuando su politica useautomatico.