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

AtributoTipoDescripción

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

AsyncbooleanIndica si la operación debe ser asincrónica (true) o sincrónica (false). Por defecto: true. 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.

CountryDocumentIdstringID asignado por la autoridad fiscal. Puede ser null si el servicio es asíncrono.

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" para éxito.

Ejemplos

Response — Éxito

{
    "Success": true,
    "GlobalDocumentId": "7b28000c-ae96-f63e-5639-fffdf28c7fd9",
    "CountryDocumentId": null,
    "OtherData": {
        "Country": "br",
        "Certifier": "NDD",
        "AuthorityTimeStamp": "09/04/2025 21:01:54"
    },
    "Messages": [],
    "ResponseValue": null,
    "Code": "200",
    "Description": null,
    "ErrorException": null
}

Response — Error

{
    "Success": false,
    "GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
    "CountryDocumentId": null,
    "OtherData": {
        "Country": "br",
        "Certifier": "NDD",
        "AuthorityTimeStamp": "10/04/2025 18:49:23"
    },
    "Messages": [
        "Regla: ERROR, Reintento: Error Transformando Archivo. Verifique el mapeo y reintente nuevamente.",
        "Error Transformando Archivo, MSTransform.500 - Inicia proceso de transformación. No se encontró Xslt configurado. Id error: 1763846c-aa4c-49c5-a374-ef86f5dac1ce"
    ],
    "ResponseValue": null,
    "Code": "500",
    "Description": "Error Transformando Archivo",
    "ErrorException": null
}