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:

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.

Dos direcciones: emisión y recepción​

La integración opera en ambas direcciones del documento tributario.

AR — EmisiónEmisiónGosocket 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.AP — RecepciónRecepciónDocumentos 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.

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.