Peru - Códigos de respuesta
| Códigos de Respuesta (SendDocumentToAuthority) | ||||
|---|---|---|---|---|
| Code | SubCodeError | Description | Comentarios | Acciones |
| 0 | N/A | La Factura número Serie-Correlativo, ha sido aceptada. La boleta número Serie-Correlativo, ha sido aceptada. La Factura numero Serie-Correlativo, ha sido aceptado con observaciones | Cuando el documento se procesó correctamente en el envío síncrono. | |
| 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 | Q009 | API-ERROR al crear el XmlDocument | Cuando se carga el XML al sistema para ser procesado y se generar un error. | 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. |
| 500 | Q022 | Excepción. | Cuando el proceso que se realiza entre la API y la Entidad Tributaria/OSE (proceso llamado compliance) no regresa un código de error, sino una excepción que es controlada. | 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. |
| 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. |
| G002 | N/A | ERROR Number < 1 carácter ó ERROR Number > 8 caracteres | Cuando se está emitiendo un documento con correlativo menor a 1 caracter ó superior a 8 caracteres de longitud. | Verificar el correlativo del documento y corregirlo antes de volver a enviar el documento, si el correlativo cumple con el tamaño esperado y aún sale error, se puede escalar el caso a Gosocket. |
| 1033 | N/A | El comprobante fue registrado previamente o El comprobante fue registrado previamente con otros datos. | 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 correlativo o el tipo de documento, en caso de ser necesario y volver a enviar. |
| 501 | N/A | No es posible guardar el xml del Documento | Cuando dentro del proceso de almacenamiento del XML se presenta algun problema. | 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. |
| 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. |
| PE001 | N/A | Proceso Asíncrono - El documento será insertado en un resumen | Cuando se envía un documento de forma asíncrona, y el documento se recibe en Gosocket correctamente. | |
| PE002 | N/A | Fecha de emisión > 1 día calendario a la fecha de recepción. Documento será procesado el DD/MM/AAA. | Cuando se envía un documento de forma asíncrona, y la fecha de emisión es del día siguiente a la fecha de recepción en Gosocket, el documento se procesa en la fecha de emisión, es decir, al día siguiente. | |
| PE004 | N/A | Documento de anulación enviado a procesar de manera asíncrona | Cuando se envía un documento de anulación de forma asíncrona y el documento se recibe en Gosocket correctamente. | |
| PE005 | N/A | Documento de anulación sin referencias válidas | Cuando se envía un documento de anulación de forma asíncrona, y no posee referencias válidas. | Verificar las referencias y corregirlas 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. |
| PE006 | N/A | Proceso Asíncrono - El documento será enviado asyncronamente | Cuando se envía una guía de remisión y el documento se recibe en Gosocket correctamente. | |
| PE010 | N/A | Comprobante de pago supera (XX días) el plazo permitido para enviar por Resumen Diario | Cuando se envía un comprobante de pago de forma asíncrona, y la fecha de emisión supera el plazo permitido para enviar por medio del resumen diario. | Verifique la fecha y modifiquela 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. |
| PE002108 | N/A | Documento supera el límite de 15 días calendario para su emisión. Documento no sera enviado a la Entidad Tributaria. | Cuando se envía el documento con una fecha de emisión superior o inferior a 15 días calendario, el documento no se envía al OSE o Entidad Tributaria porque será rechazado por el error en la fecha. | Verifique la fecha y modifiquela 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. |
| XXXX representa el código de error de SUNAT | N/A | Descripción propia de los códigos de error de SUNAT. | Cuando el documento es emitido directo a SUNAT, se obtiene el código y mensaje de error, tal cual lo regresa SUNAT. Ejemplo: ```json "Code": "2800", "Description": "Excepción | Código: 2800 |
| XXXX representa el código de error del OSE | N/A | Descripción propia de los códigos de error del OSE | Cuando el documento es emitido con un OSE como validador, se obtiene el código y mensaje de error, tal cual lo regresa el OSE. Ejemplo: ```json "Code": "2329", "Description": "Excepción | Código: 2329 |
| 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: Procesado Correctamente ¿Cómo replicarlo? Rta/. Emitiendo un documento que se procese correctamente
{
"Success": true,
"GlobalDocumentId": "eb838eb3-c275-2ad9-549f-15f150a6ffb6",
"CountryDocumentId": "45ed9f4b-5394-404b-a67b-1751ac3e067e",
"OtherData": {
"Country": "pe",
"AuthorityTimeStamp": "16/07/2025 13:57:33",
"BarCodeText": "20556695548|01|FADR|41|18.00|118.00|2025-07-16|6|10460002571|fs4kjaC8SSf3QmMejRGfXreIArs=|",
"OseIdentifier": "digiflow"
},
"Messages": [],
"ResponseValue": "PD94bWwgdmVyc2lvbj...jYXRpb25SZXNwb25zZT4=",
"Code": "0",
"Description": "La factura numero 20556695548-01-FADR-41, ha sido aceptada",
"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: 3299e81d-447b-41e8-99fd-5aad5ee82986 Fecha: 2025-07-16"
],
"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.ParserPE_UBL_21(XmlDocument xmlDocument) in D:\a\1\s\L3 Application\Gosocket.Document.ApplicationServices\ParserServices.cs:line 3732\r\n at Gosocket.Document.ApplicationServices.ParserServices.ParserPE(XmlDocument xmlDocument) in D:\a\1\s\L3 Application\Gosocket.Document.ApplicationServices\ParserServices.cs:line 3282\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 44\r\n at Gosocket.Document.ApplicationServices.CountryServices.PeruApplicationServices.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\PeruApplicationServices.cs:line 217"
],
"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: 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": "aaf678b3862cc0da8d85ee4ffb841c55d9f596e009d984f1355c1775cf737906",
"OtherData": {
"Country": "pe",
"AuthorityTimeStamp": "16/07/2025 15:54:44"
},
"Messages": [
"ApiUser no Autorizado para emisor [20551348041] en sbx"
],
"ResponseValue": null,
"Code": "401",
"Description": "Esta enviando con el ApiUser da038113-a90a-4313-9c2c-91c06b612649 el cual no esta autorizado para su empresa (20551348041) en pe.",
"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": "pe",
"AuthorityTimeStamp": "16/07/2025 16:11:44"
},
"Messages": [],
"ResponseValue": null,
"Code": "G001",
"Description": "El documento no puede ser procesado debido a que tiene una fecha futura 20-09-2027",
"ErrorException": null
}Code: G002 Description: ERROR Number < 1 carácter ¿Cómo replicarlo? Rta/. Enviar sin correlativo el documento.
{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": null,
"Messages": [
"El documento informado no cuenta con el mínimo de 1 dígito en su correlativo"
],
"ResponseValue": null,
"Code": "G002",
"Description": "ERROR Number < 1 caracter",
"ErrorException": null
}Code: G002 Description: ERROR Number > 8 caracteres ¿Cómo replicarlo? Rta/. Enviar un correlativo superior a 8 caracteres de longitud.
{
"Success": false,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": null,
"Messages": [
"El documento informado 000000045 excede el máximo 8 de dígitos en su correlativo"
],
"ResponseValue": null,
"Code": "G002",
"Description": "ERROR Number > 8 caracteres",
"ErrorException": null
}Code: 1033 Description: El comprobante fue registrado previamente/El comprobante fue registrado previamente con otros datos. ¿Cómo replicarlo? Rta/. Enviar el mismo documento (serie-correlativo) ya aprobado de nuevo sin cambiar nada o cambiando algun dato como por ejemplo la fecha.
{
"Success": false,
"GlobalDocumentId": "18564bff-9a31-e230-ad83-010634f6aaab",
"CountryDocumentId": "b11e1f2ab621ba4088a53cd8b3a79c501f2b8cf29436b475eb081658f3da4b19",
"OtherData": {
"Country": "pe",
"AuthorityTimeStamp": "16/07/2025 16:25:12"
},
"Messages": [
"Regla: 1033, Error: El comprobante fue registrado previamente."
],
"ResponseValue": "PD94bWwgdmVy...saXphZG9zPjwvSW52b2ljZT4K",
"Code": "1033",
"Description": "El comprobante fue registrado previamente",
"ErrorException": null
}
///////////
{}
"Success": false,
"GlobalDocumentId": "a4aef3aa-72d9-615f-c45e-9c1725ee99bd",
"CountryDocumentId": "3f8f1a2ecfe9d3b3b4fc756584b8ee93a213418c5574562c64e89e190460a68e",
"OtherData": {
"Country": "pe",
"AuthorityTimeStamp": "16/07/2025 16:27:07"
},
"Messages": [
"Regla: 1033, Error: El comprobante fue registrado previamente con otros datos.."
],
"ResponseValue": "PD94bWwgdmVyc2lvb...zb25hbGl6YWRvcz48L0ludm9pY2U+Cg==",
"Code": "1033",
"Description": "El comprobante fue registrado previamente con otros datos.",
"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 en empresa sin certificado o con un certificado vencido.
{
"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: a5366500-a8f4-4b16-8253-93fae085fd25 Fecha: 2025-07-16. Mensaje de error: MSSign.10000 - El certificado no existe.",
"ErrorException": null
}Code: P004 Description: Documento de anulación enviado a procesar de manera asíncrona ¿Cómo replicarlo? Rta/. Enviar documento de anulación de forma asíncrona.
{
"Success": true,
"GlobalDocumentId": "00000000-0000-0000-0000-000000000000",
"CountryDocumentId": null,
"OtherData": {
"Country": "pe",
"VoidDocument1": "27f3a4af-c32a-c6af-04ed-0bfbf8a4cf42"
},
"Messages": [],
"ResponseValue": null,
"Code": "PE004",
"Description": null,
"ErrorException": null
}Code: P006 Description: Proceso Asíncrono - El documento será enviado asyncronamente ¿Cómo replicarlo? Rta/. Enviar documento de forma asíncrona.
{
"Success": true,
"GlobalDocumentId": "521c8f36-52e6-aaf4-6bc3-4e6eecf9d14b",
"CountryDocumentId": "841c57234756c3cf6f123d85f96310e28f53b8663c00612acd19660a47611c50",
"OtherData": {
"Country": "pe",
"AuthorityTimeStamp": "11/07/2025 12:15:52",
"BarCodeText": "20556695548|09|TKER|107|0||2025-07-11|6|10482963493|psbVMEoBI1Dz0bKcSpmXUtmYZv8=|",
"OseIdentifier": "SUNAT"
},
"Messages": [],
"ResponseValue": null,
"Code": "PE006",
"Description": "Proceso Asíncrono - El documento será enviado asyncronamente",
"ErrorException": null
}Code: PE002108 Description: Documento supera el límite de 15 días calendario para su emisión. Documento no sera enviado a la Entidad Tributaria. ¿Cómo replicarlo? Rta/. Enviar un documento con fecha superior o inferior a 15 días calendario de la fecha actual.
{
"Success": false,
"GlobalDocumentId": "e3eba371-0a67-35f3-c70e-ca9678cc1cc4",
"CountryDocumentId": "affea5768adca7a8c38f2de8402d6ce7b723d40baf2f991ada56e626267c7656",
"OtherData": {
"Country": "pe",
"AuthorityTimeStamp": "16/07/2025 16:33:26",
"BarCodeText": "20556695548|01|FADR|46|18.00|118.00|2025-06-01|6|10460002571|p5kWzVVDKqE+s1b4DEDZfnmVplY=|",
"OseIdentifier": "digiflow"
},
"Messages": [
"PE002108,Documento supera el límite de 15 días calendario para su emisión. Documento no sera enviado a la Entidad Tributaria."
],
"ResponseValue": null,
"Code": "PE002108",
"Description": "Documento supera el límite de 15 días calendario para su emisión. Documento no sera enviado a la Entidad Tributaria.",
"ErrorException": null
}Code: XXXX Description: Descripción propia de los códigos de error del OSE o de SUNAT. ¿Cómo replicarlo? Rta/. Enviar un documento que sea rechazado por el OSE/SUNAT, o que genere un error en la validación del OSE/SUNAT.
{
"Success": false,
"GlobalDocumentId": "e3eba371-0a67-35f3-c70e-ca9678cc1cc4",
"CountryDocumentId": "affea5768adca7a8c38f2de8402d6ce7b723d40baf2f991ada56e626267c7656",
"OtherData": {
"Country": "pe",
"AuthorityTimeStamp": "16/07/2025 16:47:32",
"BarCodeText": "20556695548|01|FADR|46|18.00|118.00|2025-07-31|6|10460002571|96368FOH5oSOvyW4E45+1S3fudo=|",
"OseIdentifier": "digiflow"
},
"Messages": [
"2329,Excepción | Código: 2329 | Descripción: La fecha de emision se encuentra fuera del limite permitido\r\nDetalle: \r\n' ticket: 20250000000000217185665 error: Documento fuera de fecha Posterior [2025-07-31] '"
],
"ResponseValue": "",
"Code": "2329",
"Description": "Excepción | Código: 2329 | Descripción: La fecha de emision se encuentra fuera del limite permitido\r\nDetalle: \r\n' ticket: 20250000000000217185665 error: Documento fuera de fecha Posterior [2025-07-31] '",
"ErrorException": null
}Code: DNT Description: Documento no tributario. ¿Cómo replicarlo? Rta/. Enviar un documento no tributario, por ejemplo una orden de compra.
{
"Success": true,
"GlobalDocumentId": "10c088c0-11c6-ba2b-6764-216840b01a30",
"CountryDocumentId": null,
"OtherData": {
"Country": "pe",
"AuthorityTimeStamp": "16/07/2025 17:31:57",
"BarCodeText": "",
"OseIdentifier": "digiflow"
},
"Messages": [],
"ResponseValue": "PD94bWwgdmVyc2lv...G9zPgo8L0RURT4=",
"Code": "DNT",
"Description": "Documento no tributario",
"ErrorException": null
}