Agendar demo
Unidades
Catálogo API v1

Unidades

Unidades de medida que se asignan a productos (base_unit_id, purchase_unit_id). También puedes registrar factores de conversión entre unidades de la misma dimensión.

Campos

CampoTipoNotas
codestringreqÚnico por tenant — kg, L, und…
namestringreq
dimensionenumreqmass · volume · count · length · time · custom
is_activebooleanDefault true

Endpoints — Unidades

GET /catalog/units

Lista de unidades. Filtros: dimension, is_active.

GET /catalog/units/{id}
POST /catalog/units

Request

{
  "code": "L",
  "name": "Litro",
  "dimension": "volume"
}

Response 201

{
  "id": 4,
  "code": "L",
  "name": "Litro",
  "dimension": "volume",
  "is_active": true
}
PATCH /catalog/units/{id}

Edita name, is_active. El code y la dimension son inmutables.

DELETE /catalog/units/{id}

409 si hay productos activos asignados a la unidad.

Conversiones entre unidades

Registra el factor de conversión entre dos unidades del mismo tenant. Permite que el sistema calcule automáticamente cantidades al recibir compras en una unidad diferente a la unidad de stock.

POST /catalog/unit-conversions

Request

{
  "from_unit_id": 4,
  "to_unit_id": 3,
  "factor": 0.001
}

Response 201

{
  "from_unit_id": 4,
  "to_unit_id": 3,
  "factor": 0.001
}

El inverso (to → from) se registra automáticamente. 409 si la conversión ya existe.