Fiskaliza
Referenca e API-sëDokumentet e kuponit

Issue a marked receipt copy

Records a new immutable, visibly marked COPY of the coupon. ORIGINAL is issued automatically by sale, return, and cancellation creation and cannot be created here. Replaying the same business-scoped key and locale returns the same copy; changing locale conflicts. The request has no body.

POST/v1/commands/{command_id}/receipt-documents

Records a new immutable, visibly marked COPY of the coupon. ORIGINAL is issued automatically by sale, return, and cancellation creation and cannot be created here. Replaying the same business-scoped key and locale returns the same copy; changing locale conflicts. The request has no body.

Authorization

fiskalizaKey fiskaliza:receipts:issue
AuthorizationBearer <token>

An opaque Fiskaliza API key. Each operation lists the capabilities required on that key.

In: header

Scope: fiskaliza:receipts:issue

Path Parameters

command_id*string

Query Parameters

locale?unknown

Language of the server-rendered coupon. Defaults to Albanian.

Default"sq"

Value in

  • "sq"
  • "sr-Latn"
  • "en"

Header Parameters

Idempotency-Key*string

Reuse with the same request to replay the result. Changed input returns idempotency_conflict. Scoped to the business for POS onboarding and receipt documents, and to the POS for commands. Command creation also deduplicates by external_id within that POS; a matching request replays the existing command even with a different idempotency key.

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/commands/string/receipt-documents" \  -H "Idempotency-Key: string"
{  "success": true,  "warnings": [    "string"  ],  "data": {    "receipt_document": {      "id": "string",      "command_id": "string",      "locale": "sq",      "kind": "ORIGINAL",      "pdf_url": "/v1/receipt-documents/{id}/pdf",      "pdf_sha256": "string",      "issued_at": "2019-08-24T14:15:22Z"    }  }}