Hoppa till innehållet

API and integrations Reference Supplier invoices

Svenska

Supplier invoices

Supplier invoices with their totals and payment status. Addressed by the supplier's number and the supplier's own invoice number, which together are unique. Read-only: invoices are registered and matched against goods receipts inside Fluit. Payment status comes from the accounting system and is null until it has reported the invoice. The supplier_invoice.payment_status_changed webhook signals a change.

2 calls GET Base URL https://api.fluit.cloud/preview

Authentication, error codes, rate limits, idempotency and pagination apply to every call and are documented once under Getting started.

GET /supplier-invoices

List supplier invoices

Returns a paginated list of supplier invoices, newest invoice date first. paymentStatus, paidAmount, balance and finalPayDate come from the accounting system and are null until it has reported the invoice; unknown is not unpaid. ?modifiedSince= returns both created and modified invoices, including those whose payment status changed, so it can be used for delta sync.

Show the full description

To be told instead, subscribe to the supplier_invoice.payment_status_changed webhook.

supplier-invoices:read Paginated Supports ?modifiedSince

Query parameters

Field Type Description
search string Matches the supplier's invoice number and the supplier name, case-insensitively and on partial words.
supplierNumber string Returns only the invoices from this supplier number.
status enum Filters on where the invoice stands in Fluit: matching against goods receipts and posting. Draft PendingMatch Matched Posted Cancelled
paymentStatus enum Filters on how much of the invoice has been paid, as reported by the accounting system. Invoices whose payment status is unknown never match. Unpaid PartiallyPaid Paid
dueDateFrom string(date) Returns only invoices due on or after this date (ISO 8601 date).
dueDateTo string(date) Returns only invoices due on or before this date (ISO 8601 date).
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.

Responses

200 PagedResult_PublicSupplierInvoiceResponse

Paginated response: the fields below sit in items[], wrapped in totalCount, page, pageSize, totalPages, hasPreviousPage and hasNextPage. Paginated

Field Type Description
balance decimal · nullable Remaining amount to pay including tax, in the invoice currency. Null while unknown.
cancelledInLedger boolean The invoice was cancelled in the accounting system. It has nothing left to pay.
createdDate string(date-time) UTC timestamp when the invoice was registered in Fluit.
currencyCode string · nullable ISO 4217 currency code for all monetary values on this invoice.
dueDate string(date) Due date (ISO 8601 date).
exchangeRate decimal Exchange rate to the company's base currency. 1 for invoices in the base currency.
finalPayDate string(date) · nullable Date the invoice was paid in full (ISO 8601 date). Null until it is.
grossAmount decimal Total including tax: the amount owed to the supplier. Serialised as a decimal string.
invoiceDate string(date) Invoice date (ISO 8601 date).
invoiceNumber string · nullable The supplier's own invoice number, e.g. LF-88240 . Unique per supplier.
ledgerDocumentNumber string · nullable Document number in the accounting system. Null until the invoice is there.
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.
netAmount decimal Total excluding tax. Serialised as a decimal string.
orderReference string · nullable The supplier's reference to our purchase order ("your order"), as free text.
paidAmount decimal · nullable Amount paid so far, in the invoice currency. Null while unknown.
paymentStatus enum How much of the supplier invoice has been paid, as reported by the accounting system. Mirrors Domain.PurchaseInvoices.SupplierInvoicePaymentStatus . Unpaid PartiallyPaid Paid
status enum Supplier invoice status values exposed via the Public API. Mirrors Domain.PurchaseInvoices.SupplierInvoiceStatus name-for-name and value-for-value so the query projections can cast directly. PublicSupplierInvoiceEnumParityTests fails the build if the two drift apart. Draft PendingMatch Matched Posted Cancelled
supplierName string · nullable Display name of the supplier.
supplierNumber string · nullable Supplier number of the supplier that sent the invoice.
vatAmount decimal Total tax. Serialised as a decimal string.
400 ProblemDetails ?status= or ?paymentStatus= got a value outside its list.
Field Type
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standard errors: 401 403 Errors

Examples

