Motivos de ajuste de inventario
GET /api/catalogs/inventory-transactions
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Motivos que se pueden elegir al registrar un ingreso o salida manual de inventario (inventory_transaction_id). No incluye los movimientos automáticos del sistema (venta, compra, inventario inicial, traslado entre almacenes...).
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).
Parámetros de la URL (query):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
type |
string | No | input o output: solo los motivos de ese tipo. |
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. |
type |
string | Sí | input (ingreso) u output (salida). |
Errores:
401sin token o con un token inválido.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
type |
query | no | output |
input o output. Opcional. |
Respuestas
200 — Catálogo
{
"success": true,
"data": [
{
"id": "19",
"description": "Ingreso de producción",
"type": "input"
},
{
"id": "05",
"description": "Devolución recibida",
"type": "input"
},
{
"id": "13",
"description": "Mermas",
"type": "output"
},
{
"id": "28",
"description": "Ajuste por diferencia de inventario",
"type": "output"
}
]
}
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.