Saltar al contenido
Facturador

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.