Hoppa till innehållet

Överföringar

Stock transfers between warehouses, from release through shipping to receipt. Addressed by orderNumber.

7 anrop GET POST Bas-URL https://api.erp.fluit.cloud/preview

Autentisering, felkoder, rate limits, idempotens och paginering gäller alla anrop och står samlade under Kom igång.

GET /transfer-orders

List transfer orders

Returns a paginated list of stock transfers, sorted by orderNumber. ?modifiedSince= returns both created and modified transfers, so it can be used for delta sync; deletions are reported by GET /preview/deletions.

Frågeparametrar

Fält Typ Beskrivning
search string Matches the order number, case-insensitively and on partial words.
status enum Filters on how far the transfer has got. Draft Released Picking ReadyToShip InTransit PartiallyReceived Received Cancelled
fromWarehouseCode string Returns only the transfers leaving this warehouse.
toWarehouseCode string Returns only the transfers arriving at this warehouse.
modifiedSince string(date-time) Returns only records created or changed at or after this instant (ISO 8601 UTC datetime). A change anywhere inside the record counts, including on its lines.
page integer Page to return, 1-based. Default 1.
pageSize integer Number of records per page. Default 50, max 200.

Svar

200 PagedResult_PublicTransferOrderResponse

Paginerat svar: raderna nedan ligger i items[], omgivna av totalCount, page, pageSize, totalPages, hasPreviousPage och hasNextPage. Paginerad

Fält Typ Beskrivning
createdDate string(date-time) UTC timestamp when the transfer was created.
fromWarehouseCode string · nullable Code of the warehouse the stock leaves.
lines TransferOrderLine[] · nullable The transfer's lines.
links Links Hypermedia links for a public API resource. Exposed as a computed `links` property on the public response DTOs so that create and read responses carry the same self-reference — the canonical URL is derived from the business key already present on the DTO and can never drift from the route it points at.
modifiedDate string(date-time) · nullable UTC timestamp when the transfer was last modified. Null if never modified.
notes string · nullable Free-text notes. Null if not set.
orderNumber string · nullable Unique transfer order number.
receivedDate string(date-time) · nullable UTC timestamp when the transfer was received. Null until received.
requestedDate string(date) · nullable Requested arrival date (ISO 8601 date). Null if not set.
shippedDate string(date-time) · nullable UTC timestamp when the transfer was shipped. Null until shipped.
shippingMethodName string · nullable Name of the shipping method / carrier. Null if not set.
status enum Status of a stock transfer between warehouses. Draft Released Picking ReadyToShip InTransit PartiallyReceived Received Cancelled
toWarehouseCode string · nullable Code of the warehouse the stock arrives at.
400 ProblemDetails ?status= got a value outside its list.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standardfel: 401 403 Felhantering

Exempel

curl
curl "https://api.erp.fluit.cloud/preview/transfer-orders" \
  -H "X-Api-Key: fluit_live_sk_..."
