Bulk fiscalization lookup by order numbers
curl -X POST https://api.fiscomm.rs/archive/receipts/fiscalization-lookup \ -H "Authorization: Bearer $FISCOMM_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "orderNumbers": ["ORDER-1001"] }'const { records } = await client.archive.fiscalizationLookup(['ORDER-1001']);// records[i].fiscalized === true|false$res = $client->archive()->fiscalizationLookup(['ORDER-1001']);Find latest receipt per order number for a shop/company and return fiscalization status in one request.
Authorizations
Odeljak „Authorizations“Request Bodyrequired
Odeljak „Request Bodyrequired“object
Merchant Pro order numbers for fiscalization lookup
Example
[ "1001", "1002"]Lower bound for sdcDateTime filter (inclusive)
Example
2026-06-01T00:00:00.000ZLimit the lookup to one shop (order numbers repeat between web shops). Resolved from the key for API key authentication.
Example
84852Responses
Odeljak „Responses“Example
{ "records": [ { "orderNumber": "ORDER-1001", "fiscalized": true, "invoiceNumber": "AZM5ZCCR-Dt1Ov2o0-507308", "receiptId": "1895160", "transactionType": "sale", "sdcDateTime": "2026-09-15T16:48:18.972Z" }, { "orderNumber": "UNKNOWN-9", "fiscalized": false, "invoiceNumber": null, "receiptId": null, "transactionType": null, "sdcDateTime": null } ]}Validation or business-rule error. Branch on code: ERR_00202 (input validation), ERR_00701 (items total ≠ payments total), ERR_01010 (rejected by the Tax Administration).
object
HTTP status code.
Machine-readable Fiscomm error code. Examples: ERR_00202 (validation), ERR_00701 (item total does not match payment total), ERR_00002 (internal error).
Technical message describing the error.
Human-friendly message safe to surface to an end user.
Additional structured detail. For validation errors this includes validationErrors: [{ field, message }].
object
Request path.
Correlation id of the request, for support/log lookups.
Example
{ "status": 400, "code": "ERR_00202", "message": "Validation failed", "details": { "validationErrors": [ { "field": "orderNumber", "message": "should not be empty" } ] }, "path": "/receipt/normal/sale", "correlationId": "5cbf3d9f-bd38-4375-89ab-34ed6be68d97"}Missing or invalid API key.
object
HTTP status code.
Machine-readable Fiscomm error code. Examples: ERR_00202 (validation), ERR_00701 (item total does not match payment total), ERR_00002 (internal error).
Technical message describing the error.
Human-friendly message safe to surface to an end user.
Additional structured detail. For validation errors this includes validationErrors: [{ field, message }].
object
Request path.
Correlation id of the request, for support/log lookups.
Example
{ "status": 401, "code": "ERR_00101", "message": "Failed to validate API token", "correlationId": "5cbf3d9f-bd38-4375-89ab-34ed6be68d97"}The API key is valid but has no access to this shop or resource.
object
HTTP status code.
Machine-readable Fiscomm error code. Examples: ERR_00202 (validation), ERR_00701 (item total does not match payment total), ERR_00002 (internal error).
Technical message describing the error.
Human-friendly message safe to surface to an end user.
Additional structured detail. For validation errors this includes validationErrors: [{ field, message }].
object
Request path.
Correlation id of the request, for support/log lookups.
Example
{ "status": 403, "message": "Forbidden — API key has no access to this shop", "correlationId": "5cbf3d9f-bd38-4375-89ab-34ed6be68d97"}The requested resource does not exist.
object
HTTP status code.
Machine-readable Fiscomm error code. Examples: ERR_00202 (validation), ERR_00701 (item total does not match payment total), ERR_00002 (internal error).
Technical message describing the error.
Human-friendly message safe to surface to an end user.
Additional structured detail. For validation errors this includes validationErrors: [{ field, message }].
object
Request path.
Correlation id of the request, for support/log lookups.
Example
{ "status": 404, "code": "NOT_FOUND", "message": "Resource not found", "correlationId": "5cbf3d9f-bd38-4375-89ab-34ed6be68d97"}Internal error. Safe to retry later.
object
HTTP status code.
Machine-readable Fiscomm error code. Examples: ERR_00202 (validation), ERR_00701 (item total does not match payment total), ERR_00002 (internal error).
Technical message describing the error.
Human-friendly message safe to surface to an end user.
Additional structured detail. For validation errors this includes validationErrors: [{ field, message }].
object
Request path.
Correlation id of the request, for support/log lookups.
Example
{ "status": 500, "code": "ERR_00002", "userMessage": "Server error. Please try again later.", "correlationId": "5cbf3d9f-bd38-4375-89ab-34ed6be68d97"}