Supplier Invoices
Create and retrieve supplier (purchase) invoices for a given consent.
Retrieves a paginated list of supplier invoices for the specified consent.
System support
Fortnox
✅ Supported
Bjorn Lunden
✅ Supported
Spiris
✅ Supported
Tripletex
📞 Not supported / contact us
Visma e-conomic
✅ Supported
Billy
✅ Supported
Visma Dinero
📞 Not supported / contact us
Procountor
✅ Supported
Visma Netvisor
✅ Supported
Microsoft Business Central
✅ Supported
Exact Online
📞 Not supported / contact us
QuickBooks
📞 Not supported / contact us
Xero
✅ Supported
Bokio
✅ Supported
Kleer
✅ Supported
DATEV
📞 Not supported / contact us
Use the API key to access all API endpoints.
Identifier of the consent representing the connection to the accounting system.
Number of records to return per page. Range: 1-100.
Page number to return. Must be 1 or greater.
Start invoice issue date filter. Format: ISO 8601 date-time (e.g. yyyy-MM-ddTHH:mm:ssZ).
2025-01-01T00:00:00ZEnd invoice issue date filter. Format: ISO 8601 date-time (e.g. yyyy-MM-ddTHH:mm:ssZ).
2025-12-31T00:00:00ZReturn invoices modified on or after this date and time. Format: ISO 8601 date-time (e.g. yyyy-MM-ddTHH:mm:ssZ).
2025-01-01T00:00:00ZSort order for the results.
The status to filter invoices by.
Status filtering support per system is shown below.
Legend:
- ✅ = Supported
- ⛔ = Not supported
| System | IsSold | Paid | Unpaid | Overdue | Cancelled | Unsent |
|---|---|---|---|---|---|---|
| Fortnox | ⛔ | ✅ | ✅ | ✅ | ✅ | ⛔ |
| Bjorn Lunden | ⛔ | ⛔ | ✅ | ✅ | ⛔ | ⛔ |
| Spiris | ⛔ | ✅ | ⛔ | ⛔ | ⛔ | ⛔ |
| Tripletex | ⛔ | ⛔ | ⛔ | ⛔ | ⛔ | ⛔ |
| Visma e-conomic | ⛔ | ⛔ | ⛔ | ⛔ | ⛔ | ⛔ |
| Billy | ⛔ | ✅ | ⛔ | ⛔ | ⛔ | ⛔ |
| Visma Dinero | ⛔ | ⛔ | ⛔ | ⛔ | ⛔ | ⛔ |
| Procountor | ⛔ | ✅ | ⛔ | ⛔ | ✅ | ✅ |
| Visma Netvisor | ⛔ | ✅ | ✅ | ⛔ | ⛔ | ⛔ |
| Microsoft Business Central | ⛔ | ✅ | ✅ | ⛔ | ✅ | ⛔ |
| Bokio | ⛔ | ⛔ | ⛔ | ⛔ | ⛔ | ⛔ |
| Kleer | ⛔ | ⛔ | ⛔ | ⛔ | ⛔ | ⛔ |
| Xero | ⛔ | ✅ | ✅ | ✅ | ✅ | ⛔ |
| FileOne | ⛔ | ⛔ | ⛔ | ⛔ | ⛔ | ⛔ |
Comma-separated list of optional data to include in the response.
Available values:
paymentStatus— Include the payment status.
Unique identifier used to correlate and trace this request.
Returns a paginated list of supplier invoices for the specified consent.
Represents a paginated result containing metadata and a collection of items.
Missing or invalid authentication credentials.
Not authorized to access this resource.
This operation is not supported by the connected accounting system.
GET /accounting/api/v1/consents/{consentId}/supplierinvoices HTTP/1.1
Host: apione.zwapgrid.com
x-api-key: YOUR_API_KEY
x-correlation-id: 123e4567-e89b-12d3-a456-426614174000
Accept: */*
{
"meta": {
"totalResources": 10,
"totalPages": 1,
"currentPage": 1
},
"data": [
{
"id": "SINV-001",
"reference": "SINV-001",
"dueDate": "2024-04-15",
"issueDate": "2024-03-15",
"createdDateTime": "2024-03-15T10:00:00Z",
"modifiedDateTime": "2024-03-16T14:30:00Z",
"accountingSupplierParty": {
"customerAssignedAccountId": {
"id": "SUP-10001",
"schemeId": "supplierId"
},
"party": {
"partyName": {
"name": "Office Supplies Ltd",
"languageId": "ENG"
}
}
},
"notes": [
{
"text": "Office supplies order #4521",
"languageId": "ENG"
}
],
"totalBalanceAmount": {
"amount": 1000,
"currencyId": "DKK"
},
"legalMonetaryTotal": {
"taxInclusiveAmount": {
"amount": 1000,
"currencyId": "DKK"
},
"prepaidAmount": {
"amount": 0,
"currencyId": "DKK"
},
"payableRoundingAmount": {
"amount": 0,
"currencyId": "DKK"
},
"payableAmount": {
"amount": 1000,
"currencyId": "DKK"
},
"taxExclusiveAmount": {
"amount": 800,
"currencyId": "DKK"
},
"lineExtensionAmount": {
"amount": 800,
"currencyId": "DKK"
}
},
"paymentStatus": {
"status": "UNPAID",
"settlementDate": null
}
}
]
}Creates a new supplier invoice in the connected accounting system.
System support
Fortnox
✅ Supported
Bjorn Lunden
✅ Supported
Spiris
✅ Supported
Tripletex
📞 Not supported / contact us
Visma e-conomic
📞 Not supported / contact us
Billy
📞 Not supported / contact us
Visma Dinero
📞 Not supported / contact us
Procountor
📞 Not supported / contact us
Visma Netvisor
📞 Not supported / contact us
Microsoft Business Central
✅ Supported
Exact Online
📞 Not supported / contact us
QuickBooks
📞 Not supported / contact us
Xero
📞 Not supported / contact us
Bokio
✅ Supported
Kleer
📞 Not supported / contact us
DATEV
📞 Not supported / contact us
Use the API key to access all API endpoints.
Identifier of the consent representing the connection to the accounting system.
Unique identifier used to correlate and trace this request.
Represents input data for a supplier invoice.
Invoice number assigned by the sender.
Reference for the buyer (usually the buyer's purchase invoice number).
Indicates whether the invoice is booked.
Indicates whether the invoice is cancelled.
Issue date of the invoice.
Issue time of the invoice.
Due date for payment of the invoice.
Reference for the seller.
The supplier invoice was created. Response includes a Location header with the URL of the created resource.
Missing or invalid authentication credentials.
Not authorized to access this resource.
This operation is not supported by the connected accounting system.
POST /accounting/api/v1/consents/{consentId}/supplierinvoices HTTP/1.1
Host: apione.zwapgrid.com
x-api-key: YOUR_API_KEY
x-correlation-id: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 6970
{
"reference": null,
"buyerReference": null,
"bookedInvoiceIndicator": null,
"cancelledInvoiceIndicator": null,
"issueDate": null,
"issueTime": null,
"dueDate": null,
"creditInvoice": {
"creditInvoiceIndicator": null,
"reference": null,
"creditInvoiceDocumentReferences": [
{
"id": null,
"reference": null,
"documentType": "Invoice"
}
]
},
"financialDimensions": [
{
"id": null,
"reference": null,
"type": null,
"name": null,
"description": null,
"isActive": null
}
],
"notes": [
{
"text": null,
"languageId": null
}
],
"orderReference": {
"buyerOrderId": null,
"sellerOrderId": null
},
"documentCurrencyCode": {
"currencyId": null,
"currencyRate": null
},
"accountingSupplierParty": {
"customerAssignedAccountId": {
"id": null,
"schemeId": null
},
"party": {
"partyName": {
"name": null,
"languageId": null
},
"postalAddress": {
"buildingNumber": null,
"streetName": null,
"additionalStreetName": null,
"cityName": null,
"postalZone": null,
"country": {
"identificationCode": null,
"name": null
}
},
"partyLegalEntity": {
"registrationName": null,
"companyId": {
"id": null,
"schemeId": null
}
},
"contact": {
"name": null,
"telephone": null,
"email": null,
"secondaryEmail": null
},
"endpointId": {
"id": null,
"schemeId": null
},
"partyIdentification": [
{
"id": null,
"schemeId": null
}
]
}
},
"accountingCustomerParty": {
"supplierAssignedAccountId": {
"id": null,
"schemeId": null
},
"party": {
"partyName": {
"name": null,
"languageId": null
},
"postalAddress": {
"buildingNumber": null,
"streetName": null,
"additionalStreetName": null,
"cityName": null,
"postalZone": null,
"country": {
"identificationCode": null,
"name": null
}
},
"partyLegalEntity": {
"registrationName": null,
"companyId": {
"id": null,
"schemeId": null
}
},
"contact": {
"name": null,
"telephone": null,
"email": null,
"secondaryEmail": null
},
"endpointId": {
"id": null,
"schemeId": null
},
"partyIdentification": [
{
"id": null,
"schemeId": null
}
]
}
},
"invoicePeriod": {
"startDate": null,
"endDate": null
},
"delivery": {
"deliveryParty": {
"partyIdentification": {
"id": null,
"schemeId": null
},
"partyName": {
"name": null,
"languageId": null
}
},
"carrierParty": {
"partyIdentification": {
"id": null,
"schemeId": null
},
"partyName": {
"name": null,
"languageId": null
}
},
"actualDeliveryDate": null,
"trackingId": null,
"deliveryAddress": {
"buildingNumber": null,
"streetName": null,
"additionalStreetName": null,
"cityName": null,
"postalZone": null,
"country": {
"identificationCode": null,
"name": null
}
}
},
"deliveryTerms": {
"deliveryTermsId": {
"id": null,
"schemeId": null
},
"specialTerms": {
"text": null,
"languageId": null
}
},
"paymentTerms": {
"paymentTermsId": {
"id": null,
"schemeId": null
},
"notes": [
{
"text": null,
"languageId": null
}
]
},
"paymentMeans": [
{
"paymentChannelCode": null,
"paymentDueDate": null,
"paymentIds": [
{
"id": null,
"schemeId": null
}
]
}
],
"allowanceCharges": [
{
"allowanceChargeId": {
"id": null,
"schemeId": null
},
"chargeIndicator": true,
"allowanceChargeReason": null,
"allowanceChargeAmount": {
"amount": 1,
"currencyId": null
},
"taxTotal": {
"taxAmount": {
"amount": 1,
"currencyId": null
},
"taxIncludedIndicator": null,
"taxSubtotals": [
{
"taxableAmount": {
"amount": 1,
"currencyId": null
},
"taxAmount": {
"amount": 1,
"currencyId": null
},
"taxCategory": {
"id": null,
"percent": null,
"taxScheme": {
"id": null
},
"taxExemptionReason": null,
"taxExemptionReasonCode": null
}
}
]
},
"taxCategory": {
"percent": 1,
"taxScheme": {
"taxSchemeId": {
"id": null,
"schemeId": null
}
},
"id": null
},
"allowanceChargeBaseAmount": {
"amount": 1,
"currencyId": null
},
"multiplierFactorNumeric": null
}
],
"taxTotals": [
{
"taxAmount": {
"amount": 1,
"currencyId": null
},
"taxIncludedIndicator": null,
"taxSubtotals": [
{
"taxableAmount": {
"amount": 1,
"currencyId": null
},
"taxAmount": {
"amount": 1,
"currencyId": null
},
"taxCategory": {
"id": null,
"percent": null,
"taxScheme": {
"id": null
},
"taxExemptionReason": null,
"taxExemptionReasonCode": null
}
}
]
}
],
"withholdingTaxTotals": [
{
"taxAmount": {
"amount": 1,
"currencyId": null
},
"taxSubtotals": [
{
"taxableAmount": {
"amount": 1,
"currencyId": null
},
"taxAmount": {
"amount": 1,
"currencyId": null
},
"taxCategory": {
"id": null,
"percent": null,
"taxScheme": {
"id": null
},
"taxExemptionReason": null,
"taxExemptionReasonCode": null
}
}
]
}
],
"totalBalanceAmount": {
"amount": 1,
"currencyId": null
},
"additionalDocumentReferences": [
{
"id": null,
"reference": null
}
],
"legalMonetaryTotal": {
"taxInclusiveAmount": {
"amount": 1,
"currencyId": null
},
"prepaidAmount": {
"amount": 1,
"currencyId": null
},
"payableRoundingAmount": {
"amount": 1,
"currencyId": null
},
"payableAmount": {
"amount": 1,
"currencyId": null
},
"lineExtensionAmount": {
"amount": 1,
"currencyId": null
},
"taxExclusiveAmount": {
"amount": 1,
"currencyId": null
}
},
"paymentStatus": {
"status": "UNPAID",
"settlementDate": null
},
"invoiceLines": [
{
"id": null,
"type": null,
"account": {
"id": null,
"reference": null,
"standardAccountingAccountId": null,
"name": null,
"active": null,
"postable": null,
"descriptions": [
{
"text": null,
"languageId": null
}
],
"accountingAccountTypeCode": {
"code": null,
"listId": null
},
"financialDimensions": [
{
"id": null,
"reference": null,
"type": null,
"name": null,
"description": null,
"isActive": null
}
]
},
"invoicedQuantity": {
"quantity": null,
"unitCode": null
},
"lineExtensionAmount": {
"amount": 1,
"currencyId": null
},
"item": {
"name": null,
"description": null,
"sellersItemIdentification": {
"id": null,
"extendedId": null
},
"classifiedTaxCategories": [
{
"percent": 1,
"taxScheme": {
"taxSchemeId": {
"id": null,
"schemeId": null
}
},
"id": null
}
]
},
"price": {
"priceAmount": {
"amount": 1,
"currencyId": null
},
"priceTypeCode": {
"code": null,
"listId": null
},
"baseQuantity": {
"quantity": null,
"unitCode": null
},
"allowanceCharges": [
{
"allowanceChargeId": {
"id": null,
"schemeId": null
},
"chargeIndicator": true,
"allowanceChargeReason": null,
"allowanceChargeAmount": {
"amount": 1,
"currencyId": null
},
"taxTotal": {
"taxAmount": {
"amount": 1,
"currencyId": null
},
"taxIncludedIndicator": null,
"taxSubtotals": [
{
"taxableAmount": {
"amount": 1,
"currencyId": null
},
"taxAmount": {
"amount": 1,
"currencyId": null
},
"taxCategory": {
"id": null,
"percent": null,
"taxScheme": {
"id": null
},
"taxExemptionReason": null,
"taxExemptionReasonCode": null
}
}
]
},
"taxCategory": {
"percent": 1,
"taxScheme": {
"taxSchemeId": {
"id": null,
"schemeId": null
}
},
"id": null
},
"allowanceChargeBaseAmount": {
"amount": 1,
"currencyId": null
},
"multiplierFactorNumeric": null
}
]
},
"delivery": {
"actualDeliveryDate": null
},
"financialDimensions": [
{
"id": null,
"reference": null,
"type": null,
"name": null,
"description": null,
"isActive": null
}
],
"allowanceCharges": [
{
"allowanceChargeId": {
"id": null,
"schemeId": null
},
"chargeIndicator": true,
"allowanceChargeReason": null,
"allowanceChargeAmount": {
"amount": 1,
"currencyId": null
},
"taxTotal": {
"taxAmount": {
"amount": 1,
"currencyId": null
},
"taxIncludedIndicator": null,
"taxSubtotals": [
{
"taxableAmount": {
"amount": 1,
"currencyId": null
},
"taxAmount": {
"amount": 1,
"currencyId": null
},
"taxCategory": {
"id": null,
"percent": null,
"taxScheme": {
"id": null
},
"taxExemptionReason": null,
"taxExemptionReasonCode": null
}
}
]
},
"taxCategory": {
"percent": 1,
"taxScheme": {
"taxSchemeId": {
"id": null,
"schemeId": null
}
},
"id": null
},
"allowanceChargeBaseAmount": {
"amount": 1,
"currencyId": null
},
"multiplierFactorNumeric": null
}
],
"subInvoiceLines": [
{
"invoicedQuantity": {
"quantity": null,
"unitCode": null
},
"item": {
"name": null,
"description": null,
"sellersItemIdentification": {
"id": null,
"extendedId": null
},
"classifiedTaxCategories": [
{
"percent": 1,
"taxScheme": {
"taxSchemeId": {
"id": null,
"schemeId": null
}
},
"id": null
}
]
}
}
]
}
],
"sellerReference": null
}{
"id": "550e8400-e29b-41d4-a716-446655440007",
"reference": "SINV-001",
"buyerReference": "PO-4521",
"bookedInvoiceIndicator": false,
"cancelledInvoiceIndicator": false,
"issueDate": "2024-03-05",
"issueTime": "10:30:00",
"dueDate": "2024-04-05",
"creditInvoice": {
"creditInvoiceIndicator": false,
"creditInvoiceDocumentReferences": []
},
"financialDimensions": [],
"notes": [
{
"text": "Office supplies order #4521",
"languageId": "ENG"
}
],
"orderReference": {
"buyerOrderId": "PO-4521",
"sellerOrderId": null
},
"documentCurrencyCode": {
"currency": "USD",
"currencyId": "USD",
"currencyRate": 1
},
"accountingSupplierParty": {
"customerAssignedAccountId": {
"id": "SUP1",
"schemeId": "supplierId"
},
"party": {
"partyIdentification": [],
"partyName": {
"name": "Supplier Inc",
"languageId": "ENG"
},
"postalAddress": {
"buildingNumber": null,
"streetName": "Supplier Street 1",
"additionalStreetName": null,
"cityName": "New York",
"postalZone": "10001",
"country": {
"identificationCode": "US",
"name": "United States"
}
},
"partyLegalEntity": null,
"contact": null,
"endpointId": null
}
},
"accountingCustomerParty": null,
"invoicePeriod": {
"startDate": "2024-03-01",
"endDate": "2024-03-31"
},
"delivery": {
"deliveryParty": null,
"carrierParty": null,
"actualDeliveryDate": "2024-03-04",
"trackingId": null,
"deliveryAddress": null
},
"deliveryTerms": null,
"paymentTerms": null,
"paymentMeans": [],
"allowanceCharges": [],
"taxTotals": [
{
"taxAmount": {
"amount": 200,
"currencyId": "USD"
},
"taxIncludedIndicator": true
}
],
"withholdingTaxTotals": [],
"legalMonetaryTotal": {
"taxInclusiveAmount": {
"amount": 1000,
"currencyId": "USD"
},
"prepaidAmount": {
"amount": 0,
"currencyId": "USD"
},
"payableRoundingAmount": {
"amount": 0,
"currencyId": "USD"
},
"payableAmount": {
"amount": 1000,
"currencyId": "USD"
},
"lineExtensionAmount": {
"amount": 800,
"currencyId": "USD"
},
"taxExclusiveAmount": {
"amount": 800,
"currencyId": "USD"
}
},
"totalBalanceAmount": {
"amount": 1000,
"currencyId": "USD"
},
"additionalDocumentReferences": [],
"paymentStatus": {
"status": "UNPAID",
"settlementDate": "2024-04-15"
},
"invoiceLines": [],
"sellerReference": "SINV-001"
}Retrieves a single supplier invoice by its identifier.
System support
Fortnox
✅ Supported
Bjorn Lunden
✅ Supported
Spiris
✅ Supported
Tripletex
📞 Not supported / contact us
Visma e-conomic
📞 Not supported / contact us
Billy
✅ Supported
Visma Dinero
📞 Not supported / contact us
Procountor
✅ Supported
Visma Netvisor
✅ Supported
Microsoft Business Central
✅ Supported
Exact Online
📞 Not supported / contact us
QuickBooks
📞 Not supported / contact us
Xero
✅ Supported
Bokio
✅ Supported
Kleer
✅ Supported
DATEV
📞 Not supported / contact us
Use the API key to access all API endpoints.
Identifier of the consent representing the connection to the accounting system.
Identifier of the supplier invoice.
Comma-separated list of optional data to include in the response.
Available values:
paymentStatus— Include the payment status.
Unique identifier used to correlate and trace this request.
Returns the requested supplier invoice.
Represents a supplier (purchase) invoice with full detail.
Unique identifier generated by the accounting system.
External reference or number assigned to the invoice.
Reference for the buyer, usually the buyer's purchase order number.
Indicates whether the invoice is booked.
Indicates whether the invoice is cancelled.
Date when the invoice was issued. Format: yyyy-MM-dd.
Time when the invoice was issued (null if not available).
Date when the invoice payment is due. Format: yyyy-MM-dd.
External reference or number assigned by the seller (null if not available).
Missing or invalid authentication credentials.
Not authorized to access this resource.
The requested supplier invoice was not found.
This operation is not supported by the connected accounting system.
GET /accounting/api/v1/consents/{consentId}/supplierinvoices/{supplierInvoiceId} HTTP/1.1
Host: apione.zwapgrid.com
x-api-key: YOUR_API_KEY
x-correlation-id: 123e4567-e89b-12d3-a456-426614174000
Accept: */*
{
"id": "550e8400-e29b-41d4-a716-446655440007",
"reference": "SINV-001",
"buyerReference": "PO-4521",
"bookedInvoiceIndicator": false,
"cancelledInvoiceIndicator": false,
"issueDate": "2024-03-05",
"issueTime": "10:30:00",
"dueDate": "2024-04-05",
"creditInvoice": {
"creditInvoiceIndicator": false,
"creditInvoiceDocumentReferences": []
},
"financialDimensions": [],
"notes": [
{
"text": "Office supplies order #4521",
"languageId": "ENG"
}
],
"orderReference": {
"buyerOrderId": "PO-4521",
"sellerOrderId": null
},
"documentCurrencyCode": {
"currency": "USD",
"currencyId": "USD",
"currencyRate": 1
},
"accountingSupplierParty": {
"customerAssignedAccountId": {
"id": "SUP1",
"schemeId": "supplierId"
},
"party": {
"partyIdentification": [],
"partyName": {
"name": "Supplier Inc",
"languageId": "ENG"
},
"postalAddress": {
"buildingNumber": null,
"streetName": "Supplier Street 1",
"additionalStreetName": null,
"cityName": "New York",
"postalZone": "10001",
"country": {
"identificationCode": "US",
"name": "United States"
}
},
"partyLegalEntity": null,
"contact": null,
"endpointId": null
}
},
"accountingCustomerParty": null,
"invoicePeriod": {
"startDate": "2024-03-01",
"endDate": "2024-03-31"
},
"delivery": {
"deliveryParty": null,
"carrierParty": null,
"actualDeliveryDate": "2024-03-04",
"trackingId": null,
"deliveryAddress": null
},
"deliveryTerms": null,
"paymentTerms": null,
"paymentMeans": [],
"allowanceCharges": [],
"taxTotals": [
{
"taxAmount": {
"amount": 200,
"currencyId": "USD"
},
"taxIncludedIndicator": true
}
],
"withholdingTaxTotals": [],
"legalMonetaryTotal": {
"taxInclusiveAmount": {
"amount": 1000,
"currencyId": "USD"
},
"prepaidAmount": {
"amount": 0,
"currencyId": "USD"
},
"payableRoundingAmount": {
"amount": 0,
"currencyId": "USD"
},
"payableAmount": {
"amount": 1000,
"currencyId": "USD"
},
"lineExtensionAmount": {
"amount": 800,
"currencyId": "USD"
},
"taxExclusiveAmount": {
"amount": 800,
"currencyId": "USD"
}
},
"totalBalanceAmount": {
"amount": 1000,
"currencyId": "USD"
},
"additionalDocumentReferences": [],
"paymentStatus": {
"status": "UNPAID",
"settlementDate": "2024-04-15"
},
"invoiceLines": [],
"sellerReference": "SINV-001"
}Last updated
Was this helpful?