SendDocumentToAuthority

Sends an electronic document to the Brazilian tax authority (SEFAZ or Prefeitura) through NDD.

Endpoint

Available in both API versions — see Authentication to choose the one that applies to you.

Basic Auth — v1

QAhttps://developers-sbx.gosocket.net/api/v1/Document/SendDocumentToAuthority

PRODUCTIONhttps://developers.gosocket.net/api/v1/Document/SendDocumentToAuthority

OAuth 2.0 — v2

QAhttps://developers-sbx.gosocket.net/api/v2/Document/SendDocumentToAuthority

PRODUCTIONhttps://developers.gosocket.net/api/v2/Document/SendDocumentToAuthority

Method: POST

Input parameters

GUF examples for Brazil

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

AtributoTipoDescripción

FileContentstringContent of the XML file in the Gosocket Unified Format (DTE/GUF). Required.

AsyncbooleanProcessing mode. For the NDD integration the only valid value is `true` (asynchronous). The document is sent to NDD and processed in the background; the final status is queried with `GetDocument`. Required.

MappingstringUnique identifier of the mapping to use (template or layout). Default: 11111111-1111-1111-1111-111111111111. Required.

SignbooleanIndicates whether the document must be electronically signed before sending. Default: true. Required.

DefaultCertificatebooleanUse the portal default certificate. Default: false. Required.

Response parameters

AtributoTipoDescripción

Successbooleantrue — the operation was successful.

GlobalDocumentIdstringUnique global identifier of the document on the Gosocket platform.

CountryDocumentIdstringAlways `null` in the send response — the NDD integration is exclusively asynchronous. The fiscal identifier is obtained with `GetDocument` once the document is authorized.

OtherData.CountrystringCode of the country where the document was issued. Example: "br".

OtherData.CertifierstringCertifier of the document. Example: "NDD".

OtherData.AuthorityTimeStampstringDate and time the document was received by Gosocket.

MessagesarrayList of additional messages. Empty if there are no warnings.

Codestring"200" — NDD received the document and queued it for asynchronous processing.

DescriptionstringResult description. Example: "Autorização do documento a enviar".

ResponseValuestringAlways `null` for the NDD integration.

ErrorExceptionobjectnull when the operation was successful.

Examples

SendDocumentToAuthority

{
"FileContent": "<GUF/DTE XML in Gosocket format>",
"Async": true,
"Mapping": "11111111-1111-1111-1111-111111111111",
"Sign": true,
"DefaultCertificate": false
}

Notes

Exclusively asynchronous flow

The NDD integration operates exclusively in asynchronous mode (Async: true). NDD receives the document, queues it and returns immediately with Code: "200" and CountryDocumentId: null. The final status (authorized, rejected, etc.) is queried subsequently with GetDocument using the received GlobalDocumentId.

Authentication

Basic Auth (v1) or OAuth 2.0 (v2), depending on the endpoint you use — see Authentication for details and credentials.

Mapping ID

The value 11111111-1111-1111-1111-111111111111 is the generic mapping for Brazil. If your integration uses a custom mapping, request the correct GUID from the Integrations team.