Reference

Proforma and Training

The bounded workflow for Proforma and Training documents, with a refund that must repeat the whole source document.

2 operations

Issue a Proforma or Training document

post/v1/proforma-training-workflows

Scope proforma-training:writeRequires Idempotency-Key

A Proforma is an offer without tax effect; Training is practice. A Training Sale must not carry a reference; a refund must exactly repeat the source document and identify the buyer.

Contract notes (OpenAPI)

Accepts only Proforma or Training transactions through the dedicated workflow scope. Training Sale forbids a reference. Training Refund must reference an exact Boka-issued Training Sale. Proforma Sale may omit a reference or reference a Boka-issued Proforma Sale or Refund; Proforma Refund must reference a Boka-issued Proforma Sale. Refunds must exactly reproduce every source item and payment, identify the buyer, and only one unresolved or completed full refund may reserve a source. External and legacy references remain outside this bounded workflow. An unknown PFR outcome is terminal for automatic submission and an idempotent replay never creates a second fiscal request.

Request body application/json

createProformaTrainingWorkflow: Request body
Field	Type	Description
`taxpayerId`required	uuid
`businessPremiseId`required	uuid
`clientReference`required	string	min 1max 200
`invoiceType`required	string	`PROFORMATRAINING`Values
`transactionType`required	TransactionType	`SALEREFUND`Values
`cashier`required	Cashier
`id`required	string
`displayName`optional	string
`buyer`optional	Buyer
`id`optional	string	Official prefix and value, for example 10:123456789.
`optionalField`optional	string	Official buyer-cost-center prefix and value where applicable, printed as Опционо поље купца. Allowed only on a Normal Sale: any other invoice type or transaction type is rejected with 422, because the official manual testing procedure lists the field appearing on a receipt that is not a Промет Продаја as a reason to reject an ESIR. A Copy of a Normal Sale that carried it is issued without it for the same reason, and closing an advance case applies it only to the final Normal Sale, never to the closing Advance Refund.
`original`optional	BokaDocumentReference
`source`required	const "BOKA"
`fiscalDocumentId`required	uuid
`items`required	array<LineItem>	min 1 items
`catalogProductId`optional	uuid	Optional; arbitrary inline items are permitted.
`name`required	string	min 1max 2048
`unitOfMeasure`optional	string	Required on every item except the codebook advance literals (10: Аванс (Ђ) and siblings), which are prescribed verbatim without a unit. The API refuses any other item without one (422, Items.UnitOfMeasure) and composes it into the signed item name as name/unit. min 1max 50
`quantity`required	number	V-PFR Decimal(14,3). >= 0.001<= 99999999999.999step 0.001
`unitPrice`required	number	Final gross unit price sent to V-PFR as Decimal(28,4). Boka applies the mandated fiscal rounding rules. >= 0step 0.01
`unitPriceBeforeDiscount`optional	number	Optional Boka-local immutable gross unit price before discount. When present it must be greater than unitPrice; it is displayed outside the exact PFR journal and is never sent as a supplier field. >= 0step 0.0001
`gtin`optional	string	min 8max 14
`taxLabels`required	array<string>	min 1 itemsunique
`payments`required	array<Payment>	min 1 items
`type`required	PaymentType	`OTHERCASHCARDCHECKWIRE_TRANSFERVOUCHERINSTANT_PAYMENT`Values
`amount`required	number	At most two decimals (the V-PFR rejects more with validation code 2804); the field type on the wire is Decimal(28,4). >= 0step 0.01
`commercialFooter`optional	string	max 2000
`metadata`optional	object	Non-fiscal caller metadata.

Example

POST /v1/proforma-training-workflows

