Download OpenAPI specification:
The OktoPOS Manager TransactionAPI provides a way to get transactions from the OktoPOS Manager for third party applications.
All functions in this API require a valid authentication token. You can find
this token in your instance of OktoPOS Manager in OktoPOS -> System.
Clarified path parameter descriptions for the transactions endpoint to explicitly state that all path parameters are optional.
| identifier required | string |
[- {
- "referenceNumber": "string",
- "type": "sales",
- "training": false,
- "cashier": {
- "id": 0,
- "name": "string"
}, - "customer": {
- "id": 0,
- "name": "string",
- "externalIdentifier": "string"
}, - "items": [
- {
- "id": 0,
- "product": {
- "id": 87896,
- "name": "Filet Mignon",
- "externalReference": "12345",
- "scannedBarcode": "2001234567893"
}, - "distributionChannel": "INHOUSE",
- "quantity": 3,
- "price": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "discount": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "tax": {
- "id": 0,
- "amount": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "turnoverType": "sales"
}, - "position": "string"
}
], - "payments": [
- {
- "id": 0,
- "amount": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "method": {
- "name": "Rechnung",
- "token": "INVOICE"
}, - "subType": "restaurant gutschein"
}
], - "taxes": [
- {
- "gross": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "tax": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "net": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "rate": 0
}
], - "gross": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "businessDay": "2008-02-01",
- "transactionDate": {
- "timestamp": "2019-08-24T14:15:22Z",
- "timezone": "Europe/Berlin"
}
}
]All results are sorted by date of sale.
All filter parameters are optional and can be omitted. If a parameter is not used, the entire segment of the URL corresponding to that parameter must also be removed.
| from required | string <date-time> Example: 2021-12-01T12:00:00 Earliest date of sale for transactions to fetch. |
| until required | string <date-time> Example: 2021-12-15T12:00:00 Latest date of sale for transaction to fetch. |
| page required | integer Default: 1 Example: 1 The page to return for the current filter and page size. |
| size required | integer Default: 50 Example: 100 Number of items on one page. The maximum amount of items for a single page may be limited by system settings. |
| cash-register required | integer Example: 1 Id of cashregister. If omitted transactions for all cashregister allowed to access will be returned. |
[- {
- "fromDate": "2021-12-01T12:00:00",
- "untilDate": "2021-12-15T12:00:00",
- "cashRegisterId": 5,
- "actualPage": 1,
- "transactionsPerPage": 50,
- "lastPage": 1,
- "transactionCount": 1,
- "transactions": [
- {
- "referenceNumber": "string",
- "type": "sales",
- "training": false,
- "cashier": {
- "id": 0,
- "name": "string"
}, - "customer": {
- "id": 0,
- "name": "string",
- "externalIdentifier": "string"
}, - "items": [
- {
- "id": 0,
- "product": {
- "id": 87896,
- "name": "Filet Mignon",
- "externalReference": "12345",
- "scannedBarcode": "2001234567893"
}, - "distributionChannel": "INHOUSE",
- "quantity": 3,
- "price": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "discount": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "tax": {
- "id": 0,
- "amount": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "turnoverType": "sales"
}, - "position": "string"
}
], - "payments": [
- {
- "id": 0,
- "amount": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "method": {
- "name": "Rechnung",
- "token": "INVOICE"
}, - "subType": "restaurant gutschein"
}
], - "taxes": [
- {
- "gross": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "tax": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "net": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "rate": 0
}
], - "gross": {
- "currency": {
- "code": "EUR"
}, - "decimal": 17.23,
- "string": "17.23"
}, - "businessDay": "2008-02-01",
- "transactionDate": {
- "timestamp": "2019-08-24T14:15:22Z",
- "timezone": "Europe/Berlin"
}
}
]
}
]