Guatemala - Response codes
| Response Codes (SendDocumentToAuthority) | ||||
|---|---|---|---|---|
| Code | SubCodeError | Description | Comments | Actions |
| 0 | N/A | null | When the document was processed successfully (Success:true) When the document contains errors (Success:false) | Interpret and fix the error provided in Messages, before resending the document. If you cannot find the error or the problem persists after several resend attempts, the case can be escalated to Gosocket. |
| 500 | Q003 | ERROR Transforming File | When an error occurs during the process of transforming the DTE into the tax UBL. | Interpret and fix the error provided in Messages, before resending the document. If you cannot find the error or the problem persists after several resend attempts, the case can be escalated to Gosocket. |
| 500 | Q004 | ERROR Parsing File | When an error occurs during the document parsing process. | Interpret and fix the error provided in Messages, before resending the document. If you cannot find the error or the problem persists after several resend attempts, the case can be escalated to Gosocket. |
| 500 | Q005 | Company not active to issue | When the company does not have document issuance enabled. | Contact Gosocket to check for a possible block due to financial reasons. |
| 500 | Q013 | Exception generated at the time | ex.Message | When an error occurs during the document's Signing process. |
| 500 | Q019 | Error sending to the Tax Authority | When the process performed between the API and the Tax Authority (a process called compliance) has some error or connection issues. | Wait a few minutes and resend the document. If the problem persists after several resend attempts, the case can be escalated to Gosocket. |
| 99 | N091 | Duplicate document. | When the document being sent is a duplicate and already exists, previously accepted, in Gosocket's records. | Check that the approved document exists in Inbox. Correct the series, the folio, or the document type, if necessary, and resend. |
| 401 | N/A | You are sending with ApiUser {apiKey}, which is not authorized for your company ({senderCode}) in {country}. | When the method is consumed using credentials that are not associated with the issuing company. | Check that you are using the correct ApiKey, which must correspond to the one authorized for the company issuing the document. If you cannot find the error or the problem persists after several resend attempts, the case can be escalated to Gosocket. |
| G001 | N/A | The document cannot be processed because it has a future date [Object] | When the document is being issued with a future date. | Check the document's date and correct it before resending the document. If the problem persists after several resend attempts, the case can be escalated to Gosocket. |
| 7 | N/A | Error processing the request. Error Id: [Object] Date: [Object]. Error message: [Object] | When an unhandled Exception occurs within the process. | Interpret and fix the error provided in the message, before resending the document. If you cannot find the error or the problem persists after several resend attempts, the case can be escalated to Gosocket. |
| DNT | N/A | Non-tax document | When the document being sent corresponds to a Non-Tax Document. | |
| DNT-REJECTED | N/A | Non-tax document could not be stored because one that contains previous references already exists on the platform. | When, for a Non-Tax Document, the validation of previous references is not passed. | Check the data mentioned in the response and make the necessary corrections before resending the document. If the problem persists after several resend attempts, the case can be escalated to Gosocket. |
| DNT-02 | N/A | Non-tax document could not be stored because it has the same date and the same sequence number, as it already exists on the platform and is referenced to an invoice in Accepted status. | When, for a Non-Tax Document, the validation of the same date, sequence number, and being referenced to an approved invoice is not passed. | Check the data mentioned in the response and make the necessary corrections before resending the document. If the problem persists after several resend attempts, the case can be escalated to Gosocket. |
| DNT-03 | N/A | Non-tax document could not be stored because it is already referenced to an invoice in Rejected status. | When, for a Non-Tax Document, the validation of being referenced to a rejected invoice is not passed. | Check the data mentioned in the response and make the necessary corrections before resending the document. If the problem persists after several resend attempts, the case can be escalated to Gosocket. |
| DNT-06 | N/A | Non-tax document could not be stored because it has the same sequence number and the same year in the date, as it already exists on the platform and is referenced to an invoice in Accepted status. | When, for a Non-Tax Document, the validation of the same year, sequence number, and being referenced to an approved invoice is not passed. | Check the data mentioned in the response and make the necessary corrections before resending the document. If the problem persists after several resend attempts, the case can be escalated to Gosocket. |
| DNT-07 | N/A | Non-tax document could not be stored because it has the same sequence number and the same year in the date, as it already exists on the platform and is referenced to an invoice in Rejected status. | When, for a Non-Tax Document, the validation of the same year, sequence number, and being referenced to a rejected invoice is not passed. | Check the data mentioned in the response and make the necessary corrections before resending the document. If the problem persists after several resend attempts, the case can be escalated to Gosocket. |
| DNT-08 | N/A | Non-tax document could not be stored because it has the same sequence number and the same year in the date, as it already exists on the platform and is associated with an electronic invoice that is in an active Smart Supply validation process. | When, for a Non-Tax Document, the validation of the same year, sequence number, and being referenced to an invoice with an active process in Smart Supply validations is not passed. | Check the data mentioned in the response and make the necessary corrections before resending the document. If the problem persists after several resend attempts, the case can be escalated to Gosocket. |
Some response examples
Code: 0 Description: null How to replicate it? Answer: By issuing a document that is processed successfully
{
"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 How to replicate it? Answer: By issuing a document that is processed with errors
{
"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 Transforming File How to replicate it? Answer: by providing a mapping that does not exist in the request, for example "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 Parsing File How to replicate it? Answer: By sending the document's issuance date in an invalid format, for example 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: Company not active to issue How to replicate it? Answer: There is no technique that can be shared to replicate this error, since it depends on internal configurations the user has no way to modify.
{
"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: Exception generated at the time | ex.Message How to replicate it? Answer: by specifying, as the issuer, a company with no certificate uploaded or that does not exist on the platform.
{
"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: Duplicate document. How to replicate it? Answer: Send the same document (series-folio) issued on previous days with the current date
{
"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: You are sending with ApiUser {apiKey}, which is not authorized for your company ({senderCode}) in {country}.
How to replicate it? Answer: By consuming the method with authentication credentials that are not associated with the issuing company.
{
"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: The document cannot be processed because it has a future date How to replicate it? Answer: by setting an issuance date more than 2 years ahead
{
"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 processing the request. Error Id: {trackId}. Date: {logDate}. Error message: {e.Message}.
How to replicate it? Answer: Send a document with an error in the XML format, for example leaving a node open without the closing >
{
"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
}