Consultar CDR de un comprobante en SUNAT
POST /api/services/consult_cdr_status
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Consulta en SUNAT/OSE el CDR de un comprobante emitido en producción y actualiza su estado en la plataforma (útil cuando el envío no devolvió respuesta).
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success. Respuesta {success, message} con la descripción del CDR.
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
codigo_tipo_documento |
string | Sí | 01, 03, 07 u 08. |
serie_documento |
string | Sí | Serie. |
numero_documento |
integer | Sí | Número. |
Errores: 422 {success: false, message: {campo: [...]}} si falta un campo; HTTP 200 con success: false: Documento no encontrado o Code: <código>; Description: <mensaje SUNAT>.
Cuerpo
Content-Type: application/json
{
"codigo_tipo_documento": "01",
"serie_documento": "F001",
"numero_documento": 1520
}
Respuestas
200 — Aceptado
{
"success": true,
"message": "La Factura numero F001-1520, ha sido aceptada"
}
200 — No encontrado
{
"success": false,
"message": "Documento no encontrado"
}
422 — Validación
{
"success": false,
"message": {
"serie_documento": [
"El campo serie documento es obligatorio."
]
}
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.