Download OpenAPI specification:
External invoice API, authenticated via the shared Keycloak invoice-api realm.
| search | string Free-text search across invoice number, buyer/seller name and article labels |
| createdDateStart | string <date-time> |
| createdDateEnd | string <date-time> |
| invoiceIssueDateStart | string <date-time> |
| invoiceIssueDateEnd | string <date-time> |
| invoicePaymentDueDateStart | string <date-time> |
| invoicePaymentDueDateEnd | string <date-time> |
| totalAmountNetFrom | number |
| totalAmountNetTo | number |
| totalAmountGrossFrom | number |
| totalAmountGrossTo | number |
| invoiceTypeCode | string |
| sortBy | string Comma-separated |
| from | integer Default: 0 Pagination offset |
| size | integer <= 100 Default: 20 Page size (max 100) |
{- "data": [
- {
- "invoiceId": "string",
- "companyId": null,
- "direction": null,
- "status": "string",
- "createdAt": null,
- "invoiceNumber": null,
- "invoiceTypeCode": null,
- "invoiceFormat": null,
- "invoiceIssueDate": null,
- "invoicePaymentDueDate": null,
- "totalAmountNet": null,
- "totalAmountGross": null,
- "currencyCode": null,
- "buyerName": null,
- "sellerName": null
}
], - "total": null,
- "from": null,
- "size": null
}| search | string Free-text search across invoice number, buyer/seller name and article labels |
| createdDateStart | string <date-time> |
| createdDateEnd | string <date-time> |
| invoiceIssueDateStart | string <date-time> |
| invoiceIssueDateEnd | string <date-time> |
| invoicePaymentDueDateStart | string <date-time> |
| invoicePaymentDueDateEnd | string <date-time> |
| totalAmountNetFrom | number |
| totalAmountNetTo | number |
| totalAmountGrossFrom | number |
| totalAmountGrossTo | number |
| invoiceTypeCode | string |
| sortBy | string Comma-separated |
| from | integer Default: 0 Pagination offset |
| size | integer <= 100 Default: 20 Page size (max 100) |
{- "data": [
- {
- "invoiceId": "string",
- "companyId": null,
- "direction": null,
- "status": "string",
- "createdAt": null,
- "invoiceNumber": null,
- "invoiceTypeCode": null,
- "invoiceFormat": null,
- "invoiceIssueDate": null,
- "invoicePaymentDueDate": null,
- "totalAmountNet": null,
- "totalAmountGross": null,
- "currencyCode": null,
- "buyerName": null,
- "sellerName": null
}
], - "total": null,
- "from": null,
- "size": null
}| search | string Free-text search across invoice number, buyer/seller name and article labels |
| createdDateStart | string <date-time> |
| createdDateEnd | string <date-time> |
| invoiceIssueDateStart | string <date-time> |
| invoiceIssueDateEnd | string <date-time> |
| invoicePaymentDueDateStart | string <date-time> |
| invoicePaymentDueDateEnd | string <date-time> |
| totalAmountNetFrom | number |
| totalAmountNetTo | number |
| totalAmountGrossFrom | number |
| totalAmountGrossTo | number |
| invoiceTypeCode | string |
| sortBy | string Comma-separated |
| from | integer Default: 0 Pagination offset |
| size | integer <= 100 Default: 20 Page size (max 100) |
{- "data": [
- {
- "invoiceId": "string",
- "companyId": null,
- "direction": null,
- "status": "string",
- "createdAt": null,
- "invoiceNumber": null,
- "invoiceTypeCode": null,
- "invoiceFormat": null,
- "invoiceIssueDate": null,
- "invoicePaymentDueDate": null,
- "totalAmountNet": null,
- "totalAmountGross": null,
- "currencyCode": null,
- "buyerName": null,
- "sellerName": null
}
], - "total": null,
- "from": null,
- "size": null
}| invoiceId required | string <uuid> |
{- "invoiceId": "string",
- "companyId": null,
- "direction": null,
- "status": "string",
- "createdAt": null,
- "invoiceNumber": null,
- "invoiceType": null,
- "invoice": null
}required | Array of objects (Invoices) [ 1 .. 200 ] items |
{- "invoices": [
- {
- "deliveryType": "email",
- "invoice": {
- "invoiceTypeCode": "380",
- "invoiceNumber": "string",
- "invoiceIssueDate": "string",
- "invoiceCurrencyCode": "EUR",
- "invoiceFormat": "ubl",
- "buyerReference": "B2B_Rechnung",
- "paymentMeansTypeCode": "string",
- "paymentDueDate": null,
- "paymentTerms": null,
- "remittanceInformation": null,
- "paidAmount": null,
- "creditTransfer": null,
- "mandateReferenceIdentifier": null,
- "bankAssignedCreditorIdentifier": null,
- "debitedAccountIdentifier": null,
- "purchaseOrderReference": null,
- "salesOrderReference": null,
- "despatchAdviceReference": null,
- "tenderOrLotReference": null,
- "contractReference": null,
- "projectReference": null,
- "invoicingPeriodStartDate": null,
- "invoicingPeriodEndDate": null,
- "invoiceDocumentReference": null,
- "deliverToParty": null,
- "documentAllowance": null,
- "documentCharge": null,
- "buyer": {
- "name": "string",
- "electronicAddress": "string",
- "addressLine1": "string",
- "addressLine2": null,
- "addressLine3": null,
- "postCode": "string",
- "city": "string",
- "countryCode": null,
- "electronicAddressScheme": null,
- "contactPoint": null,
- "contactEmailAddress": null,
- "contactTelephoneNumber": null,
- "vatIdentifier": null,
- "identifier": null,
- "identifierScheme": null
}, - "seller": {
- "name": "string",
- "electronicAddress": "string",
- "addressLine1": "string",
- "addressLine2": null,
- "addressLine3": null,
- "postCode": "string",
- "city": "string",
- "countryCode": "string",
- "electronicAddressScheme": null,
- "contactPoint": "string",
- "contactEmailAddress": "string",
- "contactTelephoneNumber": "string",
- "vatIdentifier": null,
- "identifier": null,
- "identifierScheme": null,
- "additionalLegalInformation": null
}, - "invoiceLine": [
- {
- "identifier": "string",
- "name": "string",
- "quantityUnitMeasureCode": "string",
- "description": null,
- "quantity": null,
- "netPrice": null,
- "priceBaseQuantity": null,
- "vatRate": null,
- "vatCategoryCode": null,
- "netAmount": null,
- "sellersIdentifier": null,
- "buyersIdentifier": null,
- "standardIdentifier": null,
- "standardIdentifierScheme": null,
- "referencedPurchaseOrderLineReference": null,
- "itemAttributes": null,
- "allowance": null,
- "charge": null
}
]
}
}
]
}{- "total": 0,
- "createdCount": 0,
- "failedCount": 0,
- "created": [
- {
- "invoiceId": "string",
- "invoiceNumber": ""
}
], - "errors": [
- {
- "invoiceId": null,
- "error": "string",
- "invoice": { }
}
]
}