Tipos de percepción
GET /api/catalogs/perception-types
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Catálogo SUNAT 22: régimen de percepción del IGV, con su tasa.
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. |
percentage |
number | Sí | Tasa de percepción. |
active |
boolean | Sí | true si la empresa lo tiene activo. |
Errores:
401sin token o con un token inválido.
Respuestas
200 — Catálogo
{
"success": true,
"data": [
{
"id": "01",
"description": "Percepción Venta Interna",
"percentage": 2.0,
"active": true
},
{
"id": "02",
"description": "Percepción a la adquisición de combustible",
"percentage": 1.0,
"active": true
},
{
"id": "03",
"description": "Percepción realizada al agente de percepción con tasa especial",
"percentage": 0.5,
"active": true
}
]
}
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.