Svar 200
{
  "hasNextPage": true,
  "hasPreviousPage": true,
  "items": [
    {
      "createdDate": "2026-06-11T09:24:13.418",
      "fromWarehouseCode": "MAIN",
      "lines": [
        {
          "fromLocationCode": "STD",
          "itemName": "Widget A",
          "itemNumber": "WIDGET-A",
          "lineNumber": 1,
          "notes": "string",
          "pickedQuantity": "10",
          "receivedQuantity": "10",
          "requestedQuantity": "10",
          "shippedQuantity": "10",
          "toLocationCode": "STD"
        }
      ],
      "links": {
        "self": "string"
      },
      "modifiedDate": "2026-06-11T09:24:13.418",
      "notes": "string",
      "orderNumber": "SO-2026-1041",
      "receivedDate": "2026-06-11T09:24:13.418",
      "requestedDate": "2026-06-11",
      "shippedDate": "2026-06-11T09:24:13.418",
      "shippingMethodName": "Parcel, next day",
      "status": "Draft",
      "toWarehouseCode": "MAIN"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "totalCount": 137,
  "totalPages": 3
}

Bas-URL https://api.erp.fluit.cloud/preview. Svarsexemplet är genererat ur schemat: formen stämmer, värdena är påhittade.

POST /transfer-orders

Create a transfer order

Creates a stock transfer between two warehouses in Draft status and returns it in the same shape as GET /preview/transfer-orders/{orderNumber}. The transfer and its lines are created in one transaction — if any line fails, nothing is created.

Visa hela beskrivningen

Release it with POST /preview/transfer-orders/{orderNumber}/release to allocate stock and let the source warehouse pick. To move stock between locations inside one warehouse, use POST /preview/inventory/movements instead. Known error codes: Warehouse.NotFound, Item.NotFound, TransferOrder.SameWarehouse.

transfer-orders:write Kräver Idempotency-Key

Body krävs

Fält Typ Beskrivning
fromWarehouseCode Krävs string Warehouse the stock leaves.
lines CreateTransferOrderLine[] · nullable Lines to create atomically with the transfer.
notes string · nullable Free-text notes on the transfer.
requestedDate string(date) · nullable Requested arrival date.
shippingMethodCode string · nullable Shipping method / carrier code.
toWarehouseCode Krävs string Warehouse the stock arrives at. Must differ from the source.

Svar

201 PublicTransferOrderResponse
  • Location — URL of the newly created resource.
Fält Typ Beskrivning
createdDate string(date-time) UTC timestamp when the transfer was created.
fromWarehouseCode string · nullable Code of the warehouse the stock leaves.
lines TransferOrderLine[] · nullable The transfer's lines.
links Links Hypermedia links for a public API resource. Exposed as a computed `links` property on the public response DTOs so that create and read responses carry the same self-reference — the canonical URL is derived from the business key already present on the DTO and can never drift from the route it points at.
modifiedDate string(date-time) · nullable UTC timestamp when the transfer was last modified. Null if never modified.
notes string · nullable Free-text notes. Null if not set.
orderNumber string · nullable Unique transfer order number.
receivedDate string(date-time) · nullable UTC timestamp when the transfer was received. Null until received.
requestedDate string(date) · nullable Requested arrival date (ISO 8601 date). Null if not set.
shippedDate string(date-time) · nullable UTC timestamp when the transfer was shipped. Null until shipped.
shippingMethodName string · nullable Name of the shipping method / carrier. Null if not set.
status enum Status of a stock transfer between warehouses. Draft Released Picking ReadyToShip InTransit PartiallyReceived Received Cancelled
toWarehouseCode string · nullable Code of the warehouse the stock arrives at.
400 ProblemDetails A warehouse code or item number does not exist, the source and destination warehouse are the same, or a field failed validation.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standardfel: 401 403 409 Felhantering

Exempel

curl
curl -X POST "https://api.erp.fluit.cloud/preview/transfer-orders" \
  -H "X-Api-Key: fluit_live_sk_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d @body.json
Dated with locations and carrier
{
  "fromWarehouseCode": "HUVUD",
  "lines": [
    {
      "fromLocationCode": "A-01-01",
      "itemNumber": "ART-1001",
      "quantity": "20",
      "toLocationCode": "INKOMMANDE"
    }
  ],
  "notes": "Weekly store replenishment",
  "requestedDate": "2026-09-01",
  "shippingMethodCode": "INTERN-BIL",
  "toWarehouseCode": "BUTIK-1"
}
One line
{
  "fromWarehouseCode": "HUVUD",
  "lines": [
    {
      "itemNumber": "ART-1001",
      "quantity": "20"
    }
  ],
  "toWarehouseCode": "BUTIK-1"
}
Svar 201
{
  "createdDate": "2026-06-11T09:24:13.418",
  "fromWarehouseCode": "MAIN",
  "lines": [
    {
      "fromLocationCode": "STD",
      "itemName": "Widget A",
      "itemNumber": "WIDGET-A",
      "lineNumber": 1,
      "notes": "string",
      "pickedQuantity": "10",
      "receivedQuantity": "10",
      "requestedQuantity": "10",
      "shippedQuantity": "10",
      "toLocationCode": "STD"
    }
  ],
  "links": {
    "self": "string"
  },
  "modifiedDate": "2026-06-11T09:24:13.418",
  "notes": "string",
  "orderNumber": "SO-2026-1041",
  "receivedDate": "2026-06-11T09:24:13.418",
  "requestedDate": "2026-06-11",
  "shippedDate": "2026-06-11T09:24:13.418",
  "shippingMethodName": "Parcel, next day",
  "status": "Draft",
  "toWarehouseCode": "MAIN"
}

Bas-URL https://api.erp.fluit.cloud/preview. Svarsexemplet är genererat ur schemat: formen stämmer, värdena är påhittade.

GET /transfer-orders/{orderNumber}

Get a transfer order by order number

Returns a stock transfer with its lines, including the requested, picked, shipped and received quantity per line — the four numbers that together say where the goods currently are. Responses carry a weak ETag; pass it back in If-None-Match to get 304 Not Modified while the record is unchanged.

transfer-orders:read Stödjer ETag

Sökvägsparametrar

Fält Typ Beskrivning
orderNumber Krävs string Order number of the transfer order to read.

Svar

200 PublicTransferOrderResponse
  • ETag — Weak validator for this representation. Pass it back in If-None-Match to get 304 Not Modified while the record is unchanged.
Fält Typ Beskrivning
createdDate string(date-time) UTC timestamp when the transfer was created.
fromWarehouseCode string · nullable Code of the warehouse the stock leaves.
lines TransferOrderLine[] · nullable The transfer's lines.
links Links Hypermedia links for a public API resource. Exposed as a computed `links` property on the public response DTOs so that create and read responses carry the same self-reference — the canonical URL is derived from the business key already present on the DTO and can never drift from the route it points at.
modifiedDate string(date-time) · nullable UTC timestamp when the transfer was last modified. Null if never modified.
notes string · nullable Free-text notes. Null if not set.
orderNumber string · nullable Unique transfer order number.
receivedDate string(date-time) · nullable UTC timestamp when the transfer was received. Null until received.
requestedDate string(date) · nullable Requested arrival date (ISO 8601 date). Null if not set.
shippedDate string(date-time) · nullable UTC timestamp when the transfer was shipped. Null until shipped.
shippingMethodName string · nullable Name of the shipping method / carrier. Null if not set.
status enum Status of a stock transfer between warehouses. Draft Released Picking ReadyToShip InTransit PartiallyReceived Received Cancelled
toWarehouseCode string · nullable Code of the warehouse the stock arrives at.
304 Tom body.
  • ETag — Weak validator for this representation. Pass it back in If-None-Match to get 304 Not Modified while the record is unchanged.
404 ProblemDetails No transfer order with that order number.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standardfel: 401 403 Felhantering

Exempel

curl
curl "https://api.erp.fluit.cloud/preview/transfer-orders/{orderNumber}" \
  -H "X-Api-Key: fluit_live_sk_..."
Svar 200
{
  "createdDate": "2026-06-11T09:24:13.418",
  "fromWarehouseCode": "MAIN",
  "lines": [
    {
      "fromLocationCode": "STD",
      "itemName": "Widget A",
      "itemNumber": "WIDGET-A",
      "lineNumber": 1,
      "notes": "string",
      "pickedQuantity": "10",
      "receivedQuantity": "10",
      "requestedQuantity": "10",
      "shippedQuantity": "10",
      "toLocationCode": "STD"
    }
  ],
  "links": {
    "self": "string"
  },
  "modifiedDate": "2026-06-11T09:24:13.418",
  "notes": "string",
  "orderNumber": "SO-2026-1041",
  "receivedDate": "2026-06-11T09:24:13.418",
  "requestedDate": "2026-06-11",
  "shippedDate": "2026-06-11T09:24:13.418",
  "shippingMethodName": "Parcel, next day",
  "status": "Draft",
  "toWarehouseCode": "MAIN"
}

Bas-URL https://api.erp.fluit.cloud/preview. Svarsexemplet är genererat ur schemat: formen stämmer, värdena är påhittade.

GET /transfer-orders/{orderNumber}/lines

List transfer order lines

Returns the lines on a transfer order, sorted by line number ascending. The same lines are also embedded in GET /preview/transfer-orders/{orderNumber}; this endpoint exists so that a transfer order with many lines can be paged through rather than arriving as one unbounded array.

Visa hela beskrivningen

Returns 404 TransferOrder.NotFound if no transfer order has that number.

transfer-orders:read Paginerad

Sökvägsparametrar

Fält Typ Beskrivning
orderNumber Krävs string Order number of the transfer order whose lines to list.

Frågeparametrar

Fält Typ Beskrivning
page integer Page to return, 1-based. Default 1.
pageSize integer Number of records per page. Default 50, max 200.

Svar

200 PagedResult_PublicTransferOrderLineResponse

Paginerat svar: raderna nedan ligger i items[], omgivna av totalCount, page, pageSize, totalPages, hasPreviousPage och hasNextPage. Paginerad

Fält Typ Beskrivning
fromLocationCode string · nullable Source location code. Null when not pinned to a location.
itemName string · nullable Display name of the item.
itemNumber string · nullable Item number being transferred.
lineNumber integer Line number, unique within the transfer order.
notes string · nullable Free-text notes on the line. Null if not set.
pickedQuantity decimal Quantity picked at the source warehouse. Serialised as a decimal string.
receivedQuantity decimal Quantity received at the destination. Serialised as a decimal string.
requestedQuantity decimal Quantity requested. Serialised as a decimal string.
shippedQuantity decimal Quantity shipped. Serialised as a decimal string.
toLocationCode string · nullable Destination location code. Null when not pinned to a location.
404 ProblemDetails No transfer order with that order number.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standardfel: 401 403 Felhantering

Exempel

curl
curl "https://api.erp.fluit.cloud/preview/transfer-orders/{orderNumber}/lines" \
  -H "X-Api-Key: fluit_live_sk_..."
Svar 200
{
  "hasNextPage": true,
  "hasPreviousPage": true,
  "items": [
    {
      "fromLocationCode": "STD",
      "itemName": "Widget A",
      "itemNumber": "WIDGET-A",
      "lineNumber": 1,
      "notes": "string",
      "pickedQuantity": "10",
      "receivedQuantity": "10",
      "requestedQuantity": "10",
      "shippedQuantity": "10",
      "toLocationCode": "STD"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "totalCount": 137,
  "totalPages": 3
}

Bas-URL https://api.erp.fluit.cloud/preview. Svarsexemplet är genererat ur schemat: formen stämmer, värdena är påhittade.

POST /transfer-orders/{orderNumber}/lines/{lineNumber}/receive

Receive a transfer order line

Books a received quantity into the destination warehouse and returns the whole transfer order so the caller can see the remaining quantities without a second request. Receive lines one at a time; partial receipts are allowed and move the transfer to PartiallyReceived until every line is fully received.

Visa hela beskrivningen

You cannot receive more than was shipped — ship the quantity first. toLocationCode must be a location in the destination warehouse. Known error codes: TransferOrder.NotFound, TransferOrderLine.NotFound, TransferOrder.CannotReceiveInStatus, TransferOrder.CannotReceiveMoreThanShipped.

transfer-orders:write Kräver Idempotency-Key

Sökvägsparametrar

Fält Typ Beskrivning
orderNumber Krävs string Order number of the transfer order the goods arrived on.
lineNumber Krävs integer Line number of the line being received, as reported in lineNumber on the transfer order.

Body krävs

Fält Typ Beskrivning
batchNumber string · nullable Batch / lot number, for batch-tracked items.
quantity decimal Quantity received. Must be greater than zero and at most the shipped quantity.
serialNumber string · nullable Serial number, for serial-tracked items.
toLocationCode string · nullable Location to receive into. Defaults to the line's destination location.

Svar

200 PublicTransferOrderResponse
Fält Typ Beskrivning
createdDate string(date-time) UTC timestamp when the transfer was created.
fromWarehouseCode string · nullable Code of the warehouse the stock leaves.
lines TransferOrderLine[] · nullable The transfer's lines.
links Links Hypermedia links for a public API resource. Exposed as a computed `links` property on the public response DTOs so that create and read responses carry the same self-reference — the canonical URL is derived from the business key already present on the DTO and can never drift from the route it points at.
modifiedDate string(date-time) · nullable UTC timestamp when the transfer was last modified. Null if never modified.
notes string · nullable Free-text notes. Null if not set.
orderNumber string · nullable Unique transfer order number.
receivedDate string(date-time) · nullable UTC timestamp when the transfer was received. Null until received.
requestedDate string(date) · nullable Requested arrival date (ISO 8601 date). Null if not set.
shippedDate string(date-time) · nullable UTC timestamp when the transfer was shipped. Null until shipped.
shippingMethodName string · nullable Name of the shipping method / carrier. Null if not set.
status enum Status of a stock transfer between warehouses. Draft Released Picking ReadyToShip InTransit PartiallyReceived Received Cancelled
toWarehouseCode string · nullable Code of the warehouse the stock arrives at.
400 ProblemDetails The quantity is zero or less, it exceeds what was shipped, or toLocationCode is not a location in the destination warehouse.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable
404 ProblemDetails No transfer order with that order number, or no line with that line number on it.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable
409 ProblemDetails The transfer is in a status that cannot receive goods.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standardfel: 401 403 Felhantering

Exempel

curl
curl -X POST "https://api.erp.fluit.cloud/preview/transfer-orders/{orderNumber}/lines/{lineNumber}/receive" \
  -H "X-Api-Key: fluit_live_sk_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d @body.json
Partial receipt into a named location
{
  "batchNumber": "L-2026-14",
  "quantity": "12",
  "toLocationCode": "INKOMMANDE"
}
Receive the full quantity
{
  "quantity": "20"
}
Svar 200
{
  "createdDate": "2026-06-11T09:24:13.418",
  "fromWarehouseCode": "MAIN",
  "lines": [
    {
      "fromLocationCode": "STD",
      "itemName": "Widget A",
      "itemNumber": "WIDGET-A",
      "lineNumber": 1,
      "notes": "string",
      "pickedQuantity": "10",
      "receivedQuantity": "10",
      "requestedQuantity": "10",
      "shippedQuantity": "10",
      "toLocationCode": "STD"
    }
  ],
  "links": {
    "self": "string"
  },
  "modifiedDate": "2026-06-11T09:24:13.418",
  "notes": "string",
  "orderNumber": "SO-2026-1041",
  "receivedDate": "2026-06-11T09:24:13.418",
  "requestedDate": "2026-06-11",
  "shippedDate": "2026-06-11T09:24:13.418",
  "shippingMethodName": "Parcel, next day",
  "status": "Draft",
  "toWarehouseCode": "MAIN"
}

Bas-URL https://api.erp.fluit.cloud/preview. Svarsexemplet är genererat ur schemat: formen stämmer, värdena är påhittade.

POST /transfer-orders/{orderNumber}/release

Release a transfer order

Moves the transfer from Draft to Released, which allocates stock at the source warehouse and makes the lines available for picking.

transfer-orders:write Kräver Idempotency-Key

Sökvägsparametrar

Fält Typ Beskrivning
orderNumber Krävs string Order number of the draft transfer order to release.

Svar

204 Tom body.
400 ProblemDetails The transfer is not in Draft, or it has no lines to release.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable
404 ProblemDetails No transfer order with that order number.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standardfel: 401 403 409 Felhantering

Exempel

curl
curl -X POST "https://api.erp.fluit.cloud/preview/transfer-orders/{orderNumber}/release" \
  -H "X-Api-Key: fluit_live_sk_..." \
  -H "Idempotency-Key: $(uuidgen)"
Svar 400
{
  "detail": "string",
  "instance": "string",
  "status": 42,
  "title": "string",
  "type": "string"
}

Bas-URL https://api.erp.fluit.cloud/preview. Svarsexemplet är genererat ur schemat: formen stämmer, värdena är påhittade.

POST /transfer-orders/{orderNumber}/ship

Ship a transfer order

Ships the picked quantities from the source warehouse: every line's shipped quantity is set to its picked quantity, the stock leaves the source warehouse and the transfer moves to InTransit. Lines that were not picked ship as zero, so pick before shipping if you expect the full quantity to move.

transfer-orders:write Kräver Idempotency-Key

Sökvägsparametrar

Fält Typ Beskrivning
orderNumber Krävs string Order number of the picked transfer order to ship.

Svar

204 Tom body.
400 ProblemDetails Not every line has been picked, so there is nothing to ship on at least one of them.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable
404 ProblemDetails No transfer order with that order number.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable
409 ProblemDetails The transfer is neither ReadyToShip nor Picking, so there is nothing to ship.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standardfel: 401 403 Felhantering

Exempel

curl
curl -X POST "https://api.erp.fluit.cloud/preview/transfer-orders/{orderNumber}/ship" \
  -H "X-Api-Key: fluit_live_sk_..." \
  -H "Idempotency-Key: $(uuidgen)"
Svar 400
{
  "detail": "string",
  "instance": "string",
  "status": 42,
  "title": "string",
  "type": "string"
}

Bas-URL https://api.erp.fluit.cloud/preview. Svarsexemplet är genererat ur schemat: formen stämmer, värdena är påhittade.

Scheman

Objekten som gruppens anrop refererar till. Fälttabellerna ovan går ett steg djupt och länkar hit i stället för att upprepa samma schema på varje endpoint.

CreateTransferOrderLine

CreateTransferOrderLineInput
Fält Typ Beskrivning
fromLocationCode string · nullable Source location. Defaults to the source warehouse's pick logic.
itemNumber Krävs string Item to transfer.
notes string · nullable Free-text notes on the line.
quantity decimal Quantity to transfer. Must be greater than zero.
toLocationCode string · nullable Destination location. Defaults to the destination warehouse's receiving location.

TransferOrderLine

PublicTransferOrderLineResponse

A line on a stock transfer.

Fält Typ Beskrivning
fromLocationCode string · nullable Source location code. Null when not pinned to a location.
itemName string · nullable Display name of the item.
itemNumber string · nullable Item number being transferred.
lineNumber integer Line number, unique within the transfer order.
notes string · nullable Free-text notes on the line. Null if not set.
pickedQuantity decimal Quantity picked at the source warehouse. Serialised as a decimal string.
receivedQuantity decimal Quantity received at the destination. Serialised as a decimal string.
requestedQuantity decimal Quantity requested. Serialised as a decimal string.
shippedQuantity decimal Quantity shipped. Serialised as a decimal string.
toLocationCode string · nullable Destination location code. Null when not pinned to a location.