EVENTFLOW FE · DOCUMENTACIÓN TÉCNICA · 05
Interoperabilidad con SIFEN
Define el límite de interoperabilidad fiscal entre EventFlow FE y el entorno SIFEN de Paraguay, incluyendo envío, consulta, procesamiento de respuestas y representación del resultado fiscal.
Límite de interoperabilidad
EventFlow FE ejecuta la integración fiscal del lado del producto; SIFEN proporciona el resultado fiscal autoritativo.
EventFlow FE prepara la representación fiscal electrónica, ejecuta las operaciones requeridas de integridad documental, realiza la interacción aplicable con SIFEN y registra la respuesta resultante de la autoridad como estado del producto.
Etapas de interoperabilidad
Modelo de responsabilidades
| Operación | EventFlow FE | SIFEN |
|---|---|---|
| Preparación del documento fiscal | Es responsable de la preparación dentro del producto | No prepara el documento del producto |
| Representación electrónica | Genera la representación requerida para la interoperabilidad | Recibe la representación fiscal aplicable |
| Firma digital y QR | Ejecuta las etapas configuradas de integridad documental | Procesa el documento fiscal resultante conforme a los requisitos aplicables |
| Envío | Inicia la interacción fiscal aplicable | Recibe y procesa el documento enviado |
| Decisión fiscal | Registra y representa el resultado recibido | Proporciona el resultado fiscal autoritativo |
| Consulta de resultado | Consulta cuando la interacción aplicable requiere recuperar posteriormente el resultado | Proporciona el resultado disponible de la autoridad |
Interacción síncrona
En la ruta de interacción síncrona, EventFlow FE envía el documento fiscal electrónico aplicable y procesa la respuesta devuelta para esa interacción. La información recibida se registra de acuerdo con el ciclo de vida fiscal representado por el producto.
Interacción asíncrona
En la ruta de interacción asíncrona, el envío y la recuperación del resultado final son operaciones separadas. EventFlow FE registra el contexto del envío y posteriormente consulta el resultado de la autoridad mediante la ruta de consulta aplicable.
La finalización de la operación de envío no implica por sí misma aprobación fiscal.
Procesamiento de respuestas
Las respuestas de la autoridad se procesan como resultados fiscales derivados externamente y se representan dentro de EventFlow FE. Estados del producto como APROBADO, RECHAZADO y OBSERVADO representan dentro del ciclo de vida el resultado correspondiente de la autoridad.
La semántica de estos estados se especifica en 04. Ciclo de Vida del Documento.
Fallos de transporte y protocolo
Un fallo de transporte no es un rechazo fiscal.
Un fallo de comunicación o protocolo impide que la operación de interoperabilidad aplicable finalice normalmente. EventFlow FE registra esa condición de forma separada de los resultados de la autoridad para que el estado de transporte no sea interpretado como una decisión fiscal.
Reconciliación de resultados
Cuando el procesamiento fiscal requiere una consulta posterior, EventFlow FE reconcilia el resultado disponible de la autoridad con el estado fiscal representado por el producto. Un fallo de reconciliación se registra de forma separada tanto del fallo de transporte como del rechazo fiscal.
Invariantes de interoperabilidad
- La generación del documento electrónico precede al envío fiscal.
- Las etapas configuradas de integridad documental preceden al envío mediante la ruta SIFEN aplicable.
- La finalización del envío es distinta de la aprobación fiscal.
- Un fallo de transporte o protocolo no es un rechazo de la autoridad.
- Un envío asíncrono puede requerir una consulta posterior a la autoridad antes de que exista un resultado fiscal final.
- Los resultados fiscales representados por EventFlow FE derivan de la interacción con la autoridad.
- El procesamiento del runtime no inicia ni sustituye transacciones fiscales con SIFEN.
Límite de integridad documental
La firma digital y la generación del QR pertenecen a la ruta de preparación del documento fiscal previa a la interoperabilidad. Sus propiedades de seguridad e integridad se especifican en 06. Seguridad e Integridad Documental.
Validación en producción
La interoperabilidad fiscal de extremo a extremo ha sido validada en el entorno de producción de SIFEN mediante generación documental, firma digital, generación de QR, envío y un resultado fiscal aprobado. La evidencia de ingeniería correspondiente se documenta en 12. Validación en Producción.