Saltar al contenido
Facturador

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:

  • 403 si el traslado no toca el almacén del vendedor.
  • 404 si el registro no existe.
  • 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 — 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.