Respuestas HTTP
FacturaLlama utiliza códigos de respuesta HTTP convencionales para comunicar el estado de las solicitudes a la API. Es esencial comprender estos códigos para interpretar correctamente las respuestas y actuar en consecuencia.
Creación y Consulta de DTEs
| Código HTTP | Descripción | Respuesta |
|---|---|---|
| 200 Ok | El DTE fue recibido por el Ministerio de Hacienda y ha sido aprobado. | DTE |
| 201 Created | FacturaLlama recibio tus datos, creo el DTE y esta intentando enviarlo al Ministerio de Hacienda. | DTE |
| 202 Accepted | El DTE se encuentra anulado. | DTE |
| 422 Unprocessable Entity | El DTE fue recibido por el Ministerio de Hacienda y ha sido rechazado. | DTE |
| 400 Bad Request | FacturaLlama no ha creado el DTE, los datos recibidos tienen errores. | Error |
| 401 Unauthorized | El API Key no es valida. | Error |
| 403 Forbidden | El API Key no tiene los permisos suficientes para ejecutar la solicitud. | Error |
| 404 Not Found | El DTE no existe. | Error |
| 429 Too Many Requests | Has realizado mas solicitudes de las permitidas por minuto. | Error |
| 500 Server Errors | FacturaLlama tiene un problema grave. | Error |
DTE
| Propiedad | Tipo | Descripción |
|---|---|---|
id | UUID | Identificador único del DTE en la plataforma de FacturaLlama. |
companyId | UUID | Identificador único de la empresa. |
environment | Enum | Ambiente. Valores: TEST, LIVE. |
generationCode | UUID | Código de generación con el cual se identifica de forma única el DTE con el Ministerio de Hacienda. |
controlNumber | String | Opcional. Este número es utilizado para identificar el DTE ante el Ministerio de Hacienda (MH). |
type | Enum | Tipo de documento fiscal. FC,CCF,NC,ND,NR,CR,FEX,FSE. |
version | Integer | Versión del DTE. |
status | Enum | Estado del DTE. Valores: CREATED, PROCESSING, CONTINGENCY, APPROVED, REJECTED, INVALIDATED. |
mhResponse | Object | Opcional. Respuesta del API del Ministerio de Hacienda. |
stampReceived | String | Opcional. Sello recibido del Ministerio de Hacienda. |
processAt | Timestamp | Opcional. Fecha y hora de procesamiento del DTE por el Ministerio de Hacienda. |
dte | Object | DTE enviado en formato JSON. |
mhDteUrl | String | Opcional. Url para consultar el estado del DTE en el portal del Ministerio de Hacienda. |
generatedAt | Timestamp | Fecha y hora de creación del DTE (asignado manualmente). |
createdAt | Timestamp | Fecha y hora de creación del DTE. |
updatedAt | Timestamp | Fecha y hora de la última actualización del del DTE. |
Error
| Propiedad | Tipo | Descripción |
|---|---|---|
statusCode | Integer | Codigo Http de la respuesta. |
message | String[] | Mensajes de error. |
error | String | Causa principal del error. |
Notas Importantes
🟢 Códigos 2xx: Todo en orden
Cuando ves códigos en este rango, ¡es una buena noticia!
Los códigos en el rango 2xx indican que la solicitud fue exitosa y se procesó adecuadamente.
200 OK
Quiere decir que tu DTE fue recibido por FacturaLlama, enviado el Ministerio de Hacienda y este lo aprobo. Tu DTE ha sido enviado y aprobado exitosamente.
El status del DTE sera: APPROVED.
201 Created
Quiere decir que tu DTE fue recibido por FacturaLlama pero, que aun no se ha enviado al Ministerio de Hacienda para ser procesado. Esto puede deberse a que en ese momento los servicios del Ministerio de Hacienda no estaban disponibles. Pero, no te preocupes FacturaLlama se encargara de realizar los intentos necesarios para enviar tu DTE y/o activar las estrategias de contingencia si son necesarias. Puedes esperar unos minutos y consultar el estado de tu DTE mas tarde.
Tu DTE puede tener como status alguno de los siguientes valores: CREATED (FacturaLlama recibio tus datos pero, aun no se envian al Ministerio de Hacienda), PROCESSING (FacturaLlama envio el DTE al Ministerio de Hacienda y esta esperando respuesta), CONTINGENCY (FacturaLlama no logro establecer comunicación con los servicios del Ministerio de Hacienda asi que activo la modalidad de contingencia).
202 Accepted
El DTE se encuentra anulado. El status del DTE sera: INVALIDATED.
⚠️ Códigos 4xx: ¡Atención!
Estos códigos implican que algo no está bien con la solicitud enviada. Revisa los datos proporcionados o la estructura de la solicitud.
Los códigos en el rango 4xx señalan un error causado por la información proporcionada. Esto puede ser debido a la omisión de un parámetro requerido, una operación que no pudo completarse, entre otros.
400 Bad Request
Este código quiere decir que FacturaLlama no puede procesar tu información porque no estas enviando los datos completos o en los formatos correctos. En estos casos no se envia nada al Ministerio de Hacienda hasta que resuelvas los problemas.
401,403 Unauthorized, Forbidden
Revisa tu API Key seguramente ha sido deshabilitada o eliminada.
404 Not Found
El DTE que intentas consultar no existe.
422 Unprocessable Entity
Si recibes este código significa que FacturaLlama recibio tu información, envio el DTE al Ministerio de Hacienda pero este fue rechazado.
429 Too Many Requests
Por alguna razón estas enviando mas peticiones de las permitidas.
🔴 Códigos 5xx: Problemas de Servidor
Si te encuentras con códigos en este rango, hay algo que no está funcionando en nuestro lado.
Los códigos en el rango 5xx indican errores con los servidores de FacturaLlama. No te preocupes, estos errores son raros, pero si persisten, por favor contacta al soporte.