The Spanish version is the authoritative reference. View in Spanish

How does the NDD integration work?

NDD Space acts as a mandatory fiscal middleware between Gosocket and Brazilian tax authorities (SEFAZ and Prefeituras). Gosocket generates the document in its standard format (GUF/DTE), sends it to NDD, and NDD handles the transformation, validation and submission to the appropriate authority.

The transformation chain

Every document passes through this chain before reaching the tax authority:

Each step has a specific responsibility:

GUF examples for Brazil

See DTE/GUF examples for Brazil for reference XML samples ready to use in FileContent.

GUF / DTE

Gosocket's generic integration format. The issuer builds the document once using this format; Gosocket and NDD handle the rest.

XSLT

Technical transformation from GUF to the NDD intermediate RPS format. NDD applies the SetNFe, SetCTe or SetMDFe stylesheets according to the document type.

De/Para rules

Field mapping specific to each municipality and TaxID. Adapts the standard format to the particularities of each Prefeitura.

NDD Space

Middleware that validates schema and digital signature, manages retries and returns the approved XML (with the tax authority access key) to Gosocket.

Issuance flow (AR)

AR — IssuanceFlowGosocket sends the XML to NDD Space. NDD transforms it, validates it with SEFAZ or the Prefeitura, and returns the approved XML with the tax status.SendDocumentToAuthorityPOSTSends the document to the NDD pipeline. Input parameters, responses and GUF examples for Brazil.GetDocumentPOSTQueries the tax status and metadata of the document. Download URLs for the approved XML and PDF are available when the functionality is enabled for the TaxID.ChangeDocumentStatusPOSTExecutes document events: cancellation, correction letter and operation confirmation.

Reception flow (AP)

AP — Reception CT-e / NF-eFlowDocuments issued by suppliers arrive via email inbox or periodic synchronization (every 4 hours). NDD validates and Gosocket Inbox stores the status.AP — Reception NFS-eFlowService document reception (NFS-e) with municipality-specific particularities.

Reception: two entry routes

Reception in Brazil has a particularity compared to other countries: it requires activation in NDD Space to work.

Inbox / Upload

The supplier sends the XML directly to the Gosocket inbox. Requires a forwarding email configured on the recipient TaxID. Up to 10 retries within 30 minutes.

Periodic synchronization

NDD actively queries available documents for the TaxID every 4 hours. New documents appear in Inbox marked as "Synced from NDD".

Mandatory activation in NDD Space

Each customer (TaxID) must be activated in the NDD Space portal before starting the integration. Without this activation, reception stops at Status 5 (Error) and issuance cannot proceed.

Document lifecycle

The document status can be queried at any time with GetDocument, and subsequent events (cancellation, correction letter) are executed with ChangeDocumentStatus.