curl -X POST "https://api.bokapos.rs/v1/proforma-training-workflows" \
  -H "Authorization: Bearer $BOKAPOS_TOKEN" \
  -H "Idempotency-Key: quote-2210-proforma-1" \
  -H "Content-Type: application/json" \
  -d '{
  "taxpayerId": "3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11",
  "businessPremiseId": "b7d4e2c1-9a3f-4c8e-8f21-6e5a0c9d3b22",
  "clientReference": "QUOTE-2210",
  "invoiceType": "PROFORMA",
  "transactionType": "SALE",
  "cashier": {
    "id": "web-shop"
  },
  "buyer": {
    "id": "10:106952811"
  },
  "items": [
    {
      "name": "Bluetooth slušalice",
      "unitOfMeasure": "kom",
      "quantity": 1,
      "unitPrice": 8990,
      "gtin": "8606012345678",
      "taxLabels": [
        "F"
      ]
    }
  ],
  "payments": [
    {
      "type": "WIRE_TRANSFER",
      "amount": 8990
    }
  ],
  "commercialFooter": "Ponuda važi 7 dana."
}'

Responses

createProformaTrainingWorkflow: Responses
200 OK	Idempotent replay of a completed workflow`ProformaTrainingWorkflow`
201 Created	Fiscalized Proforma or Training document`ProformaTrainingWorkflow`
202 Accepted	The request is durably reserved but has not been submitted`ProformaTrainingWorkflow`
404 Not Found	Resource does not exist within the authenticated tenant scope`ErrorCode`
409 Conflict	Idempotency, source-reservation, or terminal workflow conflict
422 Unprocessable Content	The command violates a Boka or fiscal rule, or PFR definitively rejected the reserved operation
503 Service Unavailable	No fiscal receipt is claimed; the workflow is unavailable or its outcome is unresolved

201 Created

{
  "id": "0a1b2c3d-4e5f-4a6b-8c7d-8e9f0a1b2c3d",
  "taxpayerId": "3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11",
  "businessPremiseId": "b7d4e2c1-9a3f-4c8e-8f21-6e5a0c9d3b22",
  "clientReference": "QUOTE-2210",
  "invoiceType": "PROFORMA",
  "transactionType": "SALE",
  "state": "COMPLETED",
  "original": null,
  "document": {
    "id": "1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e",
    "taxpayerId": "3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11",
    "businessPremiseId": "b7d4e2c1-9a3f-4c8e-8f21-6e5a0c9d3b22",
    "idempotencyKey": "quote-2210-proforma-1",
    "clientReference": "QUOTE-2210",
    "invoiceType": "PROFORMA",
    "transactionType": "SALE",
    "cashierId": "web-shop",
    "buyerId": "10:106952811",
    "buyerDetails": null,
    "status": "FISCALIZED",
    "fiscalized": true,
    "failureCode": null,
    "retryable": false,
    "pfr": {
      "invoiceNumber": "JWX4K9PL-JWX4K9PL-1047",
      "sdcTime": "2026-09-01T10:15:32.483+02:00",
      "requestedBy": "JWX4K9PL",
      "signedBy": "JWX4K9PL",
      "transactionTypeCounter": 902,
      "totalCounter": 1047,
      "invoiceCounterExtension": "ПрП",
      "totalAmount": 8990,
      "totalTax": 890.9009,
      "verificationUrl": "https://sandbox.suf.purs.gov.rs/v/?vl=A0pXWDRLOVBMSldYNEs5UEwSBAAAEAQAAKCLPAAAAAAAAAABnAqJa1EAAAA...",
      "journal": "============ ФИСКАЛНИ РАЧУН ============\n...\nПФР број рачуна:      JWX4K9PL-JWX4K9PL-1047\nБројач рачуна:                902/1047ПрП\n========================================\n======== КРАЈ ФИСКАЛНОГ РАЧУНА ========="
    },
    "receipt": {
      "textUrl": "/v1/fiscal-documents/1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e/representations/official-text",
      "jsonUrl": "/v1/fiscal-documents/1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e/representations/canonical-json",
      "pdfA4Url": "/v1/fiscal-documents/1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e/representations/pdf-a4",
      "pdf80mmUrl": "/v1/fiscal-documents/1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e/representations/pdf-80mm",
      "pdf58mmUrl": "/v1/fiscal-documents/1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e/representations/pdf-58mm",
      "previewImageUrl": "/v1/fiscal-documents/1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e/representations/preview-png",
      "qrImageUrl": "/v1/fiscal-documents/1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e/representations/qr-svg",
      "verificationUrl": "https://sandbox.suf.purs.gov.rs/v/?vl=A0pXWDRLOVBMSldYNEs5UEwSBAAAEAQAAKCLPAAAAAAAAAABnAqJa1EAAAA...",
      "preferredPaperFormat": "a4"
    },
    "createdAt": "2026-09-01T08:15:31.902Z",
    "updatedAt": "2026-09-01T08:15:32.611Z"
  },
  "failureCode": null,
  "createdAt": "2026-09-02T07:02:10.000Z",
  "updatedAt": "2026-09-02T07:02:11.204Z"
}

