Eliminar (revertir) traslado
DELETE /api/inventory/transfers/{transfer_id}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Revierte un traslado: registra un traslado inverso (del destino al origen) por la misma cantidad, con su propio kardex, y el original queda en estado reversed. El stock vuelve a quedar como antes en ambos almacenes y el historial se conserva.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor). Un vendedor solo puede revertir traslados que salen de o llegan a su almacén.
Formato de respuesta: estándar {success, data, message?} (registro único). data = {transfer, reversal}: el traslado original (ya reversed, con reversed_by) y la reversión creada.
Parámetros de la ruta:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
transfer_id |
integer | Sí | Id del traslado. |
Reglas:
- Un traslado se revierte una sola vez; la reversión misma no se puede revertir.
- No se revierten por la API los traslados de productos con lotes o series, ni los generados por una guía de remisión (se anula la guía).
- Si la empresa controla stock, el almacén de destino debe tener stock suficiente para devolver la cantidad.
Errores:
403si el traslado no toca el almacén del vendedor.404si el registro no existe.409si ya fue revertido, es una reversión, tiene lotes/series, viene de una guía o no hay stock en el destino (elmessagelo explica).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 — Revertido
{
"success": true,
"data": {
"transfer": {
"id": 1207,
"date": "2026-11-06 11:20:05",
"date_of_issue": "2026-11-06",
"description": "Traslado",
"observation": null,
"state": "reversed",
"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": 1215,
"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"
}
]
},
"reversal": {
"id": 1215,
"date": "2026-11-07 09:01:44",
"date_of_issue": "2026-11-07",
"description": "Reversión de traslado #1207",
"observation": null,
"state": "reversal",
"reversal_of": 1207,
"item": {
"id": 15,
"internal_id": "P0015",
"description": "GASEOSA 500 ML",
"unit_type_id": "NIU"
},
"quantity": 5.0,
"warehouse": {
"id": 5,
"description": "Almacén - Sucursal Norte"
},
"warehouse_destination": {
"id": 3,
"description": "Almacén - Tienda Centro"
},
"document": null
}
},
"message": "Traslado revertido con éxito"
}
409 — Ya revertido
{
"success": false,
"message": "El traslado ya fue revertido."
}
409 — Con series
{
"success": false,
"message": "El producto maneja lotes o series: el traslado no se puede revertir desde la API."
}
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.