Hoppa till innehållet

Inleveranser

Goods receipts — what physically arrived, from purchase orders and inbound transfers. Addressed by receiptNumber. Receiving against a purchase order line is done under PurchaseOrders.

3 anrop GET 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 /receipts

List goods receipts

Returns a paginated list of goods receipts, sorted by receiptNumber. A receipt records what physically arrived; each line points back to the purchase order line or transfer order line it received against.

Visa hela beskrivningen

Receipts are created by receiving against a purchase order (POST /preview/purchase-orders/{orderNumber}/lines/{lineNumber}/receive) or a transfer order — there is no endpoint to create one directly, because a receipt without a document behind it is a stock adjustment.

Frågeparametrar

Fält Typ Beskrivning
search string Matches the receipt number, case-insensitively and on partial words.
status enum Filters on how far the receipt has been processed. Draft InProgress Completed Cancelled
warehouseCode string Returns only the receipts booked into 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_PublicReceiptResponse

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 receipt was created.
lines ReceiptLine[] · nullable The receipt'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 receipt was last modified. Null if never modified.
notes string · nullable Free-text notes. Null if not set.
receiptDate string(date-time) UTC timestamp of the receipt.
receiptNumber string · nullable Unique receipt number.
status enum Status of a goods receipt. Draft InProgress Completed Cancelled
warehouseCode string · nullable Warehouse the goods arrived 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/receipts" \
  -H "X-Api-Key: fluit_live_sk_..."
Svar 200
{
  "hasNextPage": true,
  "hasPreviousPage": true,
  "items": [
    {
      "createdDate": "2026-06-11T09:24:13.418",
      "lines": [
        {
          "batchNumber": "ABC-001",
          "itemName": "Widget A",
          "itemNumber": "WIDGET-A",
          "lineNumber": 1,
          "locationCode": "STD",
          "notes": "string",
          "purchaseOrderNumber": "ABC-001",
          "quantity": "10",
          "serialNumber": "ABC-001",
          "transferOrderNumber": "ABC-001",
          "unitCost": "299.00"
        }
      ],
      "links": {
        "self": "string"
      },
      "modifiedDate": "2026-06-11T09:24:13.418",
      "notes": "string",
      "receiptDate": "2026-06-11T09:24:13.418",
      "receiptNumber": "REC-2026-0231",
      "status": "Draft",
      "warehouseCode": "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.

GET /receipts/{receiptNumber}

Get a goods receipt by receipt number

Returns a goods receipt with its lines: what arrived, in what quantity, at what unit cost and into which location. Each line carries the purchase order number or transfer order number it received against, so the receipt can be matched back to the document that ordered it.

Visa hela beskrivningen

Responses carry a weak ETag; pass it back in If-None-Match to get 304 Not Modified while the record is unchanged.

receipts:read Stödjer ETag

Sökvägsparametrar

Fält Typ Beskrivning
receiptNumber Krävs string Receipt number of the goods receipt to read.

Svar

200 PublicReceiptResponse
  • 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 receipt was created.
lines ReceiptLine[] · nullable The receipt'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 receipt was last modified. Null if never modified.
notes string · nullable Free-text notes. Null if not set.
receiptDate string(date-time) UTC timestamp of the receipt.
receiptNumber string · nullable Unique receipt number.
status enum Status of a goods receipt. Draft InProgress Completed Cancelled
warehouseCode string · nullable Warehouse the goods arrived 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 goods receipt with that receipt 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/receipts/{receiptNumber}" \
  -H "X-Api-Key: fluit_live_sk_..."
Svar 200
{
  "createdDate": "2026-06-11T09:24:13.418",
  "lines": [
    {
      "batchNumber": "ABC-001",
      "itemName": "Widget A",
      "itemNumber": "WIDGET-A",
      "lineNumber": 1,
      "locationCode": "STD",
      "notes": "string",
      "purchaseOrderNumber": "ABC-001",
      "quantity": "10",
      "serialNumber": "ABC-001",
      "transferOrderNumber": "ABC-001",
      "unitCost": "299.00"
    }
  ],
  "links": {
    "self": "string"
  },
  "modifiedDate": "2026-06-11T09:24:13.418",
  "notes": "string",
  "receiptDate": "2026-06-11T09:24:13.418",
  "receiptNumber": "REC-2026-0231",
  "status": "Draft",
  "warehouseCode": "MAIN"
}

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

GET /receipts/{receiptNumber}/lines

List goods receipt lines

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

receipts:read Paginerad

Sökvägsparametrar

Fält Typ Beskrivning
receiptNumber Krävs string Receipt number of the goods receipt 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_PublicReceiptLineResponse

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

Fält Typ Beskrivning
batchNumber string · nullable Batch / lot number, for batch-tracked items.
itemName string · nullable Display name of the item.
itemNumber string · nullable Item number received.
lineNumber integer Line number, unique within the receipt.
locationCode string · nullable Location the goods were put into.
notes string · nullable Free-text notes on the line. Null if not set.
purchaseOrderNumber string · nullable Purchase order number this line received against. Null for transfer receipts.
quantity decimal Quantity received. Serialised as a decimal string.
serialNumber string · nullable Serial number, for serial-tracked items.
transferOrderNumber string · nullable Transfer order number this line received against. Null for purchase receipts.
unitCost decimal Unit cost booked, in the tenant's base currency. Serialised as a decimal string.
404 ProblemDetails No goods receipt with that receipt 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/receipts/{receiptNumber}/lines" \
  -H "X-Api-Key: fluit_live_sk_..."
Svar 200
{
  "hasNextPage": true,
  "hasPreviousPage": true,
  "items": [
    {
      "batchNumber": "ABC-001",
      "itemName": "Widget A",
      "itemNumber": "WIDGET-A",
      "lineNumber": 1,
      "locationCode": "STD",
      "notes": "string",
      "purchaseOrderNumber": "ABC-001",
      "quantity": "10",
      "serialNumber": "ABC-001",
      "transferOrderNumber": "ABC-001",
      "unitCost": "299.00"
    }
  ],
  "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.

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.

ReceiptLine

PublicReceiptLineResponse

A line on a goods receipt.

Fält Typ Beskrivning
batchNumber string · nullable Batch / lot number, for batch-tracked items.
itemName string · nullable Display name of the item.
itemNumber string · nullable Item number received.
lineNumber integer Line number, unique within the receipt.
locationCode string · nullable Location the goods were put into.
notes string · nullable Free-text notes on the line. Null if not set.
purchaseOrderNumber string · nullable Purchase order number this line received against. Null for transfer receipts.
quantity decimal Quantity received. Serialised as a decimal string.
serialNumber string · nullable Serial number, for serial-tracked items.
transferOrderNumber string · nullable Transfer order number this line received against. Null for purchase receipts.
unitCost decimal Unit cost booked, in the tenant's base currency. Serialised as a decimal string.