Examples

training

POST /v1/proforma-training-workflows

curl -X POST "https://api.bokapos.rs/v1/proforma-training-workflows" \
  -H "Authorization: Bearer $BOKAPOS_TOKEN" \
  -H "Idempotency-Key: training-2026-09-02-1" \
  -H "Content-Type: application/json" \
  -d '{
  "taxpayerId": "3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11",
  "businessPremiseId": "b7d4e2c1-9a3f-4c8e-8f21-6e5a0c9d3b22",
  "clientReference": "TRAINING-1",
  "invoiceType": "TRAINING",
  "transactionType": "SALE",
  "cashier": {
    "id": "operater-1"
  },
  "items": [
    {
      "name": "Test artikal",
      "unitOfMeasure": "kom",
      "quantity": 1,
      "unitPrice": 100,
      "taxLabels": [
        "F"
      ]
    }
  ],
  "payments": [
    {
      "type": "CASH",
      "amount": 100
    }
  ]
}'

201 Created

{
  "id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
  "taxpayerId": "3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11",
  "businessPremiseId": "b7d4e2c1-9a3f-4c8e-8f21-6e5a0c9d3b22",
  "clientReference": "TRAINING-1",
  "invoiceType": "TRAINING",
  "transactionType": "SALE",
  "state": "COMPLETED",
  "original": null,
  "document": {
    "id": "3d4e5f6a-7b8c-4d9e-8f0a-1b2c3d4e5f6a",
    "taxpayerId": "3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11",
    "businessPremiseId": "b7d4e2c1-9a3f-4c8e-8f21-6e5a0c9d3b22",
    "idempotencyKey": "training-2026-09-02-1",
    "clientReference": "TRAINING-1",
    "invoiceType": "TRAINING",
    "transactionType": "SALE",
    "cashierId": "web-shop",
    "buyerId": null,
    "buyerDetails": null,
    "status": "FISCALIZED",
    "fiscalized": true,
    "failureCode": null,
    "retryable": false,
    "pfr": {
      "invoiceNumber": "JWX4K9PL-JWX4K9PL-1048",
      "sdcTime": "2026-09-01T10:15:32.483+02:00",
      "requestedBy": "JWX4K9PL",
      "signedBy": "JWX4K9PL",
      "transactionTypeCounter": 903,
      "totalCounter": 1048,
      "invoiceCounterExtension": "ОП",
      "totalAmount": 100,
      "totalTax": 9.9099,
      "verificationUrl": "https://sandbox.suf.purs.gov.rs/v/?vl=A0pXWDRLOVBMSldYNEs5UEwSBAAAEAQAAKCLPAAAAAAAAAABnAqJa1EAAAA...",
      "journal": "============ ФИСКАЛНИ РАЧУН ============\n...\nПФР број рачуна:      JWX4K9PL-JWX4K9PL-1048\nБројач рачуна:                903/1048ОП\n========================================\n======== КРАЈ ФИСКАЛНОГ РАЧУНА ========="
    },
    "receipt": {
      "textUrl": "/v1/fiscal-documents/3d4e5f6a-7b8c-4d9e-8f0a-1b2c3d4e5f6a/representations/official-text",
      "jsonUrl": "/v1/fiscal-documents/3d4e5f6a-7b8c-4d9e-8f0a-1b2c3d4e5f6a/representations/canonical-json",
      "pdfA4Url": "/v1/fiscal-documents/3d4e5f6a-7b8c-4d9e-8f0a-1b2c3d4e5f6a/representations/pdf-a4",
      "pdf80mmUrl": "/v1/fiscal-documents/3d4e5f6a-7b8c-4d9e-8f0a-1b2c3d4e5f6a/representations/pdf-80mm",
      "pdf58mmUrl": "/v1/fiscal-documents/3d4e5f6a-7b8c-4d9e-8f0a-1b2c3d4e5f6a/representations/pdf-58mm",
      "previewImageUrl": "/v1/fiscal-documents/3d4e5f6a-7b8c-4d9e-8f0a-1b2c3d4e5f6a/representations/preview-png",
      "qrImageUrl": "/v1/fiscal-documents/3d4e5f6a-7b8c-4d9e-8f0a-1b2c3d4e5f6a/representations/qr-svg",
      "verificationUrl": "https://sandbox.suf.purs.gov.rs/v/?vl=A0pXWDRLOVBMSldYNEs5UEwSBAAAEAQAAKCLPAAAAAAAAAABnAqJa1EAAAA...",
      "preferredPaperFormat": "a4"
    },
    "createdAt": "2026-09-01T08:15:31.902Z",
    "updatedAt": "2026-09-01T08:15:32.611Z"
  },
  "failureCode": null,
  "createdAt": "2026-09-02T07:10:00.000Z",
  "updatedAt": "2026-09-02T07:10:01.100Z"
}

