Advanced Search
Search Results
61 total results found
Error Codes & Security (S16-S17)
ยง16 โ Error codes XPOS ESDC returns only the prescribed FRCS error codes; any manufacturer-specific message is listed in the User Manual. Representative mappings: CodeMeaning 1300No card / Secure Element not present 1500PIN required 2100 / 2110PIN incorrect ...
Overview & Integration Flow
XPOS ESDC exposes a local HTTP service that a Point of Sale (the built-in POS, or your own POS/ERP) uses to fiscalise sales. This guide is the integration reference for developers building against that service. Base URL The service listens on port 8888 on all...
Status & Session
These endpoints establish that the SDC is ready and unlock signing for the session. GET /api/v3/attention Lightweight health check. Returns whether the SDC is available and which card readers are connected. GET /api/v3/attention 200 OK { "available": true,...
Signing an Invoice
The core endpoint. Signs a sale on the Secure Element and returns the fiscal result (verification URL, QR, journal, signature). Requires a PIN previously verified via POST /api/v3/pin. POST /api/v3/invoices Content-Type: application/json RequestId: 4b1e...uni...
Errors, Response Codes & Validation
The SDC uses two error shapes: field validation errors (HTTP 400) and operational response codes (in the body/status). Validation errors (HTTP 400) When a request fails structural or business validation, the SDC returns HTTP 400 with a modelState array โ one ...
History & Reports
Read-back endpoints for reprinting, reconciliation and reporting. These query stored records and do not touch the card. Invoice history GET /api/v3/invoices?from=2026-08-01&to=2026-08-13&uid=EKLBHT3Y Returns fiscalised invoice records for the period (defaults...
Legacy V2 API
The Legacy V2 API exists for compatibility with older POS integrations (the FiscoBridge-era contract). New integrations should use v3. V2 signing reuses the exact same fiscalisation pipeline as v3 โ only the request parser and the returned result shape differ....