{
	"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.1.0/collection.json",
		"_exporter_id": "21155107"
	},
	"item": [
		{
			"name": "Invoice",
			"item": [
				{
					"name": "Register Invoice (Minimal)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"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": {
							"raw": "{{baseUrl}}/invoice/register",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"register"
							]
						},
						"description": "Register an invoice with only the required fields.\n\n## Required Fields Only\n\nThis example shows the **minimum required fields** for a successful invoice registration:\n\n- `docId` - Unique document identifier (UUID v4 recommended)\n- `articles` - At least one article with all required article fields\n- `payment` - At least one payment method\n\n## Article Required Fields\n\nEach article **must** include:\n- `articleId` - SKU/product identifier\n- `vatCode` - VAT category (A-L)\n- `name` - Product name\n- `price` - Unit price\n- `units` - Quantity\n- `soldIn` - Unit of measure (UN/CEFACT code)\n\n## Payment Required Fields\n\nEach payment **must** include:\n- `type` - Payment method (CASH, CARD, ACCOUNT, etc.)\n- `amount` - Payment amount\n\n**Important:** Total payment amount must equal article total."
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/invoice/register",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"invoice",
										"register"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"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}"
						}
					]
				},
				{
					"name": "Register Invoice (CARD Payment)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"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": {
							"raw": "{{baseUrl}}/invoice/register",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"register"
							]
						},
						"description": "Register an invoice with card payment.\n\n## Card Payment\n\nCard payments work the same as cash - just change the `type` to `CARD`."
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/invoice/register",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"invoice",
										"register"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"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}"
						}
					]
				},
				{
					"name": "Register Invoice (Multiple Payments)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"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": {
							"raw": "{{baseUrl}}/invoice/register",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"register"
							]
						},
						"description": "Register an invoice with multiple payment methods.\n\n## Split Payment\n\nYou can combine multiple payment methods. The total of all payment amounts must equal the invoice total.\n\nIn this example:\n- Cash: 50 ALL\n- Card: 50 ALL\n- Total: 100 ALL"
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/invoice/register",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"invoice",
										"register"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"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}"
						}
					]
				},
				{
					"name": "Register Invoice (Multiple Articles)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"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": {
							"raw": "{{baseUrl}}/invoice/register",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"register"
							]
						},
						"description": "Register an invoice with multiple articles.\n\n## Calculation\n\n- Coffee: 150 x 2 = 300 (VAT B - 20%)\n- Croissant: 100 x 1 = 100 (VAT B - 20%)\n- Fresh Juice: 200 x 1 = 200 (VAT E - 6%)\n- **Total: 600**\n\n## Mixed VAT Codes\n\nArticles can have different VAT codes. The system calculates VAT per article based on the code."
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/invoice/register",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"invoice",
										"register"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"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}"
						}
					]
				},
				{
					"name": "Register Invoice (With Discount)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"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": {
							"raw": "{{baseUrl}}/invoice/register",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"register"
							]
						},
						"description": "Register an invoice with article-level discounts.\n\n## Discount Types\n\nUse **either** `inPercentage` **or** `inValue` per article, never both.\n\n- `inPercentage`: Discount as percentage (e.g., `10` = 10% off)\n- `inValue`: Fixed discount amount\n\n## Calculation\n\n- Product 1: 1000 x 1 = 1000, minus 10% = **900**\n- Product 2: 500 x 2 = 1000, minus 100 = **900**\n- **Total: 1800**\n\n## Important\n\nPayment amount must equal the total **after** discounts."
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/invoice/register",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"invoice",
										"register"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"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}"
						}
					]
				},
				{
					"name": "Register Invoice (Invoice-Level Discount)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"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": {
							"raw": "{{baseUrl}}/invoice/register",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"register"
							]
						},
						"description": "Register an invoice with invoice-level discount.\n\n## Invoice-Level Discount\n\nUse `invoiceRebate` to apply a discount to the entire invoice.\n\n## Calculation\n\n- Articles total: 100 x 2 = 200\n- Invoice discount: 10%\n- **Final total: 180**"
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/invoice/register",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"invoice",
										"register"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"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}"
						}
					]
				},
				{
					"name": "Register Invoice (NONCASH)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"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": {
							"raw": "{{baseUrl}}/invoice/register",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"register"
							]
						},
						"description": "Register an invoice with card payment for a service."
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/invoice/register",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"invoice",
										"register"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"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}"
						}
					]
				},
				{
					"name": "Register Invoice (NONCASH with Bank Transfer)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"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": {
							"raw": "{{baseUrl}}/invoice/register",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"register"
							]
						},
						"description": "Register a NONCASH invoice with bank transfer payment.\n\n## Bank Transfer (ACCOUNT)\n\nWhen `type` is `ACCOUNT`, the `details` array is **required**.\n\n## Bank Details Fields (all required)\n\n| Field | Description |\n|-------|-------------|\n| `idNumber` | IBAN or account number |\n| `country` | ISO alpha-3 code (ALB, DEU, etc.) |\n| `countryCode` | ISO alpha-2 code (AL, DE) - exactly 2 chars |\n| `currency` | ISO 3-letter code (ALL, EUR) - exactly 3 chars |\n| `swift_code` | Bank SWIFT/BIC code |\n| `name` | Account holder name |\n| `bankName` | Bank name |"
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/invoice/register",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"invoice",
										"register"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"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}"
						}
					]
				},
				{
					"name": "Register Invoice (With Buyer)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"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": {
							"raw": "{{baseUrl}}/invoice/register",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"register"
							]
						},
						"description": "Register an invoice with buyer information.\n\n## Buyer Fields (all required when buyer is provided)\n\n| Field | Description |\n|-------|-------------|\n| `buyerIDType` | ID type: `ID`, `PASS`, `VAT` |\n| `buyerIDNum` | ID number |\n| `buyerName` | Buyer name |\n| `buyerAddress` | Address |\n| `buyerTown` | City/Town |\n| `buyerCountry` | ISO alpha-3 code (ALB) |\n\n## Buyer ID Types\n\n| Type | Use Case |\n|------|----------|\n| `ID` | Albanian personal ID |\n| `PASS` | Passport (foreign customers) |\n| `VAT` | Foreign VAT number |\n\n**Note:** `NUIS` (Albanian NIPT) is only for eInvoice - not available in Public API."
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/invoice/register",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"invoice",
										"register"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"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}"
						}
					]
				},
				{
					"name": "Register Invoice (With Currency)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"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": {
							"raw": "{{baseUrl}}/invoice/register",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"register"
							]
						},
						"description": "Register an invoice in foreign currency.\n\n## Currency Object\n\n| Field | Required | Description |\n|-------|----------|-------------|\n| `code` | Yes | ISO 3-letter currency code |\n| `exRate` | When code != ALL | Exchange rate to ALL |\n\n## Example\n\nIf `exRate` is 100, then 1 EUR = 100 ALL.\n\nThe invoice total will be calculated in ALL using the exchange rate.\n\n**Note:** When `code` is `ALL`, `exRate` defaults to 1."
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/invoice/register",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"invoice",
										"register"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"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}"
						}
					]
				},
				{
					"name": "Register Invoice (With Operator)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"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": {
							"raw": "{{baseUrl}}/invoice/register",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"register"
							]
						},
						"description": "Register an invoice with a specific operator.\n\n## Operator Code\n\nFormat: `xx000xx000` (2 letters + 3 digits + 2 letters + 3 digits)\n\nExample: `gh537ez280`\n\nUse the **Get Operators** endpoint to get available operator codes."
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/invoice/register",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"invoice",
										"register"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"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}"
						}
					]
				},
				{
					"name": "Register Invoice (Full Example)",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"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": {
							"raw": "{{baseUrl}}/invoice/register",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"register"
							]
						},
						"description": "A complete invoice example with all optional fields.\n\n## Calculation\n\n- Product A: 1000 x 2 = 2000, minus 10% = **1800**\n- Service B: 500 x 4 = **2000**\n- **Total: 3800**\n\n## Included Features\n\n- NONCASH order type\n- Operator code\n- Multiple articles\n- Article-level discount\n- Bank transfer payment\n- Buyer information"
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/invoice/register",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"invoice",
										"register"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"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}"
						}
					]
				},
				{
					"name": "Cancel Invoice",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"docId\": \"4b6a8c9d-2e3f-4a5b-8c7d-9e0f1a2b3c4d\",\n  \"correctiveInvoice\": {\n    \"iicRef\": \"E31BC7C6CF41F6E42515E765CCBC5F5F\"\n  }\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						},
						"url": {
							"raw": "{{baseUrl}}/invoice/cancel",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"cancel"
							]
						},
						"description": "Cancel a previously fiscalised invoice.\n\n## Required Fields\n\n| Field | Description |\n|-------|-------------|\n| `docId` | Unique ID for this cancellation (UUID v4) |\n| `correctiveInvoice.iicRef` | IIC of invoice to cancel (32 hex chars) |\n\n## Optional Fields\n\n| Field | Description |\n|-------|-------------|\n| `operatorCode` | Operator code |\n\n## How to Cancel\n\n1. Register an invoice and note the `iic` from response\n2. Use that IIC in `correctiveInvoice.iicRef`\n3. The response will have a negative price\n\n**Note:** Cancellation creates a new fiscal record with negative amounts."
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/invoice/cancel",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"invoice",
										"cancel"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"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}"
						}
					]
				},
				{
					"name": "Get Invoice Status",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"docId\": \"550e8400-e29b-41d4-a716-446655440001\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						},
						"url": {
							"raw": "{{baseUrl}}/invoice/status",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"status"
							]
						},
						"description": "Check the fiscalisation status of an invoice.\n\n## Required Fields\n\n| Field | Description |\n|-------|-------------|\n| `docId` | The document ID used when registering |"
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/invoice/status",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"invoice",
										"status"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"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}"
						}
					]
				},
				{
					"name": "Get Invoice PDF",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"iic\": \"E31BC7C6CF41F6E42515E765CCBC5F5F\",\n  \"pdfType\": \"A4\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						},
						"url": {
							"raw": "{{baseUrl}}/invoice/pdf",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"pdf"
							]
						},
						"description": "Generate a PDF document for a fiscalised invoice.\n\n## Required Fields\n\n| Field | Description |\n| --- | --- |\n| `iic` | The IIC code (exactly 32 hex characters) |\n\n## Optional Fields\n\n| Field | Default | Description |\n| --- | --- | --- |\n| `pdfType` | `A4` | Format: `A4` or `receipt` |\n\n## Response\n\nReturns JSON with base64-encoded PDF:\n\n``` json\n{\n  \"base64\": \"JVBERi0xLjMK...\"\n}\n\n```"
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/invoice/pdf",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"invoice",
										"pdf"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"body": "{\n  \"base64\": \"JVBERi0xLjMKJf////8KOCAwIG9iago8PAovVHlwZSAvRXh0R1N0YXRlCi9jYSAxCi9DQSAxCj4+CmVuZG9iago...\"\n}"
						}
					]
				},
				{
					"name": "Get Invoice Receipt",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"iic\": \"8CB625B77CA602BDE049DAC436F26D9F\",\n  \"pdfType\": \"receipt\",\n  \"paperWidth\": 80\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						},
						"url": {
							"raw": "{{baseUrl}}/invoice/pdf",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"invoice",
								"pdf"
							]
						},
						"description": "Generate a receipt for a fiscalised invoice.\n\n## Required Fields\n\n| Field | Description |\n| --- | --- |\n| `iic` | The IIC code (exactly 32 hex characters) |\n\n## Optional Fields\n\n| Field | Default | Description |\n| --- | --- | --- |\n| `pdfType` | `receipt` | Format: `A4` or `receipt` |\n| `paperWidth` | `null` | `58mm` or `80mm` or `110mm` |\n\n## Response\n\nReturns JSON with base64-encoded PDF:\n\n``` json\n{\n  \"base64\": \"JVBERi0xLjMK...\"\n}\n\n```"
					},
					"response": []
				}
			],
			"description": "Invoice management endpoints for creating, cancelling, and querying invoices."
		},
		{
			"name": "Balance",
			"item": [
				{
					"name": "Initiate Balance",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"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": {
							"raw": "{{baseUrl}}/balance/initiate",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"balance",
								"initiate"
							]
						},
						"description": "Initiate the opening balance for a cash register.\n\n## Required Fields\n\n| Field | Description |\n|-------|-------------|\n| `docId` | Unique document ID (UUID v4) |\n| `amount` | Opening balance amount |\n\n## Optional Fields\n\n| Field | Description |\n|-------|-------------|\n| `notes` | Notes or description |\n| `operatorCode` | Operator code (format: `xx000xx000`) |\n\n## When to Use\n\nCall this endpoint at the start of each business day before processing invoices."
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/balance/initiate",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"balance",
										"initiate"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"body": "{\n  \"orderId\": \"5d8f7e6c-4a3b-2c1d-0e9f-8a7b6c5d4e3f\",\n  \"fcdc\": \"2ce74b1b-2609-41d3-bafe-c384c725a2dc\"\n}"
						}
					]
				},
				{
					"name": "Deposit Balance",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"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": {
							"raw": "{{baseUrl}}/balance/deposit",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"balance",
								"deposit"
							]
						},
						"description": "Record a cash deposit into the register.\n\n## Required Fields\n\n| Field | Description |\n|-------|-------------|\n| `docId` | Unique document ID (UUID v4) |\n| `amount` | Deposit amount |\n\n## Optional Fields\n\n| Field | Description |\n|-------|-------------|\n| `notes` | Notes or description |\n| `operatorCode` | Operator code |"
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/balance/deposit",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"balance",
										"deposit"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"body": "{\n  \"orderId\": \"6e9f8a7b-5c4d-3e2f-1a0b-9c8d7e6f5a4b\",\n  \"fcdc\": \"1b008bfc-57a9-4559-9d1a-798b28945f7f\"\n}"
						}
					]
				},
				{
					"name": "Withdraw Balance",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"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": {
							"raw": "{{baseUrl}}/balance/withdraw",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"balance",
								"withdraw"
							]
						},
						"description": "Record a cash withdrawal from the register.\n\n## Required Fields\n\n| Field | Description |\n|-------|-------------|\n| `docId` | Unique document ID (UUID v4) |\n| `amount` | Withdrawal amount |\n\n## Optional Fields\n\n| Field | Description |\n|-------|-------------|\n| `notes` | Notes or description |\n| `operatorCode` | Operator code |"
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/balance/withdraw",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"balance",
										"withdraw"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"body": "{\n  \"orderId\": \"7f0a9b8c-6d5e-4f3a-2b1c-0d9e8f7a6b5c\",\n  \"fcdc\": \"0de9a0aa-e9b9-4e64-9612-47306ee5f095\"\n}"
						}
					]
				}
			],
			"description": "Cash register balance management endpoints."
		},
		{
			"name": "Utilities",
			"item": [
				{
					"name": "Search Taxpayers",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{\n  \"searchTerm\": \"Vodafone\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						},
						"url": {
							"raw": "{{baseUrl}}/utilities/get-taxpayers",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"utilities",
								"get-taxpayers"
							]
						},
						"description": "Search for registered taxpayers by name or NIPT.\n\n## Required Fields\n\n| Field | Description |\n|-------|-------------|\n| `searchTerm` | Name or NIPT (3-200 chars) |\n\n## Use Case\n\nSearch for business customers to get their NIPT and address information."
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/utilities/get-taxpayers",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"utilities",
										"get-taxpayers"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"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]"
						}
					]
				},
				{
					"name": "Get Operators",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							},
							{
								"key": "integration-app",
								"value": "{{integrationApp}}"
							}
						],
						"body": {
							"mode": "raw",
							"raw": "{}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						},
						"url": {
							"raw": "{{baseUrl}}/utilities/get-operators",
							"host": [
								"{{baseUrl}}"
							],
							"path": [
								"utilities",
								"get-operators"
							]
						},
						"description": "Retrieve the list of registered operators.\n\n## Use Case\n\nGet available operator codes to use in invoice registration."
					},
					"response": [
						{
							"name": "Success Response",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{baseUrl}}/utilities/get-operators",
									"host": [
										"{{baseUrl}}"
									],
									"path": [
										"utilities",
										"get-operators"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json"
								}
							],
							"cookie": [],
							"body": "[\n  {\n    \"name\": \"test3\",\n    \"opCode\": \"gh537ez280\"\n  },\n  {\n    \"name\": \"User A\",\n    \"opCode\": \"aa111aa222\"\n  }\n]"
						}
					]
				}
			],
			"description": "Utility endpoints for lookups."
		}
	],
	"auth": {
		"type": "bearer",
		"bearer": [
			{
				"key": "token",
				"value": "{{accessToken}}",
				"type": "string"
			}
		]
	},
	"event": [
		{
			"listen": "prerequest",
			"script": {
				"type": "text/javascript",
				"exec": [
					""
				]
			}
		},
		{
			"listen": "test",
			"script": {
				"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"
		}
	]
}