curl 
curl "https://api.fluit.cloud/preview/supplier-invoices"
Response 200 
{
  "hasNextPage": true,
  "hasPreviousPage": true,
  "items": [
    {
      "balance": "299.00",
      "cancelledInLedger": true,
      "createdDate": "2026-06-11T09:24:13.418",
      "currencyCode": "SEK",
      "dueDate": "2026-06-11",
      "exchangeRate": "299.00",
      "finalPayDate": "2026-06-11",
      "grossAmount": "299.00",
      "invoiceDate": "2026-06-11",
      "invoiceNumber": "INV-2026-0912",
      "ledgerDocumentNumber": "ABC-001",
      "links": {
        "self": "string"
      },
      "netAmount": "299.00",
      "orderReference": "string",
      "paidAmount": "299.00",
      "paymentStatus": "Unpaid",
      "status": "Draft",
      "supplierName": "Nordic Components AB",
      "supplierNumber": "SUP-001",
      "vatAmount": "299.00"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "totalCount": 137,
  "totalPages": 3
}

Base URL https://api.fluit.cloud/preview. The response example is generated from the schema: the shape is right, the values are made up.

GET /supplier-invoices/{supplierNumber}/{invoiceNumber}

Get a supplier invoice by supplier number and invoice number

Returns the supplier invoice with its totals and payment status. A supplier invoice is identified by the supplier's number and the supplier's own invoice number, which together are unique.

Show the full description

Supplier invoices are read-only over the public API — they are registered and matched against goods receipts inside Fluit. paymentStatus, paidAmount, balance and finalPayDate come from the accounting system and are null until it has reported the invoice. Responses carry a weak ETag; pass it back in If-None-Match to get 304 Not Modified while the record is unchanged.

supplier-invoices:read Supports ETag

Path parameters

Field Type Description
supplierNumber Required string Supplier number of the supplier that sent the invoice.
invoiceNumber Required string The supplier's own invoice number. A slash in it is sent percent-encoded as %2F.

Responses

200 PublicSupplierInvoiceResponse
  • ETag — Weak validator for this representation. Pass it back in If-None-Match to get 304 Not Modified while the record is unchanged.
Field Type Description
balance decimal · nullable Remaining amount to pay including tax, in the invoice currency. Null while unknown.
cancelledInLedger boolean The invoice was cancelled in the accounting system. It has nothing left to pay.
createdDate string(date-time) UTC timestamp when the invoice was registered in Fluit.
currencyCode string · nullable ISO 4217 currency code for all monetary values on this invoice.
dueDate string(date) Due date (ISO 8601 date).
exchangeRate decimal Exchange rate to the company's base currency. 1 for invoices in the base currency.
finalPayDate string(date) · nullable Date the invoice was paid in full (ISO 8601 date). Null until it is.
grossAmount decimal Total including tax: the amount owed to the supplier. Serialised as a decimal string.
invoiceDate string(date) Invoice date (ISO 8601 date).
invoiceNumber string · nullable The supplier's own invoice number, e.g. LF-88240 . Unique per supplier.
ledgerDocumentNumber string · nullable Document number in the accounting system. Null until the invoice is there.
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.
netAmount decimal Total excluding tax. Serialised as a decimal string.
orderReference string · nullable The supplier's reference to our purchase order ("your order"), as free text.
paidAmount decimal · nullable Amount paid so far, in the invoice currency. Null while unknown.
paymentStatus enum How much of the supplier invoice has been paid, as reported by the accounting system. Mirrors Domain.PurchaseInvoices.SupplierInvoicePaymentStatus . Unpaid PartiallyPaid Paid
status enum Supplier invoice status values exposed via the Public API. Mirrors Domain.PurchaseInvoices.SupplierInvoiceStatus name-for-name and value-for-value so the query projections can cast directly. PublicSupplierInvoiceEnumParityTests fails the build if the two drift apart. Draft PendingMatch Matched Posted Cancelled
supplierName string · nullable Display name of the supplier.
supplierNumber string · nullable Supplier number of the supplier that sent the invoice.
vatAmount decimal Total tax. Serialised as a decimal string.
304 Empty 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 invoice with that invoice number from that supplier.
Field Type
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standard errors: 401 403 Errors

Examples

curl 
curl "https://api.fluit.cloud/preview/supplier-invoices/{supplierNumber}/{invoiceNumber}"
Response 200 
{
  "balance": "299.00",
  "cancelledInLedger": true,
  "createdDate": "2026-06-11T09:24:13.418",
  "currencyCode": "SEK",
  "dueDate": "2026-06-11",
  "exchangeRate": "299.00",
  "finalPayDate": "2026-06-11",
  "grossAmount": "299.00",
  "invoiceDate": "2026-06-11",
  "invoiceNumber": "INV-2026-0912",
  "ledgerDocumentNumber": "ABC-001",
  "links": {
    "self": "string"
  },
  "netAmount": "299.00",
  "orderReference": "string",
  "paidAmount": "299.00",
  "paymentStatus": "Unpaid",
  "status": "Draft",
  "supplierName": "Nordic Components AB",
  "supplierNumber": "SUP-001",
  "vatAmount": "299.00"
}

Base URL https://api.fluit.cloud/preview. The response example is generated from the schema: the shape is right, the values are made up.

Schemas

The objects this group's calls refer to. The field tables above go one level deep and link here rather than repeating the same schema on every endpoint.