Saltar al contenido
Facturador

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:

  • 401 sin token o con un token inválido.

Respuestas

{
  "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.