Response: ProformaTrainingWorkflow

Field descriptions come from the OpenAPI contract; field names and values are identical in both languages.

createProformaTrainingWorkflow: Response
Field	Type	Description
`id`required	uuid
`taxpayerId`required	uuid
`businessPremiseId`required	uuid
`clientReference`required	string
`invoiceType`required	string	`PROFORMATRAINING`Values
`transactionType`required	TransactionType	`SALEREFUND`Values
`state`required	string	`PENDINGCOMPLETEDOUTCOME_UNKNOWNREJECTEDFAILED`Values
`original`optional	ProformaTrainingWorkflowOriginal\| null (nullable)
`source`required	const "BOKA"
`fiscalDocumentId`required	uuid
`pfrNumber`required	string
`pfrTime`required	date-time
`invoiceType`required	string	`PROFORMATRAINING`Values
`transactionType`required	TransactionType	`SALEREFUND`Values
`document`required	FiscalDocument
`id`required	uuid
`taxpayerId`required	uuid
`businessPremiseId`required	uuid
`idempotencyKey`required	string
`clientReference`required	string
`invoiceType`required	InvoiceType	`NORMALPROFORMACOPYTRAININGADVANCE`Values
`transactionType`required	TransactionType	`SALEREFUND`Values
`cashierId`required	string
`buyerId`optional	string\| null (nullable)
`buyerDetails`optional	FiscalBuyerDetails\| null (nullable)	The buyer's company-registry facts stored with the document at reservation and printed under the buyer identification. Null when the buyer is not a domestic company (prefixes 10, 12, 14 with a valid PIB) or the register could not answer at issuance.
`legalName`required	string	max 350
`taxIdentifier`required	string	pattern ^[0-9]{9}$
`registrationNumber`optional	string\| null (nullable)	pattern ^[0-9]{8}$
`address`optional	string\| null (nullable)	max 300
`city`optional	string\| null (nullable)	max 100
`source`required	string	`nbs-jrr`Values
`resolvedAt`required	date-time
`status`required	FiscalDocumentStatus	`RECEIVEDVALIDATEDSUBMITTINGFISCALIZEDREJECTEDNOT_FISCALIZEDOUTCOME_UNKNOWNRECONCILING`Values
`fiscalized`required	boolean
`failureCode`optional	string\| null (nullable)
`pfrRejection`optional	object\| null (nullable)	Present only on a single-document read of a REJECTED operation. The V-PFR's own validation result, bounded to the property path of the caller's request and the supplier's numeric codes (2310 invalid tax label; 2800 to 2808 required, length, range, value, format and list-size validation). Lists never carry it.
`items`required	array<object>	max 10 items
`property`required	string	max 120
`codes`required	array<string>	max 5 items
`retryable`required	boolean
`pfr`optional	PfrResult\| null (nullable)
`invoiceNumber`required	string
`sdcTime`required	date-time
`requestedBy`required	string
`signedBy`required	string
`transactionTypeCounter`optional	integer\| null (nullable)	V-PFR transaction-type counter (the left half of the printed counter). Null when the stored receipt does not carry it; the printed counter is always in the journal text.
`totalCounter`optional	integer\| null (nullable)	V-PFR total counter (the right half of the printed counter and the last segment of invoiceNumber). Null under the same condition as transactionTypeCounter.
`invoiceCounterExtension`optional	string\| null (nullable)	Official Cyrillic invoice/transaction type pair printed after the counter (ПП, ПР, АП, АР, КП, КР, ОП, ОР, РП, РР). Null under the same condition as transactionTypeCounter.
`totalAmount`required	number
`totalTax`optional	number\| null (nullable)	Sum of the V-PFR signed tax amounts of the document (the printed "Укупан износ пореза" before its two-decimal display rounding). Null under the same condition as transactionTypeCounter.
`verificationUrl`required	uri
`journal`required	string
`receipt`optional	ReceiptRepresentations\| null (nullable)
`textUrl`required	uri-reference
`jsonUrl`required	uri-reference
`pdfA4Url`required	uri-reference
`pdf80mmUrl`required	uri-reference
`pdf58mmUrl`required	uri-reference
`previewImageUrl`required	uri-reference
`qrImageUrl`required	uri-reference
`verificationUrl`required	uri
`preferredPaperFormat`required	string	Immutable preferred print/PDF format captured when this fiscal operation was reserved. `80mm58mma4`Values
`reference`optional	ResolvedReference
`fiscalDocumentId`optional	uuid
`pfrNumber`required	string
`pfrTime`required	date-time
`createdAt`required	date-time
`updatedAt`required	date-time
`failureCode`optional	string\| null (nullable)
`createdAt`required	date-time
`updatedAt`required	date-time

