Hoppa till innehållet

Synkronisering

Endpoints that exist for incremental synchronisation. The list endpoints' ?modifiedSince= covers records that were created or changed; GET /preview/deletions covers the ones that were removed, which no list endpoint can report because the row is gone.

1 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 /deletions

List deleted records

Returns records that have been deleted, so an incremental sync can retire its local copies. This endpoint exists because a deletion cannot be observed from the list endpoints.

Visa hela beskrivningen

When a customer, supplier, purchase order or configuration is deleted the row is really gone, so no filter on GET /preview/customers (or any other collection) can surface it — it simply stops appearing, which is indistinguishable from "unchanged since your last poll". Every deletion is recorded here instead, in the same transaction as the deletion itself. Covers: `customers`, `items`, `suppliers`, `orders`, `purchase-orders`, `configurations`, `quotes`, `returns`, `shipments`, `invoices`. Filter to one collection with `?resource=` (an unknown value returns 400 rather than an empty page). **Running a sync.** Poll `?modifiedSince=` on the list endpoints for creates and updates, and `?deletedSince=` here for removals, using the same timestamp for both. Results are sorted by `deletedDate` ascending, so take the highest `deletedDate` you have seen and pass it as the next `?deletedSince=`. Re-reading from a slightly earlier timestamp is safe: applying a deletion twice has no further effect. `businessKey` is the identifier the record had when it was deleted — customer number, item number, order number. It is normally the field you stored, so match on it; `id` is there for clients that keyed on the GUID instead. Omitting `?deletedSince=` returns the full log from the beginning, which is rarely what you want after the first sync. Paginated response: `{ items, totalCount, page, pageSize, totalPages, hasPreviousPage, hasNextPage }`. `?page=` defaults to 1, `?pageSize=` to 50 and is capped at 200.

sync:read

Frågeparametrar

Fält Typ Beskrivning
deletedSince string(date-time) Returns only records deleted at or after this instant (ISO 8601 UTC datetime). Omitting it returns the whole log from the beginning.
resource string Limits the log to one collection, given by its path segment such as customers or purchase-orders. An unknown value returns 400 rather than an empty page.
page integer Page to return, 1-based. Default 1.
pageSize integer Number of records per page. Default 50, max 200.

Svar

200 PagedResult_PublicDeletionResponse

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

Fält Typ Beskrivning
businessKey string · nullable The business key the record had when it was deleted — customer number, item number, order number. This is normally what you stored on your side, so it is the field to match on. Null when the record never had one (an unnumbered draft, for example).
deletedDate string(date-time) UTC timestamp of the deletion. Use the highest value you have seen as the next `?deletedSince=`.
id string(uuid) The deleted record's `id`, the same value its list endpoint used to return.
resource string · nullable Which collection the record belonged to: `customers`, `items`, `suppliers`, `orders`, `purchase-orders` or `configurations`. Matches the path segment of the list endpoint the record used to appear in.
400 ProblemDetails ?resource= names a collection that is not covered by the deletion log.
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/deletions" \
  -H "X-Api-Key: fluit_live_sk_..."
Svar 200
{
  "hasNextPage": true,
  "hasPreviousPage": true,
  "items": [
    {
      "businessKey": "string",
      "deletedDate": "2026-06-11T09:24:13.418",
      "id": "0f8b2c1e-4d3a-4b7e-9f10-2a6c5d8e1b44",
      "resource": "string"
    }
  ],
  "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.