EventFlow FE utiliza el versionado para identificar estados definidos del producto y revisiones de su documentación técnica pública. La compatibilidad se evalúa respecto del comportamiento documentado, los límites de responsabilidad y los requisitos fiscales aplicables.
Ámbito de Versión
| Ámbito de versión | Significado |
|---|---|
| Versión de producto | Identifica un estado publicado de EventFlow FE |
| Versión de documentación | Identifica una revisión de un documento técnico público o de un contrato documentado |
Una revisión de documentación no implica por sí misma un cambio de compatibilidad del producto.
Ámbito de Compatibilidad
La compatibilidad se evalúa sobre los comportamientos y límites del producto de los que pueden depender los usuarios, los productos conectados o el procesamiento fiscal.
| Área | Consideración de compatibilidad |
|---|---|
| Comportamiento del documento fiscal | Cambios que afectan la representación o el procesamiento fiscal documentado |
| Ciclo del documento | Cambios en los estados documentados o en su significado |
| Interoperabilidad con SIFEN | Cambios requeridos por el entorno fiscal aplicable |
| Comportamiento de integración | Cambios en el intercambio de información documentado o en los límites de responsabilidad |
| Garantías operacionales | Cambios en el comportamiento documentado de recuperación, idempotencia, aislamiento u observación |
Clasificación de Cambios
| Clase de cambio | Significado |
|---|---|
| Cambio compatible | Extiende o refina el comportamiento sin invalidar expectativas documentadas existentes |
| Cambio que afecta la compatibilidad | Modifica un contrato documentado, el significado de un estado, una expectativa de integración o una garantía de la que puede depender una implementación existente |
| Cambio requerido fiscalmente | Introduce un cambio necesario para mantener la interoperabilidad con las reglas de SIFEN o los requisitos fiscales aplicables |
Principio de Compatibilidad
La compatibilidad se evalúa respecto del comportamiento documentado y los requisitos fiscales, no respecto de detalles internos de implementación no documentados.
Los componentes internos pueden evolucionar sin constituir un cambio de compatibilidad cuando se preservan el comportamiento documentado, la semántica de la información, el significado del ciclo y de los estados, los límites de responsabilidad, el comportamiento de intercambio de integración y el comportamiento fiscal aplicable.
Los productos e integraciones conectados dependen, por tanto, del comportamiento documentado establecido en el límite de integración y no de la implementación interna de EventFlow FE.
Documentación Versionada
Los documentos técnicos poseen su propia versión de documentación. Una revisión de documentación identifica un cambio en la especificación publicada y no implica por sí misma un cambio de compatibilidad del producto.
Cuando cambia un comportamiento documentado o un contrato público, la documentación afectada se versiona en consecuencia.
Compatibilidad Fiscal
La compatibilidad de EventFlow FE incluye la interoperabilidad continua con el entorno fiscal SIFEN aplicable. Los cambios requeridos por la autoridad fiscal pueden exigir cambios correspondientes en el producto incluso cuando el comportamiento existente del producto permanecería sin modificaciones en otras circunstancias.
Los cambios originados por la autoridad se tratan separadamente de los cambios introducidos únicamente por EventFlow FE.
Documentación Relacionada
- 03. Modelo de Documento Fiscal — información fiscal representada por EventFlow FE.
- 04. Ciclo de Vida del Documento — estados documentados y ciclo del documento fiscal.
- 05. Interoperabilidad SIFEN — interoperabilidad con la autoridad fiscal.
- 10. Idempotencia y Garantías de Procesamiento — garantías documentadas de procesamiento.
- 14. Arquitectura de Integración — responsabilidades de integración y límites de intercambio.