Saltar al contenido
Facturador

Validar comprobante con la API de SUNAT

POST /api/documents/validate-document

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Consulta el estado de un comprobante emitido por la empresa en la API de validación de SUNAT (requiere que la empresa tenga configuradas sus credenciales de API SUNAT) y lo traduce al estado de la plataforma.

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.

Campo Tipo Obligatorio Descripción / valores permitidos
document_type_id string Sí 01, 03, 07, 08.
series string Sí Serie.
number numeric Sí Número.
date_of_issue date Sí YYYY-MM-DD.
total numeric Sí Importe total.

Respuesta: data.state_type_id (05 aceptado, 11 anulado, -1 no existe en SUNAT), state_type_description, code_sunat (código de SUNAT), message_sunat, state_ruc y condition_ruc del emisor.

Errores: 422 {success: false, message: {campo: [...]}}; HTTP 200 con success: false si SUNAT rechaza la consulta; 500 si la empresa no configuró sus credenciales de API SUNAT.

Cuerpo

Content-Type: application/json

{
  "document_type_id": "01",
  "series": "F001",
  "number": 1520,
  "date_of_issue": "2026-11-07",
  "total": 118.0
}

Respuestas

200 — Consultado

{
  "success": true,
  "message": "Consulta realizada correctamente.",
  "data": {
    "state_type_id": "05",
    "state_type_description": "Aceptado",
    "code_sunat": "1",
    "message_sunat": "Operation Success! ",
    "state_ruc": "ACTIVO",
    "condition_ruc": "HABIDO"
  }
}

422 — Validación

{
  "success": false,
  "message": {
    "total": [
      "El campo total 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.