El Salvador - Códigos de respuesta

Códigos de Respuesta (SendDocumentToAuthority)
Code	SubCodeError	Description	Comentarios	Acciones
001	N/A	RECIBIDO	Cuando el documento se procesó correctamente (Success:true)
XXX representa el código de respuesta de la DGI	N/A	Descripción propia de los códigos de respuesta de la DGI	Cuando el documento es emitido y se obtiene el código y mensaje de respuesta, tal cual lo regresa la DGI. Ejemplo: `json "Code": "020", "Description": "[resumen.montoTotalOperacion] CALCULO INCORRECTO"`	Interpretar la respuesta entregada en Messages, antes de enviar de nuevo el documento. Si no encuentra el error o el problema persiste luego de varios intentos de re-envío, se puede escalar el caso a Gosocket.
500	Q003	ERROR Transformando Archivo	Cuando se presenta algún error durante el proceso de transformación del DTE al UBL tributario.	Interpretar y corregir el error entregado en Messages, antes de enviar de nuevo el documento. Si no encuentra el error o el problema persiste luego de varios intentos de re-envío, se puede escalar el caso a Gosocket.
500	Q004	ERROR Parseando Archivo	Cuando se presenta algún error durante el proceso de parseo del documento.	Interpretar y corregir el error entregado en Messages, antes de enviar de nuevo el documento. Si no encuentra el error o el problema persiste luego de varios intentos de re-envío, se puede escalar el caso a Gosocket.
500	Q005	Empresa no activa para emitir	Cuando la empresa no tiene habilitada la emisión de documentos.	Comunicarse con Gosocket para validar posible bloqueo por motivos financieros.
500	Q006	Proceso pendiente para el documento [Object], TrackId:[Object].	Cuando se reciben solicitudes concurrentes en el envío del mismo documento, debido a que el sistema puede no haber alcanzado a procesarlo, se realiza este bloqueo de 1 minuto para garantizar la integridad de los documentos y evitar rechazos por duplicidad.	Esperar 1 minutos o confirmar el estado del documento antes de enviarlo de nuevo. Si luego de 1 minutos el problema persiste, se puede escalar el caso a Gosocket.
500	Q021	Error en el servidor remoto	Cuando el proceso que se realiza entre la API y la Entidad Tributaria (proceso llamado compliance) no regresa un código de error, sino una excepción que es controlada.	Interprete la excepción y realice las correcciones necesarias, o si no hay nada que corregir, espere unos minutos y vuelva a enviar el documento, si el problema persiste luego de varios intentos de re-envío, se puede escalar el caso a Gosocket.
99	N091	Documento duplicado.	Cuando el documento que se está enviando esta duplicado y ya existe aceptado anteriormente en los registros de Gosocket.	Verificar que exista el documento aprobado en Inbox. Corregir la serie, el folio o el tipo de documento, en caso de ser necesario y volver a enviar.
401	N/A	Está enviando con el ApiUser `{apiKey}`, el cual no está autorizado para su empresa (`{senderCode}`) en `{country}`.	Cuando se realiza el consumo del método utilizando credenciales que no están asociadas a la empresa emisora.	Verificar que se está utilizando el ApiKey correcto, el cual debe corresponder al autorizado para la empresa que está emitiendo el documento. Si no encuentra el error o el problema persiste luego de varios intentos de re-envío, se puede escalar el caso a Gosocket.
G001	N/A	El documento no puede ser procesado debido a que tiene una fecha futura [Object]	Cuando se está emitiendo el documento con una fecha futura.	Verificar la fecha del documento y corregirla antes de volver a enviar el documento, si el problema persiste luego de varios intentos de re-envío, se puede escalar el caso a Gosocket.
SV001	N/A	Contingencia por el Cliente	Cuando se están emitiendo documentos en contingencia debido al cliente.
77	N/A	Regla: Validando esquema del documento Archivo	Cuando el documento no supera el proceso de validación de esquema.	Interpretar y corregir el error entregado en el mensaje, antes de enviar de nuevo el documento. Si no encuentra el error o el problema persiste luego de varios intentos de re-envío, se puede escalar el caso a Gosocket.
DNT	N/A	Documento no tributario	Cuando el documento que se esta enviando corresponde a un Documento No Tributario.
DNT-02	N/A	Documento no tributario no pudo ser almacenado por tener la misma fecha, mismo consecutivo, por existir ya en la plataforma y se encuentra referenciado a una factura en estado Aceptado.	Cuando para un Documento No Tributario, no se supera la validación de misma fecha, consecutivo y estar referenciada a una factura aprobada.	Verificar los datos mencionados en la respuesta y realizar las correcciones necesarias antes de volver a enviar el documento, si el problema persiste luego de varios intentos de re-envío, se puede escalar el caso a Gosocket.
DNT-03	N/A	Documento no tributario no pudo ser almacenado por que ya se encuentra referenciado a una factura en estado Rechazado.	Cuando para un Documento No Tributario, no se supera la validación de estar referenciado a una factura rechazada.	Verificar los datos mencionados en la respuesta y realizar las correcciones necesarias antes de volver a enviar el documento, si el problema persiste luego de varios intentos de re-envío, se puede escalar el caso a Gosocket.
DNT-06	N/A	Documento no tributario no pudo ser almacenado por tener el mismo consecutivo, el año de la fecha es el mismo, por existir ya en la plataforma y este se encuentra referenciado a una factura en estado Aceptado.	Cuando para un Documento No Tributario, no se supera la validación de mismo año, consecutivo y estar referenciada a una factura aprobada.	Verificar los datos mencionados en la respuesta y realizar las correcciones necesarias antes de volver a enviar el documento, si el problema persiste luego de varios intentos de re-envío, se puede escalar el caso a Gosocket.
DNT-07	N/A	Documento no tributario no pudo ser almacenado por tener el mismo consecutivo, el año de la fecha es el mismo, por existir ya en la plataforma y este se encuentra referenciado a una factura en estado Rechazado.	Cuando para un Documento No Tributario, no se supera la validación de mismo año, consecutivo y estar referenciada a una factura rechazada.	Verificar los datos mencionados en la respuesta y realizar las correcciones necesarias antes de volver a enviar el documento, si el problema persiste luego de varios intentos de re-envío, se puede escalar el caso a Gosocket.
DNT-08	N/A	Documento no tributario no pudo ser almacenado por tener el mismo consecutivo, el año de la fecha es el mismo, por existir ya en la plataforma y este se encuentra asociado a una Factura electrónica que esta en un proceso activo de validaciones smart supply.	Cuando para un Documento No Tributario, no se supera la validación de mismo año, consecutivo y estar referenciada a una factura con proceso activo en las validaciones de Smart Supply.	Verificar los datos mencionados en la respuesta y realizar las correcciones necesarias antes de volver a enviar el documento, si el problema persiste luego de varios intentos de re-envío, se puede escalar el caso a Gosocket.

