Panamá - Response Codes
| Response Codes (SendDocumentToAuthority) | ||||
|---|---|---|---|---|
| Code | SubCodeError | Description | Comments | Actions |
| **200 | Sync** | N/A | Use of the FE authorized. Empty | When the document was processed successfully (Success:true) When the document contains errors (Success:false) |
| 500 | Q003 | ERROR Transforming File | When an error occurs during the process of transforming the DTE into the tax UBL. | Interpret and correct 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 correct 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 documents | When the company does not have document issuance enabled. | Contact Gosocket to check for a possible block due to financial reasons. |
| 500 | Q006 | Pending process for document [Object], TrackId:[Object]. | When concurrent requests are received for sending the same document, because the system may not have finished processing it yet, this 1-minute lock is applied to guarantee document integrity and avoid rejections due to duplication. | Wait 3 minutes or confirm the document's status before sending it again. If the problem persists after 3 minutes, the case can be escalated to Gosocket. |
| 500 | Q013 | Exception generated at that moment | ex.Message | When an error occurs during the document Signing process. |
| 500 | Q014 | Exception generated at that moment | ex.Message | When an error occurs during the check-digit calculation process |
| 500 | Q015 | Exception generated at that moment | ex.Message | When an error occurs during the QR code generation process. |
| 500 | Q016 | The note cannot be processed because it includes referenced documents authorized by different PACs: XXXXXX | When referenced documents that were authorized by different PACs are sent. For example, in a credit note (NC) referencing an invoice authorized by PAC 1 and additionally another invoice authorized by PAC 2. | Review the referenced documents and include in the document only those authorized by the same PAC, then resend the document. If the problem persists after several resend attempts, the case can be escalated to Gosocket. |
| 504 | Q017 | The company does not have the PAC to use configured | When the company does not have configured the PAC that will be responsible for validating documents | Review and manage the PAC configuration for the company, then resend the document. If the problem persists after several resend attempts, the case can be escalated to Gosocket. |
| 500 | Q020 | Timeout sending to PAC Panamá | When a document is issued and, at the time of sending it to the PAC, no response is received and a Timeout error is generated. | Wait a few minutes and resend the document. If the problem persists after several resend attempts, the case can be escalated to Gosocket. |
| 393 or 1513 | N/A | Duplicate document. | When the document being sent is a duplicate and already exists, previously accepted. | Verify that the approved document exists in Inbox. Correct the series, the folio, the branch, or the document type if necessary, and resend. |
| 401 | N/A | You are sending with the ApiUser {apiKey}, which is not authorized for your company ({senderCode}) in {country}. | When the method is called using credentials that are not associated with the issuing company. | Verify 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. | Verify 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 during the process. | Interpret and correct 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-02 | N/A | The non-tax document could not be stored because it has the same date and the same consecutive number, since it already exists on the platform and is referenced to an invoice in Accepted status. | When a Non-Tax Document does not pass the validation of same date, consecutive number, and being referenced to an approved invoice. | Verify 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 | The non-tax document could not be stored because it is already referenced to an invoice in Rejected status. | When a Non-Tax Document does not pass the validation of being referenced to a rejected invoice. | Verify 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 | The non-tax document could not be stored because it has the same consecutive number, the year of the date is the same, since it already exists on the platform and is referenced to an invoice in Accepted status. | When a Non-Tax Document does not pass the validation of same year, consecutive number, and being referenced to an approved invoice. | Verify 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 | The non-tax document could not be stored because it has the same consecutive number, the year of the date is the same, since it already exists on the platform and is referenced to an invoice in Rejected status. | When a Non-Tax Document does not pass the validation of same year, consecutive number, and being referenced to a rejected invoice. | Verify 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 | The non-tax document could not be stored because it has the same consecutive number, the year of the date is the same, since it already exists on the platform and it is associated with an electronic invoice that is in an active Smart Supply validation process. | When a Non-Tax Document does not pass the validation of same year, consecutive number, and being referenced to an invoice with an active process in Smart Supply validations. | Verify 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: 200|Sync Description: Use of the FE authorized How to replicate it? A/. By issuing a document that is processed successfully
{
"Success": true,
"GlobalDocumentId": "15409422-162d-5b86-3b15-31a244bc67c6",
"CountryDocumentId": "FE0120000155707757-2-2021-5000012025071700000003841870127227697223",
"OtherData": {
"Country": "pa",
"Certifier": "gosocket",
"AuthorityTimeStamp": "7/17/2025 3:31:10 PM",
"BarCodeText": "https://dgi-fep-test.mef.gob.pa:40001/Consultas/FacturasPorQR?chFE=FE0120000155707757-2-2021-5000012025071700000003841870127227697223&iAmb=2&digestValue=4mVqwug+joSbJTrEnkPE7dN9HcI0FqiMB6Z5HGRyj4s=&jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjaEZFIjoiRkUwMTIwMDAwMTU1NzA3NzU3LTItMjAyMS01MDAwMDEyMDI1MDcxNzAwMDAwMDAzODQxODcwMTI3MjI3Njk3MjIzIiwiaUFtYiI6IjIiLCJkaWdlc3RWYWx1ZSI6IjRtVnF3dWcram9TYkpUckVua1BFN2ROOUhjSTBGcWlNQjZaNUhHUnlqNHM9IiwibmJmIjoxNzUyNzY2MjcwLCJleHAiOjE3NTI3Njk4NzAsImlhdCI6MTc1Mjc2NjI3MH0.PlBwgoYz7i5xA9vtf9VLUm0N-DboC39e52Ptju-f35k",
},
"Messages": [],
"ResponseValue": "PD94bWwgdmVyc2lvbj...2PjwvckNvbnRGZT4=",
"Code": "200|Sync",
"Description": "Autorizado el uso de la FE",
"ErrorException": null
}Code: 200|Sync Description: empty How to replicate it? A/. By issuing a document that is processed with errors
{
"Success": false,
"GlobalDocumentId": "c9c28a6c-82af-57d5-8a1e-de4bf218684e",
"CountryDocumentId": "FE04200001713709-1-688962-5400002025071700000440474880128527798524",
"OtherData": {
"Country": "pa",
"Certifier": "gosocket",
"AuthorityTimeStamp": "7/17/2025 5:44:48 PM",
"BarCodeText": "https://dgi-fep-test.mef.gob.pa:40001/Consultas/FacturasPorQR?chFE=FE04200001713709-1-688962-5400002025071700000440474880128527798524&iAmb=2&digestValue=nXWpVbxgA6C2uAxuXyQOUAouDnED1NXf5P4Iz8ramzE=&jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjaEZFIjoiRkUwNDIwMDAwMTcxMzcwOS0xLTY4ODk2Mi01NDAwMDAyMDI1MDcxNzAwMDAwNDQwNDc0ODgwMTI4NTI3Nzk4NTI0IiwiaUFtYiI6IjIiLCJkaWdlc3RWYWx1ZSI6Im5YV3BWYnhnQTZDMnVBeHVYeVFPVUFvdURuRUQxTlhmNVA0SXo4cmFtekU9IiwibmJmIjoxNzUyNzc0Mjg4LCJleHAiOjE3NTI3Nzc4ODgsImlhdCI6MTc1Mjc3NDI4OH0.ouLNA4AdHRZDKGyaKI2MKY52QkL0-T5gTLO9V3VbjbE"
},
"Messages": [
"1607|Corregimiento donde se ubica el receptor contribuyente no existe en el catálogo de corregimientos",
"1710|Los documentos electrónicos referenciados no concuerdan con el mismo receptor",
"1711|Monto total de nota de crédito/débito superior al monto total de la Factura referenciada",
"1717|Monto de las notas de crédito o débito inconsistentes con el monto de la FE original referenciada",
"1718|No se permite realizar notas de crédito/débito a una FE con un evento de anulación"
],
"ResponseValue": "PD94bWwgdmVyc...NvbnRFdj48L3JDb250RmU+",
"Code": "200|Sync",
"Description": "",
"ErrorException": null
}Code: 500 SubCodeError: Q003 Description: ERROR Transforming File How to replicate it? A/. By specifying a mapping in the request that does not exist, for example "11111111-1111-1111-1111-11111111111a"
{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": {
"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: f5e19ca3-bfdb-4508-a5e8-cba0f93e0463 Fecha: 2025-07-17"
],
"ResponseValue": null,
"Code": "500",
"Description": "ERROR Transformando Archivo",
"ErrorException": null
}Code: 500 SubCodeError: Q004 Description: ERROR Parsing File How to replicate it? A/. By sending the document's issue date in an invalid format, for example 2025/05/27
{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": {
"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.ParserPA(XmlDocument xmlDocument) in D:\a\1\s\L3 Application\Gosocket.Document.ApplicationServices\ParserServices.cs:line 8843\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 76\r\n at Gosocket.Document.ApplicationServices.CountryServices.PanamaApplicationServices.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, Dictionary`2 additionalData) in D:\a\1\s\L3 Application\Gosocket.Document.ApplicationServices\CountryServices\PanamaApplicationServices.cs:line 196"
],
"ResponseValue": null,
"Code": "500",
"Description": "ERROR Parseando Archivo",
"ErrorException": null
}Code: 500 SubCodeError: Q005 Description: Company not active to issue documents How to replicate it? A/. There is no technique that can be shared to replicate this error, since it depends on internal configurations that the user cannot 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: Q006 Description: Pending process for document {code}, TrackId: {trackId}.
How to replicate it? A/. Sending concurrent requests for the same document.
{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": {
"SubCodeError": "Q006"
},
"Messages": [
"Ya Existe un proceso pendiente para este documento: 1|187|385 (TipoDocumento|Serie|Folio)"
],
"ResponseValue": null,
"Code": "500",
"Description": "Proceso pendiente 1|187|385 TrackId:1e668499-f09e-4bd3-9154-755657622fea",
"ErrorException": null
}Code: 500 SubCodeError: Q013 Description: Exception generated at that moment | ex.Message How to replicate it? A/. By specifying an issuer with no certificate uploaded or that does not exist on the platform.
{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": {
"SubCodeError": "Q013"
},
"Messages": [
"Regla: ERROR, Reintento: al firmar el documento"
],
"ResponseValue": null,
"Code": "500",
"Description": "MSSign.10000 - El certificado no existe.",
"ErrorException": null
}Code: 500 SubCodeError: Q016 Description: The note cannot be processed because it includes referenced documents authorized by different PACs: XXXXXX. How to replicate it? A/. Sending a credit note referencing an invoice authorized by PAC EBI and another authorized by PAC Gosocket.
{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": {
"SubCodeError": "Q016"
},
"Messages": [],
"ResponseValue": "PAC issue",
"Code": "500",
"Description": "No es posible procesar la nota ya que incluye documentos referenciados autorizados por diferentes PAC: ebi | Cufe: FE01200001713709-1-688962-5400002023051800000045480010124644334694 | gosocket | Cufe: FE01200001713709-1-688962-5400002023080800000040428880129615979625 | ",
"ErrorException": null
}Code: 393 Description: Duplicate document. How to replicate it? A/. Sending the same document (series-folio) issued on previous days with the current date
{
"Success": false,
"GlobalDocumentId": "3ea567cf-7ae8-0a4a-06d5-02bb0a9fe728",
"CountryDocumentId": "FE0120000155707757-2-2021-5000012025071700000003851870126327766382",
"OtherData": {
"Country": "pa",
"Certifier": "gosocket",
"AuthorityTimeStamp": "7/17/2025 4:47:15 PM",
"BarCodeText": "https://dgi-fep-test.mef.gob.pa:40001/Consultas/FacturasPorQR?chFE=FE0120000155707757-2-2021-5000012025071700000003851870126327766382&iAmb=2&digestValue=tT6ZlOPjw86+RiFKAIui7ITehjQ3/lvjBoSC555M0hs=&jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjaEZFIjoiRkUwMTIwMDAwMTU1NzA3NzU3LTItMjAyMS01MDAwMDEyMDI1MDcxNzAwMDAwMDAzODUxODcwMTI2MzI3NzY2MzgyIiwiaUFtYiI6IjIiLCJkaWdlc3RWYWx1ZSI6InRUNlpsT1Bqdzg2K1JpRktBSXVpN0lUZWhqUTMvbHZqQm9TQzU1NU0waHM9IiwibmJmIjoxNzUyNzcwODM0LCJleHAiOjE3NTI3NzQ0MzQsImlhdCI6MTc1Mjc3MDgzNH0.C2MXNeXWA2iW1mBuF8qRf1a5kKarZhrM93eLGJK3mW4"
},
"Messages": [
" Codigo : 393, Descripcion : Documento duplicado"
],
"ResponseValue": "PD94bWwgdmVyc2...ckNvbnRGZT4=",
"Code": "393",
"Description": "Documento duplicado.",
"ErrorException": null
}Code: 401 Description: You are sending with the ApiUser {apiKey}, which is not authorized for your company ({senderCode}) in {country}.
How to replicate it? A/. Calling the method with authentication credentials that are not associated with the issuing company.
{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": "01|253-92-57027|0001|385|187|2|01",
"OtherData": {},
"Messages": [
"ApiUser no Autorizado para emisor [253-92-57027] en sbx"
],
"ResponseValue": "Permiso Denegado",
"Code": "401",
"Description": "Esta enviando con el ApiUser 5e3c6e8e-0fbf-43ab-8ff8-e2631ad5e7a4 el cual no esta autorizado para su empresa (253-92-57027) en pa.",
"ErrorException": null
}Code: G001 Description: The document cannot be processed because it has a future date How to replicate it? A/. Setting an issue date more than 2 years in the future
{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": {},
"Messages": [],
"ResponseValue": "Documento con fecha del futuro",
"Code": "G001",
"Description": "El documento no puede ser procesado debido a que tiene una fecha futura 17-09-2027",
"ErrorException": null
}