{
  "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, matching the business fiscal configuration |\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 | Non-empty array of 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`vatCode` depends on the business VAT status and fiscal configuration, not only on the article. The API does not return this mapping; store it in the integration configuration.\n\n| Code | Rate | Description |\n|------|------|-------------|\n| A | 0% | Business not subject to VAT |\n| B | 20% | Standard rate |\n| C | 0% | Exempt supply |\n| D | 10% | Reduced rate |\n| E | 6% | Reduced rate |\n| J | 0% | Export of goods |\n\nDo not use other A-L codes without a confirmed fiscal configuration.\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- `NUIS` - Albanian NIPT; required for eInvoice buyers\n- `ID` - Personal ID\n- `PASS` - Passport\n- `VAT` - Foreign VAT number\n- `TAX` - Tax number\n- `SOC` - Social security number\n\nFor `NUIS`, trim and uppercase the value, then validate it with `^[A-Z]\\d{8}[A-Z]$`. There is no alternative NUIS length; use the appropriate identifier type for other values.\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\": \"AL47212110090000000235698741\",\n          \"country\": \"Shqipëri\",\n          \"countryCode\": \"AL\",\n          \"currency\": \"ALL\",\n          \"swift_code\": \"ABCDEFGH\",\n          \"name\": \"Shitësi SHPK\",\n          \"bankName\": \"Banka XYZ\"\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 and must not be empty**.\n\n## Bank Details Fields (all required)\n\n| Field | Description |\n|-------|-------------|\n| `idNumber` | IBAN or account number |\n| `country` | Country name |\n| `countryCode` | ISO alpha-2 code (AL, DE) - exactly 2 chars |\n| `currency` | Currency 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` | Identifier type: `NUIS`, `ID`, `PASS`, `VAT`, or `TAX` |\n| `buyerIDNum` | Identifier value |\n| `buyerName` | Buyer name |\n| `buyerAddress` | Address |\n| `buyerTown` | City/Town |\n| `buyerCountry` | ISO alpha-3 code (ALB) |\n\nFor an electronic invoice, use `NUIS`. Trim and uppercase `buyerIDNum`, then validate it with `^[A-Z]\\d{8}[A-Z]$`. Use the appropriate type for other identifiers."
          },
          "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\": \"AL47212110090000000235698741\",\n          \"country\": \"Shqipëri\",\n          \"countryCode\": \"AL\",\n          \"currency\": \"ALL\",\n          \"swift_code\": \"ABCDEFGH\",\n          \"name\": \"Shitësi SHPK\",\n          \"bankName\": \"Banka XYZ\"\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 operation ID; UUID or another system-generated value |\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 once at the start of each workday for the relevant fiscal device, before its first cash invoice. Do not repeat it before every invoice or every shift in the same day. Use deposit or withdraw when a shift change physically changes the till amount. There is no separate shift-close endpoint. Reuse the same docId only when retrying this operation."
          },
          "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 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\nUse the result to search and populate buyer data. `Country` uses ISO 3166-1 alpha-3, for example `ALB`. The response does not indicate active, inactive, or deregistered status and must not be used as final tax-status verification. No numeric rate limit is published; debounce searches and do not send a request for every keystroke."
          },
          "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"
    }
  ]
}
