Estados de comprobante
GET /api/catalogs/state-types
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Estados de un comprobante frente a SUNAT. Útil para filtrar listados y para interpretar state_type_id en las respuestas.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: estándar {success, data, message?} (registro único). Aquí data es la lista completa (sin paginación ni pagination): son catálogos cortos.
Activos: este catálogo no se activa ni desactiva por empresa: siempre devuelve todos los registros (all no tiene efecto).
Campos de cada fila de data:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
id |
string | Sí | Código a enviar en el campo correspondiente del comprobante / registro. |
description |
string | Sí | Descripción para mostrar al usuario. |
05 (aceptado) y 07 (observado) son comprobantes válidos; 09 y 11 ya no tienen efecto tributario.
Errores:
401sin token o con un token inválido.
Respuestas
200 — Catálogo
{
"success": true,
"data": [
{
"id": "01",
"description": "Registrado"
},
{
"id": "03",
"description": "Enviado"
},
{
"id": "05",
"description": "Aceptado"
},
{
"id": "07",
"description": "Observado"
},
{
"id": "09",
"description": "Rechazado"
},
{
"id": "11",
"description": "Anulado"
},
{
"id": "13",
"description": "Por anular"
}
]
}
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.