# easyPos integration documentation

> Official developer documentation for easyPos fiscalization and easyInvoice integrations in Albania.

## Cloud Fiscalization API

- Human documentation: https://easypos.al/api/cloud
- OpenAPI 3.0 specification: https://easypos.al/api/downloads/easypos-cloud-api.openapi.yaml
- Full AI field and recovery reference: https://easypos.al/api/downloads/easypos-cloud-api.llms.txt
- Postman collection: https://easypos.al/api/downloads/easypos-cloud-api.postman_collection.json
- Measurement unit codes for `soldIn`: https://easypos.al/downloads/lista-e-njesive-matese.xlsx
- Development base URL: https://api.dev.easypos.al/fiscalisation-service/v1
- Production base URL: https://api.easypos.al/fiscalisation-service/v1

Authentication uses `Authorization: Bearer <access-token>`, `Content-Type: application/json`,
and the stable `integration-app` identifier assigned to the integration.

Create and persist a unique `docId` before the first request. On timeout, connection loss,
HTTP 502/503, or an incomplete electronic response, query `/invoice/status` with the same
`docId`. Replay the original immutable request only when status reports that the document
does not exist. A normal invoice is complete when `fic` is present. An electronic invoice
is complete only when both `fic` and `eic` are present.

## Local integrations

- easyPos Local API and file integration: https://easypos.al/api/easypos
- easyInvoice Local API and file integration: https://easypos.al/api/easyinvoice