API Cloud: comenzi

Comenzi

Starea și rezultatul unei comenzi, și listele de comenzi.

Rute

GET …/cash-registers/{serialNumber}/commands/{commandId}get-command
GET …/cash-registers/{serialNumber}/commandslist-register-commands
GET …/commandslist-commands

Resursa GetCommandStatusResponse

commandIduuiddoar citire: Id-ul comenzii.
retryOfCommandIduuidpoate fi nulldoar citire: Id-ul inițial, când comanda a înlocuit alta sub un id nou (de exemplu un bon refuzat pentru lipsă de hârtie). Dacă ceri id-ul inițial, primești comanda nouă. null altfel. Nu apare pe sandbox.
requestIdstringpoate fi nulldoar citire: Idempotency-Key-ul cu care a fost creată comanda: al tău sau, pentru o retrimitere care înlocuiește o comandă eșuată, al celei inițiale. null dacă n-ai trimis unul.
commandTypestringdoar citire: Felul comenzii.; cashRegister.printReportZ Raport Z.
cashRegister.printReportX Raport X.
cashRegister.printFiscalReceipt Bon fiscal.
cashRegister.printNonFiscalReceipt Bon nefiscal.
cashRegister.readVatRates Citire cote TVA.
cashRegister.cashIn Intrare de numerar.
cashRegister.cashOut Ieșire de numerar.
cashRegister.openDrawer Deschidere sertar.
serialNumberstringdoar citire: Seria fiscală a casei.
statusstringdoar citire: Starea comenzii.; Pending În coadă.
Processing Casa o execută.
Sent Stare veche; nu se mai scrie.
Failed A eșuat.
Cancelled Anulată.
Succeeded A reușit.
TimedOut A expirat fără răspuns.
createdAtdatetimedoar citire: Când a fost creată, în UTC.
completedAtdatetimepoate fi nulldoar citire: Când s-a terminat, în UTC.
statusCodeintegerpoate fi nulldoar citire: Codul de stare dat de casă, același ca pe API-ul local.
contentTypestringpoate fi nulldoar citire: Tipul conținutului din body.
bodyobjectpoate fi nulldoar citire: Răspunsul casei, de obicei plicul {statusCode, data}. Mai poate fi o eroare de transport (cloud-framing-error) sau un text.
messagestringpoate fi nulldoar citire: Explicația stării.
payloadobjectpoate fi nulldoar citire: Corpul comenzii, exact cum l-ai trimis.
traceobjectpoate fi nulldoar citire: Cu o cheie API e mereu null.

Obiecte folosite aici

GetCommandStatusResponse

{
  "commandId": "c3a9f1e7-5d2b-4c8a-9e61-0f1a2b3c4d5e",
  "retryOfCommandId": "string",
  "requestId": "3f2c1a9e-7b4d-4e8a-9c21-5d6f7a8b9c0d",
  "commandType": "cashRegister.printReportZ",
  "serialNumber": "DT000001",
  "status": "Pending",
  "createdAt": "2026-09-25T09:15:01.221Z",
  "completedAt": "2026-09-25T09:15:03.870Z",
  "statusCode": 200,
  "contentType": "application/json",
  "body": {
    "statusCode": 200,
    "data": {},
    "replayedFromCommandId": "string",
    "code": "receipt_outcome_unknown"
  },
  "message": "string",
  "payload": {},
  "trace": {}
}

Rute

GET …/cash-registers/{serialNumber}/commands/{commandId} Sincron

`get-command`

Starea unei comenzi: status, codul casei și răspunsul ei.

Câmp	Descriere
`commandId`	ID-ul comenzii.
`retryOfCommandId`	La o reîncercare automată din lipsă de hârtie: ID-ul primei comenzi, cea primită de tine. `null` la comenzile obișnuite.
`commandType`	`cashRegister.printFiscalReceipt`, `cashRegister.printNonFiscalReceipt`, `cashRegister.printReportZ`, `cashRegister.printReportX` sau `cashRegister.readVatRates`.
`status`	Starea, vezi „Ciclul unei comenzi”.
`createdAt` / `completedAt`	Când a intrat în coadă / când a ajuns într-o stare finală.
`statusCode`	Codul raportat de casă: vezi „Rezultatul unei comenzi”.
`body`	Răspunsul casei, așa cum a venit.
`message`	Textul casei, din `body.message`; `null` la succes.
`payload`	Corpul trimis de tine; `null` la comenzile fără corp.
`trace`	Mereu `null` pentru cheile API.

GETCerere

curl -X GET 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/cash-registers/DT000001/commands/c3a9f1e7-5d2b-4c8a-9e61-0f1a2b3c4d5e' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY'

200Starea unei comenzi — get-command, 200

{
  "commandId": "c3a9f1e7-5d2b-4c8a-9e61-0f1a2b3c4d5e",
  "retryOfCommandId": null,
  "requestId": "3f2c1a9e-7b4d-4e8a-9c21-5d6f7a8b9c0d",
  "commandType": "cashRegister.printFiscalReceipt",
  "serialNumber": "DT000001",
  "status": "Succeeded",
  "createdAt": "2026-09-25T09:15:01.221Z",
  "completedAt": "2026-09-25T09:15:03.870Z",
  "statusCode": 200,
  "contentType": "application/json",
  "body": {
    "statusCode": 200,
    "data": {
      "message": "Receipt printed successfully.",
      "receiptNumber": null,
      "subtotal": null,
      "total": null,
      "paymentFinalized": null,
      "vatBreakdown": null,
      "pluItems": null,
      "nZrep": null,
      "nFNum": null,
      "brand": "Datecs",
      "printedAt": "2026-09-25T09:15:03.870Z",
      "debugCloseFields": null
    }
  },
  "message": null,
  "payload": { "receiptItems": [{ "type": 1, "pluSale": { "pluNumber": 101, "quantity": 2 } }] },
  "trace": null
}

GET …/cash-registers/{serialNumber}/commands Sincron

`list-register-commands`

Comenzile tale către această serie, cele mai noi primele, paginat. Filtre: status (repetabil), type, from, to. O serie pe care n-ai comandat-o răspunde cu o pagină goală, nu 404.

Răspuns PaginatedResponse
Răspuns IntegratorCommandListItemResponse
Cerere RegisterCommandsQuery

GETCerere

curl -X GET 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/cash-registers/DT000001/commands' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY'

200Răspuns

{
  "page": 1,
  "pageSize": 20,
  "total": 1,
  "items": []
}

GET …/commands Sincron

`list-commands`

Toate comenzile organizației, pe toată flota, paginat. Filtre: status, type, from, to, serialNumber, registerId.

Răspuns PaginatedResponse
Răspuns IntegratorCommandListItemResponse
Cerere IntegratorCommandsQuery

GETCerere

curl -X GET 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/commands' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY'

200Răspuns

{
  "page": 1,
  "pageSize": 20,
  "total": 1,
  "items": []
}