Read a Proforma or Training workflow

get/v1/proforma-training-workflows/{proformaTrainingWorkflowId}

Scope fiscal:read

The workflow state and its document, including OUTCOME_UNKNOWN which a system must resolve before another attempt.

Parameters

getProformaTrainingWorkflow: Parameters
Field	In	Type	Description
`proformaTrainingWorkflowId`required	path	uuid

Example

GET /v1/proforma-training-workflows/{proformaTrainingWorkflowId}

curl -X GET "https://api.bokapos.rs/v1/proforma-training-workflows/0a1b2c3d-4e5f-4a6b-8c7d-8e9f0a1b2c3d" \
  -H "Authorization: Bearer $BOKAPOS_TOKEN"

Responses

getProformaTrainingWorkflow: Responses
200 OK	Persisted workflow and fiscal-document state`ProformaTrainingWorkflow`
404 Not Found	Resource does not exist within the authenticated tenant scope`ErrorCode`

200 OK

{
  "id": "0a1b2c3d-4e5f-4a6b-8c7d-8e9f0a1b2c3d",
  "taxpayerId": "3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11",
  "businessPremiseId": "b7d4e2c1-9a3f-4c8e-8f21-6e5a0c9d3b22",
  "clientReference": "QUOTE-2210",
  "invoiceType": "PROFORMA",
  "transactionType": "SALE",
  "state": "COMPLETED",
  "original": null,
  "document": {
    "id": "1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e",
    "taxpayerId": "3f9c2a8e-6b1d-4e5a-9c47-1d2b8e6f0a11",
    "businessPremiseId": "b7d4e2c1-9a3f-4c8e-8f21-6e5a0c9d3b22",
    "idempotencyKey": "quote-2210-proforma-1",
    "clientReference": "QUOTE-2210",
    "invoiceType": "PROFORMA",
    "transactionType": "SALE",
    "cashierId": "web-shop",
    "buyerId": "10:106952811",
    "buyerDetails": null,
    "status": "FISCALIZED",
    "fiscalized": true,
    "failureCode": null,
    "retryable": false,
    "pfr": {
      "invoiceNumber": "JWX4K9PL-JWX4K9PL-1047",
      "sdcTime": "2026-09-01T10:15:32.483+02:00",
      "requestedBy": "JWX4K9PL",
      "signedBy": "JWX4K9PL",
      "transactionTypeCounter": 902,
      "totalCounter": 1047,
      "invoiceCounterExtension": "ПрП",
      "totalAmount": 8990,
      "totalTax": 890.9009,
      "verificationUrl": "https://sandbox.suf.purs.gov.rs/v/?vl=A0pXWDRLOVBMSldYNEs5UEwSBAAAEAQAAKCLPAAAAAAAAAABnAqJa1EAAAA...",
      "journal": "============ ФИСКАЛНИ РАЧУН ============\n...\nПФР број рачуна:      JWX4K9PL-JWX4K9PL-1047\nБројач рачуна:                902/1047ПрП\n========================================\n======== КРАЈ ФИСКАЛНОГ РАЧУНА ========="
    },
    "receipt": {
      "textUrl": "/v1/fiscal-documents/1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e/representations/official-text",
      "jsonUrl": "/v1/fiscal-documents/1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e/representations/canonical-json",
      "pdfA4Url": "/v1/fiscal-documents/1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e/representations/pdf-a4",
      "pdf80mmUrl": "/v1/fiscal-documents/1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e/representations/pdf-80mm",
      "pdf58mmUrl": "/v1/fiscal-documents/1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e/representations/pdf-58mm",
      "previewImageUrl": "/v1/fiscal-documents/1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e/representations/preview-png",
      "qrImageUrl": "/v1/fiscal-documents/1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e/representations/qr-svg",
      "verificationUrl": "https://sandbox.suf.purs.gov.rs/v/?vl=A0pXWDRLOVBMSldYNEs5UEwSBAAAEAQAAKCLPAAAAAAAAAABnAqJa1EAAAA...",
      "preferredPaperFormat": "a4"
    },
    "createdAt": "2026-09-01T08:15:31.902Z",
    "updatedAt": "2026-09-01T08:15:32.611Z"
  },
  "failureCode": null,
  "createdAt": "2026-09-02T07:02:10.000Z",
  "updatedAt": "2026-09-02T07:02:11.204Z"
}

