{"info":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","description":"

Official Postman collection for the easyPos Public Fiscalisation API.

\n

Base URL

\n\n

Authentication

\n

All requests require two headers:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
HeaderValue
AuthorizationBearer <your-access-token>
integration-appYour integration app identifier
\n
\n

Required Fields Summary

\n

Invoice Registration

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldRequiredDefaultDescription
docIdYes-Unique document ID (UUID v4 recommended)
articlesYes-Array of articles (min 1)
paymentYes-Array of payments (min 1)
operatorCodeNo-Operator code (format: xx000xx000)
currencyNoALLCurrency object
buyerNo-Buyer information
invoiceRebateNo-Invoice-level discount
\n

Article Object (all fields required)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
articleIdProduct SKU (max 100 chars)
vatCodeVAT code: A-L
nameProduct name (max 100 chars)
priceUnit price
unitsQuantity
soldInUN/CEFACT unit code
rebateOptional: {inPercentage} OR {inValue}
\n

Payment Object

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldRequiredDescription
typeYesCASH, CARD, ACCOUNT, etc.
amountYesPayment amount
detailsFor ACCOUNTBank account details
\n
\n

Unit Codes (soldIn)

\n

Uses UN/CEFACT codes:

\n\n

VAT Codes

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CodeRateDescription
A0%Tax Free
B20%Standard Rate
C0%Type 2 Exemption (Articles 53/54)
D10%Reduced Rate
E6%Reduced Rate
F0%Margin Scheme - Travel Agents
G0%Margin Scheme - Art Works
H0%Margin Scheme - Used Goods
I0%Margin Scheme - Collectibles
J0%Export of Goods
K0%Type 1 Exemption (Article 51)
\n

Payment Types

\n\n

Buyer ID Types

\n\n

Note: NUIS (Albanian NIPT) is only for eInvoice - not available in Public API.

\n

Support

\n

For API access: support@easypos.al

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"21155107","collectionId":"750bb575-e572-4da6-a429-cad4887d5d86","publishedId":"2sBXVkCA3S","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-01-23T15:00:45.000Z"},"item":[{"name":"Invoice","item":[{"name":"Register Invoice (Minimal)","id":"35518349-833c-426b-a08f-283426089a25","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"550e8400-e29b-41d4-a716-446655440001\",\n \"articles\": [\n {\n \"articleId\": \"PROD001\",\n \"vatCode\": \"B\",\n \"name\": \"Product Name\",\n \"price\": 100,\n \"units\": 2,\n \"soldIn\": \"XPP\"\n }\n ],\n \"payment\": [\n {\n \"type\": \"CASH\",\n \"amount\": 200\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register","description":"

Register an invoice with only the required fields.

\n

Required Fields Only

\n

This example shows the minimum required fields for a successful invoice registration:

\n\n

Article Required Fields

\n

Each article must include:

\n\n

Payment Required Fields

\n

Each payment must include:

\n\n

Important: Total payment amount must equal article total.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","register"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"13861754-fa6f-4eeb-a73e-743421695409","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"550e8400-e29b-41d4-a716-446655440001\",\n \"fic\": \"7251edde-e10c-4e56-9f8b-a9e215ed2475\",\n \"iic\": \"E31BC7C6CF41F6E42515E765CCBC5F5F\",\n \"link\": \"https://efiskalizimi-app-test.tatime.gov.al/invoice-check/#/verify?iic=E31BC7C6CF41F6E42515E765CCBC5F5F&tin=L52101183A&crtd=2026-01-12T12:00:00+01:00&ord=1&bu=kl749av758&cr=bx587ad808&sw=wc801oy838&prc=200.00\"\n}"}],"_postman_id":"35518349-833c-426b-a08f-283426089a25"},{"name":"Register Invoice (CARD Payment)","id":"93a123af-eea5-4f9b-b1fa-8b7f4e1423ce","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"6ba7b810-9dad-11d1-80b4-00c04fd430c8\",\n \"articles\": [\n {\n \"articleId\": \"PROD001\",\n \"vatCode\": \"B\",\n \"name\": \"Product Name\",\n \"price\": 150,\n \"units\": 1,\n \"soldIn\": \"XPP\"\n }\n ],\n \"payment\": [\n {\n \"type\": \"CARD\",\n \"amount\": 150\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register","description":"

Register an invoice with card payment.

\n

Card Payment

\n

Card payments work the same as cash - just change the type to CARD.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","register"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"2e8ae0dd-4418-4486-b897-031a3aaf0bdb","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"6ba7b810-9dad-11d1-80b4-00c04fd430c8\",\n \"fic\": \"fa73cc56-52b4-4f0c-b26a-b57c4dfebcdd\",\n \"iic\": \"603E2000F58E8154051876C31F7727C6\",\n \"link\": \"https://efiskalizimi-app-test.tatime.gov.al/invoice-check/#/verify?iic=603E2000F58E8154051876C31F7727C6&tin=L52101183A&crtd=2026-01-12T12:39:47+01:00&ord=14&bu=kl749av758&cr=bx587ad808&sw=wc801oy838&prc=150.00\"\n}"}],"_postman_id":"93a123af-eea5-4f9b-b1fa-8b7f4e1423ce"},{"name":"Register Invoice (Multiple Payments)","id":"2c0e1b4a-6644-4d9e-a092-46421569ac0d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"f47ac10b-58cc-4372-a567-0e02b2c3d479\",\n \"articles\": [\n {\n \"articleId\": \"PROD001\",\n \"vatCode\": \"B\",\n \"name\": \"Product Name\",\n \"price\": 100,\n \"units\": 1,\n \"soldIn\": \"XPP\"\n }\n ],\n \"payment\": [\n {\n \"type\": \"CASH\",\n \"amount\": 50\n },\n {\n \"type\": \"CARD\",\n \"amount\": 50\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register","description":"

Register an invoice with multiple payment methods.

\n

Split Payment

\n

You can combine multiple payment methods. The total of all payment amounts must equal the invoice total.

\n

In this example:

\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","register"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"afb21f21-c72c-43c4-b86e-9f604737c9d1","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"f47ac10b-58cc-4372-a567-0e02b2c3d479\",\n \"fic\": \"d164a2e0-ffbc-494b-800b-cbc0868c2c99\",\n \"iic\": \"6A73DA403FB417E2356D16B94339DF98\",\n \"link\": \"https://efiskalizimi-app-test.tatime.gov.al/invoice-check/#/verify?iic=6A73DA403FB417E2356D16B94339DF98&tin=L52101183A&crtd=2026-01-12T12:40:06+01:00&ord=15&bu=kl749av758&cr=bx587ad808&sw=wc801oy838&prc=100.00\"\n}"}],"_postman_id":"2c0e1b4a-6644-4d9e-a092-46421569ac0d"},{"name":"Register Invoice (Multiple Articles)","id":"c5f9fbe3-7ab3-40d5-897f-08dc82021a59","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\",\n \"articles\": [\n {\n \"articleId\": \"PROD001\",\n \"vatCode\": \"B\",\n \"name\": \"Coffee\",\n \"price\": 150,\n \"units\": 2,\n \"soldIn\": \"XPP\"\n },\n {\n \"articleId\": \"PROD002\",\n \"vatCode\": \"B\",\n \"name\": \"Croissant\",\n \"price\": 100,\n \"units\": 1,\n \"soldIn\": \"XPP\"\n },\n {\n \"articleId\": \"PROD003\",\n \"vatCode\": \"E\",\n \"name\": \"Fresh Juice\",\n \"price\": 200,\n \"units\": 1,\n \"soldIn\": \"KGM\"\n }\n ],\n \"payment\": [\n {\n \"type\": \"CASH\",\n \"amount\": 600\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register","description":"

Register an invoice with multiple articles.

\n

Calculation

\n\n

Mixed VAT Codes

\n

Articles can have different VAT codes. The system calculates VAT per article based on the code.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","register"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"78cd4d8e-11db-427c-9247-5a69cae0b7a4","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11\",\n \"fic\": \"87e0e0ca-e1bc-4d38-960e-2016684a7468\",\n \"iic\": \"916CCC9042A75603CB92E09E2B30AA2D\",\n \"link\": \"https://efiskalizimi-app-test.tatime.gov.al/invoice-check/#/verify?iic=916CCC9042A75603CB92E09E2B30AA2D&tin=L52101183A&crtd=2026-01-12T12:38:43+01:00&ord=13&bu=kl749av758&cr=bx587ad808&sw=wc801oy838&prc=600.00\"\n}"}],"_postman_id":"c5f9fbe3-7ab3-40d5-897f-08dc82021a59"},{"name":"Register Invoice (With Discount)","id":"dc5ca0a9-578d-42c6-998c-c865b2d4a048","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"c9bf9e57-1685-4c89-bafb-ff5af830be8a\",\n \"articles\": [\n {\n \"articleId\": \"PROD001\",\n \"vatCode\": \"B\",\n \"name\": \"Product with 10% Discount\",\n \"price\": 1000,\n \"units\": 1,\n \"soldIn\": \"XPP\",\n \"rebate\": {\n \"inPercentage\": 10\n }\n },\n {\n \"articleId\": \"PROD002\",\n \"vatCode\": \"B\",\n \"name\": \"Product with Fixed Discount\",\n \"price\": 500,\n \"units\": 2,\n \"soldIn\": \"XPP\",\n \"rebate\": {\n \"inValue\": 100\n }\n }\n ],\n \"payment\": [\n {\n \"type\": \"CARD\",\n \"amount\": 1800\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register","description":"

Register an invoice with article-level discounts.

\n

Discount Types

\n

Use either inPercentage or inValue per article, never both.

\n\n

Calculation

\n\n

Important

\n

Payment amount must equal the total after discounts.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","register"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"0223c8b5-1216-4792-a051-1bf6e485e541","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"c9bf9e57-1685-4c89-bafb-ff5af830be8a\",\n \"fic\": \"12dd2bba-90ca-4357-af48-5d520929166c\",\n \"iic\": \"0A4DE5C110EB2875F3FF308BBF92B150\",\n \"link\": \"https://efiskalizimi-app-test.tatime.gov.al/invoice-check/#/verify?iic=0A4DE5C110EB2875F3FF308BBF92B150&tin=L52101183A&crtd=2026-01-12T16:15:43+01:00&ord=6&bu=kl749av758&cr=bx587ad808&sw=wc801oy838&prc=1800.00\"\n}"}],"_postman_id":"dc5ca0a9-578d-42c6-998c-c865b2d4a048"},{"name":"Register Invoice (Invoice-Level Discount)","id":"fdfe4e9e-7d4d-43f6-b0dd-f65c0edd70e0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"e4eaaaf2-d142-11e1-b3e4-080027620cdd\",\n \"articles\": [\n {\n \"articleId\": \"PROD001\",\n \"vatCode\": \"B\",\n \"name\": \"Product\",\n \"price\": 100,\n \"units\": 2,\n \"soldIn\": \"XPP\"\n }\n ],\n \"payment\": [\n {\n \"type\": \"CASH\",\n \"amount\": 180\n }\n ],\n \"invoiceRebate\": {\n \"inPercentage\": 10\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register","description":"

Register an invoice with invoice-level discount.

\n

Invoice-Level Discount

\n

Use invoiceRebate to apply a discount to the entire invoice.

\n

Calculation

\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","register"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"11768e54-995d-4237-a8a5-8a61e83c0613","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"e4eaaaf2-d142-11e1-b3e4-080027620cdd\",\n \"fic\": \"338e5a49-3c68-70d0-6c04-a9d09b84c8e1\",\n \"iic\": \"338E5A493C6870D06C04A9D09B84C8E1\",\n \"link\": \"https://efiskalizimi-app-test.tatime.gov.al/invoice-check/#/verify?iic=338E5A493C6870D06C04A9D09B84C8E1&tin=L52101183A&crtd=2026-01-12T12:59:39+01:00&ord=19&bu=kl749av758&cr=bx587ad808&sw=wc801oy838&prc=180.00\"\n}"}],"_postman_id":"fdfe4e9e-7d4d-43f6-b0dd-f65c0edd70e0"},{"name":"Register Invoice (NONCASH)","id":"3909384a-75e8-40fa-a417-393468e8b0db","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"7c9e6679-7425-40de-944b-e07fc1f90ae7\",\n \"articles\": [\n {\n \"articleId\": \"SVC001\",\n \"vatCode\": \"B\",\n \"name\": \"Consulting Service\",\n \"price\": 5000,\n \"units\": 8,\n \"soldIn\": \"XPP\"\n }\n ],\n \"payment\": [\n {\n \"type\": \"CARD\",\n \"amount\": 40000\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register","description":"

Register an invoice with card payment for a service.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","register"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"0b43e5fb-a630-430d-beda-1617a0f6b3b0","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"7c9e6679-7425-40de-944b-e07fc1f90ae7\",\n \"fic\": \"87e0e0ca-e1bc-4d38-960e-2016684a7468\",\n \"iic\": \"916CCC9042A75603CB92E09E2B30AA2D\",\n \"link\": \"https://efiskalizimi-app-test.tatime.gov.al/invoice-check/#/verify?iic=916CCC9042A75603CB92E09E2B30AA2D&tin=L52101183A&crtd=2026-01-12T12:38:43+01:00&ord=13&bu=kl749av758&cr=bx587ad808&sw=wc801oy838&prc=40000.00\"\n}"}],"_postman_id":"3909384a-75e8-40fa-a417-393468e8b0db"},{"name":"Register Invoice (NONCASH with Bank Transfer)","id":"194c40cd-7a40-4f92-88bd-a507bd934e0a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"8a14e538-a7d5-4b60-b317-51c1c5c1b6b5\",\n \"articles\": [\n {\n \"articleId\": \"SVC001\",\n \"vatCode\": \"B\",\n \"name\": \"Consulting Services\",\n \"price\": 5000,\n \"units\": 8,\n \"soldIn\": \"XPP\"\n }\n ],\n \"payment\": [\n {\n \"type\": \"ACCOUNT\",\n \"amount\": 40000,\n \"details\": [\n {\n \"idNumber\": \"AL12345678901234567890123456\",\n \"country\": \"ALB\",\n \"countryCode\": \"AL\",\n \"currency\": \"ALL\",\n \"swift_code\": \"SGSBALTX\",\n \"name\": \"Company Account\",\n \"bankName\": \"Raiffeisen Bank\"\n }\n ]\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register","description":"

Register a NONCASH invoice with bank transfer payment.

\n

Bank Transfer (ACCOUNT)

\n

When type is ACCOUNT, the details array is required.

\n

Bank Details Fields (all required)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
idNumberIBAN or account number
countryISO alpha-3 code (ALB, DEU, etc.)
countryCodeISO alpha-2 code (AL, DE) - exactly 2 chars
currencyISO 3-letter code (ALL, EUR) - exactly 3 chars
swift_codeBank SWIFT/BIC code
nameAccount holder name
bankNameBank name
\n
","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","register"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"505ffe82-600d-44a3-aa54-128ac8f33f4a","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"8a14e538-a7d5-4b60-b317-51c1c5c1b6b5\",\n \"fic\": \"d164a2e0-ffbc-494b-800b-cbc0868c2c99\",\n \"iic\": \"B877E504364C21A63573E954F9AAFBAB\",\n \"link\": \"https://efiskalizimi-app-test.tatime.gov.al/invoice-check/#/verify?iic=B877E504364C21A63573E954F9AAFBAB&tin=L52101183A&crtd=2026-01-12T12:52:13+01:00&ord=16&bu=kl749av758&cr=bx587ad808&sw=wc801oy838&prc=40000.00\"\n}"}],"_postman_id":"194c40cd-7a40-4f92-88bd-a507bd934e0a"},{"name":"Register Invoice (With Buyer)","id":"b353e95b-5052-44ba-8b3f-179c7d0bb39b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d\",\n \"articles\": [\n {\n \"articleId\": \"SVC001\",\n \"vatCode\": \"B\",\n \"name\": \"Consulting Services\",\n \"price\": 1000,\n \"units\": 1,\n \"soldIn\": \"XPP\"\n }\n ],\n \"payment\": [\n {\n \"type\": \"CARD\",\n \"amount\": 1000\n }\n ],\n \"buyer\": {\n \"buyerIDType\": \"ID\",\n \"buyerIDNum\": \"I12345678A\",\n \"buyerName\": \"Client Company LLC\",\n \"buyerAddress\": \"Rruga e Dibres 123\",\n \"buyerTown\": \"Tirane\",\n \"buyerCountry\": \"ALB\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register","description":"

Register an invoice with buyer information.

\n

Buyer Fields (all required when buyer is provided)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
buyerIDTypeID type: ID, PASS, VAT
buyerIDNumID number
buyerNameBuyer name
buyerAddressAddress
buyerTownCity/Town
buyerCountryISO alpha-3 code (ALB)
\n

Buyer ID Types

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
TypeUse Case
IDAlbanian personal ID
PASSPassport (foreign customers)
VATForeign VAT number
\n

Note: NUIS (Albanian NIPT) is only for eInvoice - not available in Public API.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","register"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"848ade80-0cd6-4893-a14c-0a29aaebda0c","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d\",\n \"fic\": \"232d5344-d520-4304-8b28-bf898426f9ae\",\n \"iic\": \"2006CA023ABEB8E4A5FF781487101146\",\n \"link\": \"https://efiskalizimi-app-test.tatime.gov.al/invoice-check/#/verify?iic=2006CA023ABEB8E4A5FF781487101146&tin=L52101183A&crtd=2026-01-12T12:59:57+01:00&ord=20&bu=kl749av758&cr=bx587ad808&sw=wc801oy838&prc=1000.00\"\n}"}],"_postman_id":"b353e95b-5052-44ba-8b3f-179c7d0bb39b"},{"name":"Register Invoice (With Currency)","id":"cd8c9835-e729-4dc5-9105-11771f6c9714","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed\",\n \"articles\": [\n {\n \"articleId\": \"PROD001\",\n \"vatCode\": \"B\",\n \"name\": \"Product\",\n \"price\": 100,\n \"units\": 1,\n \"soldIn\": \"XPP\"\n }\n ],\n \"payment\": [\n {\n \"type\": \"CARD\",\n \"amount\": 100\n }\n ],\n \"currency\": {\n \"code\": \"EUR\",\n \"exRate\": 100\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register","description":"

Register an invoice in foreign currency.

\n

Currency Object

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldRequiredDescription
codeYesISO 3-letter currency code
exRateWhen code != ALLExchange rate to ALL
\n

Example

\n

If exRate is 100, then 1 EUR = 100 ALL.

\n

The invoice total will be calculated in ALL using the exchange rate.

\n

Note: When code is ALL, exRate defaults to 1.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","register"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"534d55bd-f5a1-4831-82ef-6eba9dbc359d","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed\",\n \"fic\": \"1f85aef9-cd77-44d0-a10b-ab57df2f0c51\",\n \"iic\": \"DAF67AC224499EA6825EFD7C1F987C57\",\n \"link\": \"https://efiskalizimi-app-test.tatime.gov.al/invoice-check/#/verify?iic=DAF67AC224499EA6825EFD7C1F987C57&tin=L52101183A&crtd=2026-01-12T13:00:06+01:00&ord=21&bu=kl749av758&cr=bx587ad808&sw=wc801oy838&prc=10000.00\"\n}"}],"_postman_id":"cd8c9835-e729-4dc5-9105-11771f6c9714"},{"name":"Register Invoice (With Operator)","id":"45c8bc57-c05b-4d16-acdd-e762578e2a5a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"operatorCode\": \"gh537ez280\",\n \"articles\": [\n {\n \"articleId\": \"PROD001\",\n \"vatCode\": \"B\",\n \"name\": \"Product\",\n \"price\": 100,\n \"units\": 1,\n \"soldIn\": \"XPP\"\n }\n ],\n \"payment\": [\n {\n \"type\": \"CARD\",\n \"amount\": 100\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register","description":"

Register an invoice with a specific operator.

\n

Operator Code

\n

Format: xx000xx000 (2 letters + 3 digits + 2 letters + 3 digits)

\n

Example: gh537ez280

\n

Use the Get Operators endpoint to get available operator codes.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","register"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"2c0aaa3f-82c9-4fdc-b447-0421b937e1f2","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"fic\": \"ae88a114-0623-4426-9f79-602a1c553ee5\",\n \"iic\": \"1DED58A6820A5D963430CA523EF02404\",\n \"link\": \"https://efiskalizimi-app-test.tatime.gov.al/invoice-check/#/verify?iic=1DED58A6820A5D963430CA523EF02404&tin=L52101183A&crtd=2026-01-12T13:00:10+01:00&ord=22&bu=kl749av758&cr=bx587ad808&sw=wc801oy838&prc=100.00\"\n}"}],"_postman_id":"45c8bc57-c05b-4d16-acdd-e762578e2a5a"},{"name":"Register Invoice (Full Example)","id":"032be979-542c-4057-bec8-b826cb277fe8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"d290f1ee-6c54-4b01-90e6-d701748f0851\",\n \"operatorCode\": \"gh537ez280\",\n \"articles\": [\n {\n \"articleId\": \"PROD001\",\n \"vatCode\": \"B\",\n \"name\": \"Product A\",\n \"price\": 1000,\n \"units\": 2,\n \"soldIn\": \"XPP\",\n \"rebate\": {\n \"inPercentage\": 10\n }\n },\n {\n \"articleId\": \"SVC001\",\n \"vatCode\": \"B\",\n \"name\": \"Service B\",\n \"price\": 500,\n \"units\": 4,\n \"soldIn\": \"XPP\"\n }\n ],\n \"payment\": [\n {\n \"type\": \"ACCOUNT\",\n \"amount\": 3800,\n \"details\": [\n {\n \"idNumber\": \"AL12345678901234567890123456\",\n \"country\": \"ALB\",\n \"countryCode\": \"AL\",\n \"currency\": \"ALL\",\n \"swift_code\": \"SGSBALTX\",\n \"name\": \"Company Account\",\n \"bankName\": \"Raiffeisen Bank\"\n }\n ]\n }\n ],\n \"buyer\": {\n \"buyerIDType\": \"ID\",\n \"buyerIDNum\": \"I12345678A\",\n \"buyerName\": \"Client Company LLC\",\n \"buyerAddress\": \"Rruga e Dibres 123\",\n \"buyerTown\": \"Tirane\",\n \"buyerCountry\": \"ALB\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register","description":"

A complete invoice example with all optional fields.

\n

Calculation

\n\n

Included Features

\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","register"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"c38b83c8-242e-4288-a864-a5c2714d758c","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/register"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"d290f1ee-6c54-4b01-90e6-d701748f0851\",\n \"fic\": \"d164a2e0-ffbc-494b-800b-cbc0868c2c99\",\n \"iic\": \"B877E504364C21A63573E954F9AAFBAB\",\n \"link\": \"https://efiskalizimi-app-test.tatime.gov.al/invoice-check/#/verify?iic=B877E504364C21A63573E954F9AAFBAB&tin=L52101183A&crtd=2026-01-12T12:52:13+01:00&ord=16&bu=kl749av758&cr=bx587ad808&sw=wc801oy838&prc=3800.00\"\n}"}],"_postman_id":"032be979-542c-4057-bec8-b826cb277fe8"},{"name":"Cancel Invoice","id":"6a6faf22-b9c9-48aa-a716-3e0844fd15a9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"4b6a8c9d-2e3f-4a5b-8c7d-9e0f1a2b3c4d\",\n \"correctiveInvoice\": {\n \"iicRef\": \"E31BC7C6CF41F6E42515E765CCBC5F5F\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/cancel","description":"

Cancel a previously fiscalised invoice.

\n

Required Fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
docIdUnique ID for this cancellation (UUID v4)
correctiveInvoice.iicRefIIC of invoice to cancel (32 hex chars)
\n

Optional Fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
operatorCodeOperator code
\n

How to Cancel

\n
    \n
  1. Register an invoice and note the iic from response
    2. \n
  2. Use that IIC in correctiveInvoice.iicRef
    3. \n
  3. The response will have a negative price
    4. \n
\n

Note: Cancellation creates a new fiscal record with negative amounts.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","cancel"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"ec7d9e2b-fb51-4ea6-a51c-d9510bdfb303","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/cancel"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"4b6a8c9d-2e3f-4a5b-8c7d-9e0f1a2b3c4d\",\n \"fic\": \"08b67c7b-3be7-40bd-8e65-da8592e598c4\",\n \"iic\": \"DB94AE01585A0B84FEF65D30790CEC08\",\n \"link\": \"https://efiskalizimi-app-test.tatime.gov.al/invoice-check/#/verify?iic=DB94AE01585A0B84FEF65D30790CEC08&tin=L52101183A&crtd=2026-01-11T16:16:16+01:00&ord=8&bu=kl749av758&cr=bx587ad808&sw=wc801oy838&prc=-200.00\"\n}"}],"_postman_id":"6a6faf22-b9c9-48aa-a716-3e0844fd15a9"},{"name":"Get Invoice Status","id":"3bff3fcf-9578-4a7d-af5d-7995c01fcf5b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"550e8400-e29b-41d4-a716-446655440001\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/status","description":"

Check the fiscalisation status of an invoice.

\n

Required Fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
docIdThe document ID used when registering
\n
","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","status"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"163e361b-4877-4c14-b642-7d2351d35aee","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"550e8400-e29b-41d4-a716-446655440001\",\n \"fic\": \"7251edde-e10c-4e56-9f8b-a9e215ed2475\",\n \"iic\": \"E31BC7C6CF41F6E42515E765CCBC5F5F\",\n \"link\": \"https://efiskalizimi-app-test.tatime.gov.al/invoice-check/#/verify?iic=E31BC7C6CF41F6E42515E765CCBC5F5F&tin=L52101183A&crtd=2026-01-11T13:02:22+01:00&ord=1&bu=kl749av758&cr=bx587ad808&sw=wc801oy838&prc=200.00\"\n}"}],"_postman_id":"3bff3fcf-9578-4a7d-af5d-7995c01fcf5b"},{"name":"Get Invoice PDF","id":"9c42e87b-051c-4928-9adb-660af2839cfb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"iic\": \"E31BC7C6CF41F6E42515E765CCBC5F5F\",\n \"pdfType\": \"A4\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/pdf","description":"

Generate a PDF document for a fiscalised invoice.

\n

Required Fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
iicThe IIC code (exactly 32 hex characters)
\n

Optional Fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDefaultDescription
pdfTypeA4Format: A4 or receipt
\n

Response

\n

Returns JSON with base64-encoded PDF:

\n
{\n  \"base64\": \"JVBERi0xLjMK...\"\n}\n\n
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","pdf"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"b7cb9a25-599f-4541-95d2-20207f9440a7","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/pdf"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"base64\": \"JVBERi0xLjMKJf////8KOCAwIG9iago8PAovVHlwZSAvRXh0R1N0YXRlCi9jYSAxCi9DQSAxCj4+CmVuZG9iago...\"\n}"}],"_postman_id":"9c42e87b-051c-4928-9adb-660af2839cfb"},{"name":"Get Invoice Receipt","id":"a770fa5c-bff3-47cd-ace0-de58012da2af","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"iic\": \"8CB625B77CA602BDE049DAC436F26D9F\",\n \"pdfType\": \"receipt\",\n \"paperWidth\": 80\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/invoice/pdf","description":"

Generate a receipt for a fiscalised invoice.

\n

Required Fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
iicThe IIC code (exactly 32 hex characters)
\n

Optional Fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDefaultDescription
pdfTypereceiptFormat: A4 or receipt
paperWidthnull58mm or 80mm or 110mm
\n

Response

\n

Returns JSON with base64-encoded PDF:

\n
{\n  \"base64\": \"JVBERi0xLjMK...\"\n}\n\n
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["invoice","pdf"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"a770fa5c-bff3-47cd-ace0-de58012da2af"}],"id":"918734e2-75a4-4518-b114-b15d19af71b2","description":"

Invoice management endpoints for creating, cancelling, and querying invoices.

\n","_postman_id":"918734e2-75a4-4518-b114-b15d19af71b2","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}}},{"name":"Balance","item":[{"name":"Initiate Balance","id":"14cd53fd-0bba-4ded-a95d-7ab0f6ce4ad4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"5d8f7e6c-4a3b-2c1d-0e9f-8a7b6c5d4e3f\",\n \"amount\": 10000,\n \"notes\": \"Opening balance for the day\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/balance/initiate","description":"

Initiate the opening balance for a cash register.

\n

Required Fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
docIdUnique document ID (UUID v4)
amountOpening balance amount
\n

Optional Fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
notesNotes or description
operatorCodeOperator code (format: xx000xx000)
\n

When to Use

\n

Call this endpoint at the start of each business day before processing invoices.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["balance","initiate"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"142d8e4c-9422-4e9f-8251-7280db7a00a2","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/balance/initiate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"5d8f7e6c-4a3b-2c1d-0e9f-8a7b6c5d4e3f\",\n \"fcdc\": \"2ce74b1b-2609-41d3-bafe-c384c725a2dc\"\n}"}],"_postman_id":"14cd53fd-0bba-4ded-a95d-7ab0f6ce4ad4"},{"name":"Deposit Balance","id":"ff55fe5f-dab3-4a23-9c67-f9b2e9e9145c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"6e9f8a7b-5c4d-3e2f-1a0b-9c8d7e6f5a4b\",\n \"amount\": 5000,\n \"notes\": \"Additional cash deposit\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/balance/deposit","description":"

Record a cash deposit into the register.

\n

Required Fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
docIdUnique document ID (UUID v4)
amountDeposit amount
\n

Optional Fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
notesNotes or description
operatorCodeOperator code
\n
","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["balance","deposit"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"79a098f8-5369-4eeb-a803-54c714d551c3","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/balance/deposit"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"6e9f8a7b-5c4d-3e2f-1a0b-9c8d7e6f5a4b\",\n \"fcdc\": \"1b008bfc-57a9-4559-9d1a-798b28945f7f\"\n}"}],"_postman_id":"ff55fe5f-dab3-4a23-9c67-f9b2e9e9145c"},{"name":"Withdraw Balance","id":"760c5913-5c73-4173-963b-ae0db64db2e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"docId\": \"7f0a9b8c-6d5e-4f3a-2b1c-0d9e8f7a6b5c\",\n \"amount\": 2000,\n \"notes\": \"Cash withdrawal for bank deposit\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/balance/withdraw","description":"

Record a cash withdrawal from the register.

\n

Required Fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
docIdUnique document ID (UUID v4)
amountWithdrawal amount
\n

Optional Fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
notesNotes or description
operatorCodeOperator code
\n
","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["balance","withdraw"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"355fc00e-e7a6-4646-b2ad-e5c69d04d3eb","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/balance/withdraw"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orderId\": \"7f0a9b8c-6d5e-4f3a-2b1c-0d9e8f7a6b5c\",\n \"fcdc\": \"0de9a0aa-e9b9-4e64-9612-47306ee5f095\"\n}"}],"_postman_id":"760c5913-5c73-4173-963b-ae0db64db2e4"}],"id":"506a1012-6b90-403c-a564-427bbee90820","description":"