Algunos ejemplos de respuesta

Code: 001 Description: RECIBIDO ¿Cómo replicarlo? Rta/. Emitiendo un documento que se procese correctamente

{
"Success": true,
"GlobalDocumentId": "afd3a7fe-c511-2448-b8fa-c48dadcf1f3d",
"CountryDocumentId": "3D5E61AF-FB58-472E-BF63-16058D9B9646",
"OtherData": {
"Country": "sv",
"Certifier": "DGI",
"AuthorityTimeStamp": "21/07/2025 16:07:07"
},
"Messages": [],
"ResponseValue": "ew0KICAiZ2VuZXJhd...kVDSUJJRE8iDQp9",
"Code": "001",
"Description": "RECIBIDO",
"ErrorException": null
}

Code: XXX Description: Descripción propia de los códigos de respuesta de la DGI ¿Cómo replicarlo? Rta/. Emitiendo un documento que se procese con errores

{
"Success": false,
"GlobalDocumentId": "41c3d075-f362-dc58-9812-d98187aa89ac",
"CountryDocumentId": "C117C039-12E1-498C-840C-D017C9E0A14C",
"OtherData": {
"Country": "sv",
"Certifier": "DGI",
"AuthorityTimeStamp": "22/07/2025 16:42:55"
},
"Messages": [],
"ResponseValue": "ew0KICAiZ2VuZXJ...DT1JSRUNUTyINCn0=",
"Code": "020",
"Description": "[resumen.montoTotalOperacion] CALCULO INCORRECTO",
"ErrorException": null
}

Code: 500 SubCodeError: Q003 Description: ERROR Transformando Archivo ¿Cómo replicarlo? Rta/. informando en el request un mapping que no exista, por ejemplo "11111111-1111-1111-1111-11111111111a"

{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": {
"Country": "sv",
"Certifier": "DGI",
"AuthorityTimeStamp": "21/07/2025 16:10:54",
"SubCodeError": "Q003"
},
"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 encontro Xslt configurado.. Id error: 1d6677fc-56a6-47bf-9868-269ac14a7006 Fecha: 2025-07-21"
],
"ResponseValue": null,
"Code": "500",
"Description": "ERROR Transformando Archivo",
"ErrorException": null
}

Code: 500 SubCodeError: Q004 Description: ERROR Parseando Archivo ¿Cómo replicarlo? Rta/. Enviando la fecha de emisión del documento con un formato invalido, por ejemplo 2025/05/27

