Saltar al contenido
Facturador

Listar traslados

GET /api/inventory/transfers

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Lista los traslados entre almacenes, del más reciente al más antiguo. Incluye los registrados con Trasladar productos entre almacenes y los de las notas de traslado y guías del sistema.

Quién puede usarlo: cualquier usuario autenticado. Un administrador ve todos los traslados (o el que indique en warehouse_id); un vendedor solo los que salen de o llegan al almacén de su establecimiento: si pide otro almacén responde 403.

Formato de respuesta: listado con paginación por cursor {success, data[], pagination: {next_cursor, has_more}}.

Parámetros de la URL (query):

Campo Tipo Obligatorio Descripción / valores permitidos
warehouse_id integer No Traslados que salen de o llegan a ese almacén.
warehouse_destination_id integer No Solo los que llegan a ese almacén.
item_id integer No Producto.
document_id integer No Los productos de una nota de traslado (document.id).
state string No active, reversed o reversal.
date_start / date_end YYYY-MM-DD No Rango por fecha de registro.
search string No Descripción o código interno del producto.
limit / cursor integer / string No Paginación por cursor (limit de 1 a 100, por defecto 15).

Paginación por cursor: envía limit (1 a 100, por defecto 15). La respuesta trae pagination.next_cursor; para la página siguiente repite la misma consulta agregando cursor=<next_cursor>. Cuando pagination.has_more es false no hay más páginas.

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 un vendedor pide un almacén que no es el de su establecimiento.
  • 422 si state o las fechas no son válidos.
  • 401 sin token o con un token inválido.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
warehouse_id query no 1 Almacén de origen o destino.
item_id query no 1 Producto.
state query sí active active, reversed o reversal.
limit query no 15 Registros por página, de 1 a 100. Por defecto 15.
cursor query no Valor de pagination.next_cursor de la respuesta anterior para obtener la página siguiente.

Respuestas

200 — Traslados

{
  "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
    },
    {
      "id": 1188,
      "date": "2026-11-06 11:20:05",
      "date_of_issue": "2026-11-06",
      "description": "Traslado",
      "observation": null,
      "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": {
        "id": 54,
        "number": "NT01-12",
        "description": "Envío semanal",
        "dispatch_id": null
      }
    }
  ],
  "pagination": {
    "next_cursor": "eyJpZCI6MTUsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0",
    "has_more": true
  }
}

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.