Cash register balance management endpoints.

\n","_postman_id":"506a1012-6b90-403c-a564-427bbee90820","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}}},{"name":"Utilities","item":[{"name":"Search Taxpayers","id":"7bc4b5f9-798e-44e8-ab9b-a1fe318defcf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{\n \"searchTerm\": \"Vodafone\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/utilities/get-taxpayers","description":"

Search for registered taxpayers by name or NIPT.

\n

Required Fields

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
searchTermName or NIPT (3-200 chars)
\n

Use Case

\n

Search for business customers to get their NIPT and address information.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["utilities","get-taxpayers"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"c37d7a8c-4d05-4f77-9a17-8fb78dade96d","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/utilities/get-taxpayers"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"Address\": \"Rruga Pavaresia, kodi postal 1050, Kashar 61\",\n \"Country\": \"ALB\",\n \"Name\": \"FONDACIONI VODAFONE ALBANIA\",\n \"Tin\": \"K72118452F\",\n \"Town\": \"Tirane\"\n },\n {\n \"Address\": \"Autostrada Tirane- Durres, Rruga Pavaresia, Nr.61, Kashar\",\n \"Country\": \"ALB\",\n \"Name\": \"VODAFONE ALBANIA\",\n \"Tin\": \"K11715005L\",\n \"Town\": \"Kashar\"\n }\n]"}],"_postman_id":"7bc4b5f9-798e-44e8-ab9b-a1fe318defcf"},{"name":"Get Operators","id":"4ba81f82-0400-4fdd-8c8c-cec1a769b3e2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"integration-app","value":"generic"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://api.dev.easypos.al/fiscalisation-service/v1/utilities/get-operators","description":"

Retrieve the list of registered operators.

\n

Use Case

\n

Get available operator codes to use in invoice registration.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}},"urlObject":{"path":["utilities","get-operators"],"host":["https://api.dev.easypos.al/fiscalisation-service/v1"],"query":[],"variable":[]}},"response":[{"id":"09099c12-4e71-4b14-8b74-64d47f84ffc5","name":"Success Response","originalRequest":{"method":"POST","header":[],"url":"https://api.dev.easypos.al/fiscalisation-service/v1/utilities/get-operators"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"name\": \"test3\",\n \"opCode\": \"gh537ez280\"\n },\n {\n \"name\": \"User A\",\n \"opCode\": \"aa111aa222\"\n }\n]"}],"_postman_id":"4ba81f82-0400-4fdd-8c8c-cec1a769b3e2"}],"id":"ab2fc30d-f23e-401d-bf41-90f50dc333ce","description":"

Utility endpoints for lookups.

\n","_postman_id":"ab2fc30d-f23e-401d-bf41-90f50dc333ce","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]},"isInherited":true,"source":{"_postman_id":"750bb575-e572-4da6-a429-cad4887d5d86","id":"750bb575-e572-4da6-a429-cad4887d5d86","name":"easyPos Public API","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"your-access-token-here"}]}},"event":[{"listen":"prerequest","script":{"id":"8d4aa7d6-5f52-4d40-a9a7-3278b99156da","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"f9afae76-f338-44bb-ae16-898321f98cd7","type":"text/javascript","exec":[""]}}],"variable":[{"key":"baseUrl","value":"https://api.dev.easypos.al/fiscalisation-service/v1","type":"string"},{"key":"accessToken","value":"your-access-token-here","type":"string"},{"key":"integrationApp","value":"generic","type":"string"}]}