{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","description":"Official Postman collection for the easyPos Public Fiscalisation API.\n\n## Base URL\n\n- **Production:** `https://api.easypos.al/fiscalisation-service/v1`\n- **Development:** `https://api.dev.easypos.al/fiscalisation-service/v1`\n\n## Authentication\n\nAll requests require two headers:\n\n| Header | Value |\n|--------|-------|\n| `Authorization` | `Bearer <your-access-token>` |\n| `integration-app` | Your integration app identifier |\n\n---\n\n## Required Fields Summary\n\n### Invoice Registration\n\n| Field | Required | Default | Description |\n|-------|----------|---------|-------------|\n| `docId` | Yes | - | Unique document ID (UUID v4 recommended) |\n| `articles` | Yes | - | Array of articles (min 1) |\n| `payment` | Yes | - | Array of payments (min 1) |\n| `operatorCode` | No | - | Operator code (format: `xx000xx000`) |\n| `currency` | No | `ALL` | Currency object |\n| `buyer` | No | - | Buyer information |\n| `invoiceRebate` | No | - | Invoice-level discount |\n\n### Article Object (all fields required)\n\n| Field | Description |\n|-------|-------------|\n| `articleId` | Product SKU (max 100 chars) |\n| `vatCode` | VAT code: A-L |\n| `name` | Product name (max 100 chars) |\n| `price` | Unit price |\n| `units` | Quantity |\n| `soldIn` | UN/CEFACT unit code |\n| `rebate` | Optional: `{inPercentage}` OR `{inValue}` |\n\n### Payment Object\n\n| Field | Required | Description |\n|-------|----------|-------------|\n| `type` | Yes | `CASH`, `CARD`, `ACCOUNT`, etc. |\n| `amount` | Yes | Payment amount |\n| `details` | For ACCOUNT | Bank account details |\n\n---\n\n## Unit Codes (soldIn)\n\nUses UN/CEFACT codes:\n- `XPP` - Piece\n- `KGM` - Kilogram\n\n## VAT Codes\n\n| Code | Rate | Description |\n|------|------|-------------|\n| A | 0% | Tax Free |\n| B | 20% | Standard Rate |\n| C | 0% | Type 2 Exemption (Articles 53/54) |\n| D | 10% | Reduced Rate |\n| E | 6% | Reduced Rate |\n| F | 0% | Margin Scheme - Travel Agents |\n| G | 0% | Margin Scheme - Art Works |\n| H | 0% | Margin Scheme - Used Goods |\n| I | 0% | Margin Scheme - Collectibles |\n| J | 0% | Export of Goods |\n| K | 0% | Type 1 Exemption (Article 51) |\n\n## Payment Types\n\n- `CASH` / `BANKNOTE` - Cash payment\n- `CARD` - Card payment\n- `ACCOUNT` - Bank transfer (requires `details`)\n- `CHECK` - Check payment\n- `SVOUCHER` - Smart voucher\n- `COMPANY` - Company payment\n- `FACTORING` - Factoring\n- `COMPENSATION` - Compensation\n- `TRANSFER` - Transfer of rights/debts\n- `WAIVER` - Waiver of debts\n- `KIND` - Payment in kind\n- `OTHER` - Other payment methods\n\n## Buyer ID Types\n\n- `ID` - Personal ID\n- `PASS` - Passport\n- `VAT` - Foreign VAT number\n- `TAX` - Tax number\n- `SOC` - Social security number\n\n**Note:** `NUIS` (Albanian NIPT) is only for eInvoice - not available in Public API.\n\n## Support\n\nFor API access: support@easypos.al","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"21155107","team":3358777,"collectionId":"750bb575-e572-4da6-a429-cad4887d5d86","publishedId":"2sBXVkCA3S","public":true,"publicUrl":"https://documenter-api.postman.tech/view/21155107/2sBXVkCA3S","privateUrl":"https://go.postman.co/documentation/21155107-750bb575-e572-4da6-a429-cad4887d5d86","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"easyPos Public API provides cloud-based fiscalization for Albanian businesses. Register invoices, manage cash balances, and generate fiscal receipts via simple REST endpoints. Integrate directly from any platform using HTTP requests. Includes support for multiple payment types, foreign currencies, buyer information, an"},{"name":"title","value":""}],"appearance":{"default":"system_default","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.11.8","publishDate":"2026-01-23T15:00:45.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":"easyPos Public API provides cloud-based fiscalization for Albanian businesses. Register invoices, manage cash balances, and generate fiscal receipts via simple REST endpoints. Integrate directly from any platform using HTTP requests. Includes support for multiple payment types, foreign currencies, buyer information, an"},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/325f1c84655971210f4e89946b4d5def52437a1d339377406d87493b797d8c63","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sBXVkCA3S"}