Cuentas por cobrar

Cuando ocurre un error o una excepción en una solicitud a la API de Cuentas por Cobrar, Duemint retorna una respuesta estructurada que permite identificar la causa del problema y actuar en consecuencia.

Estos errores ayudan a los equipos técnicos a validar parámetros, autenticaciones y métodos utilizados en las integraciones.

Tipos de errores — Cuentas por Cobrar (CxC)

HTTP Status Code	HTTP Status Name	Descripción
400	Bad Request	Existe algún error en los parámetros enviados en la solicitud.
403	Forbidden	Existe un error asociado al token enviado en la cabecera de la solicitud.
404	Not Found	La URL solicitada no existe.
405	Method Not Allowed	El método HTTP utilizado (GET/POST, etc.) no es válido para este endpoint.
500	Internal Server Error	Error interno del servidor.

💡 Estos códigos se devuelven junto a un mensaje detallado en formato JSON que describe el motivo del error.

Ejemplo de respuesta

A continuación se muestra un ejemplo utilizando el método getDocument de la API de Duemint.
En este caso, se ha omitido deliberadamente el parámetro :id, que es obligatorio para la solicitud.

METHOD GET
curl "https://api.duemint.com/v1/getDocument?expandClient=1" \
 -H 'Authorization: Bearer <token>' -H 'Accept: application/json'

La respuesta a esta solicitud sería un Http status code 400 (Bad Request) con el siguiente contenido, en donde el valor error corresponde a un código de uso interno, y el valor message corresponde a una descripción detallada del error.

{"error":"010","message":"Param :id es requerido."}