Saltar al contenido principal

¿Cómo funciona la integración NDD?

NDD Space actúa como middleware fiscal obligatorio entre Gosocket y las entidades tributarias brasileñas (SEFAZ y Prefeituras). Gosocket genera el documento en su formato estándar (GUF/DTE), lo envía a NDD, y NDD se encarga de transformarlo, validarlo y remitirlo a la autoridad competente.

La cadena de transformación​

Todo documento pasa por esta cadena antes de llegar a la autoridad fiscal:

Cada paso tiene una responsabilidad concreta:

Ejemplos de GUF para Brasil

Consulta los ejemplos de DTE/GUF para Brasil para ver XMLs de referencia listos para usar en FileContent.

GUF / DTE
Formato de integración genérico de Gosocket. El emisor construye el documento una sola vez con este formato; Gosocket y NDD hacen el resto.
XSLT
Transformación técnica del GUF al formato intermedio RPS de NDD. NDD aplica las hojas SetNFe, SetCTe o SetMDFe según el tipo de documento.
Reglas De/Para
Mapeo de campos específico por municipalidad y TaxID. Permite adaptar el formato estándar a las particularidades de cada Prefeitura.
NDD Space
Middleware que valida esquema y firma digital, gestiona reintentos y retorna el XML aprobado (con la clave de acceso de la ET) a Gosocket.

Flujo de emisión (AR)​

AR — EmisiónFlujoGosocket envía el XML a NDD Space. NDD lo transforma, lo valida ante SEFAZ o la Prefeitura y retorna el XML aprobado con el estado tributario.SendDocumentToAuthorityPOSTEnvía el documento al pipeline NDD. Parámetros de entrada, respuestas y ejemplos de GUF para Brasil.GetDocumentPOSTConsulta el estado tributario y metadata del documento. Las URLs de descarga del XML y PDF aprobados están disponibles cuando la funcionalidad está habilitada para el TaxID.ChangeDocumentStatusPOSTEjecuta eventos sobre el documento: cancelación, carta de corrección y confirmación de operación.

Flujo de recepción (AP)​

AP — Recepción CT-e / NF-eFlujoDocumentos emitidos por proveedores llegan por casilla de email o por sincronización periódica (cada 4 horas). NDD valida y Gosocket Inbox almacena el estado.AP — Recepción NFS-eFlujoRecepción de servicios (NFS-e) con particularidades por municipalidad.

Recepción: dos rutas de entrada​

La recepción en Brasil tiene una particularidad respecto a otros países: requiere activación en NDD Space para funcionar.

Casilla de recepción / Upload
El proveedor envía el XML directamente a la casilla de Gosocket. Requiere email de reenvío configurado en el TaxID receptor. Hasta 10 reintentos en 30 minutos.
Sincronización periódica
NDD consulta activamente los documentos disponibles para el TaxID cada 4 horas. Los documentos nuevos aparecen en Inbox marcados como "Sincronizado desde NDD".
Activación obligatoria en NDD Space

Cada cliente (TaxID) debe estar activado en el portal NDD Space antes de iniciar la integración. Sin esta habilitación, la recepción se detiene con Estado 5 (Error) y la emisión no puede avanzar.

Ciclo de vida de un documento​

El estado del documento se puede consultar en cualquier momento con GetDocument, y los eventos posteriores (cancelación, carta de corrección) se ejecutan con ChangeDocumentStatus.