Guatemala - Códigos de respuesta
| Códigos de Respuesta (SendDocumentToAuthority) | ||||
|---|---|---|---|---|
| Code | SubCodeError | Description | Comentarios | Acciones |
| 0 | N/A | null | Cuando el documento se procesó correctamente (Success:true) Cuando el documento contiende errores (Success:false) | 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 | 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 | Q013 | Excepción generada en el momento | ex.Message | Cuando se presenta algún error durante el proceso de Firma del documento. |
| 500 | Q019 | Error en el envío a la Entidad Tributaria | Cuando el proceso que se realiza entre la API y la Entidad Tributaria (proceso llamado compliance) presenta algún error o problemas de conexión. | 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. |
| 7 | N/A | Error al procesar la solicitud. Id de error: [Object] Fecha: [Object]. Mensaje de error: [Object] | Cuando dentro del proceso se presenta una Excepción no controlada. | 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-REJECTED | N/A | Documento no tributario no pudo ser almacenado por existir ya en la plataforma uno que contiene referencias previas. | Cuando para un Documento No Tributario, no se supera la validación de referencias previas. | 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-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: 0 Description: null ¿Cómo replicarlo? Rta/. Emitiendo un documento que se procese correctamente
{
"Success": true,
"GlobalDocumentId": "730725bb-de95-4c69-9582-077d1b7b65ca",
"CountryDocumentId": "E0871962-175C-4AC7-AE40-ECA1F056B01B",
"OtherData": {
"Country": "gt",
"Certifier": "Megaprint",
"AuthorityTimeStamp": "21/07/2025 14:02:49",
"Number": "391924423",
"Series": "E0871962",
"BarCodeText": "https://felpub.c.sat.gob.gt/verificador-web/publico/vistas/verificacionDte.jsf?tipo=autorizacion&numero=E0871962-175C-4AC7-AE40-ECA1F056B01B&emisor=104525746&receptor=28370503&monto=100.00"
},
"Messages": [],
"ResponseValue": "PD94bWwgdmVyc...RlOkdURG9jdW1lbnRvPg==",
"Code": "0",
"Description": null,
"ErrorException": null
}Code: 0 Description: null ¿Cómo replicarlo? Rta/. Emitiendo un documento que se procese con errores
{
"Success": false,
"GlobalDocumentId": "8692ca43-7abe-49a0-ae0b-2e3f2566a9b4",
"CountryDocumentId": "",
"OtherData": {
"Country": "gt",
"Certifier": "Megaprint",
"AuthorityTimeStamp": "21/07/2025 15:26:11"
},
"Messages": [
"Regla: FEL_GEN102, Rechazo: RESTRICTION_ENUMERATION: Attribute [AfiliacionIVA] of parent[Emisor] does not match enumeration."
],
"ResponseValue": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9InllcyI/PjxSZWdpc3RyYURvY3VtZW50b1hNTFJlc3BvbnNlPjxsaXN0YWRvX2Vycm9yZXM+PGVycm9yPjxjb2RfZXJyb3I+RkVMX0dFTjEwMjwvY29kX2Vycm9yPjxkZXNjX2Vycm9yPlJFU1RSSUNUSU9OX0VOVU1FUkFUSU9OOiBBdHRyaWJ1dGUgW0FmaWxpYWNpb25JVkFdIG9mIHBhcmVudFtFbWlzb3JdIGRvZXMgbm90IG1hdGNoIGVudW1lcmF0aW9uLjwvZGVzY19lcnJvcj48L2Vycm9yPjwvbGlzdGFkb19lcnJvcmVzPjx0aXBvX3Jlc3B1ZXN0YT4xPC90aXBvX3Jlc3B1ZXN0YT48L1JlZ2lzdHJhRG9jdW1lbnRvWE1MUmVzcG9uc2U+",
"Code": "0",
"Description": null,
"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": "gt",
"Certifier": "Megaprint",
"AuthorityTimeStamp": "21/07/2025 15:01:59",
"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: 8559e180-9db9-419a-86ae-3ad651023552 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": "gt",
"Certifier": "Megaprint",
"AuthorityTimeStamp": "22/07/2025 17:02:26",
"SubCodeError": "Q004"
},
"Messages": [
"Regla: ERROR, Reintento: Error en el ParserXML, verifique el XML y reintente nuevamente.",
"System.FormatException: Input string was not in a correct format.\r\n at System.Number.StringToNumber(String str, NumberStyles options, NumberBuffer& number, NumberFormatInfo info, Boolean parseDecimal)\r\n at System.Number.ParseInt32(String s, NumberStyles style, NumberFormatInfo info)\r\n at System.Convert.ToInt32(String value)\r\n at Gosocket.Document.ApplicationServices.ParserServices.ParserGT(XmlDocument xmlDocument) in D:\a\1\s\L3 Application\Gosocket.Document.ApplicationServices\ParserServices.cs:line 2943\r\n at Gosocket.Document.ApplicationServices.ParserServices.ParserXml(XmlDocument document, String country) in D:\a\1\s\L3 Application\Gosocket.Document.ApplicationServices\ParserServices.cs:line 28\r\n at Gosocket.Document.ApplicationServices.GuatemalaApplicationServices.MakeDocumentAndSend(String country, String mappingId, String data, String apiKey, Boolean sign, Boolean systemDefaultCertificate, Boolean async, Guid trackId, List`1 accountCodes, Boolean internalSystemUpload, String& senderCode, ProcessPerformanceLogData& procLogData) in D:\a\1\s\L3 Application\Gosocket.Document.ApplicationServices\CountryServices\GuatemalaApplicationServices.cs:line 171"
],
"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: Q013 Description: Excepción generada en el momento | ex.Message ¿Cómo replicarlo? Rta/. informando en el emisor una empresa sin certificado cargado o que no exista en la plataforma.
{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": {
"Country": "gt",
"Certifier": "Megaprint",
"AuthorityTimeStamp": "30/07/2025 09:25:31",
"SubCodeError": "Q013"
},
"Messages": [
"Regla: ERROR, Reintento: al firmar el documento"
],
"ResponseValue": null,
"Code": "500",
"Description": "MSSign.10000 - El certificado no existe.",
"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": "ca2c29bd-d826-92a7-2f22-239de853b033",
"CountryDocumentId": null,
"OtherData": {
"Country": "gt",
"Certifier": "Megaprint",
"AuthorityTimeStamp": "21/07/2025 15:05:28",
"SubCodeError": "N091"
},
"Messages": [
"Notificación: Documento enviado anteriormente con fecha 09-08-2024 a 28370503"
],
"ResponseValue": null,
"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": "gt",
"Certifier": "Megaprint",
"AuthorityTimeStamp": "21/07/2025 15:07:51"
},
"Messages": [
"ApiUser no Autorizado para emisor [104525746] en sbx"
],
"ResponseValue": null,
"Code": "401",
"Description": "Esta enviando con el ApiUser 4a15ccad-821c-44b5-9f22-7c00ae2706b8 el cual no esta autorizado para su empresa (104525746) en gt.",
"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": "gt",
"Certifier": "Megaprint",
"AuthorityTimeStamp": "21/07/2025 15:06:38"
},
"Messages": [],
"ResponseValue": null,
"Code": "G001",
"Description": "El documento no puede ser procesado debido a que tiene una fecha futura 21-07-2028",
"ErrorException": null
}Code: 7 Description: Error al procesar la solicitud. Id de error: {trackId}. Fecha: {logDate}. Mensaje de error: {e.Message}.
¿Cómo replicarlo? Rta/. Enviar documento con error en formato del xml, por ejemplo dejar un nodo abierto sin el >
{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": null,
"Messages": [],
"ResponseValue": "",
"Code": "7",
"Description": "Error al procesar la solicitud. Id de error: f192cc88-6283-4e79-a6d8-277f3e7cc497 Fecha: 2025-07-30. Mensaje de error: '<' is an unexpected token. The expected token is '>'. Line 54, position 5.",
"ErrorException": null
}