Hoppa till innehållet

API och integrationer Referens Leverantörsfakturor

English

Leverantörsfakturor

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 anrop GET Bas-URL https://api.fluit.cloud/preview

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

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.

Visa hela beskrivningen

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

supplier-invoices:read Paginerad Stödjer ?modifiedSince

Frågeparametrar

Fält Typ Beskrivning
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.

Svar

200 PagedResult_PublicSupplierInvoiceResponse

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

Fält Typ Beskrivning
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.
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.fluit.cloud/preview/supplier-invoices"
Svar 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
}

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

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.

Visa hela beskrivningen

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 Stödjer ETag

Sökvägsparametrar

Fält Typ Beskrivning
supplierNumber Krävs string Supplier number of the supplier that sent the invoice.
invoiceNumber Krävs string The supplier's own invoice number. A slash in it is sent percent-encoded as %2F.

Svar

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.
Fält Typ Beskrivning
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 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 invoice with that invoice number from that supplier.
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.fluit.cloud/preview/supplier-invoices/{supplierNumber}/{invoiceNumber}"
Svar 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"
}

Bas-URL https://api.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.