Dictionaries

All the enum values you need when creating documents are returned by one endpoint:

curl -s https://prod.api.fakturnia.pl/external/v1/dictionaries \
  -H "Authorization: Bearer $TOKEN"

This is the source of truth for your integration. The endpoint only needs a valid OAuth token (no extra scope), and the data is static and non-sensitive. Rather than hardcoding the values below, fetch them once at integration start, so a new dictionary entry won't break your code.

The full content of each dictionary is below. You use these lists when creating documents.

Document types (documentTypes)#

These are all the types supported by the External API. There are no separate types for split payment, the margin scheme, reverse charge or a VAT-exempt invoice, the way some other systems have. Fakturnia is fully KSeF-compliant and these document features are set via annotations. This is the current standard: fewer document types and a simpler integration. The "Sent to KSeF" column tells you whether a type can be submitted to KSeF.

VAT rates (vatRates)#

value is what you send in vatRate. The special string codes mean net = gross, VAT = 0.

Payment methods (paymentMethods)#

You send paymentMethodId in the document.

Payment statuses (paymentStatuses)#

Currencies (currencies)#

availableExchangeRate indicates whether you can pass exchangeRate for that currency.

Country codes (countries)#

The ISO 3166-1 alpha-2 code goes in countryCode (contractor).

GTU codes (gtu)#

Optional gtu on a line item.

Margin procedures (marginProcedures)#

You send id in annotations.marginProcedure.procedureId.

VAT exemption types (vatExemptionTypes)#

You send type in annotations.vatExemption.exemptionType, and the legal basis in legalBasis (pattern in the "Example" column).

Payment date headers (paymentDateHeaders)#

You send id in additionalPaymentDateHeaderId.

Additional date headers (additionalDateHeaders)#

You send id in subDateHeaderId (the header above the sale date).