{
  "info": {
    "name": "fature.al API, document examples",
    "description": "One request per document type. Set baseUrl (sandbox by default) and token. Replace the example original_invoice_iic and invoice ids with real ones from your account.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://demo.fature.al/api/v1"
    },
    {
      "key": "token",
      "value": "YOUR_API_TOKEN"
    }
  ],
  "item": [
    {
      "name": "Fiscal Invoice",
      "item": [
        {
          "name": "Fiscal invoice (non-cash)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{token}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoice/noncash",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoice",
                "noncash"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"internalId\": \"FAT-2026-0412\",\n  \"payment_method\": \"TRANSFER\",\n  \"client\": {\n    \"name\": \"Alpha SHPK\"\n  },\n  \"lines\": [\n    {\n      \"product_name\": \"Double room\",\n      \"product_code\": \"ROOM-DBL\",\n      \"unit\": \"night\",\n      \"quantity\": 3,\n      \"price\": 9000,\n      \"total\": 27000,\n      \"vat\": 6\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Cash Fiscal Invoice",
      "item": [
        {
          "name": "Cash invoice",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{token}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoice/cash",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoice",
                "cash"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"internalId\": \"ARK-2026-0001\",\n  \"payment_method\": \"CARD\",\n  \"lines\": [\n    {\n      \"product_name\": \"Breakfast\",\n      \"product_code\": \"BRK-01\",\n      \"unit\": \"piece\",\n      \"quantity\": 2,\n      \"price\": 800,\n      \"total\": 1600,\n      \"vat\": 20\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "E-Invoice",
      "item": [
        {
          "name": "E-invoice",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{token}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoice/e-invoice",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoice",
                "e-invoice"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"internalId\": \"EF-2026-0098\",\n  \"doc_type\": \"380\",\n  \"process\": \"P1\",\n  \"payment_method\": \"TRANSFER\",\n  \"client\": {\n    \"nuis\": \"L62221018T\",\n    \"name\": \"Ei3 Software Solution shpk\",\n    \"address\": \"Rruga e Kavajës 12\",\n    \"city\": \"Tiranë\",\n    \"country\": \"ALB\"\n  },\n  \"lines\": [\n    {\n      \"product_name\": \"Conference hall\",\n      \"product_code\": \"HALL-01\",\n      \"unit\": \"day\",\n      \"unit_code\": \"DAY\",\n      \"quantity\": 1,\n      \"price\": 40000,\n      \"total\": 40000,\n      \"vat\": 20\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Reservations Advance Deposits",
      "item": [
        {
          "name": "Deposit paid at the front desk (cash invoice)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{token}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoice/cash",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoice",
                "cash"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"internalId\": \"DEP-2026-0031\",\n  \"payment_method\": \"CARD\",\n  \"notes\": \"Advance for reservation R-88213, 12 to 15 October\",\n  \"lines\": [\n    {\n      \"product_name\": \"Advance, reservation R-88213\",\n      \"product_code\": \"DEP-RES\",\n      \"unit\": \"piece\",\n      \"quantity\": 1,\n      \"price\": 10000,\n      \"total\": 10000,\n      \"vat\": 6\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Deposit paid by bank transfer (non-cash invoice)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{token}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoice/noncash",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoice",
                "noncash"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"internalId\": \"DEP-2026-0033\",\n  \"payment_method\": \"TRANSFER\",\n  \"client\": {\n    \"name\": \"Arben Hoxha\"\n  },\n  \"notes\": \"Advance for reservation R-88215\",\n  \"lines\": [\n    {\n      \"product_name\": \"Advance, reservation R-88215\",\n      \"product_code\": \"DEP-RES\",\n      \"unit\": \"piece\",\n      \"quantity\": 1,\n      \"price\": 20000,\n      \"total\": 20000,\n      \"vat\": 6\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Deposit from a business that receives e-invoices (doc_type 386, P4)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{token}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoice/e-invoice",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoice",
                "e-invoice"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"internalId\": \"DEP-2026-0032\",\n  \"doc_type\": \"386\",\n  \"process\": \"P4\",\n  \"payment_method\": \"TRANSFER\",\n  \"client\": {\n    \"nuis\": \"L62221018T\",\n    \"name\": \"Ei3 Software Solution shpk\",\n    \"address\": \"Rruga e Kavajës 12\",\n    \"city\": \"Tiranë\",\n    \"country\": \"ALB\"\n  },\n  \"lines\": [\n    {\n      \"product_name\": \"Advance, reservation R-88214\",\n      \"product_code\": \"DEP-RES\",\n      \"unit\": \"piece\",\n      \"unit_code\": \"C62\",\n      \"quantity\": 1,\n      \"price\": 30000,\n      \"total\": 30000,\n      \"vat\": 6\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Group Advance Deposits",
      "item": [
        {
          "name": "Group deposit, several payers (bulk non-cash)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{token}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoice/bulk-noncash",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoice",
                "bulk-noncash"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"invoices\": [\n    {\n      \"internalId\": \"DEP-GRP-0007-01\",\n      \"payment_method\": \"TRANSFER\",\n      \"client\": {\n        \"name\": \"Arben Hoxha\"\n      },\n      \"lines\": [\n        {\n          \"product_name\": \"Advance, group G-0007\",\n          \"product_code\": \"DEP-GRP\",\n          \"unit\": \"piece\",\n          \"quantity\": 1,\n          \"price\": 15000,\n          \"total\": 15000,\n          \"vat\": 6\n        }\n      ]\n    },\n    {\n      \"internalId\": \"DEP-GRP-0007-02\",\n      \"payment_method\": \"TRANSFER\",\n      \"client\": {\n        \"name\": \"Elira Kola\"\n      },\n      \"lines\": [\n        {\n          \"product_name\": \"Advance, group G-0007\",\n          \"product_code\": \"DEP-GRP\",\n          \"unit\": \"piece\",\n          \"quantity\": 1,\n          \"price\": 15000,\n          \"total\": 15000,\n          \"vat\": 6\n        }\n      ]\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Credit Note",
      "item": [
        {
          "name": "Credit note on a non-cash invoice",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{token}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoice/noncash",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoice",
                "noncash"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"internalId\": \"CN-2026-0037\",\n  \"doc_type\": \"381\",\n  \"original_invoice_iic\": \"8FE72E2ACD1C500A83F8C89B4E2E3E1D\",\n  \"payment_method\": \"TRANSFER\",\n  \"client\": {\n    \"name\": \"Alpha SHPK\"\n  },\n  \"lines\": [\n    {\n      \"product_name\": \"Discount, one unused night\",\n      \"product_code\": \"ROOM-DBL\",\n      \"unit\": \"night\",\n      \"quantity\": 1,\n      \"price\": 9000,\n      \"total\": 9000,\n      \"vat\": 6\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Credit note on an e-invoice (process P9)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{token}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoice/e-invoice",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoice",
                "e-invoice"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"internalId\": \"CN-2026-0038\",\n  \"doc_type\": \"381\",\n  \"process\": \"P9\",\n  \"original_invoice_iic\": \"8FE72E2ACD1C500A83F8C89B4E2E3E1D\",\n  \"payment_method\": \"TRANSFER\",\n  \"client\": {\n    \"nuis\": \"L62221018T\",\n    \"name\": \"Ei3 Software Solution shpk\",\n    \"address\": \"Rruga e Kavajës 12\",\n    \"city\": \"Tiranë\",\n    \"country\": \"ALB\"\n  },\n  \"lines\": [\n    {\n      \"product_name\": \"Discount, service interruption\",\n      \"product_code\": \"HALL-01\",\n      \"unit\": \"day\",\n      \"unit_code\": \"DAY\",\n      \"quantity\": 1,\n      \"price\": 2000,\n      \"total\": 2000,\n      \"vat\": 20\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Debit Note",
      "item": [
        {
          "name": "Debit note on a non-cash invoice",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{token}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoice/noncash",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoice",
                "noncash"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"internalId\": \"DN-2026-0012\",\n  \"doc_type\": \"383\",\n  \"original_invoice_iic\": \"8FE72E2ACD1C500A83F8C89B4E2E3E1D\",\n  \"payment_method\": \"TRANSFER\",\n  \"client\": {\n    \"name\": \"Alpha SHPK\"\n  },\n  \"lines\": [\n    {\n      \"product_name\": \"Minibar, not invoiced\",\n      \"product_code\": \"MINIBAR\",\n      \"unit\": \"piece\",\n      \"quantity\": 4,\n      \"price\": 500,\n      \"total\": 2000,\n      \"vat\": 20\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Corrective Fiscal Invoice",
      "item": [
        {
          "name": "Full cancellation (any invoice type)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{token}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoice/cancel/40312",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoice",
                "cancel",
                "40312"
              ]
            }
          }
        },
        {
          "name": "Partial cancellation (cash invoices only)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{token}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoice/cancel/40313",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoice",
                "cancel",
                "40313"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"lines\": [\n    {\n      \"product_name\": \"Breakfast\",\n      \"product_code\": \"BRK-01\",\n      \"quantity\": 1\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Full cancellation by your own number",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Authorization",
                "value": "Bearer {{token}}"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoice/cancel-by-internal-id/ARK-2026-0001",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoice",
                "cancel-by-internal-id",
                "ARK-2026-0001"
              ]
            }
          }
        }
      ]
    }
  ]
}