Warehouses

Stock Transfers

Moving goods from one location to another without changing how much you own in total.

Last updated 2026-10-13

DigitalKey ERP — Docs · digital-key.co/docs/warehouses/stock-transfer

Requires subscriptionwarehouse.transfer3,000 IQD / month

Overview

A transfer takes quantity out of one warehouse and puts it into another. Your total stock is unchanged — only its distribution moves. This is a stock document, not a financial one: nothing about cost, revenue or balances changes.

Warehouses — Stock transfer form
Stock transfer form
Stock transfer form — Source and destination warehouses with the items and quantities being moved.
  1. 1

    Start a transfer

    Go to Warehouses and create a new transfer.

  2. 2

    Choose source and destination

    Pick where the stock is leaving from and where it is going. They must be different locations.

  3. 3

    Add the items

    Add each product and the quantity to move. The quantity available at the source is shown so you can see what can actually be sent.

    Warehouses — Transfer lines
    Transfer lines
    Transfer lines — Products with the quantity to move and the quantity available at source.
  4. 4

    Add a note (optional)

    Worth recording who is carrying it or which vehicle it went on.

  5. 5

    Save

    Stock leaves the source and arrives at the destination, and a movement is written at both ends.

Fields

POST /api/v1/warehouses/transfers
ParameterTypeRequiredDescription
from_warehouse_idintegerRequiredWhere the stock is leaving from.
to_warehouse_idintegerRequiredWhere it is going. Must differ from the source.
notesstringOptionalFree text about the transfer.
itemsarrayRequiredWhat is being moved.
items[].product_idintegerRequiredProduct to move.
items[].qtydecimalRequiredQuantity to move.

The transfer record

ParameterTypeRequiredDescription
transfer_idintegerOptionalInternal identifier.
transfer_nostringOptionalReference number for the transfer.
from_warehouse_namestringOptionalResolved source name.
to_warehouse_namestringOptionalResolved destination name.
transfer_datetimestampOptionalWhen it was made.
statusstring= pendingOptionalState of the transfer.
items[].qty_availabledecimalOptionalQuantity that was available at source when the transfer was prepared.

Validation rules

  • Source and destination must be different.
  • At least one item is required.
  • Quantities must be greater than zero.
  • Both warehouses must belong to your business.
Warningqty_available reflects the source stock at the time the transfer was prepared. If goods are sold from that location while a transfer is being keyed in, the figure on screen can be stale — check the source before sending large moves.

What it records

A transfer writes a stock movement at each end — one reducing the source, one increasing the destination — each with the quantity before and after, so the history explains both sides.

NoteBecause the two movements are a matched pair, a transfer never changes total stock. If the total does change, the cause is a sale, a purchase, an adjustment or damage — not a transfer.

Related