Transferir entre almacenes

Mueve stock de un almacén a otro: salida `11` en el origen y entrada `21` en el destino, al costo promedio del origen.

POSThttps://api.facturalo.pe/api/v3/inventario/transferencias

Parámetros del body

Campo

Descripción

origenId

string | nullopcional

UUID del almacén de origen. Default: principal.

destinoId

stringrequerido

UUID del almacén de destino (distinto al origen).

fecha

stringrequerido

YYYY-MM-DD.

documento

object | nullopcional

Opcional, por ejemplo la guía de remisión (09).

nota

string | nullopcional

Texto libre.

items

arrayrequerido

Productos a transferir.

varianteId

stringrequerido

UUID, SKU o código de barras.

cantidad

numberopcional

Mayor que 0.

series

string[] | nullopcional

Con controlaSeries: series en stock en el origen.

Language

Credentials

Header

Authorization

Token de la empresa · HTTP directo

Fetch Request

$ # Node 18+ fetch

const response = await fetch("https://api.facturalo.pe/api/v3/inventario/transferencias", {
  method: "POST",
  headers: {
    "Authorization": "sk_test_…",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "origenId": "11111111-2222-3333-4444-555555555555",
    "destinoId": "22222222-2222-3333-4444-555555555555",
    "fecha": "2026-11-05",
    "items": [
      {
        "varianteId": "POLO-S-AZ",
        "cantidad": 5
      },
      {
        "varianteId": "LAPT-HP-INT-I20",
        "series": [
          "5CD1234ABC"
        ]
      }
    ]
  })
});

const data = await response.json();
console.log(data);

HTTP directo · funciona con cualquier cliente HTTP

Response

Elige un ejemplo de respuesta:

application/json

201Created

{
  "success": true,
  "message": "Movimiento registrado.",
  "data": [
    {
      "id": "a3301a1c-6b0e-4f7e-8a51-2f1d7c9b0e11",
      "fecha": "2026-11-03",
      "documento": null,
      "tipoOperacion": "11",
      "operacion": "Salida por transferencia entre almacenes",
      "origen": "transferencia",
      "entrada": null,
      "salida": {
        "cantidad": 5,
        "costoUnitario": 12,
        "total": 60
      },
      "saldo": {
        "cantidad": 15,
        "costoUnitario": 12,
        "total": 180
      },
      "nota": null,
      "varianteId": "a32f4541-75eb-4b59-ad28-3c571652fe39",
      "descripcion": "LAPTOP HP INTEL I20",
      "sku": "LAPT-HP-INT-I20",
      "direccion": "salida",
      "grupo": "a3301a1c-0000-4f7e-8a51-2f1d7c9b0e11",
      "establecimiento": {
        "id": "11111111-2222-3333-4444-555555555555",
        "nombre": "Principal"
      },
      "comprobanteId": null,
      "series": [],
      "creado": "2026-11-09T10:20:00-05:00"
    },
    {
      "id": "a3301a1c-6b0e-4f7e-8a51-2f1d7c9b0e11",
      "fecha": "2026-11-03",
      "documento": null,
      "tipoOperacion": "21",
      "operacion": "Entrada por transferencia entre almacenes",
      "origen": "transferencia",
      "entrada": {
        "cantidad": 5,
        "costoUnitario": 12,
        "total": 60
      },
      "salida": null,
      "saldo": {
        "cantidad": 5,
        "costoUnitario": 12,
        "total": 60
      },
      "nota": null,
      "varianteId": "a32f4541-75eb-4b59-ad28-3c571652fe39",
      "descripcion": "LAPTOP HP INTEL I20",
      "sku": "LAPT-HP-INT-I20",
      "direccion": "entrada",
      "grupo": "a3301a1c-0000-4f7e-8a51-2f1d7c9b0e11",
      "establecimiento": {
        "id": "22222222-2222-3333-4444-555555555555",
        "nombre": "Almacén Norte"
      },
      "comprobanteId": null,
      "series": [],
      "creado": "2026-11-09T10:20:00-05:00"
    }
  ]
}