SendDocumentToAuthority

Envía un documento electrónico a la autoridad fiscal brasileña (SEFAZ o Prefeitura) a través de NDD.

Endpoint

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

PRODUCCIÓNhttps://developers.gosocket.net/api/v1/Document/SendDocumentToAuthority

Método: POST

Parámetros de entrada

Ejemplos de GUF para Brasil

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

AtributoTipoDescripción

FileContentstringContenido del archivo XML en Formato Unificado Gosocket (DTE/GUF). Requerido.

AsyncbooleanModo de procesamiento. Para la integración NDD el único valor válido es `true` (asíncrono). El documento se envía a NDD y se procesa en segundo plano; el estado definitivo se consulta con `GetDocument`. Requerido.

MappingstringIdentificador único del mapeo a utilizar (plantilla o layout). Por defecto: 11111111-1111-1111-1111-111111111111. Requerido.

SignbooleanIndica si el documento debe firmarse electrónicamente antes del envío. Por defecto: true. Requerido.

DefaultCertificatebooleanUsar el certificado por defecto del portal. Por defecto: false. Requerido.

Parámetros de respuesta

AtributoTipoDescripción

Successbooleantrue — la operación fue exitosa.

GlobalDocumentIdstringIdentificador global único del documento en la plataforma Gosocket.

CountryDocumentIdstringSiempre `null` en la respuesta de envío — la integración NDD es exclusivamente asíncrona. El identificador fiscal definitivo se obtiene con `GetDocument` una vez que el documento sea autorizado.

OtherData.CountrystringCódigo del país donde fue emitido el documento. Ejemplo: "br".

OtherData.CertifierstringCertificador del documento. Ejemplo: "NDD".

OtherData.AuthorityTimeStampstringFecha y hora en que el documento fue recibido por Gosocket.

MessagesarrayLista de mensajes adicionales. Vacía si no hay advertencias.

Codestring"200" — NDD recibió el documento y lo encoló para procesamiento asíncrono.

DescriptionstringDescripción del resultado. Ejemplo: "Autorização do documento a enviar".

ResponseValuestringSiempre `null` para la integración NDD.

ErrorExceptionobjectnull cuando la operación fue exitosa.

Ejemplos

SendDocumentToAuthority

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

Notas

Autenticación

Todos los métodos requieren autenticación Basic Auth. Usa el API Key como usuario y el API Secret como contraseña. Ambas credenciales se generan en el portal de Gosocket.

Flujo exclusivamente asíncrono

La integración NDD opera únicamente en modo asíncrono (Async: true). NDD recibe el documento, lo encola y retorna inmediatamente con Code: "200" y CountryDocumentId: null. El estado definitivo (autorizado, rechazado, etc.) se consulta posteriormente con GetDocument usando el GlobalDocumentId recibido.

Mapping ID

El valor 11111111-1111-1111-1111-111111111111 es el mapping genérico de Brasil. Si tu integración usa un mapping personalizado, solicita el GUID correcto al equipo de Integraciones.