The Spanish version is the authoritative reference. View in Spanish
NDD — Brazil Integration
Gosocket integrates with NDD Space as a fiscal middleware for Brazil. NDD is the authorized intermediary that validates, transforms and forwards electronic documents to the Brazilian tax entities (SEFAZ and municipalities).
What does the Gosocket + NDD integration do?
Who is this documentation for?
This documentation is aimed at:
- Development teams integrating client systems with the Gosocket platform for Brazil
- Operations teams configuring and activating TaxIDs in NDD Space
- Partners channeling Brazilian fiscal documents through Gosocket + NDD
Integration mechanism
The integration operates via REST API with OAuth 2.0 authentication. Gosocket receives the document in GUF/DTE format and sends it to NDD Space via SendDocumentToAuthority. NDD transforms the document, validates it with SEFAZ or the corresponding Prefeitura and returns the approved XML with the tax status. The status can be subsequently queried with GetDocument; events such as cancellation or correction letter are executed with ChangeDocumentStatus.
See How it works for the full architecture and the transformation chain details.
Where to start
If this is your first time working with this integration, we recommend following this order:
- Read How it works to understand the architecture and the role of NDD Space as middleware
- Review NDD Portal and confirm the TaxID is active in NDD Space (prerequisite)
- Check the Process Flows for the issuance and reception call sequence
- Explore the APIs for the technical details of each method
Sections in this documentation
How it worksGuideArchitecture, transformation chain and document lifecycle.NDD PortalReferenceAccess to the NDD Space portal: Documentos and Configurações modules.Process FlowsFlowsIssuance (AR) and reception (AP) flows for NF-e, CT-e, NFS-e and more.APIsREST APISendDocumentToAuthority, GetDocument and ChangeDocumentStatus methods.Document TypesReferenceCatalog of supported electronic fiscal documents for Brazil.Graphic Representations (PDF)ReferencePDF generation with JasperReports for NF-e, CT-e and NFS-e.Municipality AvailabilityReferenceNFS-e implementation status by Brazilian municipality.