Response: ProformaTrainingWorkflow

Field descriptions come from the OpenAPI contract; field names and values are identical in both languages.

getProformaTrainingWorkflow: Response
Field	Type	Description
`id`required	uuid
`taxpayerId`required	uuid
`businessPremiseId`required	uuid
`clientReference`required	string
`invoiceType`required	string	`PROFORMATRAINING`Values
`transactionType`required	TransactionType	`SALEREFUND`Values
`state`required	string	`PENDINGCOMPLETEDOUTCOME_UNKNOWNREJECTEDFAILED`Values
`original`optional	ProformaTrainingWorkflowOriginal\| null (nullable)
`source`required	const "BOKA"
`fiscalDocumentId`required	uuid
`pfrNumber`required	string
`pfrTime`required	date-time
`invoiceType`required	string	`PROFORMATRAINING`Values
`transactionType`required	TransactionType	`SALEREFUND`Values
`document`required	FiscalDocument
`id`required	uuid
`taxpayerId`required	uuid
`businessPremiseId`required	uuid
`idempotencyKey`required	string
`clientReference`required	string
`invoiceType`required	InvoiceType	`NORMALPROFORMACOPYTRAININGADVANCE`Values
`transactionType`required	TransactionType	`SALEREFUND`Values
`cashierId`required	string
`buyerId`optional	string\| null (nullable)
`buyerDetails`optional	FiscalBuyerDetails\| null (nullable)	The buyer's company-registry facts stored with the document at reservation and printed under the buyer identification. Null when the buyer is not a domestic company (prefixes 10, 12, 14 with a valid PIB) or the register could not answer at issuance.
`legalName`required	string	max 350
`taxIdentifier`required	string	pattern ^[0-9]{9}$
`registrationNumber`optional	string\| null (nullable)	pattern ^[0-9]{8}$
`address`optional	string\| null (nullable)	max 300
`city`optional	string\| null (nullable)	max 100
`source`required	string	`nbs-jrr`Values
`resolvedAt`required	date-time
`status`required	FiscalDocumentStatus	`RECEIVEDVALIDATEDSUBMITTINGFISCALIZEDREJECTEDNOT_FISCALIZEDOUTCOME_UNKNOWNRECONCILING`Values
`fiscalized`required	boolean
`failureCode`optional	string\| null (nullable)
`pfrRejection`optional	object\| null (nullable)	Present only on a single-document read of a REJECTED operation. The V-PFR's own validation result, bounded to the property path of the caller's request and the supplier's numeric codes (2310 invalid tax label; 2800 to 2808 required, length, range, value, format and list-size validation). Lists never carry it.
`items`required	array<object>	max 10 items
`property`required	string	max 120
`codes`required	array<string>	max 5 items
`retryable`required	boolean
`pfr`optional	PfrResult\| null (nullable)
`invoiceNumber`required	string
`sdcTime`required	date-time
`requestedBy`required	string
`signedBy`required	string
`transactionTypeCounter`optional	integer\| null (nullable)	V-PFR transaction-type counter (the left half of the printed counter). Null when the stored receipt does not carry it; the printed counter is always in the journal text.
`totalCounter`optional	integer\| null (nullable)	V-PFR total counter (the right half of the printed counter and the last segment of invoiceNumber). Null under the same condition as transactionTypeCounter.
`invoiceCounterExtension`optional	string\| null (nullable)	Official Cyrillic invoice/transaction type pair printed after the counter (ПП, ПР, АП, АР, КП, КР, ОП, ОР, РП, РР). Null under the same condition as transactionTypeCounter.
`totalAmount`required	number
`totalTax`optional	number\| null (nullable)	Sum of the V-PFR signed tax amounts of the document (the printed "Укупан износ пореза" before its two-decimal display rounding). Null under the same condition as transactionTypeCounter.
`verificationUrl`required	uri
`journal`required	string
`receipt`optional	ReceiptRepresentations\| null (nullable)
`textUrl`required	uri-reference
`jsonUrl`required	uri-reference
`pdfA4Url`required	uri-reference
`pdf80mmUrl`required	uri-reference
`pdf58mmUrl`required	uri-reference
`previewImageUrl`required	uri-reference
`qrImageUrl`required	uri-reference
`verificationUrl`required	uri
`preferredPaperFormat`required	string	Immutable preferred print/PDF format captured when this fiscal operation was reserved. `80mm58mma4`Values
`reference`optional	ResolvedReference
`fiscalDocumentId`optional	uuid
`pfrNumber`required	string
`pfrTime`required	date-time
`createdAt`required	date-time
`updatedAt`required	date-time
`failureCode`optional	string\| null (nullable)
`createdAt`required	date-time
`updatedAt`required	date-time