Ver traslado
GET /api/inventory/transfers/{transfer_id}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Devuelve un traslado con sus series o lotes y los movimientos de kardex que generó.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor). Un vendedor solo ve los traslados que salen de o llegan a su almacén (403 si no).
Formato de respuesta: estándar {success, data, message?} (registro único).
Parámetros de la ruta:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
transfer_id |
integer | Sí | Id del traslado. |
Campos de cada traslado:
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Id del traslado (un producto movido de un almacén a otro). |
date / date_of_issue |
string | Fecha y hora de registro / fecha del traslado. |
description / observation |
string | Descripción y texto libre ingresado al trasladar. |
state |
string | active vigente, reversed revertido (eliminado) o reversal (es la reversión de otro traslado; reversal_of indica cuál). |
item, quantity |
object, number | Producto y cantidad. |
warehouse / warehouse_destination |
object | Almacén de origen y de destino. |
document |
object o null | Nota de traslado que agrupa varios productos {id, number, description, dispatch_id}; dispatch_id indica que la generó una guía de remisión. |
El detalle agrega reversed_by (id de la reversión), series y lots (series y lotes trasladados de ese producto) y kardex (los dos movimientos: salida del origen y entrada al destino).
Errores:
403si el traslado no toca el almacén del vendedor.404si el registro no existe.401sin token o con un token inválido.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
transfer_id |
ruta | sí | 1 |
Respuestas
200 — Traslado
{
"success": true,
"data": {
"id": 1207,
"date": "2026-11-06 11:20:05",
"date_of_issue": "2026-11-06",
"description": "Traslado",
"observation": "Reposición sucursal norte",
"state": "active",
"reversal_of": null,
"item": {
"id": 15,
"internal_id": "P0015",
"description": "GASEOSA 500 ML",
"unit_type_id": "NIU"
},
"quantity": 5.0,
"warehouse": {
"id": 3,
"description": "Almacén - Tienda Centro"
},
"warehouse_destination": {
"id": 5,
"description": "Almacén - Sucursal Norte"
},
"document": null,
"reversed_by": null,
"series": [],
"lots": [],
"kardex": [
{
"id": 9130,
"warehouse_id": 3,
"quantity": -5.0,
"date_of_issue": "2026-11-06"
},
{
"id": 9131,
"warehouse_id": 5,
"quantity": 5.0,
"date_of_issue": "2026-11-06"
}
]
}
}
403 — Registro de otro almacén
{
"success": false,
"message": "No tienes permiso para acceder a este registro."
}
404 — No existe
{
"success": false,
"message": "Registro no encontrado."
}
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.