Tipos de cliente
GET /api/catalogs/person-types
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Tipos de cliente de la empresa (p. ej. mayorista, minorista). Un tipo puede tener una lista de precios asociada (price_label_id).
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 |
|---|---|---|---|
description |
string | Sí | Descripción para mostrar al usuario. |
id |
integer | Sí | Id para person_type_id del cliente. |
price_label_id |
integer/null | Sí | Etiqueta de precio que se aplica a este tipo de cliente (ver Etiquetas de precio). |
Errores:
401sin token o con un token inválido.
Respuestas
200 — Catálogo
{
"success": true,
"data": [
{
"id": 1,
"description": "MAYORISTA",
"price_label_id": 2
},
{
"id": 2,
"description": "MINORISTA",
"price_label_id": null
}
]
}
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.