Saltar al contenido
Facturador

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:

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

Respuestas

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