Tipos de retención
GET /api/catalogs/retention-types
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Catálogo SUNAT 23: régimen de retenció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 retenció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": "Tasa 3%",
"percentage": 3.0,
"active": true
},
{
"id": "02",
"description": "Tasa 6%",
"percentage": 6.0,
"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.