> ## Documentation Index
> Fetch the complete documentation index at: https://docs-pos.solya.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Transfers

> Move stock between stores in the Solya POS Centrale — request, ship, receive and reconcile inter-store transfers.

**Transfers** move stock from one store to another. The Centrale drives the full
lifecycle — request, ship, receive — and surfaces any **discrepancy** between what
was shipped and what arrived.

## What it is for

* Rebalance stock across the network (send surplus to where it sells).
* Fulfil demand identified in [network availability](/en/centrale/reseau-atp).
* Keep an auditable record of stock in transit.

## Key screens and actions

<Steps>
  <Step title="Request a transfer">
    Create a transfer from a source store to a destination store, with the lines
    (units and quantities) to move.
  </Step>

  <Step title="Ship">
    Mark the transfer shipped when the stock leaves the source store; it becomes
    stock in transit.
  </Step>

  <Step title="Receive">
    The destination store confirms receipt, adding the stock to its on-hand
    quantity.
  </Step>

  <Step title="Reconcile discrepancies">
    If the received quantities differ from what was shipped, the discrepancy view
    shows the gap for follow-up.
  </Step>
</Steps>

A transfer can also be **cancelled** before it completes. The transfer list and
workflow views track each transfer's state through the lifecycle.

## In the API

| Capability    | Endpoints                                                     |
| ------------- | ------------------------------------------------------------- |
| List & detail | `GET /v1/transfers`, `GET /v1/transfers/{transferId}`         |
| Create        | `POST /v1/transfers`                                          |
| Lifecycle     | `POST /v1/transfers/{transferId}/ship`, `/receive`, `/cancel` |
| Discrepancy   | `GET /v1/transfers/{transferId}/discrepancy`                  |

Transfer writes require the transfer **manage** scope — see
[roles and permissions](/en/getting-started/roles-and-permissions). Full request
shapes are in the [API Reference](/en/developers/overview).