Skip to content

EET

Receipts sent to the EET evidence (sales registration) and their delivery state. Requires the active eetV2 module in the e-shop.

A record in state pending or sending is still waiting for the tax administration's answer; registered, rejected and failed are final unless the record is sent again. lastError explains a rejection or a failure, deadlineMissedAt is set when the legal sending deadline was missed.

Records sent to the playground environment are tests: they are never legally valid, even when confirmed. Use isLegallyValid to tell a legally registered receipt apart.

Amounts in price are always in CZK, as price strings with two decimals. A sale in another currency also carries sourceCurrency with the original amount and the exchange rate used.

Operations

List of EET records

Request

Returns the receipts sent to the EET evidence (sales registration), newest receipt first, with their delivery state. All filters are optional and are combined with AND.

The list supports Paging. The endpoint requires the active eetV2 module in the e-shop; records stay listed even after the EET evidence is switched off in the e-shop settings.

Security
shoptetAccessToken or shoptetPrivateApiToken
Query
receiptedAtFromstring

time of the sale, in ISO 8601 format, lower limit (inclusive). Optional.

Example:receiptedAtFrom=2026-10-01T00:00:00+0200
receiptedAtTostring

time of the sale, in ISO 8601 format, upper limit (inclusive). Must not be earlier than receiptedAtFrom. Optional.

Example:receiptedAtTo=2026-10-31T23:59:59+0100
statesstring

filtering according to delivery state; comma-separated list, a record matches any of the given states. Allowed values: pending, sending, registered, rejected, failed. Optional.

Example:states=rejected,failed
sourcestring

filtering according to where the receipt originated. Optional.

Enum:"cash_register""pos_terminal""eshop""manual""api"
Example:source=cash_register
evidenceUnitIdinteger

filtering according to EET evidence unit identifier. Optional.

Example:evidenceUnitId=3
deviceIdstring

filtering according to cash desk identifier, exact match. Optional.

Example:deviceId=POKLADNA01
paymentMethodGuidstring

filtering according to payment method identifier. An unknown identifier returns an empty list. Optional.

Example:paymentMethodGuid=1b02cb8e-d7b5-11e0-9a5c-feab5ed617ed
adminUserIdinteger

filtering according to administrator identifier. Optional.

Example:adminUserId=12
orderCodestring

filtering according to order code, exact match. Optional.

Example:orderCode=2026000017
itemsPerPageinteger

Returned items per page. Default and max value is 20.

Example:itemsPerPage=15
pageinteger

Page number to return. Default value is 1.

Example:page=3
Headers
Content-Typestringrequired
Default:"application/json"
curl -i -X GET \
  'https://api.docs.shoptet.com/_mock/shoptet-api/openapi/api/eet/records?receiptedAtFrom=2026-10-01T00%3A00%3A00%2B0200&receiptedAtTo=2026-10-31T23%3A59%3A59%2B0100&states=rejected%2Cfailed&source=cash_register&evidenceUnitId=3&deviceId=POKLADNA01&paymentMethodGuid=1b02cb8e-d7b5-11e0-9a5c-feab5ed617ed&adminUserId=12&orderCode=2026000017&itemsPerPage=15&page=3' \
  -H 'Content-Type: application/json' \
  -H 'Shoptet-Access-Token: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
dataobjectrequired
errorsArray of objects or null(Errors)required
metadataobject(Metadata)required
Response
{
  "data": {
    "records": [ … ],
    "paginator": { … }
  },
  "errors": [
    { … }
  ],
  "metadata": {
    "requestId": "019c8c34-64f3-7328-af43-bf1e34fa39d7"
  }
}