Saltar al contenido
Facturador

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:

  • 403 si el traslado no toca el almacén del vendedor.
  • 404 si el registro no existe.
  • 409 si ya fue revertido, es una reversión, tiene lotes/series, viene de una guía o no hay stock en el destino (el message lo explica).
  • 401 sin 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.