{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": {
"Country": "sv",
"Certifier": "DGI",
"AuthorityTimeStamp": "21/07/2025 16:09:59",
"SubCodeError": "Q004"
},
"Messages": [
"Regla: ERROR, Reintento: Error en el ParserXML, verifique el XML y reintente nuevamente.",
"Input string was not in a correct format."
],
"ResponseValue": null,
"Code": "500",
"Description": "ERROR Parseando Archivo",
"ErrorException": null
}

Code: 500 SubCodeError: Q005 Description: Empresa no activa para emitir ¿Cómo replicarlo? Rta/. No hay una tecnica que se pueda compartir para replicar este error, ya que depende de configuraciones internas que el usuario no tiene como modificar.

{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": {
"SubCodeError": "Q005"
},
"Messages": [],
"ResponseValue": "Empresa no activa",
"Code": "500",
"Description": "Empresa no activa para emitir",
"ErrorException": null
}

Code: 500 SubCodeError: Q006 Description: Proceso pendiente para el documento {code}, TrackId: {trackId}. ¿Cómo replicarlo? Rta/. Enviar solicitudes concurrentes del mismo documento.

{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": {
"Country": "sv",
"Certifier": "DGI",
"AuthorityTimeStamp": "21/07/2025 16:24:02",
"SubCodeError": "Q006"
},
"Messages": [
"Regla: Ya Existe un proceso pendiente para este documento: DTE-1-001-236. (TipoDocumento-Serie-Folio)"
],
"ResponseValue": null,
"Code": "500",
"Description": "Proceso pendiente para el documento DTE-1-001-236, TrackId:01adc102-fa8c-46cc-acab-1153195c81ad.",
"ErrorException": null
}

Code: 99 SubCodeError: N091 Description: Documento duplicado. ¿Cómo replicarlo? Rta/. Enviar el mismo documento (serie-folio) emitido en dias anteriores con fecha actual

{
"Success": false,
"GlobalDocumentId": "afd3a7fe-c511-2448-b8fa-c48dadcf1f3d",
"CountryDocumentId": null,
"OtherData": {
"Country": "sv",
"Certifier": "DGI",
"AuthorityTimeStamp": "21/07/2025 16:15:55",
"SubCodeError": "N091"
},
"Messages": [
"Notificación: Documento enviado anteriormente con fecha 21-07-2025 a 06140109171067"
],
"ResponseValue": "PD94bWwgdmVyc2lvbj...9QZXJzb25hbGl6YWRvcz4KPC9EVEU+",
"Code": "99",
"Description": "Documento duplicado",
"ErrorException": null
}

Code: 401 Description: Está enviando con el ApiUser {apiKey}, el cual no está autorizado para su empresa ({senderCode}) en {country}. ¿Cómo replicarlo? Rta/. Consumiendo el método con credenciales de autenticación que no estén asociadas a la empresa emisora.

{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": {
"Country": "sv",
"Certifier": "DGI",
"AuthorityTimeStamp": "21/07/2025 16:29:39"
},
"Messages": [
"ApiUser no Autorizado para emisor [06142709211090] en sbx"
],
"ResponseValue": null,
"Code": "401",
"Description": "Esta enviando con el ApiUser 6fd63884-0f2a-4027-b9fb-7547e5bd88c0 el cual no esta autorizado para su empresa (06142709211090) en sv.",
"ErrorException": null
}

Code: G001 Description: El documento no puede ser procesado debido a que tiene una fecha futura ¿Cómo replicarlo? Rta/. definiendo una fecha de emisión mayor a 2 años

{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": {
"Country": "sv",
"Certifier": "DGI",
"AuthorityTimeStamp": "21/07/2025 16:26:29"
},
"Messages": [],
"ResponseValue": null,
"Code": "G001",
"Description": "El documento no puede ser procesado debido a que tiene una fecha futura 21-07-2027",
"ErrorException": null
}

Code: SV001 Description: Contingencia por el Cliente ¿Cómo replicarlo? Rta/. enviando un documento en contingencia debida al cliente

{
"Success": true,
"GlobalDocumentId": "706980ab-5322-f17b-2aa4-c2c4028909a1",
"CountryDocumentId": "1291ABA2-542C-1B0E-80E4-C13EF34851D9",
"OtherData": {
"Country": "sv",
"Certifier": "DGI",
"AuthorityTimeStamp": "21/07/2025 04:42:37"
},
"Messages": [
"Notificación: Contingencia por el Cliente."
],
"ResponseValue": null,
"Code": "SV001",
"Description": "Contingencia por el Cliente",
"ErrorException": null
}

Algunos ejemplos de respuesta​

Algunos ejemplos de respuesta