Panamá - Códigos de respuesta
| Códigos de Respuesta (SendDocumentToAuthority) | ||||
|---|---|---|---|---|
| Code | SubCodeError | Description | Comentarios | Acciones |
| **200 | Sync** | N/A | Autorizado el uso de la FE. Vacía | Cuando el documento se procesó correctamente (Success:true) Cuando el documento contiende errores (Success:false) |
| 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 3 minutos o confirmar el estado del documento antes de enviarlo de nuevo. Si luego de 3 minutos el problema persiste, se puede escalar el caso a Gosocket. |
| 500 | Q013 | Excepción generada en el momento | ex.Message | Cuando se presenta algún error durante el proceso de Firma del documento. |
| 500 | Q014 | Excepción generada en el momento | ex.Message | Cuando se presenta algún error durante el proceso de Cálculo del dígito de verificación |
| 500 | Q015 | Excepción generada en el momento | ex.Message | Cuando se presenta algún error durante el proceso de Generación del código QR. |
| 500 | Q016 | No es posible procesar la nota ya que incluye documentos referenciados autorizados por diferentes PAC: XXXXXX | Cuando se envían documentos referenciados que fueron autorizados por diferentes PAC. Por ejemplo, en una NC referenciando una Factura autorizada por el PAC 1 y adicional otra Factura autorizada por el PAC 2. | Revise los documentos referenciados y relacione en el documento unicamente los autorizados por el mismo PAC, vuelva a enviar el documento, si el problema persiste luego de varios intentos de re-envío, se puede escalar el caso a Gosocket. |
| 504 | Q017 | La empresa no tiene configurado el PAC a utilizar | Cuando la empresa no tiene configurado el PAC que se encargará de validar por documentos | Revise y gestione la configuración del PAC para la empresa, vuelva a enviar el documento, si el problema persiste luego de varios intentos de re-envío, se puede escalar el caso a Gosocket. |
| 500 | Q020 | Timeout envío PAC Panamá | Cuando se emite un documento y al momento de enviar al PAC no se obtiene respuesta y se genera un error por TimeOut. | 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. |
| 393 o 1513 | N/A | Documento duplicado. | Cuando el documento que se está enviando esta duplicado y ya existe aceptado anteriormente. | Verificar que exista el documento aprobado en Inbox. Corregir la serie, el folio, la sucursal 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-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: 200|Sync Description: Autorizado el uso de la FE ¿Cómo replicarlo? Rta/. Emitiendo un documento que se procese correctamente
{
"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: vacía ¿Cómo replicarlo? Rta/. Emitiendo un documento que se procese con errores
{
"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 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": {
"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 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": {
"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: 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": {
"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: Excepción generada en el momento | ex.Message ¿Cómo replicarlo? Rta/. informando en el emisor sin certificado cargado o que no exista en la plataforma.
{
"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: No es posible procesar la nota ya que incluye documentos referenciados autorizados por diferentes PAC: XXXXXX. ¿Cómo replicarlo? Rta/. Enviar una nota de credito referenciando una factura autorizada por el PAC EBI y otra autorizada por el 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: Documento duplicado. ¿Cómo replicarlo? Rta/. Enviar el mismo documento (serie-folio) emitido en dias anteriores con fecha actual
{
"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: 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": "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: 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": {},
"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
}