Skip to main content

Flujo operativo

La integración Opera se compone de recepción JSON, transformación fiscal, envío tributario y respuesta estructurada al ERP.

1.1 Recepción de transacción​

  • Protocolo: HTTPS
  • Método: POST
  • Formato: JSON
  • Autenticación: Basic Auth

Oracle Opera - Hospitality Cloud envía la información completa de la transacción de facturación hacia API-FLIP (payload JSON).

1.2 Transformación estructural​

API-FLIP realiza los siguientes pasos:

  1. Valida la estructura del JSON.
  2. Convierte el JSON a un XML intermedio (DTE-GUF).
  3. Aplica la transformación mediante un archivo XSLT.
  4. Genera el DTE-GUF con la estructura fiscal requerida por el país.

Esta transformación permite:

  • Adaptabilidad multi-país.
  • Independencia del formato del ERP.
  • Versionamiento controlado según cada regulación.

1.3 Envío al ente tributario​

  • API-FLIP invoca al API de emisión convencional (SendDocumentToAuthority).
  • Durante este paso se realiza:
    • Firma digital (si aplica).
    • Validación final.
    • Envío al ente tributario.
  • Se obtiene una respuesta de:
    • Autorización
    • Rechazo
    • Observación

1.4 Asignación de folio​

Una vez generado el DTE y enviado al API SendDocumentToAuthority:

  • El API invoca un servicio interno de folios (Gestor de folios).
  • Se valida la disponibilidad.
  • Se asigna un folio único fiscal.
  • Se actualiza el DTE con el folio correspondiente.

Este paso garantiza correlatividad y control tributario.

1.5 Respuesta al ERP​

API-FLIP construye una respuesta en formato JSON que incluye:

  • Estado de la operación (AUTHORIZED / ERROR).
  • Código tributario.
  • Mensaje descriptivo de aceptación u observaciones, dependiendo del ente fiscal.
  • Folio asignado.
  • Identificador fiscal (UUID / CAE / TrackID, según el país).
  • Fecha de autorización.

Puedes ver un ejemplo completo de esta respuesta en Ejemplo de respuesta.