{ "openapi": "3.1.0", "info": { "title": "fature.al API v2", "version": "2.0", "description": "# fature.al API v2\n\nVersioni 2 mban dy grupe: **faturat** dhe **klient\u00ebt**. Vet\u00ebm k\u00ebto ndryshojn\u00eb form\u00eb nga v1, prandaj\nvet\u00ebm k\u00ebto kan\u00eb adres\u00eb t\u00eb dyt\u00eb. Gjith\u00e7ka tjet\u00ebr, flet\u00ebt shoq\u00ebruese, faturat e blerjes, produktet,\narka fiskale, raportet dhe regjistrimi, mbetet te `v1` dhe thirret prej andej edhe nga nj\u00eb integrim\nq\u00eb faturat i d\u00ebrgon me `v2`.\n\nT\u00eb dy versionet ndajn\u00eb token-in, kredencialet e aplikacionit, formatin e p\u00ebrgjigjes dhe kufijt\u00eb e\nk\u00ebrkesave. Konceptet, identifikimi dhe rregullat e p\u00ebrbashk\u00ebta jan\u00eb te dokumentacioni i v1, te\n[`\/docs\/api`](\/docs\/api). N\u00ebse nuk e keni lexuar, filloni prej andej.\n\n## Serverat\n\n| Mjedisi | URL |\n| --- | --- |\n| **Live** | `https:\/\/fature.al\/api\/v2` |\n| **Sandbox** | `https:\/\/demo.fature.al\/api\/v2` |\n\n## \u00c7far\u00eb ndryshon nga v1\n\n### Pagesa e fatur\u00ebs \u00ebsht\u00eb gjithmon\u00eb list\u00eb\n\nFatura e d\u00ebrgon pages\u00ebn si `payment_methods`, me nj\u00eb element p\u00ebr \u00e7do m\u00ebnyr\u00eb. Nj\u00eb fatur\u00eb e paguar me\nnj\u00eb m\u00ebnyr\u00eb t\u00eb vetme d\u00ebrgon nj\u00eb list\u00eb me nj\u00eb element, k\u00ebshtu q\u00eb ka nj\u00eb form\u00eb t\u00eb vetme p\u00ebr t'u m\u00ebsuar.\n\n```json\n\"payment_methods\": [\n {\"type\": \"BANKNOTE\", \"amount\": 1200},\n {\"type\": \"CARD\", \"amount\": 800}\n]\n```\n\n| Rregulli | Kufiri |\n| --- | --- |\n| Sa m\u00ebnyra mban nj\u00eb fatur\u00eb | 10 |\n| Vlera e nj\u00eb `amount` | \u00c7do num\u00ebr q\u00eb pranon CIS-i, edhe 0 dhe negative |\n| E nj\u00ebjta m\u00ebnyr\u00eb dy her\u00eb | Nuk lejohet |\n| Shuma e `amount` | Sa totali i fatur\u00ebs, me zbritjen tashm\u00eb t\u00eb zbatuar |\n\nFushat `payment_method`, `company_card` dhe `vouchers` mbi fatur\u00ebn nuk pranohen: karta e kompanis\u00eb\nshkon te `payment_methods[].company_card` dhe tollonat te `payment_methods[].vouchers`, brenda\nelementit q\u00eb i k\u00ebrkon. Faturat q\u00eb kthehen nga listat dhe detajet e mbajn\u00eb po at\u00eb list\u00eb, ndaj\nrakordimi i pagesave lexon gjithmon\u00eb nj\u00eb form\u00eb t\u00eb vetme.\n\nFatura porosi nuk mban pages\u00eb fare: ajo hap tavolin\u00ebn, dhe p\u00ebrmbledh\u00ebsja e paguan.\n\n### Klienti ndahet n\u00eb objekte\n\n- **Objekte n\u00eb vend t\u00eb fushave t\u00eb sheshta.** T\u00eb dh\u00ebnat vijn\u00eb n\u00eb `company`, `person`, `address` dhe\n `contact`, dhe fusha `type` (`company` ose `person`) thot\u00eb cili nga dy t\u00eb par\u00ebt \u00ebsht\u00eb i plot\u00ebsuar.\n- **Identifikuesi \u00ebsht\u00eb objekt.** `id` me `type` (`nuis`, `vat`, `tax` p\u00ebr kompani; `id`,\n `passport`, `social` p\u00ebr persona) dhe `value`, n\u00eb vend t\u00eb `nipt` ose `document_number`.\n- **Vlerat jan\u00eb me shkronja t\u00eb vogla.** `company` n\u00eb vend t\u00eb `COMPANY`, `nuis` n\u00eb vend t\u00eb `NUIS`.\n- **P\u00ebrdit\u00ebsimi b\u00ebhet me `PATCH`**, jo me `PUT`, dhe `type` nuk ndryshon: nj\u00eb `type` i ndrysh\u00ebm nga\n ai ekzistues refuzohet me `422`.\n\n`GET \/clients` e v2 kthen ende formatin e shesht\u00eb t\u00eb v1, sepse aplikacioni celular u nd\u00ebrtua mbi t\u00eb.\nDetajet, krijimi dhe p\u00ebrdit\u00ebsimi jan\u00eb n\u00eb formatin e ri, dhe nj\u00eb klient i krijuar me `v1` lexohet me\n`v2` pa asnj\u00eb hap tjet\u00ebr." }, "servers": [ { "url": "https:\/\/fature.al\/api\/v2", "description": "Live" }, { "url": "https:\/\/demo.fature.al\/api\/v2", "description": "Sandbox" } ], "tags": [ { "name": "Faturat", "description": "L\u00ebshimi i faturave dhe gjith\u00e7ka q\u00eb vjen pas tij: cash, jo-cash, e-fatur\u00eb, porosi, p\u00ebrmbledh\u00ebse dhe bulk jo-cash, si dhe lista, detajet, anulimi dhe dokumenti p\u00ebr printim.\n\nK\u00ebrkesa dhe p\u00ebrgjigja jan\u00eb ato t\u00eb v1, me nj\u00eb ndryshim t\u00eb vet\u00ebm: pagesa jepet dhe kthehet gjithmon\u00eb si list\u00eb `payment_methods`, me nj\u00eb element p\u00ebr \u00e7do m\u00ebnyr\u00eb pagese. Nj\u00eb fatur\u00eb e paguar me nj\u00eb m\u00ebnyr\u00eb t\u00eb vetme d\u00ebrgon nj\u00eb list\u00eb me nj\u00eb element. Fushat `payment_method`, `company_card` dhe `vouchers` mbi fatur\u00ebn nuk pranohen: karta e kompanis\u00eb dhe tollonat rrin\u00eb brenda elementit q\u00eb i k\u00ebrkon.\n\nFlet\u00ebt shoq\u00ebruese dhe faturat e blerjes nuk mbajn\u00eb m\u00ebnyr\u00eb pagese dhe nuk ndryshojn\u00eb n\u00eb v2, ndaj thirren te `v1`." }, { "name": "Klient\u00ebt", "description": "Klient\u00ebt e kompanis\u00eb, bler\u00ebsit q\u00eb dalin n\u00eb fatur\u00eb: lista, detajet, krijimi dhe p\u00ebrdit\u00ebsimi, si dhe k\u00ebrkimi i nj\u00eb biznesi sipas NIPT-it n\u00eb regjistrin fiskal.\n\nJu duhet kur mbani regjistrin e klient\u00ebve n\u00eb fature.al, ose kur doni t\u00eb verifikoni nj\u00eb NIPT para se ta vini n\u00eb fatur\u00eb. P\u00ebr nj\u00eb fatur\u00eb t\u00eb vetme mjafton objekti `client` gjat\u00eb l\u00ebshimit; klienti nuk ka nevoj\u00eb t\u00eb krijohet m\u00eb par\u00eb." } ], "security": [ { "bearerAuth": [], "clientId": [], "clientSecret": [] }, { "bearerAuth": [] } ], "paths": { "\/invoice\/e-invoice": { "post": { "operationId": "v2.invoice.e-invoice", "description": "E nj\u00ebjta e-fatur\u00eb si te `v1`, me pages\u00ebn si list\u00eb `payment_methods`. P\u00ebr bler\u00ebsin, llojin e\ndokumentit (`doc_type` dhe `process`) dhe notat e korrigjimit vlejn\u00eb rregullat e\n[`POST \/api\/v1\/invoice\/e-invoice`](\/docs\/api).", "summary": "L\u00ebsho e-fatur\u00eb", "tags": [ "Faturat" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/EInvoiceRequest" } } } }, "responses": { "200": { "description": "Kur fatura refuzohet pas validimit, nga CIS-i ose gjat\u00eb ruajtjes, p\u00ebrgjigja kthehet me HTTP 200 dhe `status: false`; arsyeja \u00ebsht\u00eb te `message`.", "content": { "application\/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "invoice": { "$ref": "#\/components\/schemas\/InvoiceIssueResult" } }, "required": [ "invoice" ] } }, "required": [ "status", "data" ] }, { "$ref": "#\/components\/schemas\/ApiError" } ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "422": { "description": "T\u00eb dh\u00ebnat nuk kaluan validimin. Kjo p\u00ebrgjigje p\u00ebrdor fush\u00ebn `success`, jo `status`, dhe `errors` \u00ebsht\u00eb objekt sipas fush\u00ebs. Vet\u00ebm `internalId` q\u00eb mungon kthehet me formatin standard t\u00eb gabimit.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiValidationError" }, { "$ref": "#\/components\/schemas\/ApiError" } ] } } } }, "400": { "description": "T\u00eb dh\u00ebna t\u00eb paplota ose t\u00eb pavlefshme p\u00ebr fiskalizim. `errors` thot\u00eb sakt\u00eb \u00e7far\u00eb duhet plot\u00ebsuar. Fatura nuk u ruajt; riprovoni me t\u00eb nj\u00ebjtin `internalId`.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "403": { "description": "Abonimi ka mbaruar, ose veprimi nuk lejohet p\u00ebr k\u00ebt\u00eb llogari.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "409": { "description": "Nj\u00eb k\u00ebrkes\u00eb me k\u00ebt\u00eb `internalId` \u00ebsht\u00eb ende n\u00eb proces. Prisni pak dhe riprovoni, ose lexoni gjendjen me `POST \/invoice\/details\/{internalId}`.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit. Nga kufiri i p\u00ebrgjithsh\u00ebm p\u00ebrgjigja mban vet\u00ebm `message` dhe header-in `Retry-After`; nga kufiri i endpoint-it mban formatin standard t\u00eb gabimit.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiError" }, { "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ] } ] } } }, "headers": { "Retry-After": { "description": "Pas sa sekondash mund t\u00eb riprovoni. E d\u00ebrgon vet\u00ebm nj\u00eb kufi me dritare kohore, si ai i p\u00ebrgjithsh\u00ebm ose ai i anulimeve; refuzimi i nj\u00eb k\u00ebrkese ende n\u00eb proces nuk e mban.", "schema": { "type": "integer" } } } }, "500": { "description": "Gabim i papritur n\u00eb server.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "503": { "description": "Sh\u00ebrbimi i fiskalizimit nuk u arrit dhe fatura nuk u ruajt. Riprovoni me t\u00eb nj\u00ebjtin `internalId`.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } } } } }, "\/invoice\/noncash": { "post": { "operationId": "v2.invoice.noncash", "description": "E nj\u00ebjta fatur\u00eb si te `v1`, me pages\u00ebn si list\u00eb `payment_methods`. P\u00ebr bler\u00ebsin, llogarin\u00eb\nbankare, notat e korrigjimit dhe zbritjet vlejn\u00eb rregullat e\n[`POST \/api\/v1\/invoice\/noncash`](\/docs\/api).\n\nM\u00ebnyrat e lejuara jan\u00eb `ACCOUNT`, `COMPENSATION`, `FACTORING`, `KIND`, `OTHER`, `TRANSFER`\ndhe `WAIVER`; asnj\u00ebra nuk mban kart\u00eb kompanie ose tollona. Kur m\u00ebnyra q\u00eb paguan pjes\u00ebn m\u00eb t\u00eb\nmadhe \u00ebsht\u00eb `ACCOUNT`, fatura k\u00ebrkon llogarin\u00eb bankare, si te `v1`.", "summary": "L\u00ebsho fatur\u00eb jo-cash", "tags": [ "Faturat" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/NonCashInvoiceRequest" } } } }, "responses": { "200": { "description": "Kur fatura refuzohet pas validimit, nga CIS-i ose gjat\u00eb ruajtjes, p\u00ebrgjigja kthehet me HTTP 200 dhe `status: false`; arsyeja \u00ebsht\u00eb te `message`.", "content": { "application\/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "invoice": { "$ref": "#\/components\/schemas\/InvoiceIssueResult" } }, "required": [ "invoice" ] } }, "required": [ "status", "data" ] }, { "$ref": "#\/components\/schemas\/ApiError" } ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "422": { "description": "T\u00eb dh\u00ebnat nuk kaluan validimin. Kjo p\u00ebrgjigje p\u00ebrdor fush\u00ebn `success`, jo `status`, dhe `errors` \u00ebsht\u00eb objekt sipas fush\u00ebs. Vet\u00ebm `internalId` q\u00eb mungon kthehet me formatin standard t\u00eb gabimit.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiValidationError" }, { "$ref": "#\/components\/schemas\/ApiError" } ] } } } }, "400": { "description": "T\u00eb dh\u00ebna t\u00eb paplota ose t\u00eb pavlefshme p\u00ebr fiskalizim. `errors` thot\u00eb sakt\u00eb \u00e7far\u00eb duhet plot\u00ebsuar. Fatura nuk u ruajt; riprovoni me t\u00eb nj\u00ebjtin `internalId`.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "403": { "description": "Abonimi ka mbaruar, ose veprimi nuk lejohet p\u00ebr k\u00ebt\u00eb llogari.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "409": { "description": "Nj\u00eb k\u00ebrkes\u00eb me k\u00ebt\u00eb `internalId` \u00ebsht\u00eb ende n\u00eb proces. Prisni pak dhe riprovoni, ose lexoni gjendjen me `POST \/invoice\/details\/{internalId}`.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit. Nga kufiri i p\u00ebrgjithsh\u00ebm p\u00ebrgjigja mban vet\u00ebm `message` dhe header-in `Retry-After`; nga kufiri i endpoint-it mban formatin standard t\u00eb gabimit.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiError" }, { "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ] } ] } } }, "headers": { "Retry-After": { "description": "Pas sa sekondash mund t\u00eb riprovoni. E d\u00ebrgon vet\u00ebm nj\u00eb kufi me dritare kohore, si ai i p\u00ebrgjithsh\u00ebm ose ai i anulimeve; refuzimi i nj\u00eb k\u00ebrkese ende n\u00eb proces nuk e mban.", "schema": { "type": "integer" } } } }, "500": { "description": "Gabim i papritur n\u00eb server.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "503": { "description": "Sh\u00ebrbimi i fiskalizimit nuk u arrit dhe fatura nuk u ruajt. Riprovoni me t\u00eb nj\u00ebjtin `internalId`.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } } } } }, "\/invoice\/cash": { "post": { "operationId": "v2.invoice.cash", "description": "E nj\u00ebjta fatur\u00eb si te `v1`, me pages\u00ebn si list\u00eb. P\u00ebr bler\u00ebsin, rreshtat, zbritjet dhe\nvet\u00ebfaturimin vlejn\u00eb rregullat e [`POST \/api\/v1\/invoice\/cash`](\/docs\/api).\n\n## Pagesa\n\n`payment_methods` mban nj\u00eb element p\u00ebr \u00e7do m\u00ebnyr\u00eb dhe \u00ebsht\u00eb i detyruesh\u00ebm edhe kur fatura\npaguhet e gjitha me nj\u00eb m\u00ebnyr\u00eb.\n\n```json\n\"payment_methods\": [\n {\"type\": \"BANKNOTE\", \"amount\": 1200},\n {\"type\": \"CARD\", \"amount\": 800}\n]\n```\n\n| Rregulli | Kufiri |\n| --- | --- |\n| Sa m\u00ebnyra mban nj\u00eb fatur\u00eb | 10 |\n| E nj\u00ebjta m\u00ebnyr\u00eb dy her\u00eb | Nuk lejohet |\n| Shuma e `amount` | Sa totali i fatur\u00ebs, me zbritjen tashm\u00eb t\u00eb zbatuar |\n\nElementi `COMPANY` mban vet\u00eb `company_card`, dhe elementi `SVOUCHER` mban vet\u00eb `vouchers`.\nNj\u00eb list\u00eb q\u00eb nuk e mbledh totalin refuzohet me `400`, sepse shuma kontrollohet vet\u00ebm pasi\nzbritja mbi fatur\u00ebn \u00ebsht\u00eb zbatuar.\n\nVet\u00ebfaturimi paguhet nga arka, si te `v1`: kur arka nuk mbulon totalin, fatura nuk ruhet dhe\np\u00ebrgjigja vjen me HTTP 200 dhe `status: false`.", "summary": "L\u00ebsho fatur\u00eb cash", "tags": [ "Faturat" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/CashInvoice" } } } }, "responses": { "200": { "description": "Kur p\u00ebrdoruesi nuk ka pajisje fiskale, kur arka nuk mbulon nj\u00eb vet\u00ebfaturim, ose kur fatura refuzohet pas validimit nga CIS-i ose gjat\u00eb ruajtjes, p\u00ebrgjigja kthehet me HTTP 200 dhe `status: false`; arsyeja \u00ebsht\u00eb te `message`.", "content": { "application\/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "invoice": { "$ref": "#\/components\/schemas\/InvoiceIssueResult" } }, "required": [ "invoice" ] } }, "required": [ "status", "data" ] }, { "$ref": "#\/components\/schemas\/ApiError" } ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "422": { "description": "T\u00eb dh\u00ebnat nuk kaluan validimin. Kjo p\u00ebrgjigje p\u00ebrdor fush\u00ebn `success`, jo `status`, dhe `errors` \u00ebsht\u00eb objekt sipas fush\u00ebs. Vet\u00ebm `internalId` q\u00eb mungon kthehet me formatin standard t\u00eb gabimit.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiValidationError" }, { "$ref": "#\/components\/schemas\/ApiError" } ] } } } }, "400": { "description": "T\u00eb dh\u00ebna t\u00eb paplota ose t\u00eb pavlefshme p\u00ebr fiskalizim. `errors` thot\u00eb sakt\u00eb \u00e7far\u00eb duhet plot\u00ebsuar. Fatura nuk u ruajt; riprovoni me t\u00eb nj\u00ebjtin `internalId`.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "403": { "description": "Abonimi ka mbaruar, ose veprimi nuk lejohet p\u00ebr k\u00ebt\u00eb llogari.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "409": { "description": "Nj\u00eb k\u00ebrkes\u00eb me k\u00ebt\u00eb `internalId` \u00ebsht\u00eb ende n\u00eb proces. Prisni pak dhe riprovoni, ose lexoni gjendjen me `POST \/invoice\/details\/{internalId}`.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit. Nga kufiri i p\u00ebrgjithsh\u00ebm p\u00ebrgjigja mban vet\u00ebm `message` dhe header-in `Retry-After`; nga kufiri i endpoint-it mban formatin standard t\u00eb gabimit.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiError" }, { "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ] } ] } } }, "headers": { "Retry-After": { "description": "Pas sa sekondash mund t\u00eb riprovoni. E d\u00ebrgon vet\u00ebm nj\u00eb kufi me dritare kohore, si ai i p\u00ebrgjithsh\u00ebm ose ai i anulimeve; refuzimi i nj\u00eb k\u00ebrkese ende n\u00eb proces nuk e mban.", "schema": { "type": "integer" } } } }, "500": { "description": "Gabim i papritur n\u00eb server.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "503": { "description": "Sh\u00ebrbimi i fiskalizimit nuk u arrit dhe fatura nuk u ruajt. Riprovoni me t\u00eb nj\u00ebjtin `internalId`.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } } } } }, "\/invoice\/order": { "post": { "operationId": "v2.invoice.order", "description": "E nj\u00ebjta porosi si te `v1`. Porosia hap tavolin\u00ebn dhe nuk paguan asgj\u00eb, ndaj nuk mban as\n`payment_method` dhe as `payment_methods`: pagesa vjen m\u00eb von\u00eb, me fatur\u00ebn p\u00ebrmbledh\u00ebse q\u00eb e\nmbyll tavolin\u00ebn. Rregullat jan\u00eb ato t\u00eb [`POST \/api\/v1\/invoice\/order`](\/docs\/api).", "summary": "L\u00ebsho fatur\u00eb porosi", "tags": [ "Faturat" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/OrderInvoice" } } } }, "responses": { "200": { "description": "Kur p\u00ebrdoruesi nuk ka pajisje fiskale, ose kur fatura refuzohet pas validimit nga CIS-i ose gjat\u00eb ruajtjes, p\u00ebrgjigja kthehet me HTTP 200 dhe `status: false`; arsyeja \u00ebsht\u00eb te `message`.", "content": { "application\/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "invoice": { "$ref": "#\/components\/schemas\/OrderInvoiceIssueResult" } }, "required": [ "invoice" ] } }, "required": [ "status", "data" ] }, { "$ref": "#\/components\/schemas\/ApiError" } ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "422": { "description": "T\u00eb dh\u00ebnat nuk kaluan validimin. Kjo p\u00ebrgjigje p\u00ebrdor fush\u00ebn `success`, jo `status`, dhe `errors` \u00ebsht\u00eb objekt sipas fush\u00ebs. Vet\u00ebm `internalId` q\u00eb mungon kthehet me formatin standard t\u00eb gabimit.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiValidationError" }, { "$ref": "#\/components\/schemas\/ApiError" } ] } } } }, "400": { "description": "T\u00eb dh\u00ebna t\u00eb paplota ose t\u00eb pavlefshme p\u00ebr fiskalizim. `errors` thot\u00eb sakt\u00eb \u00e7far\u00eb duhet plot\u00ebsuar. Fatura nuk u ruajt; riprovoni me t\u00eb nj\u00ebjtin `internalId`.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "403": { "description": "Abonimi ka mbaruar, ose veprimi nuk lejohet p\u00ebr k\u00ebt\u00eb llogari.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "409": { "description": "Nj\u00eb k\u00ebrkes\u00eb me k\u00ebt\u00eb `internalId` \u00ebsht\u00eb ende n\u00eb proces. Prisni pak dhe riprovoni, ose lexoni gjendjen me `POST \/invoice\/details\/{internalId}`.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit. Nga kufiri i p\u00ebrgjithsh\u00ebm p\u00ebrgjigja mban vet\u00ebm `message` dhe header-in `Retry-After`; nga kufiri i endpoint-it mban formatin standard t\u00eb gabimit.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiError" }, { "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ] } ] } } }, "headers": { "Retry-After": { "description": "Pas sa sekondash mund t\u00eb riprovoni. E d\u00ebrgon vet\u00ebm nj\u00eb kufi me dritare kohore, si ai i p\u00ebrgjithsh\u00ebm ose ai i anulimeve; refuzimi i nj\u00eb k\u00ebrkese ende n\u00eb proces nuk e mban.", "schema": { "type": "integer" } } } }, "500": { "description": "Gabim i papritur n\u00eb server.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "503": { "description": "Sh\u00ebrbimi i fiskalizimit nuk u arrit dhe fatura nuk u ruajt. Riprovoni me t\u00eb nj\u00ebjtin `internalId`.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } } } } }, "\/invoice\/summary": { "post": { "operationId": "v2.invoice.summary", "description": "Mbyll pages\u00ebn e nj\u00eb ose m\u00eb shum\u00eb faturave porosi me nj\u00eb dokument t\u00eb vet\u00ebm, si te `v1`, me\npages\u00ebn si list\u00eb `payment_methods`. Nj\u00eb tavolin\u00eb e paguar gjysm\u00eb me para n\u00eb dor\u00eb dhe gjysm\u00eb me\nkart\u00eb d\u00ebrgon nj\u00eb list\u00eb me dy elemente; e paguar e gjitha me kart\u00eb, nj\u00eb list\u00eb me nj\u00eb element.\nLejohen vet\u00ebm `BANKNOTE` dhe `CARD`. Rregullat p\u00ebr `order_invoices` dhe zbritjen jan\u00eb ato t\u00eb\n[`POST \/api\/v1\/invoice\/summary`](\/docs\/api).", "summary": "L\u00ebsho fatur\u00eb p\u00ebrmbledh\u00ebse", "tags": [ "Faturat" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/SummaryInvoice" } } } }, "responses": { "200": { "description": "Kur p\u00ebrdoruesi nuk ka pajisje fiskale, ose kur fatura refuzohet pas validimit nga CIS-i ose gjat\u00eb ruajtjes, p\u00ebrgjigja kthehet me HTTP 200 dhe `status: false`; arsyeja \u00ebsht\u00eb te `message`.", "content": { "application\/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "invoice": { "$ref": "#\/components\/schemas\/SummaryInvoiceIssueResult" } }, "required": [ "invoice" ] } }, "required": [ "status", "data" ] }, { "$ref": "#\/components\/schemas\/ApiError" } ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "422": { "description": "T\u00eb dh\u00ebnat nuk kaluan validimin. Kjo p\u00ebrgjigje p\u00ebrdor fush\u00ebn `success`, jo `status`, dhe `errors` \u00ebsht\u00eb objekt sipas fush\u00ebs. Vet\u00ebm `internalId` q\u00eb mungon kthehet me formatin standard t\u00eb gabimit.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiValidationError" }, { "$ref": "#\/components\/schemas\/ApiError" } ] } } } }, "400": { "description": "Nj\u00eb porosi nuk u gjet, nuk \u00ebsht\u00eb fatur\u00eb porosi, ose \u00ebsht\u00eb mbyllur tashm\u00eb; ose t\u00eb dh\u00ebnat jan\u00eb t\u00eb paplota p\u00ebr fiskalizim. `errors` thot\u00eb sakt\u00eb cila. Fatura nuk u ruajt; riprovoni me t\u00eb nj\u00ebjtin `internalId`.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "403": { "description": "Abonimi ka mbaruar, ose veprimi nuk lejohet p\u00ebr k\u00ebt\u00eb llogari.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "409": { "description": "Nj\u00eb k\u00ebrkes\u00eb me k\u00ebt\u00eb `internalId` \u00ebsht\u00eb ende n\u00eb proces. Prisni pak dhe riprovoni, ose lexoni gjendjen me `POST \/invoice\/details\/{internalId}`.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit. Nga kufiri i p\u00ebrgjithsh\u00ebm p\u00ebrgjigja mban vet\u00ebm `message` dhe header-in `Retry-After`; nga kufiri i endpoint-it mban formatin standard t\u00eb gabimit.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiError" }, { "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ] } ] } } }, "headers": { "Retry-After": { "description": "Pas sa sekondash mund t\u00eb riprovoni. E d\u00ebrgon vet\u00ebm nj\u00eb kufi me dritare kohore, si ai i p\u00ebrgjithsh\u00ebm ose ai i anulimeve; refuzimi i nj\u00eb k\u00ebrkese ende n\u00eb proces nuk e mban.", "schema": { "type": "integer" } } } }, "500": { "description": "Gabim i papritur n\u00eb server.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "503": { "description": "Sh\u00ebrbimi i fiskalizimit nuk u arrit dhe fatura nuk u ruajt. Riprovoni me t\u00eb nj\u00ebjtin `internalId`.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } } } } }, "\/invoice\/cancel\/{id}": { "post": { "operationId": "v2.invoice.cancel", "description": "I nj\u00ebjti anulim si te `v1`: pa body anulohet e gjith\u00eb fatura, me `lines` vet\u00ebm nj\u00eb pjes\u00eb e\nsaj, e mundur **vet\u00ebm p\u00ebr faturat cash**. Rregullat e plota jan\u00eb te\n[`POST \/api\/v1\/invoice\/cancel\/{id}`](\/docs\/api).\n\nP\u00ebrgjigja \u00ebsht\u00eb dokumenti korrigjues, me `iic` dhe `fic` t\u00eb vetat dhe me `payment_methods`\nbashk\u00eb me t\u00eb. Kur CIS-i nuk arrihet, anulimi ruhet me `fic: null` dhe fiskalizohet vet\u00eb m\u00eb\nvon\u00eb. Anulimet kan\u00eb kufirin e tyre t\u00eb k\u00ebrkesave: 30 n\u00eb minut\u00eb dhe 600 n\u00eb or\u00eb p\u00ebr token.", "summary": "Anulo nj\u00eb fatur\u00eb sipas id", "tags": [ "Faturat" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Id-ja e fatur\u00ebs n\u00eb fature.al.", "schema": { "type": "integer" }, "example": 403 } ], "requestBody": { "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/CancelInvoiceRequest" } } } }, "responses": { "200": { "description": "Dokumenti korrigjues, me `iic` dhe `fic` t\u00eb vetat; `fic` \u00ebsht\u00eb `null` kur CIS-i nuk u arrit dhe fiskalizimi do t\u00eb p\u00ebrfundoj\u00eb vet\u00eb.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "invoice": { "anyOf": [ { "$ref": "#\/components\/schemas\/InvoiceIssueResult" }, { "$ref": "#\/components\/schemas\/OrderInvoiceIssueResult" }, { "$ref": "#\/components\/schemas\/SummaryInvoiceIssueResult" } ] } }, "required": [ "invoice" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "422": { "description": "Fatura nuk mund t\u00eb anulohet n\u00eb gjendjen e saj aktuale, ose rreshtat e d\u00ebrguar nuk p\u00ebrputhen me origjinalin. `errors` thot\u00eb pse.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "404": { "description": "Fatura nuk u gjet, ose nuk i p\u00ebrket kompanis\u00eb suaj.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "500": { "description": "Gabim i papritur n\u00eb server, p\u00ebrfshir\u00eb rastin kur anulimi nuk u regjistrua dot te CIS-i.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "429": { "description": "Kufiri i anulimeve u arrit, ose nj\u00eb anulim tjet\u00ebr i t\u00eb nj\u00ebjtit tip \u00ebsht\u00eb ende n\u00eb proces. Nga kufiri i anulimeve p\u00ebrgjigja mban vet\u00ebm `message` dhe header-in `Retry-After`.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiError" }, { "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ] } ] } } }, "headers": { "Retry-After": { "description": "Pas sa sekondash mund t\u00eb riprovoni. E d\u00ebrgon vet\u00ebm nj\u00eb kufi me dritare kohore, si ai i p\u00ebrgjithsh\u00ebm ose ai i anulimeve; refuzimi i nj\u00eb k\u00ebrkese ende n\u00eb proces nuk e mban.", "schema": { "type": "integer" } } } } } } }, "\/invoice\/cancel-by-internal-id\/{internalId}": { "post": { "operationId": "v2.invoice.cancel-by-internal-id", "description": "I nj\u00ebjti anulim si te `v1`, duke e gjetur fatur\u00ebn me `internalId`-n\u00eb q\u00eb d\u00ebrguat kur e l\u00ebshuat:\npa body anulohet e gjith\u00eb fatura, me `lines` vet\u00ebm nj\u00eb pjes\u00eb e saj, e mundur **vet\u00ebm p\u00ebr\nfaturat cash**. Rregullat e plota jan\u00eb te\n[`POST \/api\/v1\/invoice\/cancel-by-internal-id\/{internalId}`](\/docs\/api).\n\nP\u00ebrgjigja \u00ebsht\u00eb dokumenti korrigjues, me `iic` dhe `fic` t\u00eb vetat dhe me `payment_methods`\nbashk\u00eb me t\u00eb. Kur CIS-i nuk arrihet, anulimi ruhet me `fic: null` dhe fiskalizohet vet\u00eb m\u00eb\nvon\u00eb.", "summary": "Anulo nj\u00eb fatur\u00eb sipas internalId", "tags": [ "Faturat" ], "parameters": [ { "name": "internalId", "in": "path", "required": true, "description": "Identifikuesi juaj i fatur\u00ebs, i d\u00ebrguar kur u l\u00ebshua.", "schema": { "type": "string" }, "example": "CASH-001" } ], "requestBody": { "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/CancelInvoiceRequest" } } } }, "responses": { "200": { "description": "Dokumenti korrigjues, me `iic` dhe `fic` t\u00eb vetat; `fic` \u00ebsht\u00eb `null` kur CIS-i nuk u arrit dhe fiskalizimi do t\u00eb p\u00ebrfundoj\u00eb vet\u00eb.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "invoice": { "anyOf": [ { "$ref": "#\/components\/schemas\/InvoiceIssueResult" }, { "$ref": "#\/components\/schemas\/OrderInvoiceIssueResult" }, { "$ref": "#\/components\/schemas\/SummaryInvoiceIssueResult" } ] } }, "required": [ "invoice" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "422": { "description": "Fatura nuk mund t\u00eb anulohet n\u00eb gjendjen e saj aktuale, ose rreshtat e d\u00ebrguar nuk p\u00ebrputhen me origjinalin. `errors` thot\u00eb pse.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "404": { "description": "Fatura nuk u gjet, ose nuk i p\u00ebrket kompanis\u00eb suaj.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "500": { "description": "Gabim i papritur n\u00eb server, p\u00ebrfshir\u00eb rastin kur anulimi nuk u regjistrua dot te CIS-i.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "429": { "description": "Kufiri i anulimeve u arrit, ose nj\u00eb anulim tjet\u00ebr i t\u00eb nj\u00ebjtit tip \u00ebsht\u00eb ende n\u00eb proces. Nga kufiri i anulimeve p\u00ebrgjigja mban vet\u00ebm `message` dhe header-in `Retry-After`.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiError" }, { "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ] } ] } } }, "headers": { "Retry-After": { "description": "Pas sa sekondash mund t\u00eb riprovoni. E d\u00ebrgon vet\u00ebm nj\u00eb kufi me dritare kohore, si ai i p\u00ebrgjithsh\u00ebm ose ai i anulimeve; refuzimi i nj\u00eb k\u00ebrkese ende n\u00eb proces nuk e mban.", "schema": { "type": "integer" } } } } } } }, "\/invoice\/bulk-noncash": { "post": { "operationId": "v2.invoice.bulk-noncash", "description": "I nj\u00ebjti bulk si te `v1`, ku \u00e7do fatur\u00eb e `invoices` mban pages\u00ebn e vet si list\u00eb\n`payment_methods`. P\u00ebrgjigja \u00ebsht\u00eb nj\u00eb objekt me nj\u00eb hyrje p\u00ebr \u00e7do `internalId`, dhe statusi\nHTTP mbetet `200` edhe kur ndonj\u00eb fatur\u00eb d\u00ebshton: kontrolloni `status` brenda \u00e7do hyrjeje dhe\nriprovoni vet\u00ebm ato q\u00eb d\u00ebshtuan.", "summary": "L\u00ebsho fatura jo-cash n\u00eb bulk", "tags": [ "Faturat" ], "responses": { "200": { "description": "Nj\u00eb objekt me nj\u00eb hyrje p\u00ebr \u00e7do `internalId`. Nj\u00eb fatur\u00eb q\u00eb d\u00ebshton mban formatin e gabimit brenda hyrjes s\u00eb vet, dhe statusi i p\u00ebrgjigjes mbetet 200.", "content": { "application\/json": { "schema": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "invoice": { "$ref": "#\/components\/schemas\/InvoiceIssueResult" } }, "required": [ "invoice" ] } }, "required": [ "status", "data" ] }, { "$ref": "#\/components\/schemas\/ApiError" } ] } } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "403": { "description": "Abonimi ka mbaruar, ose veprimi nuk lejohet p\u00ebr k\u00ebt\u00eb llogari.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit. Nga kufiri i p\u00ebrgjithsh\u00ebm p\u00ebrgjigja mban vet\u00ebm `message` dhe header-in `Retry-After`; nga kufiri i endpoint-it mban formatin standard t\u00eb gabimit.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiError" }, { "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ] } ] } } }, "headers": { "Retry-After": { "description": "Pas sa sekondash mund t\u00eb riprovoni. E d\u00ebrgon vet\u00ebm nj\u00eb kufi me dritare kohore, si ai i p\u00ebrgjithsh\u00ebm ose ai i anulimeve; refuzimi i nj\u00eb k\u00ebrkese ende n\u00eb proces nuk e mban.", "schema": { "type": "integer" } } } }, "500": { "description": "Gabim i papritur n\u00eb server.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } } } } }, "\/invoice\/print\/{id}": { "get": { "operationId": "v2.invoice.pdf", "description": "Kthen dokumentin e fatur\u00ebs p\u00ebr t'ia dh\u00ebn\u00eb bler\u00ebsit ose p\u00ebr ta printuar. Pa parametra kthehet\nformati i parazgjedhur i tipit: kupon termik p\u00ebr faturat cash (58 ose 80 mm, sipas\nkonfigurimit t\u00eb p\u00ebrdoruesit), dokument A4 p\u00ebr faturat jo-cash dhe preventiv\u00ebt, dhe PDF-ja\nzyrtare nga platforma e e-faturave p\u00ebr e-faturat.\n\nMe parametrin `format` merrni t\u00eb nj\u00ebjtat versione q\u00eb ofron edhe paneli i fature.al:\n\n| `format` | Tipi i fatur\u00ebs | Rezultati | Content-Type |\n| --- | --- | --- | --- |\n| `a4` | Cash | Dokument A4 i fatur\u00ebs | application\/pdf |\n| `thermal` | Jo-cash | Kupon termik | application\/pdf |\n| `v2` | Jo-cash, preventiv | Dokument A4, versioni i gjer\u00eb | application\/pdf |\n| `receipt` | Preventiv | Kupon termik | application\/pdf |\n| `local` | E-fatur\u00eb | Dokument A4 i gjeneruar nga fature.al, pa e k\u00ebrkuar PDF-n\u00eb zyrtare | application\/pdf |\n| `local-thermal` | E-fatur\u00eb | Kupon termik i gjeneruar nga fature.al | application\/pdf |\n| `html` | Cash | Kuponi termik si HTML, p\u00ebr ta d\u00ebrguar vet\u00eb n\u00eb printer | text\/html |\n| `json` | T\u00eb gjitha | T\u00eb dh\u00ebnat e dokumentit n\u00eb JSON, p\u00ebr ta formatuar vet\u00eb fatur\u00ebn | application\/json |\n\n`lang` (`en`, `it`, `de`) e p\u00ebrkthen dokumentin A4 t\u00eb faturave jo-cash, t\u00eb preventiv\u00ebve dhe t\u00eb\ne-faturave, dhe kombinohet me `format`. Pa t\u00eb, dokumenti kthehet shqip. Kuponat termik\u00eb dhe\nfaturat cash mbeten gjithmon\u00eb shqip, sepse jan\u00eb dokumente fiskale.\n\nP\u00ebr faturat cash, `copy_only=1` kthen kopjen e kuponit n\u00eb vend t\u00eb origjinalit.\n\nNj\u00eb `format` q\u00eb nuk vlen p\u00ebr tipin e fatur\u00ebs nuk kthen gabim: kthehet formati i parazgjedhur i\natij tipi.", "summary": "Shkarko dokumentin e fatur\u00ebs", "tags": [ "Faturat" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Id-ja e fatur\u00ebs n\u00eb fature.al.", "schema": { "type": "integer" }, "example": 403 }, { "name": "copy_only", "in": "query", "description": "Vet\u00ebm p\u00ebr faturat cash: kthen kopjen e kuponit n\u00eb vend t\u00eb origjinalit.", "schema": { "type": "integer" }, "example": 1 }, { "name": "format", "in": "query", "description": "Versioni i dokumentit sipas tabel\u00ebs m\u00eb sip\u00ebr: `a4`, `thermal`, `v2`, `receipt`, `local`, `local-thermal`, `html`, `json`.", "schema": { "type": "string" }, "example": "a4" }, { "name": "lang", "in": "query", "description": "Gjuha e dokumentit A4: `en`, `it` ose `de`. Pa t\u00eb dokumenti kthehet shqip.", "schema": { "type": "string" }, "example": "en" } ], "responses": { "200": { "description": "Tipi i p\u00ebrmbajtjes varet nga `format`: PDF si parazgjedhje, `text\/html` me `format=html`, dhe dokumenti i fatur\u00ebs n\u00eb JSON me `format=json`, gati p\u00ebr ta formatuar vet\u00eb.", "content": { "application\/pdf": { "schema": { "type": "string", "format": "binary" } }, "application\/json": { "schema": { "$ref": "#\/components\/schemas\/InvoicePrintDocument" } }, "text\/html": { "schema": { "type": "string" } } }, "headers": { "Content-Disposition": { "schema": { "type": "string" } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "404": { "description": "Fatura nuk u gjet, ose nuk i p\u00ebrket kompanis\u00eb suaj.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ] } } } } } } }, "\/invoice\/print-eic\/{eic}": { "get": { "operationId": "v2.einvoice.pdf", "description": "Kthen PDF-n\u00eb zyrtare t\u00eb e-fatur\u00ebs nga platforma e e-faturave, sipas kodit EIC q\u00eb ju ktheu\nl\u00ebshimi.\n\nKontrolloni `Content-Type` para se ta ruani si PDF: nj\u00eb EIC q\u00eb nuk gjendet kthen tekstin\n`Document not found.` me statusin `200` dhe `text\/html`, jo nj\u00eb PDF.", "summary": "Shkarko PDF-n\u00eb e e-fatur\u00ebs sipas EIC", "tags": [ "Faturat" ], "parameters": [ { "name": "eic", "in": "path", "required": true, "description": "Kodi EIC i e-fatur\u00ebs, nj\u00eb UUID.", "schema": { "type": "string" }, "example": "2e9b6f31-d712-4c45-8cc0-9faf24c805a3" } ], "responses": { "200": { "description": "PDF-ja e e-fatur\u00ebs. Kontrolloni `Content-Type` para se ta ruani: nj\u00eb EIC q\u00eb nuk gjendet kthehet po me statusin 200, por si `text\/html`.", "content": { "application\/pdf": { "schema": { "type": "string", "format": "binary" } }, "text\/html": { "schema": { "type": "string" } } }, "headers": { "Content-Disposition": { "schema": { "type": "string" } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" } } } }, "\/invoice": { "get": { "operationId": "v2.invoice.list", "description": "E nj\u00ebjta list\u00eb si te `v1`, ku \u00e7do fatur\u00eb mban `payment_methods` n\u00eb vend t\u00eb `payment_method`.\nFiltrat dhe pagination jan\u00eb ata t\u00eb [`GET \/api\/v1\/invoice`](\/docs\/api).", "summary": "Listo faturat", "tags": [ "Faturat" ], "responses": { "200": { "description": "Faturat e periudh\u00ebs te `items`, nga m\u00eb e reja te m\u00eb e vjetra, me `pagination`; `items` \u00ebsht\u00eb bosh kur nuk ka fatura.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#\/components\/schemas\/InvoiceListItem" } }, "pagination": { "$ref": "#\/components\/schemas\/InvoiceListPagination" } }, "required": [ "items", "pagination" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" } } } }, "\/invoice\/{id}\/details": { "get": { "operationId": "v2.invoice.details", "description": "T\u00eb nj\u00ebjtat detaje si te `v1`, ku pagesa vjen si list\u00eb `payment_methods`. Kur fatura nuk gjendet,\n`data.invoice` \u00ebsht\u00eb `null` me statusin `200`.", "summary": "Merr nj\u00eb fatur\u00eb sipas id", "tags": [ "Faturat" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Id-ja e fatur\u00ebs n\u00eb fature.al.", "schema": { "type": "integer" }, "example": 403 } ], "responses": { "200": { "description": "Fatura e plot\u00eb te `data.invoice`, ose `null` kur nuk gjendet.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "invoice": { "anyOf": [ { "$ref": "#\/components\/schemas\/InvoiceDetail" }, { "type": "null" } ] } }, "required": [ "invoice" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" } } } }, "\/invoice\/details\/{internalId}": { "post": { "operationId": "v2.invoice.details-by-internal-id", "description": "I nj\u00ebjti rezultat l\u00ebshimi si te `v1`, me `payment_methods` bashk\u00eb me t\u00eb. P\u00ebrdoreni p\u00ebr t\u00eb lexuar\ngjendjen pas nj\u00eb timeout-i ose pas nj\u00eb `409`.", "summary": "Merr nj\u00eb fatur\u00eb sipas internalId", "tags": [ "Faturat" ], "parameters": [ { "name": "internalId", "in": "path", "required": true, "description": "Identifikuesi juaj i fatur\u00ebs, i d\u00ebrguar kur u l\u00ebshua.", "schema": { "type": "string" }, "example": "CASH-001" } ], "responses": { "200": { "description": "Rezultati i l\u00ebshimit t\u00eb fatur\u00ebs me k\u00ebt\u00eb `internalId`, i nj\u00ebjti q\u00eb ktheu l\u00ebshimi, me `payment_methods`.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "invoice": { "anyOf": [ { "$ref": "#\/components\/schemas\/InvoiceIssueResult" }, { "$ref": "#\/components\/schemas\/OrderInvoiceIssueResult" }, { "$ref": "#\/components\/schemas\/SummaryInvoiceIssueResult" } ] } }, "required": [ "invoice" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" } } } }, "\/clients": { "get": { "operationId": "v2.clients.list", "description": "Kthen klient\u00ebt e kompanis\u00eb, nga m\u00eb i riu te m\u00eb i vjetri, me k\u00ebrkim me tekst. \u00c7do klient vjen\nme t\u00eb nj\u00ebjtat fusha si te `GET \/clients\/{id}\/details`.\n\nP\u00ebrdoreni p\u00ebr t\u00eb gjetur `id`-n\u00eb e nj\u00eb klienti t\u00eb ruajtur, ose p\u00ebr t\u00eb sinkronizuar regjistrin\ntuaj me at\u00eb t\u00eb fature.al.\n\n- Pagination me `limit` dhe `offset`. `limit` kufizohet n\u00eb `100`; nj\u00eb vler\u00eb m\u00eb e madhe ulet pa\n gabim. `pagination` kthen `total`, ndaj vazhdoni me `offset += limit` derisa `offset` t\u00eb\n arrij\u00eb `total`.\n- `query` k\u00ebrkon me p\u00ebrputhje t\u00eb pjesshme n\u00eb emrin e kompanis\u00eb, emrin, mbiemrin, NIPT-in,\n numrin e dokumentit, email-in, telefonin dhe numrin e klientit.\n- Nj\u00eb k\u00ebrkes\u00eb e dyt\u00eb nga i nj\u00ebjti token, nd\u00ebrsa e para nuk ka mbaruar, refuzohet menj\u00ebher\u00eb me\n `429`.\n\n`company_type` kthehet `null` p\u00ebr nj\u00eb person, `first_name` dhe `surname` p\u00ebr nj\u00eb kompani;\n`name` mban gjithmon\u00eb emrin e plot\u00eb.", "summary": "Listo klient\u00ebt", "tags": [ "Klient\u00ebt" ], "parameters": [ { "name": "limit", "in": "query", "description": "Sa klient\u00eb t\u00eb kthehen n\u00eb nj\u00eb faqe, deri n\u00eb 100.", "schema": { "type": "integer", "default": 20 }, "example": 20 }, { "name": "offset", "in": "query", "description": "Nga cili klient t\u00eb fillohet, duke num\u00ebruar nga 0.", "schema": { "type": "integer", "default": 0 }, "example": 0 }, { "name": "query", "in": "query", "description": "K\u00ebrkim n\u00eb emrin e kompanis\u00eb, emrin, mbiemrin, NIPT-in, numrin e dokumentit, email-in, telefonin ose numrin e klientit.", "schema": { "type": "string" }, "example": "Agon" } ], "responses": { "200": { "description": "Klient\u00ebt e faqes te `items`, me `pagination`; `items` \u00ebsht\u00eb bosh kur asnj\u00eb klient nuk p\u00ebrputhet.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#\/components\/schemas\/ClientV1" } }, "pagination": { "$ref": "#\/components\/schemas\/ClientListPagination" } }, "required": [ "items", "pagination" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit. Nga kufiri i p\u00ebrgjithsh\u00ebm p\u00ebrgjigja mban vet\u00ebm `message` dhe header-in `Retry-After`; nga kufiri i endpoint-it mban formatin standard t\u00eb gabimit.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiError" }, { "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ] } ] } } }, "headers": { "Retry-After": { "description": "Pas sa sekondash mund t\u00eb riprovoni. E d\u00ebrgon vet\u00ebm nj\u00eb kufi me dritare kohore, si ai i p\u00ebrgjithsh\u00ebm ose ai i anulimeve; refuzimi i nj\u00eb k\u00ebrkese ende n\u00eb proces nuk e mban.", "schema": { "type": "integer" } } } }, "500": { "description": "Gabim i papritur n\u00eb server.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } } } }, "post": { "operationId": "v2.clients.create", "description": "Krijon nj\u00eb klient n\u00eb formatin e v2. Body ndahet sipas fush\u00ebs `type`, q\u00eb pranon `company` ose\n`person`, dhe plot\u00ebsohet vet\u00ebm objekti q\u00eb i p\u00ebrket llojit.\n\n| `type` | Objekti | Fushat e detyrueshme |\n| --- | --- | --- |\n| `company` | `company` | `name`, `id` |\n| `person` | `person` | `first_name`, `last_name`, `id` |\n\n## Identifikuesi\n\nJepet gjithmon\u00eb si objekt `id` me `type` dhe `value`, dhe vlerat e lejuara varen nga lloji:\n\n- kompani: `nuis`, `vat`, `tax`;\n- person: `id`, `passport`, `social`.\n\n## Objektet e p\u00ebrbashk\u00ebta\n\n`address` (`line`, `city`, `country` me tre shkronja) dhe `contact` (`phone`, `email`) jan\u00eb\nopsionale dhe vlejn\u00eb p\u00ebr t\u00eb dy llojet. `company.category` pranon `business`, `bank` ose\n`exchange`.\n\nRuani `id`-n\u00eb q\u00eb kthehet: me t\u00eb klienti gjendet dhe p\u00ebrdit\u00ebsohet p\u00ebrs\u00ebri. Nj\u00eb k\u00ebrkes\u00eb e dyt\u00eb\nnga i nj\u00ebjti token, nd\u00ebrsa e para nuk ka mbaruar, refuzohet menj\u00ebher\u00eb me `429`.", "summary": "Krijo nj\u00eb klient", "tags": [ "Klient\u00ebt" ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ClientV2Request" } } } }, "responses": { "200": { "description": "Klienti i krijuar te `data.client`, me `id`-n\u00eb e tij n\u00eb fature.al; ruajeni p\u00ebr faturat dhe p\u00ebr p\u00ebrdit\u00ebsimet.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "client": { "$ref": "#\/components\/schemas\/ClientV2" } }, "required": [ "client" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "422": { "description": "T\u00eb dh\u00ebnat nuk kaluan validimin. Kjo p\u00ebrgjigje p\u00ebrdor fush\u00ebn `success`, jo `status`, dhe `errors` \u00ebsht\u00eb objekt sipas fush\u00ebs.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiValidationError" } } } }, "403": { "description": "Abonimi ka mbaruar, ose veprimi nuk lejohet p\u00ebr k\u00ebt\u00eb llogari.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "409": { "description": "Ekziston tashm\u00eb nj\u00eb klient me t\u00eb nj\u00ebjtat t\u00eb dh\u00ebna.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit. Nga kufiri i p\u00ebrgjithsh\u00ebm p\u00ebrgjigja mban vet\u00ebm `message` dhe header-in `Retry-After`; nga kufiri i endpoint-it mban formatin standard t\u00eb gabimit.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiError" }, { "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ] } ] } } }, "headers": { "Retry-After": { "description": "Pas sa sekondash mund t\u00eb riprovoni. E d\u00ebrgon vet\u00ebm nj\u00eb kufi me dritare kohore, si ai i p\u00ebrgjithsh\u00ebm ose ai i anulimeve; refuzimi i nj\u00eb k\u00ebrkese ende n\u00eb proces nuk e mban.", "schema": { "type": "integer" } } } }, "500": { "description": "Gabim i papritur n\u00eb server.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } } } } }, "\/clients\/{id}": { "get": { "operationId": "v2.clients.show", "description": "Kthen klientin n\u00eb formatin e v2: `company` ose `person` sipas `type`, plus `address`,\n`contact`, `customer_number` dhe `verified`.\n\n\u00cbsht\u00eb i nj\u00ebjti klient q\u00eb kthen edhe `v1`, vet\u00ebm i strukturuar ndryshe. Nj\u00eb klient i krijuar me\n`v1` lexohet k\u00ebtu pa asnj\u00eb hap tjet\u00ebr.", "summary": "Merr nj\u00eb klient sipas id", "tags": [ "Klient\u00ebt" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Id-ja e klientit.", "schema": { "type": "integer" }, "example": 42 } ], "responses": { "200": { "description": "Klienti te `data.client`, me `company` ose `person` t\u00eb mbushur sipas llojit t\u00eb tij.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "client": { "$ref": "#\/components\/schemas\/ClientV2" } }, "required": [ "client" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "404": { "description": "Klienti nuk u gjet, ose nuk i p\u00ebrket kompanis\u00eb suaj.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "500": { "description": "Gabim i papritur n\u00eb server.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } } } }, "patch": { "operationId": "v2.clients.update", "description": "P\u00ebrdit\u00ebson nj\u00eb klient me `PATCH` dhe me t\u00eb nj\u00ebjtin body si krijimi, me nj\u00eb kufizim: `type`\nnuk ndryshon. Nj\u00eb kompani nuk b\u00ebhet person dhe as e kund\u00ebrta; nj\u00eb `type` i ndrysh\u00ebm nga ai\nekzistues refuzohet me `422`.\n\nNj\u00eb k\u00ebrkes\u00eb e dyt\u00eb nga i nj\u00ebjti token, nd\u00ebrsa e para nuk ka mbaruar, refuzohet menj\u00ebher\u00eb me\n`429`.", "summary": "P\u00ebrdit\u00ebso nj\u00eb klient", "tags": [ "Klient\u00ebt" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Id-ja e klientit.", "schema": { "type": "integer" }, "example": 42 } ], "requestBody": { "required": true, "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ClientV2Request" } } } }, "responses": { "200": { "description": "Klienti i p\u00ebrdit\u00ebsuar te `data.client`, i plot\u00eb, jo vet\u00ebm fushat e d\u00ebrguara.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "client": { "$ref": "#\/components\/schemas\/ClientV2" } }, "required": [ "client" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "422": { "description": "T\u00eb dh\u00ebnat nuk kaluan validimin. Kjo p\u00ebrgjigje p\u00ebrdor fush\u00ebn `success`, jo `status`, dhe `errors` \u00ebsht\u00eb objekt sipas fush\u00ebs. Vet\u00ebm nj\u00eb `type` i ndrysh\u00ebm nga ai ekzistues kthehet me formatin standard t\u00eb gabimit.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiValidationError" }, { "$ref": "#\/components\/schemas\/ApiError" } ] } } } }, "403": { "description": "Abonimi ka mbaruar, ose veprimi nuk lejohet p\u00ebr k\u00ebt\u00eb llogari.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "404": { "description": "Klienti nuk u gjet, ose nuk i p\u00ebrket kompanis\u00eb suaj.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "409": { "description": "Ekziston tashm\u00eb nj\u00eb klient me t\u00eb nj\u00ebjtat t\u00eb dh\u00ebna.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit. Nga kufiri i p\u00ebrgjithsh\u00ebm p\u00ebrgjigja mban vet\u00ebm `message` dhe header-in `Retry-After`; nga kufiri i endpoint-it mban formatin standard t\u00eb gabimit.", "content": { "application\/json": { "schema": { "anyOf": [ { "$ref": "#\/components\/schemas\/ApiError" }, { "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ] } ] } } }, "headers": { "Retry-After": { "description": "Pas sa sekondash mund t\u00eb riprovoni. E d\u00ebrgon vet\u00ebm nj\u00eb kufi me dritare kohore, si ai i p\u00ebrgjithsh\u00ebm ose ai i anulimeve; refuzimi i nj\u00eb k\u00ebrkese ende n\u00eb proces nuk e mban.", "schema": { "type": "integer" } } } }, "500": { "description": "Gabim i papritur n\u00eb server.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/ApiError" } } } } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "description": "Token-i i p\u00ebrdoruesit, nga Konfigurime > API Tokens.", "scheme": "bearer" }, "clientId": { "type": "apiKey", "description": "Client id i aplikacionit tuaj, fillon me ft_id_", "in": "header", "name": "X-Client-Id" }, "clientSecret": { "type": "apiKey", "description": "Client secret i aplikacionit tuaj, fillon me ft_sk_", "in": "header", "name": "X-Client-Secret" } }, "schemas": { "ApiError": { "type": "object", "properties": { "status": { "type": "boolean", "description": "Gjithmon\u00eb false. Nj\u00eb p\u00ebrgjigje e suksesshme mban `status: true` dhe objektin `data`.", "examples": [ false ] }, "message": { "type": "string", "description": "P\u00ebrshkrimi i gabimit. Bosh kur d\u00ebshtimi nuk mban ndonj\u00eb mesazh t\u00eb vetin.", "examples": [ "Te dhenat jo te sakta." ] }, "errors": { "type": "array", "description": "Mesazhe p\u00ebr t'u shfaqur te p\u00ebrdoruesi ose p\u00ebr t'u ruajtur n\u00eb log. Mungon kur nuk ka gj\u00eb\np\u00ebr t\u00eb shtuar p\u00ebrtej `message`.", "items": { "type": "string" } } }, "required": [ "status", "message", "errors" ], "title": "ApiError" }, "ApiValidationError": { "type": "object", "properties": { "success": { "type": "boolean", "description": "Gjithmon\u00eb false.", "examples": [ false ] }, "message": { "type": "string", "description": "Nj\u00eb rresht p\u00ebrmbledh\u00ebs, i nj\u00ebjt\u00eb p\u00ebr \u00e7do d\u00ebshtim validimi.", "examples": [ "Te dhena jo te sakta" ] }, "errors": { "type": "object", "description": "Fushat q\u00eb nuk kaluan validimin, secila me mesazhet e veta. \u00c7el\u00ebsat me pik\u00eb tregojn\u00eb brenda\nobjekteve dhe element\u00ebve t\u00eb array-ve, p.sh. `lines.0.quantity`.", "additionalProperties": { "type": "array", "items": { "type": "string" } } } }, "required": [ "success", "message", "errors" ], "title": "ApiValidationError" }, "CancelInvoiceRequest": { "type": "object", "properties": { "lines": { "type": "array", "description": "Rreshtat q\u00eb anulohen. Pa t\u00eb anulohet e gjith\u00eb fatura; me t\u00eb anulohet vet\u00ebm pjesa e\nd\u00ebrguar, e mundur vet\u00ebm p\u00ebr faturat cash. \u00c7do rresht duhet t\u00eb ekzistoj\u00eb n\u00eb fatur\u00ebn\norigjinale me t\u00eb nj\u00ebjtin `product_code` dhe `product_name`, dhe sasia mund vet\u00ebm t\u00eb ulet. Nj\u00eb fatur\u00eb e l\u00ebshuar me zbritje mbi t\u00eb gjith\u00eb fatur\u00ebn nuk pranon anulim t\u00eb pjessh\u00ebm:\nd\u00ebrgojeni k\u00ebrkes\u00ebn pa `lines`, q\u00eb t\u00eb anulohet e plot\u00eb.", "items": { "type": "object", "properties": { "product_name": { "type": "string", "description": "Emri i produktit, si\u00e7 \u00ebsht\u00eb n\u00eb fatur\u00ebn origjinale." }, "product_code": { "type": "string", "description": "Kodi i produktit, si\u00e7 \u00ebsht\u00eb n\u00eb fatur\u00ebn origjinale." }, "quantity": { "type": "number", "description": "Sasia q\u00eb kthehet, m\u00eb e madhe se 0 dhe jo m\u00eb e madhe se ajo e fatur\u00ebs origjinale." }, "price": { "type": [ "number", "null" ], "description": "\u00c7mimi p\u00ebr nj\u00ebsi, me TVSH. Duhet vet\u00ebm kur i nj\u00ebjti produkt \u00ebsht\u00eb faturuar n\u00eb dy\nrreshta me \u00e7mime t\u00eb ndryshme, q\u00eb t\u00eb dallohet cili rresht anulohet." } }, "required": [ "product_name", "product_code", "quantity" ] }, "minItems": 1 } }, "title": "CancelInvoiceRequest" }, "CashInvoice": { "type": "object", "description": "Fatura me para ne dore, ne formen e v2.\n\nCdo fushe tjeter eshte fjale per fjale ajo e v1, dhe nje test e mban ashtu.\nNdryshon vetem pagesa: ketu ajo jepet gjithmone si liste `payment_methods`,\nedhe kur fatura shlyhet me nje menyre te vetme, keshtu qe nje integrim i ri\nmesohet me nje forme te vetme ne vend te dyjave.\n\nKarta e kompanise dhe tollonat rrine brenda elementit qe i kerkon.\n\nRregullat jane shkruar te plota dhe nuk merren nga klasa e v1, sepse\ngjeneruesi i dokumentacionit e lexon `rules()` si tekst dhe nga nje thirrje\n`parent::rules()` nuk merr dot asnje fushe. Shihni V2RequestRulesParityTest.", "properties": { "internalId": { "type": "string", "description": "Identifikuesi i fatur\u00ebs n\u00eb sistemin tuaj, unik brenda kompanis\u00eb p\u00ebr vitin; sh\u00ebrben edhe si\n\u00e7el\u00ebs idempotence. I detyruesh\u00ebm.", "examples": [ "CASH-001" ] }, "client": { "type": "object", "description": "Bler\u00ebsi. Opsional: pa t\u00eb fatura l\u00ebshohet p\u00ebr klientin e rastit. Me `client.internal_id` merret nj\u00eb klient i ruajtur n\u00eb fature.al; ndryshe `client.name` b\u00ebhet i detyruesh\u00ebm sapo d\u00ebrgoni \u00e7far\u00ebdo fushe tjet\u00ebr t\u00eb `client`.", "properties": { "internal_id": { "type": [ "integer", "null" ], "description": "Id-ja e nj\u00eb klienti t\u00eb ruajtur n\u00eb fature.al. Kur e d\u00ebrgoni, bler\u00ebsi merret prej saj dhe fushat e tjera t\u00eb `client` nuk lexohen." }, "name": { "type": [ "string", "null" ], "description": "Emri i bler\u00ebsit. I detyruesh\u00ebm sapo d\u00ebrgoni \u00e7far\u00ebdo fushe tjet\u00ebr t\u00eb `client`.", "examples": [ "Klient i rastit" ] }, "id": { "type": [ "object", "null" ], "description": "Dokumenti i identifikimit t\u00eb bler\u00ebsit, si objekt me `type` dhe `id`.", "properties": { "type": { "type": [ "string", "null" ], "description": "Lloji i dokumentit: `NUIS` p\u00ebr nj\u00eb biznes shqiptar, `VAT` ose `TAX` p\u00ebr nj\u00eb biznes t\u00eb huaj, `ID`, `PASS` ose `SOC` p\u00ebr nj\u00eb person. Pa t\u00eb merret `NUIS`.", "enum": [ "NUIS", "VAT", "TAX", "ID", "PASS", "SOC", null ] }, "id": { "type": [ "string", "null" ], "description": "Numri i dokumentit t\u00eb identifikimit, p.sh. NIPT-i kur `type` \u00ebsht\u00eb `NUIS`.", "examples": [ "L62221018T" ] } } }, "address": { "type": [ "string", "null" ], "description": "Adresa e bler\u00ebsit; shkon te CIS-i. Nj\u00eb klient i em\u00ebruar e k\u00ebrkon, ose n\u00eb k\u00ebt\u00eb k\u00ebrkes\u00eb ose t\u00eb ruajtur m\u00eb par\u00eb te klienti n\u00eb fature.al." }, "city": { "type": [ "string", "null" ], "description": "Qyteti i bler\u00ebsit; shkon te CIS-i. Nj\u00eb klient i em\u00ebruar e k\u00ebrkon, ose n\u00eb k\u00ebt\u00eb k\u00ebrkes\u00eb ose t\u00eb ruajtur m\u00eb par\u00eb te klienti n\u00eb fature.al." }, "country": { "type": [ "string", "null" ], "description": "Shteti i bler\u00ebsit, kod ISO 3166-1 alpha-3, p.sh. `ALB`, `RKS`, `ITA`. Pa t\u00eb merret `ALB`." } } }, "lines": { "type": "array", "description": "Rreshtat e fatur\u00ebs, t\u00eb pakt\u00ebn nj\u00eb.", "items": { "type": "object", "properties": { "product_name": { "type": "string", "description": "Emri i produktit ose i sh\u00ebrbimit.", "examples": [ "Kafe" ] }, "product_code": { "type": "string", "description": "Kodi i produktit n\u00eb katalogun tuaj.", "examples": [ "KAF-001" ] }, "unit": { "type": "string", "description": "Nj\u00ebsia mat\u00ebse, si tekst q\u00eb lexon njeriu.", "examples": [ "cope" ] }, "quantity": { "type": "number", "description": "Sasia.", "examples": [ 2 ] }, "price": { "type": "number", "description": "\u00c7mimi p\u00ebr nj\u00ebsi, me TVSH.", "examples": [ 150 ] }, "total": { "type": "number", "description": "Totali i rreshtit, me TVSH.", "examples": [ 300 ] }, "discount": { "type": [ "number", "null" ], "description": "Zbritja e rreshtit, n\u00eb p\u00ebrqindje mbi \u00e7mimin e nj\u00ebsis\u00eb, nga 0 deri n\u00eb 100. Opsionale: pa t\u00eb,\nose me vler\u00eb bosh, rreshti kalon si\u00e7 e d\u00ebrgoni. `price` mbetet \u00e7mimi i plot\u00eb i nj\u00ebsis\u00eb, nd\u00ebrsa `total` d\u00ebrgohet tashm\u00eb i ulur: `price` her\u00eb\n`quantity`, me zbritjen e hequr. Nj\u00eb `total` q\u00eb nuk p\u00ebrputhet me at\u00eb shif\u00ebr e refuzon\nk\u00ebrkes\u00ebn me `400`, dhe `errors` thot\u00eb cili rresht dhe cila vler\u00eb pritej.", "examples": [ 10 ], "minimum": 0, "maximum": 100 }, "vat": { "type": "integer", "description": "Norma e TVSH-s\u00eb n\u00eb p\u00ebrqindje: `0`, `6`, `10` ose `20`. E detyrueshme. Kur biznesi juaj nuk \u00ebsht\u00eb n\u00eb skem\u00ebn e TVSH-s\u00eb, rreshti regjistrohet me TVSH `0` dhe\np\u00ebrjashtim `TAX_FREE`, sido q\u00eb ta d\u00ebrgoni k\u00ebt\u00eb fush\u00eb; k\u00ebrkesa nuk refuzohet.", "enum": [ "0", "6", "10", "20" ], "examples": [ 20 ] }, "vat_exempt_type": { "type": [ "string", "null" ], "description": "Lloji i p\u00ebrjashtimit nga TVSH-ja, kur rreshti \u00ebsht\u00eb i p\u00ebrjashtuar: `TYPE_1`, `TYPE_2`, `EXPORT_OF_GOODS` ose `TAX_FREE`.", "enum": [ "TYPE_1", "TYPE_2", "EXPORT_OF_GOODS", "TAX_FREE", null ] } }, "required": [ "product_name", "product_code", "unit", "quantity", "price", "total", "vat" ] }, "minItems": 1 }, "invoice_discount_type": { "type": [ "string", "null" ], "description": "Si lexohet `invoice_discount_value`: `percent` si p\u00ebrqindje, `amount` si vler\u00eb fikse me\nTVSH. Zbritja zbatohet mbi t\u00eb gjith\u00eb fatur\u00ebn: rreshtat ruhen si\u00e7 i d\u00ebrgoni dhe ulet vet\u00ebm\ntotali. Punon vet\u00ebm n\u00eb \u00e7ift me `invoice_discount_value`. Nj\u00ebra pa tjetr\u00ebn injorohet n\u00eb heshtje dhe\nfatura del pa zbritje.", "enum": [ "percent", "amount", null ], "examples": [ "percent" ] }, "invoice_discount_value": { "type": [ "number", "null" ], "description": "Vlera e zbritjes, e lexuar sipas `invoice_discount_type`: p\u00ebrqindje deri n\u00eb 100 kur tipi\n\u00ebsht\u00eb `percent`; vler\u00eb me TVSH n\u00eb monedh\u00ebn e fatur\u00ebs, deri n\u00eb totalin e fatur\u00ebs, kur tipi\n\u00ebsht\u00eb `amount`. Zeroja e l\u00eb fatur\u00ebn pa zbritje. Zbritja shp\u00ebrndahet mbi grupet e TVSH-s\u00eb sipas pesh\u00ebs s\u00eb secilit n\u00eb total dhe TVSH-ja\nrillogaritet mbi vler\u00ebn e ulur.", "examples": [ 10 ], "minimum": 0 }, "currency": { "type": [ "string", "null" ], "description": "Monedha e fatur\u00ebs, kod ISO 4217; pa t\u00eb merret `ALL`.", "examples": [ "ALL" ] }, "exchange_rate": { "type": [ "number", "null" ], "description": "Sa lek\u00eb vlen nj\u00eb nj\u00ebsi e monedh\u00ebs s\u00eb fatur\u00ebs. Pa t\u00eb, ose me vler\u00eb jo pozitive, merret 1. P\u00ebr\nmonedha q\u00eb vlejn\u00eb m\u00eb pak se nj\u00eb lek, si JPY ose HUF, d\u00ebrgoni vler\u00eb n\u00ebn 1.", "examples": [ 100.5 ] }, "due_date": { "type": [ "string", "null" ], "description": "Afati i pages\u00ebs, `YYYY-MM-DD`.", "examples": [ "2026-10-04" ] }, "supply_start_date": { "type": [ "string", "null" ], "description": "Fillimi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`, p\u00ebr fatura q\u00eb mbulojn\u00eb nj\u00eb interval.", "examples": [ "2026-09-01" ] }, "supply_end_date": { "type": [ "string", "null" ], "description": "Fundi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`.", "examples": [ "2026-09-30" ] }, "reverse_charge": { "type": [ "boolean", "null" ], "description": "Ngarkesa e kund\u00ebrt: TVSH-ja deklarohet nga bler\u00ebsi, jo nga shit\u00ebsi.", "examples": [ false ] }, "notes": { "type": [ "string", "null" ], "description": "Sh\u00ebnime q\u00eb shfaqen n\u00eb fatur\u00eb.", "examples": [ "Faleminderit per blerjen" ] }, "periodic_invoice": { "type": [ "boolean", "null" ], "description": "Sh\u00ebnon nj\u00eb fatur\u00eb t\u00eb nj\u00eb cikli t\u00eb p\u00ebrs\u00ebritur faturimi.", "examples": [ false ] }, "self_issue_type": { "type": [ "string", "null" ], "description": "Vet\u00ebfaturim: `DOMESTIC`, `ABROAD` ose `OTHER`. Kur e d\u00ebrgoni, `client` \u00ebsht\u00eb shit\u00ebsi dhe i\nduhet identifikimi (`client.id`) bashk\u00eb me shtetin. Pa t\u00eb fatura \u00ebsht\u00eb e zakonshme.", "enum": [ "DOMESTIC", "ABROAD", "OTHER", null ], "examples": [ "DOMESTIC" ] }, "payment_method": { "type": "string", "description": "Nuk pranohet n\u00eb v2: m\u00ebnyra e pages\u00ebs d\u00ebrgohet si element i `payment_methods`." }, "company_card": { "type": "string", "description": "Nuk pranohet mbi fatur\u00ebn n\u00eb v2: shkon te `payment_methods[].company_card`, brenda elementit `COMPANY`." }, "vouchers": { "type": "string", "description": "Nuk pranohen mbi fatur\u00ebn n\u00eb v2: shkojn\u00eb te `payment_methods[].vouchers`, brenda elementit `SVOUCHER`." }, "payment_methods": { "type": "array", "description": "M\u00ebnyrat e pages\u00ebs, nj\u00eb element p\u00ebr secil\u00ebn. E detyrueshme edhe kur fatura paguhet me nj\u00eb\nm\u00ebnyr\u00eb t\u00eb vetme; at\u00ebher\u00eb lista ka nj\u00eb element. Deri n\u00eb 10 elemente, e nj\u00ebjta m\u00ebnyr\u00eb nuk\np\u00ebrs\u00ebritet dhe shuma e `amount` duhet t\u00eb jet\u00eb sa totali i fatur\u00ebs, me zbritjen tashm\u00eb t\u00eb\nzbatuar; ndryshe k\u00ebrkesa refuzohet me `400`.", "examples": [ [ { "type": "BANKNOTE", "amount": 1200 }, { "type": "CARD", "amount": 800 } ] ], "items": { "type": "object", "properties": { "type": { "type": "string", "description": "M\u00ebnyra e pages\u00ebs e k\u00ebtij elementi: `BANKNOTE`, `CARD`, `CHECK`, `SVOUCHER`, `COMPANY` ose\n`ORDER`. E detyrueshme.", "enum": [ "BANKNOTE", "CARD", "CHECK", "SVOUCHER", "COMPANY", "ORDER" ], "examples": [ "BANKNOTE" ] }, "amount": { "type": "number", "description": "Sa paguhet me k\u00ebt\u00eb m\u00ebnyr\u00eb, me TVSH, n\u00eb monedh\u00ebn e fatur\u00ebs. E detyrueshme. Pranon \u00e7do vler\u00eb\nq\u00eb pranon CIS-i: edhe 0, p\u00ebr nj\u00eb fatur\u00eb me vler\u00eb 0, dhe negative.", "examples": [ 1200 ] }, "company_card": { "type": [ "string", "null" ], "description": "Karta e kompanis\u00eb. E detyrueshme vet\u00ebm n\u00eb elementin `COMPANY` dhe e refuzuar n\u00eb \u00e7do element\ntjet\u00ebr. Deri n\u00eb 50 karaktere.", "examples": [ "4111-2233" ], "maxLength": 50 }, "vouchers": { "type": [ "array", "null" ], "description": "Numrat seriale t\u00eb tollonave, n\u00eb form\u00ebn num\u00ebr-vit-NIPT, pa p\u00ebrs\u00ebritje, deri n\u00eb 20. T\u00eb\ndetyruesh\u00ebm vet\u00ebm n\u00eb elementin `SVOUCHER` dhe t\u00eb refuzuar n\u00eb \u00e7do element tjet\u00ebr.", "examples": [ [ "12-2026-K51501011M" ] ], "items": { "type": "string", "description": "Nj\u00eb tollon, n\u00eb form\u00ebn num\u00ebr-vit-NIPT. Nuk p\u00ebrs\u00ebritet brenda elementit.", "pattern": "^[1-9][0-9]{0,7}-[0-9]{4}-[a-zA-Z][0-9]{8}[a-zA-Z]$" }, "maxItems": 20, "uniqueItems": true } }, "required": [ "type", "amount" ] }, "minItems": 1, "maxItems": 10, "uniqueItems": true } }, "required": [ "internalId", "lines", "payment_methods" ], "title": "CashInvoice" }, "ClientListPagination": { "type": "object", "properties": { "records": { "type": "integer", "description": "Sa klient\u00eb mban `items` n\u00eb k\u00ebt\u00eb p\u00ebrgjigje.", "examples": [ 20 ] }, "total": { "type": "integer", "description": "Sa klient\u00eb p\u00ebrputhen gjithsej me k\u00ebrkimin, n\u00eb t\u00eb gjitha faqet.", "examples": [ 137 ] }, "limit": { "type": "integer", "description": "Kufiri q\u00eb u zbatua: ai q\u00eb d\u00ebrguat, i ulur n\u00eb `100` kur ishte m\u00eb i madh; `20` kur nuk d\u00ebrguat.", "examples": [ 20 ] }, "offset": { "type": "integer", "description": "Nga cili klient filloi kjo faqe, duke num\u00ebruar nga 0.", "examples": [ 0 ] } }, "required": [ "records", "total", "limit", "offset" ], "title": "ClientListPagination" }, "ClientV1": { "type": "object", "properties": { "id": { "type": "integer", "description": "Id-ja e klientit n\u00eb fature.al.", "examples": [ 42 ] }, "name": { "type": "string", "description": "Emri i plot\u00eb: emri i kompanis\u00eb te nj\u00eb kompani, emri dhe mbiemri te nj\u00eb person.", "examples": [ "Alpha SHPK" ] }, "client_type": { "type": [ "string", "null" ], "description": "`COMPANY` ose `PERSON`.", "examples": [ "COMPANY" ] }, "company_name": { "type": [ "string", "null" ], "description": "Emri i kompanis\u00eb; bosh ose null te nj\u00eb person.", "examples": [ "Alpha SHPK" ] }, "company_type": { "type": [ "string", "null" ], "description": "Kategoria e kompanis\u00eb: `BUSINESS`, `BANK` ose `EXCHANGE`. Gjithmon\u00eb null te nj\u00eb person.", "examples": [ "BUSINESS" ] }, "nipt": { "type": [ "string", "null" ], "description": "NIPT-i i kompanis\u00eb, ose numri VAT\/TAX i nj\u00eb biznesi t\u00eb huaj; null kur nuk ka.", "examples": [ "L91806031A" ] }, "first_name": { "type": [ "string", "null" ], "description": "Emri i personit; gjithmon\u00eb null te nj\u00eb kompani.", "examples": [ "Agon" ] }, "surname": { "type": [ "string", "null" ], "description": "Mbiemri i personit; gjithmon\u00eb null te nj\u00eb kompani.", "examples": [ "Hoxha" ] }, "birthday": { "type": [ "string", "null" ], "description": "Data e lindjes, `YYYY-MM-DD`; null kur nuk \u00ebsht\u00eb dh\u00ebn\u00eb.", "examples": [ "1990-01-15" ] }, "id_type": { "type": [ "string", "null" ], "description": "Lloji i dokumentit t\u00eb identifikimit: `NUIS`, `ID`, `PASS`, `VAT`, `TAX` ose `SOC`; null kur\nnuk \u00ebsht\u00eb regjistruar.", "examples": [ "NUIS" ] }, "id_num": { "type": [ "string", "null" ], "description": "Numri i dokumentit: NIPT-i te nj\u00eb kompani, numri i dokumentit personal te nj\u00eb person.", "examples": [ "L91806031A" ] }, "nationality_code": { "type": [ "string", "null" ], "description": "Shteti i klientit, kod ISO 3166-1 alpha-3.", "examples": [ "ALB" ] }, "nationality_id": { "type": [ "integer", "null" ], "description": "Id-ja e shtetit n\u00eb fature.al, \u00e7ifti i `nationality_code`.", "examples": [ 3 ] }, "telephone": { "type": [ "string", "null" ], "description": "Telefoni.", "examples": [ "+355691234567" ] }, "email": { "type": [ "string", "null" ], "description": "Email-i.", "examples": [ "info@alpha.al" ] }, "address": { "type": [ "string", "null" ], "description": "Adresa.", "examples": [ "Rruga e Kavaj\u00ebs 12" ] }, "city": { "type": [ "string", "null" ], "description": "Qyteti.", "examples": [ "Tiran\u00eb" ] }, "customer_number": { "type": [ "string", "null" ], "description": "Numri i klientit n\u00eb sistemin tuaj. Kur nuk e keni dh\u00ebn\u00eb, fature.al v\u00eb numrin rendor t\u00eb\nklientit brenda kompanis\u00eb.", "examples": [ "CLI-001" ] }, "created_at": { "type": [ "string", "null" ], "description": "Data dhe ora e krijimit, ISO 8601.", "examples": [ "2026-09-13T10:15:00+02:00" ] } }, "required": [ "id", "name", "client_type", "company_name", "company_type", "nipt", "first_name", "surname", "birthday", "id_type", "id_num", "nationality_code", "nationality_id", "telephone", "email", "address", "city", "customer_number", "created_at" ], "title": "ClientV1" }, "ClientV2": { "type": "object", "properties": { "id": { "type": "integer", "description": "Id-ja e klientit n\u00eb fature.al.", "examples": [ 8123 ] }, "type": { "type": "string", "description": "`company` ose `person`.", "examples": [ "company" ] }, "company": { "anyOf": [ { "description": "I plot\u00ebsuar kur `type` \u00ebsht\u00eb `company`, p\u00ebrndryshe null.", "$ref": "#\/components\/schemas\/ClientV2Company" }, { "type": "null" } ] }, "person": { "anyOf": [ { "description": "I plot\u00ebsuar kur `type` \u00ebsht\u00eb `person`, p\u00ebrndryshe null.", "$ref": "#\/components\/schemas\/ClientV2Person" }, { "type": "null" } ] }, "address": { "description": "Adresa e klientit.", "$ref": "#\/components\/schemas\/ClientV2Address" }, "contact": { "description": "Telefoni dhe email-i i klientit.", "$ref": "#\/components\/schemas\/ClientV2Contact" }, "customer_number": { "type": [ "string", "null" ], "description": "Referenca juaj p\u00ebr k\u00ebt\u00eb klient, kur e keni dh\u00ebn\u00eb.", "examples": [ "CL-0042" ] }, "verified": { "type": "boolean", "description": "true kur identifikuesi i klientit \u00ebsht\u00eb konfirmuar te administrata tatimore.", "examples": [ true ] }, "created_at": { "type": [ "string", "null" ], "description": "Data dhe ora e krijimit, ISO 8601.", "examples": [ "2026-03-02T09:30:00+01:00" ] }, "updated_at": { "type": [ "string", "null" ], "description": "Data dhe ora e ndryshimit t\u00eb fundit, ISO 8601.", "examples": [ "2026-09-10T16:45:00+02:00" ] } }, "required": [ "id", "type", "company", "person", "address", "contact", "customer_number", "verified", "created_at", "updated_at" ], "title": "ClientV2" }, "ClientV2Address": { "type": "object", "properties": { "line": { "type": [ "string", "null" ], "description": "Rruga dhe numri.", "examples": [ "Rruga e Kavaj\u00ebs 12" ] }, "city": { "type": [ "string", "null" ], "description": "Qyteti.", "examples": [ "Tiran\u00eb" ] }, "country": { "type": [ "string", "null" ], "description": "Kodi i shtetit, ISO 3166-1 alpha-3.", "examples": [ "ALB" ] } }, "required": [ "line", "city", "country" ], "title": "ClientV2Address" }, "ClientV2Company": { "type": "object", "properties": { "name": { "type": [ "string", "null" ], "description": "Emri i kompanis\u00eb.", "examples": [ "Alba Trade shpk" ] }, "category": { "type": [ "string", "null" ], "description": "`business`, `bank` ose `exchange`; null kur kompania nuk \u00ebsht\u00eb klasifikuar.", "examples": [ "business" ] }, "id": { "description": "Identifikuesi fiskal i kompanis\u00eb, zakonisht NIPT-i.", "$ref": "#\/components\/schemas\/ClientV2Id" } }, "required": [ "name", "category", "id" ], "title": "ClientV2Company" }, "ClientV2Contact": { "type": "object", "properties": { "phone": { "type": [ "string", "null" ], "description": "Numri i telefonit.", "examples": [ "+355 69 234 5678" ] }, "email": { "type": [ "string", "null" ], "description": "Adresa e email-it.", "examples": [ "info@albatrade.al" ] } }, "required": [ "phone", "email" ], "title": "ClientV2Contact" }, "ClientV2Id": { "type": "object", "properties": { "type": { "type": "string", "description": "`nuis`, `vat` ose `tax` te nj\u00eb kompani; `id`, `passport` ose `social` te nj\u00eb person.", "examples": [ "nuis" ] }, "value": { "type": [ "string", "null" ], "description": "Vet\u00eb identifikuesi; null kur klienti nuk ka asnj\u00eb t\u00eb regjistruar.", "examples": [ "K91807012A" ] } }, "required": [ "type", "value" ], "title": "ClientV2Id" }, "ClientV2Person": { "type": "object", "properties": { "first_name": { "type": [ "string", "null" ], "description": "Emri.", "examples": [ "Arben" ] }, "last_name": { "type": [ "string", "null" ], "description": "Mbiemri.", "examples": [ "Hoxha" ] }, "birthday": { "type": [ "string", "null" ], "description": "Dat\u00eblindja, `YYYY-MM-DD`.", "examples": [ "1985-04-21" ] }, "id": { "description": "Dokumenti i identifikimit t\u00eb personit.", "$ref": "#\/components\/schemas\/ClientV2Id" } }, "required": [ "first_name", "last_name", "birthday", "id" ], "title": "ClientV2Person" }, "ClientV2Request": { "type": "object", "properties": { "type": { "type": "string", "description": "Lloji i klientit: `company` ose `person`. I detyruesh\u00ebm; vendos cili objekt\nplot\u00ebsohet. N\u00eb p\u00ebrdit\u00ebsim nuk ndryshohet: nj\u00eb `type` i ndrysh\u00ebm nga ai ekzistues\nrefuzohet me `422`.", "enum": [ "company", "person" ], "examples": [ "company" ] }, "company": { "type": "object", "description": "T\u00eb dh\u00ebnat e kompanis\u00eb. T\u00eb detyrueshme kur `type` \u00ebsht\u00eb `company`.", "properties": { "name": { "type": [ "string", "null" ], "description": "Emri i kompanis\u00eb. I detyruesh\u00ebm p\u00ebr `company`.", "maxLength": 255 }, "category": { "type": [ "string", "null" ], "description": "Kategoria e kompanis\u00eb: `business`, `bank` ose `exchange`.", "enum": [ "business", "bank", "exchange", null ] }, "id": { "type": "object", "description": "Identifikuesi i kompanis\u00eb, si objekt me `type` dhe `value`. I detyruesh\u00ebm p\u00ebr `company`.", "properties": { "type": { "type": "string", "description": "Lloji i identifikuesit: `nuis` p\u00ebr nj\u00eb biznes shqiptar, `vat` ose `tax` p\u00ebr nj\u00eb biznes t\u00eb huaj.", "enum": [ "nuis", "vat", "tax" ] }, "value": { "type": "string", "description": "Vlera e identifikuesit, p.sh. NIPT-i kur `type` \u00ebsht\u00eb `nuis`. Deri n\u00eb 20 karaktere.", "maxLength": 20 } } } } }, "person": { "type": "object", "description": "T\u00eb dh\u00ebnat e personit. T\u00eb detyrueshme kur `type` \u00ebsht\u00eb `person`.", "properties": { "first_name": { "type": [ "string", "null" ], "description": "Emri. I detyruesh\u00ebm p\u00ebr `person`.", "maxLength": 255 }, "last_name": { "type": [ "string", "null" ], "description": "Mbiemri. I detyruesh\u00ebm p\u00ebr `person`.", "maxLength": 255 }, "birthday": { "type": [ "string", "null" ], "format": "date-time", "description": "Data e lindjes, `YYYY-MM-DD`." }, "id": { "type": "object", "description": "Dokumenti i identifikimit, si objekt me `type` dhe `value`. I detyruesh\u00ebm p\u00ebr `person`.", "properties": { "type": { "type": "string", "description": "Lloji i dokumentit: `id` kart\u00eb identiteti, `passport` pasaport\u00eb, `social` num\u00ebr i sigurimeve shoq\u00ebrore.", "enum": [ "id", "passport", "social" ] }, "value": { "type": "string", "description": "Numri i dokumentit.", "maxLength": 255 } } } } }, "address": { "type": "object", "description": "Adresa e klientit. Opsionale, e nj\u00ebjta p\u00ebr t\u00eb dy llojet.", "properties": { "line": { "type": [ "string", "null" ], "description": "Rruga dhe numri.", "maxLength": 255 }, "city": { "type": [ "string", "null" ], "description": "Qyteti.", "maxLength": 50 }, "country": { "type": [ "string", "null" ], "description": "Shteti, kod ISO 3166-1 alpha-3. Pa t\u00eb merret `ALB`.", "minLength": 3, "maxLength": 3 } } }, "contact": { "type": "object", "description": "Kontaktet e klientit. Opsionale.", "properties": { "phone": { "type": [ "string", "null" ], "description": "Telefoni.", "maxLength": 255 }, "email": { "type": [ "string", "null" ], "format": "email", "description": "Email-i.", "maxLength": 255 } } }, "customer_number": { "type": [ "string", "null" ], "description": "Numri i klientit n\u00eb sistemin tuaj, n\u00ebse mbani nj\u00eb t\u00eb till\u00eb.", "examples": [ "CL-00412" ], "maxLength": 30 } }, "required": [ "type" ], "title": "ClientV2Request" }, "EInvoiceRequest": { "type": "object", "description": "Fatura elektronike, ne formen e v2.\n\nCdo fushe tjeter eshte fjale per fjale ajo e v1, dhe nje test e mban ashtu.\nNdryshon vetem pagesa: ketu ajo jepet gjithmone si liste `payment_methods`,\nedhe kur fatura shlyhet me nje menyre te vetme, keshtu qe nje integrim i ri\nmesohet me nje forme te vetme ne vend te dyjave.\n\nAsnje menyre e kesaj fature nuk mban karte ose tollona, ndaj elementi i listes mban vetem `type` dhe `amount`.\n\nRregullat jane shkruar te plota dhe nuk merren nga klasa e v1, sepse\ngjeneruesi i dokumentacionit e lexon `rules()` si tekst dhe nga nje thirrje\n`parent::rules()` nuk merr dot asnje fushe. Shihni V2RequestRulesParityTest.", "properties": { "internalId": { "type": "string", "description": "Identifikuesi i fatur\u00ebs n\u00eb sistemin tuaj, unik brenda kompanis\u00eb p\u00ebr vitin; sh\u00ebrben edhe si\n\u00e7el\u00ebs idempotence. I detyruesh\u00ebm.", "examples": [ "EINV-2026-000412" ] }, "client": { "type": "object", "description": "Bler\u00ebsi. I detyruesh\u00ebm: nj\u00eb e-fatur\u00eb nuk l\u00ebshohet p\u00ebr klientin e rastit. D\u00ebrgoni `client.internal_id` p\u00ebr nj\u00eb klient t\u00eb ruajtur n\u00eb fature.al, ose `client.nuis`, `client.name` dhe `client.country` p\u00ebr nj\u00eb klient nga sistemi juaj.", "properties": { "internal_id": { "type": [ "integer", "null" ], "description": "Id-ja e nj\u00eb klienti t\u00eb ruajtur n\u00eb fature.al. Kur e d\u00ebrgoni, bler\u00ebsi merret prej saj dhe\nfushat e tjera t\u00eb `client` nuk lexohen.", "examples": [ 8812 ] }, "nuis": { "type": "string", "description": "NIPT-i i bler\u00ebsit. I detyruesh\u00ebm kur nuk d\u00ebrgoni `client.internal_id`.", "examples": [ "L62221018T" ] }, "name": { "type": "string", "description": "Emri i bler\u00ebsit. I detyruesh\u00ebm kur nuk d\u00ebrgoni `client.internal_id`.", "examples": [ "Ei3 Software Solution shpk" ] }, "address": { "type": [ "string", "null" ], "description": "Adresa e bler\u00ebsit; shkon te CIS-i. Nj\u00eb klient i em\u00ebruar e k\u00ebrkon, ose n\u00eb k\u00ebt\u00eb k\u00ebrkes\u00eb ose t\u00eb ruajtur m\u00eb par\u00eb te klienti n\u00eb fature.al." }, "city": { "type": [ "string", "null" ], "description": "Qyteti i bler\u00ebsit; shkon te CIS-i. Nj\u00eb klient i em\u00ebruar e k\u00ebrkon, ose n\u00eb k\u00ebt\u00eb k\u00ebrkes\u00eb ose t\u00eb ruajtur m\u00eb par\u00eb te klienti n\u00eb fature.al." }, "country": { "type": "string", "description": "Shteti i bler\u00ebsit, kod ISO 3166-1 alpha-3, p.sh. `ALB`, `RKS`, `ITA`. I detyruesh\u00ebm kur nuk\nd\u00ebrgoni `client.internal_id`.", "examples": [ "ALB" ] } } }, "lines": { "type": "array", "description": "Rreshtat e fatur\u00ebs, t\u00eb pakt\u00ebn nj\u00eb.", "items": { "type": "object", "properties": { "product_name": { "type": "string", "description": "Emri i produktit ose i sh\u00ebrbimit.", "examples": [ "Kafe" ] }, "product_code": { "type": "string", "description": "Kodi i produktit n\u00eb katalogun tuaj.", "examples": [ "KAF-001" ] }, "unit": { "type": "string", "description": "Nj\u00ebsia mat\u00ebse, si tekst q\u00eb lexon njeriu.", "examples": [ "cope" ] }, "unit_code": { "type": "string", "description": "Kodi fiskal i nj\u00ebsis\u00eb mat\u00ebse, ai q\u00eb mban dokumenti UBL, p.sh. `C62` nj\u00ebsi, `XPP` cop\u00eb,\n`KGM` kg, `LTR` lit\u00ebr, `HUR` or\u00eb, `MTK` m\u00b2. I detyruesh\u00ebm; nuk nxirret nga `unit`. Kuptimi\ni t\u00eb 49 kodeve \u00ebsht\u00eb te hyrja, \"Kodet e nj\u00ebsive mat\u00ebse\".", "enum": [ "C62", "XPP", "LTR", "MLT", "SEC", "MIN", "HUR", "DAY", "MON", "ANN", "MTK", "E4", "58", "KGM", "DT", "DTN", "TNE", "GRM", "M4", "E54", "KMT", "D68", "QB", "H93", "MTQ", "MSK", "MTR", "CMT", "MMT", "LM", "KWH", "E49", "E55", "OT", "PR", "DZN", "XBX", "XPK", "XPX", "XRO", "XBG", "XBO", "XCT", "XCR", "XSA", "XCA", "XBA", "SET", "IE" ], "examples": [ "C62" ] }, "quantity": { "type": "number", "description": "Sasia.", "examples": [ 2 ] }, "price": { "type": "number", "description": "\u00c7mimi p\u00ebr nj\u00ebsi, me TVSH.", "examples": [ 150 ] }, "total": { "type": "number", "description": "Totali i rreshtit, me TVSH.", "examples": [ 300 ] }, "discount": { "type": [ "number", "null" ], "description": "Zbritja e rreshtit, n\u00eb p\u00ebrqindje mbi \u00e7mimin e nj\u00ebsis\u00eb, nga 0 deri n\u00eb 100. Opsionale: pa t\u00eb,\nose me vler\u00eb bosh, rreshti kalon si\u00e7 e d\u00ebrgoni. `price` mbetet \u00e7mimi i plot\u00eb i nj\u00ebsis\u00eb, nd\u00ebrsa `total` d\u00ebrgohet tashm\u00eb i ulur: `price` her\u00eb\n`quantity`, me zbritjen e hequr. Nj\u00eb `total` q\u00eb nuk p\u00ebrputhet me at\u00eb shif\u00ebr e refuzon\nk\u00ebrkes\u00ebn me `400`, dhe `errors` thot\u00eb cili rresht dhe cila vler\u00eb pritej.", "examples": [ 10 ], "minimum": 0, "maximum": 100 }, "vat": { "type": [ "integer", "null" ], "description": "Norma e TVSH-s\u00eb n\u00eb p\u00ebrqindje: `0`, `6`, `10` ose `20`. Validimi e lejon t\u00eb mungoj\u00eb, por\nd\u00ebrgojeni n\u00eb \u00e7do rresht: pa t\u00eb rreshti mbetet pa norm\u00eb TVSH-je. Kur biznesi juaj nuk \u00ebsht\u00eb n\u00eb skem\u00ebn e TVSH-s\u00eb, rreshti regjistrohet me TVSH `0` dhe\np\u00ebrjashtim `TAX_FREE`, sido q\u00eb ta d\u00ebrgoni k\u00ebt\u00eb fush\u00eb; k\u00ebrkesa nuk refuzohet.", "enum": [ "0", "6", "10", "20", null ], "examples": [ 20 ] }, "vat_exempt_type": { "type": [ "string", "null" ], "description": "Lloji i p\u00ebrjashtimit nga TVSH-ja, kur rreshti \u00ebsht\u00eb i p\u00ebrjashtuar: `TYPE_1`, `TYPE_2`,\n`EXPORT_OF_GOODS` ose `TAX_FREE`.", "enum": [ "TYPE_1", "TYPE_2", "EXPORT_OF_GOODS", "TAX_FREE", null ], "examples": [ "EXPORT_OF_GOODS" ] } }, "required": [ "product_name", "product_code", "unit", "unit_code", "quantity", "price", "total" ] }, "minItems": 1 }, "invoice_discount_type": { "type": [ "string", "null" ], "description": "Si lexohet `invoice_discount_value`: `percent` si p\u00ebrqindje, `amount` si vler\u00eb fikse me\nTVSH. Zbritja zbatohet mbi t\u00eb gjith\u00eb fatur\u00ebn: rreshtat ruhen si\u00e7 i d\u00ebrgoni dhe ulet vet\u00ebm\ntotali. Punon vet\u00ebm n\u00eb \u00e7ift me `invoice_discount_value`. Nj\u00ebra pa tjetr\u00ebn injorohet n\u00eb heshtje dhe\nfatura del pa zbritje.", "enum": [ "percent", "amount", null ], "examples": [ "percent" ] }, "invoice_discount_value": { "type": [ "number", "null" ], "description": "Vlera e zbritjes, e lexuar sipas `invoice_discount_type`: p\u00ebrqindje deri n\u00eb 100 kur tipi\n\u00ebsht\u00eb `percent`; vler\u00eb me TVSH n\u00eb monedh\u00ebn e fatur\u00ebs, deri n\u00eb totalin e fatur\u00ebs, kur tipi\n\u00ebsht\u00eb `amount`. Zeroja e l\u00eb fatur\u00ebn pa zbritje. Zbritja shp\u00ebrndahet mbi grupet e TVSH-s\u00eb sipas pesh\u00ebs s\u00eb secilit n\u00eb total dhe TVSH-ja\nrillogaritet mbi vler\u00ebn e ulur. N\u00eb dokumentin UBL del si AllowanceCharge, me nj\u00eb z\u00eb p\u00ebr \u00e7do\nnorm\u00eb TVSH-je.", "examples": [ 10 ], "minimum": 0 }, "bank_account": { "type": [ "integer", "null" ], "description": "Id-ja e nj\u00eb llogarie bankare t\u00eb ruajtur n\u00eb fature.al.", "examples": [ 42 ] }, "bank_account_iban": { "type": [ "string", "null" ], "description": "IBAN-i i nj\u00eb llogarie t\u00eb ruajtur n\u00eb fature.al; llogaria gjendet me IBAN, n\u00eb vend t\u00eb\n`bank_account`.", "examples": [ "AL35202111090000000001234567" ] }, "bankAccount": { "type": "object", "description": "Llogaria bankare e plot\u00eb, kur nuk e keni ende n\u00eb fature.al: `name`, `iban`, `currency`, `swift`, `holder`. Ruhet si llogari e kompanis\u00eb suaj; nj\u00eb IBAN q\u00eb ekziston tashm\u00eb rip\u00ebrdoret.", "properties": { "name": { "type": [ "string", "null" ], "description": "Emri i bank\u00ebs.", "examples": [ "BKT" ] }, "iban": { "type": [ "string", "null" ], "description": "IBAN-i i llogaris\u00eb.", "examples": [ "AL35202111090000000001234567" ] }, "currency": { "type": [ "string", "null" ], "description": "Monedha e llogaris\u00eb, kod ISO 4217.", "examples": [ "ALL" ] }, "swift": { "type": [ "string", "null" ], "description": "Kodi SWIFT\/BIC i bank\u00ebs.", "examples": [ "NCBAALTX" ] }, "notes": { "type": [ "string", "null" ], "description": "Sh\u00ebnime q\u00eb shoq\u00ebrojn\u00eb llogarin\u00eb n\u00eb fatur\u00eb." }, "holder": { "type": [ "string", "null" ], "description": "Mbajt\u00ebsi i llogaris\u00eb.", "examples": [ "Ei3 Software Solution shpk" ] } } }, "currency": { "type": [ "string", "null" ], "description": "Monedha e fatur\u00ebs, kod ISO 4217; pa t\u00eb merret `ALL`.", "examples": [ "ALL" ] }, "exchange_rate": { "type": [ "number", "null" ], "description": "Sa lek\u00eb vlen nj\u00eb nj\u00ebsi e monedh\u00ebs s\u00eb fatur\u00ebs. Pa t\u00eb, ose me vler\u00eb jo pozitive, merret 1. P\u00ebr\nmonedha q\u00eb vlejn\u00eb m\u00eb pak se nj\u00eb lek, si JPY ose HUF, d\u00ebrgoni vler\u00eb n\u00ebn 1.", "examples": [ 100.5 ] }, "due_date": { "type": [ "string", "null" ], "description": "Afati i pages\u00ebs, `YYYY-MM-DD`.", "examples": [ "2026-10-04" ] }, "supply_start_date": { "type": [ "string", "null" ], "description": "Fillimi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`, p\u00ebr fatura q\u00eb mbulojn\u00eb nj\u00eb interval.", "examples": [ "2026-09-01" ] }, "supply_end_date": { "type": [ "string", "null" ], "description": "Fundi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`.", "examples": [ "2026-09-30" ] }, "reverse_charge": { "type": [ "boolean", "null" ], "description": "Ngarkesa e kund\u00ebrt: TVSH-ja deklarohet nga bler\u00ebsi, jo nga shit\u00ebsi.", "examples": [ false ] }, "notes": { "type": [ "string", "null" ], "description": "Sh\u00ebnime q\u00eb shfaqen n\u00eb fatur\u00eb.", "examples": [ "Faleminderit per blerjen" ] }, "periodic_invoice": { "type": [ "boolean", "null" ], "description": "Sh\u00ebnon nj\u00eb fatur\u00eb t\u00eb nj\u00eb cikli t\u00eb p\u00ebrs\u00ebritur faturimi.", "examples": [ false ] }, "doc_type": { "type": "string", "description": "Lloji i dokumentit UBL: `380` fatur\u00eb shitjeje, `381` not\u00eb krediti, `383` not\u00eb debiti. I\ndetyruesh\u00ebm. Nj\u00eb not\u00eb k\u00ebrkon `original_invoice_iic`; rreshtat q\u00eb d\u00ebrgoni jan\u00eb rreshtat e\nkorrigjimit, me vlera pozitive, dhe drejtimin e p\u00ebrcakton `doc_type`. Validimi pranon edhe\nkodet e tjera t\u00eb standardit UBL, `80`, `82`, `84`, `384`, `386`, `388`, `393`, `394`,\n`395`, `575`, `623` dhe `780`, me kuptimin q\u00eb u jep standardi.", "enum": [ "80", "82", "84", "380", "381", "383", "384", "386", "388", "393", "394", "395", "575", "623", "780" ], "examples": [ "380" ] }, "process": { "type": "string", "description": "Profili UBL i dokumentit (ProfileID): `P1` p\u00ebr nj\u00eb shitje, `P9` p\u00ebr nj\u00eb korrigjim. I\ndetyruesh\u00ebm. Validimi pranon `P1` deri `P11`, sipas standardit UBL.", "enum": [ "P1", "P2", "P3", "P4", "P5", "P6", "P7", "P8", "P9", "P10", "P11" ], "examples": [ "P1" ] }, "original_invoice_iic": { "type": [ "string", "null" ], "description": "`iic`-ja e fatur\u00ebs q\u00eb ky dokument korrigjon, ajo q\u00eb ju ktheu fatura origjinale. E\ndetyrueshme kur `doc_type` \u00ebsht\u00eb `381` ose `383` dhe e refuzuar me \u00e7do lloj tjet\u00ebr\ndokumenti. Origjinali duhet t\u00eb jet\u00eb i t\u00eb nj\u00ebjtit lloj, i fiskalizuar, i paanuluar dhe ende i\nkorrigjuesh\u00ebm; p\u00ebr t\u00eb kthyer nj\u00eb fatur\u00eb t\u00eb plot\u00eb p\u00ebrdorni anulimin, jo nj\u00eb not\u00eb krediti.", "examples": [ "8FE72E2ACD1C500A83F8C89B4E2E3E1D" ] }, "payment_method": { "type": "string", "description": "Nuk pranohet n\u00eb v2: m\u00ebnyra e pages\u00ebs d\u00ebrgohet si element i `payment_methods`." }, "payment_methods": { "type": "array", "description": "M\u00ebnyrat e pages\u00ebs, nj\u00eb element p\u00ebr secil\u00ebn. E detyrueshme edhe kur fatura paguhet me nj\u00eb\nm\u00ebnyr\u00eb t\u00eb vetme; at\u00ebher\u00eb lista ka nj\u00eb element. Deri n\u00eb 10 elemente, e nj\u00ebjta m\u00ebnyr\u00eb nuk\np\u00ebrs\u00ebritet dhe shuma e `amount` duhet t\u00eb jet\u00eb sa totali i fatur\u00ebs, me zbritjen tashm\u00eb t\u00eb\nzbatuar; ndryshe k\u00ebrkesa refuzohet me `400`. Asnj\u00eb nga k\u00ebto m\u00ebnyra nuk mban kart\u00eb ose\ntollona, ndaj elementi ka vet\u00ebm `type` dhe `amount`.", "examples": [ [ { "type": "TRANSFER", "amount": 1500 }, { "type": "COMPENSATION", "amount": 500 } ] ], "items": { "type": "object", "properties": { "type": { "type": "string", "description": "M\u00ebnyra e pages\u00ebs e k\u00ebtij elementi: `ACCOUNT`, `COMPENSATION`, `FACTORING`, `KIND`, `OTHER`,\n`TRANSFER` ose `WAIVER`. E detyrueshme.", "enum": [ "ACCOUNT", "COMPENSATION", "FACTORING", "KIND", "OTHER", "TRANSFER", "WAIVER" ], "examples": [ "TRANSFER" ] }, "amount": { "type": "number", "description": "Sa paguhet me k\u00ebt\u00eb m\u00ebnyr\u00eb, me TVSH, n\u00eb monedh\u00ebn e fatur\u00ebs. E detyrueshme. Pranon \u00e7do vler\u00eb\nq\u00eb pranon CIS-i: edhe 0, p\u00ebr nj\u00eb fatur\u00eb me vler\u00eb 0, dhe negative.", "examples": [ 1500 ] } }, "required": [ "type", "amount" ] }, "minItems": 1, "maxItems": 10, "uniqueItems": true } }, "required": [ "internalId", "client", "lines", "doc_type", "process", "payment_methods" ], "title": "EInvoiceRequest" }, "InvoiceAddress": { "type": "object", "properties": { "street": { "type": [ "string", "null" ], "description": "Rruga dhe numri.", "examples": [ "Rruga e Kavaj\u00ebs 12" ] }, "city": { "type": [ "string", "null" ], "description": "Qyteti.", "examples": [ "Tiran\u00eb" ] }, "country": { "type": "string", "description": "Kodi i shtetit, ISO 3166-1 alpha-3; `ALB` kur bler\u00ebsi nuk ka t\u00eb regjistruar asnj\u00eb.", "examples": [ "ALB" ] } }, "required": [ "street", "city", "country" ], "title": "InvoiceAddress" }, "InvoiceAmount": { "type": "object", "properties": { "currency": { "type": "string", "description": "Monedha e fatur\u00ebs, ISO 4217.", "examples": [ "EUR" ] }, "exchange_rate": { "type": [ "number", "null" ], "description": "Kursi i k\u00ebmbimit ndaj lekut; null kur fatura \u00ebsht\u00eb tashm\u00eb n\u00eb lek.", "examples": [ 98.5 ] }, "gross": { "type": "number", "description": "Totali me TVSH, pasi \u00ebsht\u00eb hequr zbritja mbi fatur\u00ebn.", "examples": [ 540 ] }, "net": { "type": "number", "description": "Totali pa TVSH, pasi \u00ebsht\u00eb hequr zbritja mbi fatur\u00ebn.", "examples": [ 450 ] }, "vat": { "type": "number", "description": "TVSH-ja gjithsej.", "examples": [ 90 ] }, "discount": { "type": "number", "description": "Zbritja mbi t\u00eb gjith\u00eb fatur\u00ebn, si shum\u00eb pa TVSH: sa u hoq nga vlera pa TVSH e fatur\u00ebs.\nZbritjet e rreshtave nuk jan\u00eb k\u00ebtu; ato jan\u00eb te `lines[].discount`. Zero kur fatura nuk ka\nzbritje mbi fatur\u00ebn.", "examples": [ 0 ] }, "net_all": { "type": "number", "description": "Totali pa TVSH n\u00eb lek.", "examples": [ 44325 ] }, "gross_all": { "type": "number", "description": "Totali me TVSH n\u00eb lek.", "examples": [ 53190 ] }, "vat_all": { "type": "number", "description": "TVSH-ja n\u00eb lek.", "examples": [ 8865 ] }, "discount_all": { "type": "number", "description": "Zbritja mbi fatur\u00ebn n\u00eb lek.", "examples": [ 0 ] }, "local_currency": { "anyOf": [ { "description": "I pranish\u00ebm vet\u00ebm n\u00eb nj\u00eb fatur\u00eb n\u00eb monedh\u00eb t\u00eb huaj.", "$ref": "#\/components\/schemas\/InvoiceLocalAmount" }, { "type": "null" } ] } }, "required": [ "currency", "exchange_rate", "gross", "net", "vat", "discount", "net_all", "gross_all", "vat_all", "discount_all", "local_currency" ], "title": "InvoiceAmount" }, "InvoiceBankAccount": { "type": "object", "properties": { "id": { "type": "integer", "description": "Id-ja e llogaris\u00eb bankare n\u00eb fature.al.", "examples": [ 27 ] }, "bank_name": { "type": [ "string", "null" ], "description": "Emri i bank\u00ebs.", "examples": [ "Banka Komb\u00ebtare Tregtare" ] }, "iban": { "type": [ "string", "null" ], "description": "IBAN-i i llogaris\u00eb.", "examples": [ "AL47212110090000000235698741" ] }, "swift": { "type": [ "string", "null" ], "description": "Kodi SWIFT i bank\u00ebs.", "examples": [ "NCBAALTX" ] }, "currency": { "type": [ "string", "null" ], "description": "Monedha e llogaris\u00eb, ISO 4217.", "examples": [ "EUR" ] }, "notes": { "type": [ "string", "null" ], "description": "Sh\u00ebnime t\u00eb lira mbi llogarin\u00eb.", "examples": [ "Llogaria n\u00eb euro" ] } }, "required": [ "id", "bank_name", "iban", "swift", "currency", "notes" ], "title": "InvoiceBankAccount" }, "InvoiceDetail": { "type": "object", "properties": { "id": { "type": "integer", "description": "Id-ja e fatur\u00ebs n\u00eb fature.al.", "examples": [ 40323 ] }, "number": { "type": [ "string", "null" ], "description": "Numri i fatur\u00ebs, si `12\/2026`.", "examples": [ "12\/2026" ] }, "type": { "type": "string", "description": "Lloji i fatur\u00ebs: `CASH`, `NONCASH` ose `EINVOICE`.", "examples": [ "EINVOICE" ] }, "issue_date": { "type": "string", "description": "Data e l\u00ebshimit, `YYYY-MM-DD`.", "examples": [ "2026-09-13" ] }, "due_date": { "type": "string", "description": "Afati i pages\u00ebs, `YYYY-MM-DD`.", "examples": [ "2026-09-27" ] }, "delivery_date": { "type": "string", "description": "Data e dor\u00ebzimit, ose fundi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`.", "examples": [ "2026-09-13" ] }, "created_at": { "type": [ "string", "null" ], "description": "Data dhe ora e krijimit, `YYYY-MM-DD HH:MM:SS`, ora lokale.", "examples": [ "2026-09-13 10:15:00" ] }, "supply_start_date": { "type": [ "string", "null" ], "description": "Fillimi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`.", "examples": [ "2026-09-01" ] }, "supply_end_date": { "type": [ "string", "null" ], "description": "Fundi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`.", "examples": [ "2026-09-13" ] }, "client": { "description": "Bler\u00ebsi i fatur\u00ebs.", "$ref": "#\/components\/schemas\/InvoiceParty" }, "amount": { "description": "Shumat e fatur\u00ebs, n\u00eb monedh\u00ebn e saj dhe n\u00eb lek\u00eb.", "$ref": "#\/components\/schemas\/InvoiceAmount" }, "payment": { "description": "Sa \u00ebsht\u00eb shlyer nga fatura.", "$ref": "#\/components\/schemas\/InvoicePayment" }, "bank_account": { "anyOf": [ { "description": "Llogaria bankare e shtypur n\u00eb fatur\u00eb, ose `null`.", "$ref": "#\/components\/schemas\/InvoiceBankAccount" }, { "type": "null" } ] }, "notes": { "type": [ "string", "null" ], "description": "Sh\u00ebnimet q\u00eb dalin n\u00eb fatur\u00eb.", "examples": [ "Pagesa brenda 14 dit\u00ebve." ] }, "iic": { "type": [ "string", "null" ], "description": "Kodi identifikues i fatur\u00ebs (IIC, n\u00eb ligj NSLF).", "examples": [ "3C7E9A1F52B84D0E6A2C4F8B1D9E7A35" ] }, "fic": { "type": [ "string", "null" ], "description": "Kodi q\u00eb ktheu CIS-i kur e regjistroi fatur\u00ebn (FIC, n\u00eb ligj NIVF). `null` sa koh\u00eb fatura pret fiskalizimin.", "examples": [ "2f6c1e8a-9b3d-4c7e-a5f1-0d8b6e4c2a91" ] }, "eic": { "type": [ "string", "null" ], "description": "Kodi i fatur\u00ebs n\u00eb platform\u00ebn e e-faturave. Vet\u00ebm te e-faturat.", "examples": [ "9b4e2d1c-6f7a-4b3c-8d2e-1f0a9c8b7d65" ] }, "doc_type": { "type": [ "string", "null" ], "description": "Lloji i dokumentit n\u00eb UBL: `380` fatur\u00eb, `381` not\u00eb krediti, `383` not\u00eb debiti. `null` te nj\u00eb fatur\u00eb e zakonshme fiskale.", "examples": [ "380" ] }, "process": { "type": [ "string", "null" ], "description": "Profili UBL: `P1` p\u00ebr nj\u00eb shitje, `P9` p\u00ebr nj\u00eb korrigjim. Vendoset te e-faturat.", "examples": [ "P1" ] }, "self_issue_type": { "type": [ "string", "null" ], "description": "Lloji i vet\u00ebfaturimit, kur fatura \u00ebsht\u00eb vet\u00ebfaturim.", "examples": [ "DOMESTIC" ] }, "reversed_at": { "type": [ "string", "null" ], "description": "Kur u anulua fatura, `YYYY-MM-DD HH:MM:SS`, ose `null`.", "examples": [ "2026-09-14 08:05:00" ] }, "reversed_by": { "type": [ "integer", "null" ], "description": "Id-ja e fatur\u00ebs q\u00eb kjo fatur\u00eb anulon, ose `null`.", "examples": [ 40311 ] }, "pdf_url": { "type": "string", "description": "URL-ja p\u00ebr t\u00eb shkarkuar PDF-n\u00eb e fatur\u00ebs.", "examples": [ "https:\/\/fature.al\/api\/v1\/invoice\/print\/40323" ] }, "reverse_charge": { "type": "boolean", "description": "Ngarkes\u00eb e kund\u00ebrt: TVSH-n\u00eb e deklaron bler\u00ebsi.", "examples": [ false ] }, "periodic_invoice": { "type": "boolean", "description": "Fatur\u00eb e nj\u00eb cikli t\u00eb p\u00ebrs\u00ebritur faturimi.", "examples": [ false ] }, "payment_methods": { "type": "array", "description": "Nj\u00eb element p\u00ebr \u00e7do m\u00ebnyr\u00eb pagese, me shum\u00ebn q\u00eb u shlye me secil\u00ebn. Nj\u00eb fatur\u00eb e paguar me\nnj\u00eb m\u00ebnyr\u00eb t\u00eb vetme mban nj\u00eb element me t\u00eb gjith\u00eb shum\u00ebn.", "items": { "$ref": "#\/components\/schemas\/InvoicePaymentMethod" } }, "lines": { "type": "array", "description": "Rreshtat e fatur\u00ebs; ngarkohen vet\u00ebm kur lexohet nj\u00eb fatur\u00eb e vetme.", "items": { "$ref": "#\/components\/schemas\/InvoiceLine" } } }, "required": [ "id", "number", "type", "issue_date", "due_date", "delivery_date", "created_at", "supply_start_date", "supply_end_date", "client", "amount", "payment", "bank_account", "notes", "iic", "fic", "eic", "doc_type", "process", "self_issue_type", "reversed_at", "reversed_by", "pdf_url", "reverse_charge", "periodic_invoice", "payment_methods", "lines" ], "title": "InvoiceDetail" }, "InvoiceIssueResult": { "type": "object", "properties": { "id": { "type": "integer", "description": "Id-ja e fatur\u00ebs n\u00eb fature.al. Ruajeni pran\u00eb `internalId` tuaj.", "examples": [ 40323 ] }, "number": { "type": [ "string", "null" ], "description": "Numri i fatur\u00ebs, si `12\/2026`.", "examples": [ "12\/2026" ] }, "iic": { "type": [ "string", "null" ], "description": "Kodi identifikues i fatur\u00ebs, IIC (NSLF).", "examples": [ "3C7E9A1F52B84D0E6A2C4F8B1D9E7A35" ] }, "fic": { "type": [ "string", "null" ], "description": "Kodi q\u00eb kthen CIS-i kur regjistron fatur\u00ebn, FIC (NIVF). Null sa koh\u00eb fatura pret fiskalizimin e shtyr\u00eb.", "examples": [ "2f6c1e8a-9b3d-4c7e-a5f1-0d8b6e4c2a91" ] }, "tcrCode": { "type": [ "string", "null" ], "description": "Kodi TCR i pajisjes fiskale q\u00eb e l\u00ebshoi; null te faturat q\u00eb nuk l\u00ebshohen nga nj\u00eb TCR.", "examples": [ "xb131xb131" ] }, "businessCode": { "type": [ "string", "null" ], "description": "Kodi i nj\u00ebsis\u00eb s\u00eb biznesit n\u00ebn t\u00eb cil\u00ebn u l\u00ebshua fatura.", "examples": [ "bb123bb123" ] }, "operatorCode": { "type": [ "string", "null" ], "description": "Kodi i operatorit q\u00eb e l\u00ebshoi fatur\u00ebn.", "examples": [ "aa123aa123" ] }, "fiscalizedAt": { "type": "string", "description": "Data dhe ora e krijimit t\u00eb fatur\u00ebs, `YYYY-MM-DD HH:MM:SS`, or\u00eb lokale.", "examples": [ "2026-09-13 10:15:00" ] }, "verifyURL": { "type": [ "string", "null" ], "description": "URL-ja e verifikimit te administrata tatimore, ajo q\u00eb hap kodi QR.", "examples": [ "https:\/\/efiskalizimi-app.tatime.gov.al\/invoice-check\/#\/verify?iic=3C7E9A1F52B84D0E6A2C4F8B1D9E7A35&tin=L81306019C&crtd=2026-09-13T10:15:00+02:00&prc=53190.00" ] }, "pdf": { "type": "string", "description": "URL-ja p\u00ebr t\u00eb shkarkuar dokumentin. Te nj\u00eb e-fatur\u00eb q\u00eb ka tashm\u00eb EIC, tregon PDF-n\u00eb zyrtare\nt\u00eb platform\u00ebs s\u00eb e-faturave n\u00eb vend t\u00eb asaj t\u00eb fature.al.", "examples": [ "https:\/\/fature.al\/api\/v1\/invoice\/print\/40323" ] }, "eic": { "type": [ "string", "null" ], "description": "Kodi i e-fatur\u00ebs n\u00eb platform\u00ebn e e-faturave, EIC. \u00c7el\u00ebsi \u00ebsht\u00eb i pranish\u00ebm vet\u00ebm te nj\u00eb\ne-fatur\u00eb q\u00eb e ka tashm\u00eb; te \u00e7do fatur\u00eb tjet\u00ebr mungon fare, nuk vjen null.", "examples": [ "9b4e2d1c-6f7a-4b3c-8d2e-1f0a9c8b7d65" ] }, "payment_methods": { "type": "array", "description": "Nj\u00eb element p\u00ebr \u00e7do m\u00ebnyr\u00eb pagese, me shum\u00ebn q\u00eb u shlye me secil\u00ebn. E nj\u00ebjta list\u00eb q\u00eb kthen\n`GET \/invoice\/{id}\/details`.", "items": { "$ref": "#\/components\/schemas\/InvoicePaymentMethod" } } }, "required": [ "id", "number", "iic", "fic", "tcrCode", "businessCode", "operatorCode", "fiscalizedAt", "verifyURL", "pdf", "eic", "payment_methods" ], "title": "InvoiceIssueResult" }, "InvoiceLine": { "type": "object", "properties": { "name": { "type": "string", "description": "Emri i produktit ose i sh\u00ebrbimit.", "examples": [ "Or\u00eb pune mir\u00ebmbajtje" ] }, "product_code": { "type": [ "string", "null" ], "description": "Kodi i produktit n\u00eb fature.al, kur rreshti i p\u00ebrket nj\u00eb produkti t\u00eb katalogut.", "examples": [ "SRV-MNT" ] }, "unit": { "type": [ "string", "null" ], "description": "Nj\u00ebsia mat\u00ebse.", "examples": [ "Or\u00eb" ] }, "unit_code": { "type": [ "string", "null" ], "description": "Kodi i nj\u00ebsis\u00eb mat\u00ebse, p.sh. `C62`.", "examples": [ "HUR" ] }, "quantity": { "type": "number", "description": "Sasia.", "examples": [ 2 ] }, "unitPrice": { "type": "number", "description": "\u00c7mimi p\u00ebr nj\u00ebsi me TVSH, pasi \u00ebsht\u00eb hequr zbritja e rreshtit.", "examples": [ 270 ] }, "vat_rate": { "type": [ "number", "null" ], "description": "Norma e TVSH-s\u00eb n\u00eb p\u00ebrqind.", "examples": [ 20 ] }, "vat_exempt_type": { "type": [ "string", "null" ], "description": "Tipi i p\u00ebrjashtimit nga TVSH-ja, kur rreshti \u00ebsht\u00eb i p\u00ebrjashtuar.", "examples": [ "TYPE_1" ] }, "discount_rate": { "type": [ "number", "null" ], "description": "Zbritja e rreshtit n\u00eb p\u00ebrqind, si\u00e7 u d\u00ebrgua te `lines[].discount`; null kur rreshti nuk ka zbritje.", "examples": [ 10 ] }, "discount": { "type": [ "number", "null" ], "description": "Shuma e zbritjes s\u00eb rreshtit, pa TVSH.", "examples": [ 50 ] }, "amount_net": { "type": "number", "description": "Vlera e rreshtit pa TVSH.", "examples": [ 450 ] }, "amount_vat": { "type": "number", "description": "TVSH-ja e rreshtit.", "examples": [ 90 ] }, "total": { "type": "number", "description": "Totali i rreshtit me TVSH.", "examples": [ 540 ] } }, "required": [ "name", "product_code", "unit", "unit_code", "quantity", "unitPrice", "vat_rate", "vat_exempt_type", "discount_rate", "discount", "amount_net", "amount_vat", "total" ], "title": "InvoiceLine" }, "InvoiceListItem": { "type": "object", "properties": { "id": { "type": "integer", "description": "Id-ja e fatur\u00ebs n\u00eb fature.al.", "examples": [ 40323 ] }, "number": { "type": [ "string", "null" ], "description": "Numri i fatur\u00ebs, si `12\/2026`.", "examples": [ "12\/2026" ] }, "type": { "type": "string", "description": "Lloji i fatur\u00ebs: `CASH`, `NONCASH` ose `EINVOICE`.", "examples": [ "EINVOICE" ] }, "issue_date": { "type": "string", "description": "Data e l\u00ebshimit, `YYYY-MM-DD`.", "examples": [ "2026-09-13" ] }, "due_date": { "type": "string", "description": "Afati i pages\u00ebs, `YYYY-MM-DD`.", "examples": [ "2026-09-27" ] }, "delivery_date": { "type": "string", "description": "Data e dor\u00ebzimit, ose fundi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`.", "examples": [ "2026-09-13" ] }, "created_at": { "type": [ "string", "null" ], "description": "Data dhe ora e krijimit, `YYYY-MM-DD HH:MM:SS`, ora lokale.", "examples": [ "2026-09-13 10:15:00" ] }, "supply_start_date": { "type": [ "string", "null" ], "description": "Fillimi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`.", "examples": [ "2026-09-01" ] }, "supply_end_date": { "type": [ "string", "null" ], "description": "Fundi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`.", "examples": [ "2026-09-13" ] }, "client": { "description": "Bler\u00ebsi i fatur\u00ebs.", "$ref": "#\/components\/schemas\/InvoiceParty" }, "amount": { "description": "Shumat e fatur\u00ebs, n\u00eb monedh\u00ebn e saj dhe n\u00eb lek\u00eb.", "$ref": "#\/components\/schemas\/InvoiceAmount" }, "payment": { "description": "Sa \u00ebsht\u00eb shlyer nga fatura.", "$ref": "#\/components\/schemas\/InvoicePayment" }, "bank_account": { "anyOf": [ { "description": "Llogaria bankare e shtypur n\u00eb fatur\u00eb, ose `null`.", "$ref": "#\/components\/schemas\/InvoiceBankAccount" }, { "type": "null" } ] }, "notes": { "type": [ "string", "null" ], "description": "Sh\u00ebnimet q\u00eb dalin n\u00eb fatur\u00eb.", "examples": [ "Pagesa brenda 14 dit\u00ebve." ] }, "iic": { "type": [ "string", "null" ], "description": "Kodi identifikues i fatur\u00ebs (IIC, n\u00eb ligj NSLF).", "examples": [ "3C7E9A1F52B84D0E6A2C4F8B1D9E7A35" ] }, "fic": { "type": [ "string", "null" ], "description": "Kodi q\u00eb ktheu CIS-i kur e regjistroi fatur\u00ebn (FIC, n\u00eb ligj NIVF). `null` sa koh\u00eb fatura pret fiskalizimin.", "examples": [ "2f6c1e8a-9b3d-4c7e-a5f1-0d8b6e4c2a91" ] }, "eic": { "type": [ "string", "null" ], "description": "Kodi i fatur\u00ebs n\u00eb platform\u00ebn e e-faturave. Vet\u00ebm te e-faturat.", "examples": [ "9b4e2d1c-6f7a-4b3c-8d2e-1f0a9c8b7d65" ] }, "doc_type": { "type": [ "string", "null" ], "description": "Lloji i dokumentit n\u00eb UBL: `380` fatur\u00eb, `381` not\u00eb krediti, `383` not\u00eb debiti. `null` te nj\u00eb fatur\u00eb e zakonshme fiskale.", "examples": [ "380" ] }, "process": { "type": [ "string", "null" ], "description": "Profili UBL: `P1` p\u00ebr nj\u00eb shitje, `P9` p\u00ebr nj\u00eb korrigjim. Vendoset te e-faturat.", "examples": [ "P1" ] }, "self_issue_type": { "type": [ "string", "null" ], "description": "Lloji i vet\u00ebfaturimit, kur fatura \u00ebsht\u00eb vet\u00ebfaturim.", "examples": [ "DOMESTIC" ] }, "reversed_at": { "type": [ "string", "null" ], "description": "Kur u anulua fatura, `YYYY-MM-DD HH:MM:SS`, ose `null`.", "examples": [ "2026-09-14 08:05:00" ] }, "reversed_by": { "type": [ "integer", "null" ], "description": "Id-ja e fatur\u00ebs q\u00eb kjo fatur\u00eb anulon, ose `null`.", "examples": [ 40311 ] }, "pdf_url": { "type": "string", "description": "URL-ja p\u00ebr t\u00eb shkarkuar PDF-n\u00eb e fatur\u00ebs.", "examples": [ "https:\/\/fature.al\/api\/v1\/invoice\/print\/40323" ] }, "reverse_charge": { "type": "boolean", "description": "Ngarkes\u00eb e kund\u00ebrt: TVSH-n\u00eb e deklaron bler\u00ebsi.", "examples": [ false ] }, "periodic_invoice": { "type": "boolean", "description": "Fatur\u00eb e nj\u00eb cikli t\u00eb p\u00ebrs\u00ebritur faturimi.", "examples": [ false ] }, "payment_methods": { "type": "array", "description": "Nj\u00eb element p\u00ebr \u00e7do m\u00ebnyr\u00eb pagese, me shum\u00ebn q\u00eb u shlye me secil\u00ebn. Nj\u00eb fatur\u00eb e paguar me\nnj\u00eb m\u00ebnyr\u00eb t\u00eb vetme mban nj\u00eb element me t\u00eb gjith\u00eb shum\u00ebn.", "items": { "$ref": "#\/components\/schemas\/InvoicePaymentMethod" } } }, "required": [ "id", "number", "type", "issue_date", "due_date", "delivery_date", "created_at", "supply_start_date", "supply_end_date", "client", "amount", "payment", "bank_account", "notes", "iic", "fic", "eic", "doc_type", "process", "self_issue_type", "reversed_at", "reversed_by", "pdf_url", "reverse_charge", "periodic_invoice", "payment_methods" ], "title": "InvoiceListItem" }, "InvoiceListPagination": { "type": "object", "properties": { "records": { "type": "integer", "description": "Sa fatura mban `items` n\u00eb k\u00ebt\u00eb faqe.", "examples": [ 10 ] }, "limit": { "type": "integer", "description": "Parametri `limit` i k\u00ebrkes\u00ebs, pas rrumbullakimit n\u00eb t\u00eb pakt\u00ebn 1.", "examples": [ 10 ] }, "offset": { "type": "integer", "description": "Parametri `offset` i k\u00ebrkes\u00ebs, pas rrumbullakimit n\u00eb t\u00eb pakt\u00ebn 0.", "examples": [ 0 ] }, "type": { "type": [ "string", "null" ], "description": "Filtri `type` ashtu si\u00e7 u d\u00ebrgua, `null` kur nuk u d\u00ebrgua.", "examples": [ "CASH,NONCASH" ] }, "query": { "type": [ "string", "null" ], "description": "Filtri `query` ashtu si\u00e7 u d\u00ebrgua, `null` kur nuk u d\u00ebrgua.", "examples": [ "K12345AB" ] } }, "required": [ "records", "limit", "offset", "type", "query" ], "title": "InvoiceListPagination" }, "InvoiceLocalAmount": { "type": "object", "properties": { "exchange_rate": { "type": "number", "description": "Kursi i k\u00ebmbimit me t\u00eb cilin u kthyen shumat.", "examples": [ 98.5 ] }, "gross": { "type": "number", "description": "Totali me TVSH n\u00eb lek.", "examples": [ 53190 ] }, "net": { "type": "number", "description": "Totali pa TVSH n\u00eb lek.", "examples": [ 44325 ] }, "vat": { "type": "number", "description": "TVSH-ja n\u00eb lek.", "examples": [ 8865 ] }, "discount": { "type": "number", "description": "Zbritja mbi fatur\u00ebn n\u00eb lek, si shum\u00eb pa TVSH.", "examples": [ 0 ] } }, "required": [ "exchange_rate", "gross", "net", "vat", "discount" ], "title": "InvoiceLocalAmount" }, "InvoiceParty": { "type": "object", "properties": { "name": { "type": "string", "description": "Emri i plot\u00eb i personit ose emri i kompanis\u00eb.", "examples": [ "Alba Trade shpk" ] }, "id": { "description": "Identifikuesi fiskal i bler\u00ebsit.", "$ref": "#\/components\/schemas\/InvoicePartyId" }, "address": { "description": "Adresa e bler\u00ebsit.", "$ref": "#\/components\/schemas\/InvoiceAddress" } }, "required": [ "name", "id", "address" ], "title": "InvoiceParty" }, "InvoicePartyId": { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "Tipi i identifikuesit: `NUIS`, `VAT` ose `TAX` te nj\u00eb biznes; `ID`, `PASS` ose `SOC` te nj\u00eb person.", "examples": [ "NUIS" ] }, "id": { "type": [ "string", "null" ], "description": "Vlera e identifikuesit, p.sh. NIPT-i.", "examples": [ "K91807012A" ] } }, "required": [ "type", "id" ], "title": "InvoicePartyId" }, "InvoicePayment": { "type": "object", "properties": { "state": { "type": "string", "description": "`PAID`, `PARTIALLY_PAID` ose `UNPAID`.", "examples": [ "PARTIALLY_PAID" ] }, "amount_paid": { "type": "number", "description": "Shuma e ark\u00ebtuar deri tani, n\u00eb monedh\u00ebn e fatur\u00ebs.", "examples": [ 300 ] }, "amount_left": { "type": "number", "description": "Totali me TVSH minus shum\u00ebn e ark\u00ebtuar, n\u00eb monedh\u00ebn e fatur\u00ebs.", "examples": [ 240 ] } }, "required": [ "state", "amount_paid", "amount_left" ], "title": "InvoicePayment" }, "InvoicePaymentMethod": { "type": "object", "properties": { "type": { "type": "string", "description": "M\u00ebnyra e pages\u00ebs, p.sh. `BANKNOTE` ose `CARD`.", "examples": [ "ACCOUNT" ] }, "amount": { "type": "number", "description": "Shuma e shlyer me k\u00ebt\u00eb m\u00ebnyr\u00eb, me TVSH, n\u00eb monedh\u00ebn e fatur\u00ebs.", "examples": [ 540 ] }, "company_card": { "type": [ "string", "null" ], "description": "Numri i kart\u00ebs s\u00eb kompanis\u00eb; i plot\u00ebsuar vet\u00ebm kur `type` \u00ebsht\u00eb `COMPANY`, p\u00ebrndryshe null.", "examples": [ null ] }, "vouchers": { "type": "array", "description": "Numrat serial\u00eb t\u00eb tollonave; t\u00eb plot\u00ebsuar vet\u00ebm kur `type` \u00ebsht\u00eb `SVOUCHER`, p\u00ebrndryshe list\u00eb bosh.", "examples": [ [] ], "items": { "type": "string" } } }, "required": [ "type", "amount", "company_card", "vouchers" ], "title": "InvoicePaymentMethod" }, "InvoicePrintAmounts": { "type": "object", "properties": { "net": { "type": "number", "description": "Totali pa TVSH.", "examples": [ 450 ] }, "gross": { "type": "number", "description": "Totali me TVSH.", "examples": [ 540 ] }, "vat": { "type": "number", "description": "TVSH-ja gjithsej.", "examples": [ 90 ] }, "discount": { "type": "number", "description": "Zbritja mbi fatur\u00ebn, si shum\u00eb pa TVSH.", "examples": [ 0 ] }, "net_all": { "type": "number", "description": "Totali pa TVSH n\u00eb lek.", "examples": [ 44325 ] }, "gross_all": { "type": "number", "description": "Totali me TVSH n\u00eb lek.", "examples": [ 53190 ] }, "vat_all": { "type": "number", "description": "TVSH-ja n\u00eb lek.", "examples": [ 8865 ] }, "discount_all": { "type": "number", "description": "Zbritja mbi fatur\u00ebn n\u00eb lek.", "examples": [ 0 ] } }, "required": [ "net", "gross", "vat", "discount", "net_all", "gross_all", "vat_all", "discount_all" ], "title": "InvoicePrintAmounts" }, "InvoicePrintClient": { "type": "object", "properties": { "name": { "type": "string", "description": "Emri i bler\u00ebsit.", "examples": [ "Alba Trade shpk" ] }, "id": { "description": "Identifikuesi fiskal i bler\u00ebsit.", "$ref": "#\/components\/schemas\/InvoicePartyId" }, "addres": { "type": [ "string", "null" ], "description": "Rruga e bler\u00ebsit. \u00c7el\u00ebsi shkruhet v\u00ebrtet `addres`, me nj\u00eb s. \u00cbsht\u00eb gabim shtypi q\u00eb nuk mund ta ndreqim pa\nprishur \u00e7do integrim q\u00eb e lexon tashm\u00eb.", "examples": [ "Rruga e Kavaj\u00ebs 12" ] }, "city": { "type": [ "string", "null" ], "description": "Qyteti i bler\u00ebsit.", "examples": [ "Tiran\u00eb" ] }, "country": { "type": "string", "description": "Kodi i shtetit, ISO 3166-1 alpha-3; `ALB` kur bler\u00ebsi nuk ka t\u00eb regjistruar asnj\u00eb.", "examples": [ "ALB" ] } }, "required": [ "name", "id", "addres", "city", "country" ], "title": "InvoicePrintClient" }, "InvoicePrintCompany": { "type": "object", "properties": { "name": { "type": "string", "description": "Emri i kompanis\u00eb si\u00e7 printohet.", "examples": [ "Alfa Solutions shpk" ] }, "nuis": { "type": [ "string", "null" ], "description": "NIPT-i i shit\u00ebsit.", "examples": [ "L81306019C" ] }, "address": { "type": [ "string", "null" ], "description": "Adresa e nj\u00ebsis\u00eb s\u00eb biznesit q\u00eb e l\u00ebshoi fatur\u00ebn.", "examples": [ "Rruga Myslym Shyri 47, Tiran\u00eb" ] } }, "required": [ "name", "nuis", "address" ], "title": "InvoicePrintCompany" }, "InvoicePrintDocument": { "type": "object", "properties": { "logo": { "type": [ "string", "null" ], "description": "Logoja e kompanis\u00eb n\u00eb base64; null kur nuk \u00ebsht\u00eb vendosur.", "examples": [ "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==" ] }, "title": { "type": "string", "description": "Titulli i dokumentit n\u00eb gjuh\u00ebn e llogaris\u00eb, p.sh. \"Fatur\u00eb Tatimore\".", "examples": [ "Fatur\u00eb Tatimore" ] }, "company": { "description": "Shit\u00ebsi.", "$ref": "#\/components\/schemas\/InvoicePrintCompany" }, "client": { "description": "Bler\u00ebsi.", "$ref": "#\/components\/schemas\/InvoicePrintClient" }, "transporter": { "description": "Transportuesi; \u00e7do fush\u00eb e tij \u00ebsht\u00eb null kur fatura nuk ka transportues.", "$ref": "#\/components\/schemas\/InvoicePrintTransporter" }, "invoice": { "description": "Vet\u00eb fatura: rreshtat, totalet dhe kodet fiskale.", "$ref": "#\/components\/schemas\/InvoicePrintInvoice" } }, "required": [ "logo", "title", "company", "client", "transporter", "invoice" ], "title": "InvoicePrintDocument" }, "InvoicePrintInvoice": { "type": "object", "properties": { "type": { "type": "string", "description": "Lloji i fatur\u00ebs: `CASH`, `NONCASH` ose `EINVOICE`.", "examples": [ "EINVOICE" ] }, "payment_method": { "type": [ "string", "null" ], "description": "M\u00ebnyra e pages\u00ebs, si kod.", "examples": [ "ACCOUNT" ] }, "payment_method_label": { "type": [ "string", "null" ], "description": "M\u00ebnyra e pages\u00ebs e shkruar n\u00eb gjuh\u00ebn e llogaris\u00eb, gati p\u00ebr printim.", "examples": [ "Transaksion nga llogaria - ACCOUNT" ] }, "bank_account": { "anyOf": [ { "description": "Llogaria bankare q\u00eb printohet si udh\u00ebzim pagese, ose `null`.", "$ref": "#\/components\/schemas\/InvoiceBankAccount" }, { "type": "null" } ] }, "issueDate": { "type": [ "string", "null" ], "description": "Data dhe ora e l\u00ebshimit, `YYYY-MM-DD HH:MM:SS`.", "examples": [ "2026-09-13 10:15:00" ] }, "businessCode": { "type": [ "string", "null" ], "description": "Kodi i nj\u00ebsis\u00eb s\u00eb biznesit q\u00eb l\u00ebshoi fatur\u00ebn.", "examples": [ "bb123bb123" ] }, "operatorCode": { "type": [ "string", "null" ], "description": "Kodi i operatorit q\u00eb l\u00ebshoi fatur\u00ebn.", "examples": [ "aa123aa123" ] }, "operatorName": { "type": [ "string", "null" ], "description": "Emri i operatorit i shkurtuar, si `Ana H.`, kur njihet.", "examples": [ "Ana H." ] }, "deviceCode": { "type": [ "string", "null" ], "description": "Kodi TCR i pajisjes fiskale.", "examples": [ "xb131xb131" ] }, "currency": { "type": [ "string", "null" ], "description": "Monedha e fatur\u00ebs; `null` kur \u00ebsht\u00eb n\u00eb lek\u00eb.", "examples": [ "EUR" ] }, "exchangeRate": { "type": [ "number", "null" ], "description": "Sa lek\u00eb vlen nj\u00eb nj\u00ebsi e monedh\u00ebs; `null` kur fatura \u00ebsht\u00eb n\u00eb lek\u00eb.", "examples": [ 98.5 ] }, "number": { "type": [ "string", "null" ], "description": "Numri i fatur\u00ebs, si `12\/2026`.", "examples": [ "12\/2026" ] }, "lines": { "type": "array", "description": "Rreshtat e fatur\u00ebs, n\u00eb radh\u00ebn n\u00eb t\u00eb cil\u00ebn printohen.", "items": { "$ref": "#\/components\/schemas\/InvoicePrintLine" } }, "amounts": { "description": "Shumat e fatur\u00ebs, gati p\u00ebr printim.", "$ref": "#\/components\/schemas\/InvoicePrintAmounts" }, "iic": { "type": [ "string", "null" ], "description": "Kodi identifikues i fatur\u00ebs (IIC, n\u00eb ligj NSLF).", "examples": [ "3C7E9A1F52B84D0E6A2C4F8B1D9E7A35" ] }, "fic": { "type": [ "string", "null" ], "description": "Kodi q\u00eb ktheu CIS-i (FIC, n\u00eb ligj NIVF); `null` sa koh\u00eb fatura pret fiskalizimin.", "examples": [ "2f6c1e8a-9b3d-4c7e-a5f1-0d8b6e4c2a91" ] }, "eic": { "type": [ "string", "null" ], "description": "Kodi i fatur\u00ebs n\u00eb platform\u00ebn e e-faturave. Vet\u00ebm te e-faturat.", "examples": [ "9b4e2d1c-6f7a-4b3c-8d2e-1f0a9c8b7d65" ] }, "process": { "type": [ "string", "null" ], "description": "Profili UBL i dokumentit, te e-faturat.", "examples": [ "P1" ] }, "doc_type": { "type": [ "string", "null" ], "description": "Lloji i dokumentit UBL, te e-faturat.", "examples": [ "380" ] }, "notes": { "type": [ "string", "null" ], "description": "Sh\u00ebnimet q\u00eb dalin n\u00eb fatur\u00eb.", "examples": [ "Pagesa brenda 14 dit\u00ebve." ] }, "verifyUrl": { "type": [ "string", "null" ], "description": "URL-ja e verifikimit te tatimet, ajo q\u00eb kodohet si QR.", "examples": [ "https:\/\/efiskalizimi-app.tatime.gov.al\/invoice-check\/#\/verify?iic=3C7E9A1F52B84D0E6A2C4F8B1D9E7A35&tin=L81306019C&crtd=2026-09-13T10:15:00+02:00&prc=53190.00" ] }, "footer": { "type": "array", "description": "Rreshtat q\u00eb printohen n\u00ebn totalin, tashm\u00eb t\u00eb renditur.", "examples": [ [ "Faleminderit p\u00ebr besimin!", "fiskalizoi: fature.al", "---" ] ], "items": { "type": "string" } } }, "required": [ "type", "payment_method", "payment_method_label", "bank_account", "issueDate", "businessCode", "operatorCode", "operatorName", "deviceCode", "currency", "exchangeRate", "number", "lines", "amounts", "iic", "fic", "eic", "process", "doc_type", "notes", "verifyUrl", "footer" ], "title": "InvoicePrintInvoice" }, "InvoicePrintLine": { "type": "object", "properties": { "name": { "type": "string", "description": "Emri i produktit ose i sh\u00ebrbimit.", "examples": [ "Or\u00eb pune mir\u00ebmbajtje" ] }, "unit": { "type": [ "string", "null" ], "description": "Nj\u00ebsia mat\u00ebse.", "examples": [ "Or\u00eb" ] }, "quantity": { "type": "number", "description": "Sasia.", "examples": [ 2 ] }, "unitPrice": { "type": "number", "description": "\u00c7mimi p\u00ebr nj\u00ebsi me TVSH, pasi \u00ebsht\u00eb hequr zbritja e rreshtit.", "examples": [ 270 ] }, "total": { "type": "number", "description": "Totali i rreshtit me TVSH.", "examples": [ 540 ] } }, "required": [ "name", "unit", "quantity", "unitPrice", "total" ], "title": "InvoicePrintLine" }, "InvoicePrintTransporter": { "type": "object", "properties": { "name": { "type": [ "string", "null" ], "description": "Emri i transportuesit.", "examples": [ "Trans Alba shpk" ] }, "plate": { "type": [ "string", "null" ], "description": "Targa e mjetit.", "examples": [ "AA 123 BB" ] }, "address": { "type": [ "string", "null" ], "description": "Adresa e transportuesit.", "examples": [ "Rruga e Durr\u00ebsit 5" ] }, "city": { "type": [ "string", "null" ], "description": "Qyteti i transportuesit.", "examples": [ "Durr\u00ebs" ] } }, "required": [ "name", "plate", "address", "city" ], "title": "InvoicePrintTransporter" }, "NonCashInvoiceRequest": { "type": "object", "description": "Fatura pa para ne dore, ne formen e v2.\n\nCdo fushe tjeter eshte fjale per fjale ajo e v1, dhe nje test e mban ashtu.\nNdryshon vetem pagesa: ketu ajo jepet gjithmone si liste `payment_methods`,\nedhe kur fatura shlyhet me nje menyre te vetme, keshtu qe nje integrim i ri\nmesohet me nje forme te vetme ne vend te dyjave.\n\nAsnje menyre e kesaj fature nuk mban karte ose tollona, ndaj elementi i listes mban vetem `type` dhe `amount`.\n\nRregullat jane shkruar te plota dhe nuk merren nga klasa e v1, sepse\ngjeneruesi i dokumentacionit e lexon `rules()` si tekst dhe nga nje thirrje\n`parent::rules()` nuk merr dot asnje fushe. Shihni V2RequestRulesParityTest.", "properties": { "internalId": { "type": "string", "description": "Identifikuesi i fatur\u00ebs n\u00eb sistemin tuaj, unik brenda kompanis\u00eb p\u00ebr vitin; sh\u00ebrben edhe si\n\u00e7el\u00ebs idempotence. I detyruesh\u00ebm.", "examples": [ "NONCASH-2026-000412" ] }, "client": { "type": "object", "description": "Bler\u00ebsi. Pa t\u00eb fatura l\u00ebshohet p\u00ebr klientin e rastit. Me `client.internal_id` merret nj\u00eb klient i ruajtur n\u00eb fature.al; ndryshe `client.name` \u00ebsht\u00eb i detyruesh\u00ebm.", "properties": { "internal_id": { "type": [ "integer", "null" ], "description": "Id-ja e nj\u00eb klienti t\u00eb ruajtur n\u00eb fature.al. Kur e d\u00ebrgoni, bler\u00ebsi merret prej saj dhe fushat e tjera t\u00eb `client` nuk lexohen." }, "name": { "type": "string", "description": "Emri i bler\u00ebsit. I detyruesh\u00ebm kur nuk d\u00ebrgoni `client.internal_id`.", "examples": [ "Alpha SHPK" ] }, "id": { "type": [ "object", "null" ], "description": "Dokumenti i identifikimit t\u00eb bler\u00ebsit, si objekt me `type` dhe `id`.", "properties": { "type": { "type": [ "string", "null" ], "description": "Lloji i dokumentit: `NUIS` p\u00ebr nj\u00eb biznes shqiptar, `VAT` ose `TAX` p\u00ebr nj\u00eb biznes t\u00eb huaj,\n`ID`, `PASS` ose `SOC` p\u00ebr nj\u00eb person. Pa t\u00eb merret `NUIS`.", "enum": [ "NUIS", "VAT", "TAX", "ID", "PASS", "SOC", null ], "examples": [ "NUIS" ] }, "id": { "type": [ "string", "null" ], "description": "Numri i dokumentit t\u00eb identifikimit, p.sh. NIPT-i kur `type` \u00ebsht\u00eb `NUIS`.", "examples": [ "L62221018T" ] } } }, "address": { "type": [ "string", "null" ], "description": "Adresa e bler\u00ebsit; shkon te CIS-i. Nj\u00eb klient i em\u00ebruar e k\u00ebrkon, ose n\u00eb k\u00ebt\u00eb k\u00ebrkes\u00eb ose t\u00eb ruajtur m\u00eb par\u00eb te klienti n\u00eb fature.al." }, "city": { "type": [ "string", "null" ], "description": "Qyteti i bler\u00ebsit; shkon te CIS-i. Nj\u00eb klient i em\u00ebruar e k\u00ebrkon, ose n\u00eb k\u00ebt\u00eb k\u00ebrkes\u00eb ose t\u00eb ruajtur m\u00eb par\u00eb te klienti n\u00eb fature.al." }, "country": { "type": "string", "description": "Shteti i bler\u00ebsit, kod ISO 3166-1 alpha-3, p.sh. `ALB`, `RKS`, `ITA`. Pa t\u00eb merret `ALB`." } } }, "lines": { "type": "array", "description": "Rreshtat e fatur\u00ebs, t\u00eb pakt\u00ebn nj\u00eb.", "items": { "type": "object", "properties": { "product_name": { "type": "string", "description": "Emri i produktit ose i sh\u00ebrbimit.", "examples": [ "Kafe" ] }, "product_code": { "type": "string", "description": "Kodi i produktit n\u00eb katalogun tuaj.", "examples": [ "KAF-001" ] }, "unit": { "type": "string", "description": "Nj\u00ebsia mat\u00ebse, si tekst q\u00eb lexon njeriu.", "examples": [ "cope" ] }, "quantity": { "type": "number", "description": "Sasia.", "examples": [ 2 ] }, "price": { "type": "number", "description": "\u00c7mimi p\u00ebr nj\u00ebsi, me TVSH.", "examples": [ 150 ] }, "total": { "type": "number", "description": "Totali i rreshtit, me TVSH.", "examples": [ 300 ] }, "discount": { "type": [ "number", "null" ], "description": "Zbritja e rreshtit, n\u00eb p\u00ebrqindje mbi \u00e7mimin e nj\u00ebsis\u00eb, nga 0 deri n\u00eb 100. Opsionale: pa t\u00eb,\nose me vler\u00eb bosh, rreshti kalon si\u00e7 e d\u00ebrgoni. `price` mbetet \u00e7mimi i plot\u00eb i nj\u00ebsis\u00eb, nd\u00ebrsa `total` d\u00ebrgohet tashm\u00eb i ulur: `price` her\u00eb\n`quantity`, me zbritjen e hequr. Nj\u00eb `total` q\u00eb nuk p\u00ebrputhet me at\u00eb shif\u00ebr e refuzon\nk\u00ebrkes\u00ebn me `400`, dhe `errors` thot\u00eb cili rresht dhe cila vler\u00eb pritej.", "examples": [ 10 ], "minimum": 0, "maximum": 100 }, "vat": { "type": [ "integer", "null" ], "description": "Norma e TVSH-s\u00eb n\u00eb p\u00ebrqindje: `0`, `6`, `10` ose `20`. Validimi e lejon t\u00eb mungoj\u00eb, por\nd\u00ebrgojeni n\u00eb \u00e7do rresht: pa t\u00eb rreshti mbetet pa norm\u00eb TVSH-je. Kur biznesi juaj nuk \u00ebsht\u00eb n\u00eb skem\u00ebn e TVSH-s\u00eb, rreshti regjistrohet me TVSH `0` dhe\np\u00ebrjashtim `TAX_FREE`, sido q\u00eb ta d\u00ebrgoni k\u00ebt\u00eb fush\u00eb; k\u00ebrkesa nuk refuzohet.", "enum": [ "0", "6", "10", "20", null ], "examples": [ 20 ] }, "vat_exempt_type": { "type": [ "string", "null" ], "description": "Lloji i p\u00ebrjashtimit nga TVSH-ja, kur rreshti \u00ebsht\u00eb i p\u00ebrjashtuar: `TYPE_1`, `TYPE_2`,\n`EXPORT_OF_GOODS` ose `TAX_FREE`.", "enum": [ "TYPE_1", "TYPE_2", "EXPORT_OF_GOODS", "TAX_FREE", null ], "examples": [ "EXPORT_OF_GOODS" ] } }, "required": [ "product_name", "product_code", "unit", "quantity", "price", "total" ] }, "minItems": 1 }, "invoice_discount_type": { "type": [ "string", "null" ], "description": "Si lexohet `invoice_discount_value`: `percent` si p\u00ebrqindje, `amount` si vler\u00eb fikse me\nTVSH. Zbritja zbatohet mbi t\u00eb gjith\u00eb fatur\u00ebn: rreshtat ruhen si\u00e7 i d\u00ebrgoni dhe ulet vet\u00ebm\ntotali. Punon vet\u00ebm n\u00eb \u00e7ift me `invoice_discount_value`. Nj\u00ebra pa tjetr\u00ebn injorohet n\u00eb heshtje dhe\nfatura del pa zbritje.", "enum": [ "percent", "amount", null ], "examples": [ "percent" ] }, "invoice_discount_value": { "type": [ "number", "null" ], "description": "Vlera e zbritjes, e lexuar sipas `invoice_discount_type`: p\u00ebrqindje deri n\u00eb 100 kur tipi\n\u00ebsht\u00eb `percent`; vler\u00eb me TVSH n\u00eb monedh\u00ebn e fatur\u00ebs, deri n\u00eb totalin e fatur\u00ebs, kur tipi\n\u00ebsht\u00eb `amount`. Zeroja e l\u00eb fatur\u00ebn pa zbritje. Zbritja shp\u00ebrndahet mbi grupet e TVSH-s\u00eb sipas pesh\u00ebs s\u00eb secilit n\u00eb total dhe TVSH-ja\nrillogaritet mbi vler\u00ebn e ulur. Baza e zbritjes \u00ebsht\u00eb shuma e rreshtave; tarifa `fee` mbetet\njasht\u00eb saj.", "examples": [ 10 ], "minimum": 0 }, "bank_account": { "type": [ "integer", "null" ], "description": "Id-ja e nj\u00eb llogarie bankare t\u00eb ruajtur n\u00eb fature.al.", "examples": [ 42 ] }, "bank_account_iban": { "type": [ "string", "null" ], "description": "IBAN-i i nj\u00eb llogarie t\u00eb ruajtur n\u00eb fature.al; llogaria gjendet me IBAN, n\u00eb vend t\u00eb\n`bank_account`.", "examples": [ "AL35202111090000000001234567" ] }, "bankAccount": { "type": "object", "description": "Llogaria bankare e plot\u00eb, kur nuk e keni ende n\u00eb fature.al: `name`, `iban`, `currency`, `swift`, `holder`. Ruhet si llogari e kompanis\u00eb suaj; nj\u00eb IBAN q\u00eb ekziston tashm\u00eb rip\u00ebrdoret.", "properties": { "name": { "type": [ "string", "null" ], "description": "Emri i bank\u00ebs.", "examples": [ "BKT" ] }, "iban": { "type": [ "string", "null" ], "description": "IBAN-i i llogaris\u00eb.", "examples": [ "AL35202111090000000001234567" ] }, "currency": { "type": [ "string", "null" ], "description": "Monedha e llogaris\u00eb, kod ISO 4217.", "examples": [ "ALL" ] }, "swift": { "type": [ "string", "null" ], "description": "Kodi SWIFT\/BIC i bank\u00ebs.", "examples": [ "NCBAALTX" ] }, "notes": { "type": [ "string", "null" ], "description": "Sh\u00ebnime q\u00eb shoq\u00ebrojn\u00eb llogarin\u00eb n\u00eb fatur\u00eb." }, "holder": { "type": [ "string", "null" ], "description": "Mbajt\u00ebsi i llogaris\u00eb.", "examples": [ "Ei3 Software Solution shpk" ] } } }, "fee": { "type": "object", "description": "Tarifa, si objekt me `fee_type` dhe `fee_amount`. Shtohet mbi rreshtat dhe mbetet jasht\u00eb zbritjes.", "properties": { "fee_type": { "type": [ "string", "null" ], "description": "Lloji i tarif\u00ebs: `OTHER`, `COMMISSION`, `PACK` ose `BOTTLE`.", "examples": [ "PACK" ] }, "fee_amount": { "type": [ "number", "null" ], "description": "Vlera e tarif\u00ebs, n\u00eb monedh\u00ebn e fatur\u00ebs.", "examples": [ 50 ] } } }, "currency": { "type": [ "string", "null" ], "description": "Monedha e fatur\u00ebs, kod ISO 4217; pa t\u00eb merret `ALL`.", "examples": [ "ALL" ] }, "exchange_rate": { "type": [ "number", "null" ], "description": "Sa lek\u00eb vlen nj\u00eb nj\u00ebsi e monedh\u00ebs s\u00eb fatur\u00ebs. Pa t\u00eb, ose me vler\u00eb jo pozitive, merret 1. P\u00ebr\nmonedha q\u00eb vlejn\u00eb m\u00eb pak se nj\u00eb lek, si JPY ose HUF, d\u00ebrgoni vler\u00eb n\u00ebn 1.", "examples": [ 100.5 ] }, "due_date": { "type": [ "string", "null" ], "description": "Afati i pages\u00ebs, `YYYY-MM-DD`.", "examples": [ "2026-10-04" ] }, "supply_start_date": { "type": [ "string", "null" ], "description": "Fillimi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`, p\u00ebr fatura q\u00eb mbulojn\u00eb nj\u00eb interval.", "examples": [ "2026-09-01" ] }, "supply_end_date": { "type": [ "string", "null" ], "description": "Fundi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`.", "examples": [ "2026-09-30" ] }, "reverse_charge": { "type": [ "boolean", "null" ], "description": "Ngarkesa e kund\u00ebrt: TVSH-ja deklarohet nga bler\u00ebsi, jo nga shit\u00ebsi.", "examples": [ false ] }, "notes": { "type": [ "string", "null" ], "description": "Sh\u00ebnime q\u00eb shfaqen n\u00eb fatur\u00eb.", "examples": [ "Faleminderit per blerjen" ] }, "periodic_invoice": { "type": [ "boolean", "null" ], "description": "Sh\u00ebnon nj\u00eb fatur\u00eb t\u00eb nj\u00eb cikli t\u00eb p\u00ebrs\u00ebritur faturimi.", "examples": [ false ] }, "self_issue_type": { "type": [ "string", "null" ], "description": "Vet\u00ebfaturim: `DOMESTIC`, `ABROAD` ose `OTHER`. Kur e d\u00ebrgoni, `client` \u00ebsht\u00eb shit\u00ebsi dhe i\nduhet identifikimi (`client.id`) bashk\u00eb me shtetin. Pa t\u00eb fatura \u00ebsht\u00eb e zakonshme.", "enum": [ "DOMESTIC", "ABROAD", "OTHER", null ], "examples": [ "DOMESTIC" ] }, "doc_type": { "type": [ "string", "null" ], "description": "Lloji i dokumentit: `380` fatur\u00eb shitjeje, `381` not\u00eb krediti, `383` not\u00eb debiti. Pa t\u00eb, ose\nme `380`, fatura \u00ebsht\u00eb e zakonshme. Nj\u00eb not\u00eb k\u00ebrkon `original_invoice_iic`; rreshtat q\u00eb\nd\u00ebrgoni jan\u00eb rreshtat e korrigjimit, me vlera pozitive, dhe drejtimin e p\u00ebrcakton\n`doc_type`.", "examples": [ "381" ] }, "original_invoice_iic": { "type": [ "string", "null" ], "description": "`iic`-ja e fatur\u00ebs q\u00eb ky dokument korrigjon, ajo q\u00eb ju ktheu fatura origjinale. E\ndetyrueshme kur `doc_type` \u00ebsht\u00eb `381` ose `383` dhe e refuzuar me \u00e7do lloj tjet\u00ebr\ndokumenti. Origjinali duhet t\u00eb jet\u00eb i t\u00eb nj\u00ebjtit lloj, i fiskalizuar, i paanuluar dhe ende i\nkorrigjuesh\u00ebm; p\u00ebr t\u00eb kthyer nj\u00eb fatur\u00eb t\u00eb plot\u00eb p\u00ebrdorni anulimin, jo nj\u00eb not\u00eb krediti.", "examples": [ "8FE72E2ACD1C500A83F8C89B4E2E3E1D" ] }, "payment_method": { "type": "string", "description": "Nuk pranohet n\u00eb v2: m\u00ebnyra e pages\u00ebs d\u00ebrgohet si element i `payment_methods`." }, "payment_methods": { "type": "array", "description": "M\u00ebnyrat e pages\u00ebs, nj\u00eb element p\u00ebr secil\u00ebn. E detyrueshme edhe kur fatura paguhet me nj\u00eb\nm\u00ebnyr\u00eb t\u00eb vetme; at\u00ebher\u00eb lista ka nj\u00eb element. Deri n\u00eb 10 elemente, e nj\u00ebjta m\u00ebnyr\u00eb nuk\np\u00ebrs\u00ebritet dhe shuma e `amount` duhet t\u00eb jet\u00eb sa totali i fatur\u00ebs, me zbritjen tashm\u00eb t\u00eb\nzbatuar; ndryshe k\u00ebrkesa refuzohet me `400`. Asnj\u00eb nga k\u00ebto m\u00ebnyra nuk mban kart\u00eb ose\ntollona, ndaj elementi ka vet\u00ebm `type` dhe `amount`.", "examples": [ [ { "type": "TRANSFER", "amount": 1500 }, { "type": "COMPENSATION", "amount": 500 } ] ], "items": { "type": "object", "properties": { "type": { "type": "string", "description": "M\u00ebnyra e pages\u00ebs e k\u00ebtij elementi: `ACCOUNT`, `COMPENSATION`, `FACTORING`, `KIND`, `OTHER`,\n`TRANSFER` ose `WAIVER`. E detyrueshme.", "enum": [ "ACCOUNT", "COMPENSATION", "FACTORING", "KIND", "OTHER", "TRANSFER", "WAIVER" ], "examples": [ "TRANSFER" ] }, "amount": { "type": "number", "description": "Sa paguhet me k\u00ebt\u00eb m\u00ebnyr\u00eb, me TVSH, n\u00eb monedh\u00ebn e fatur\u00ebs. E detyrueshme. Pranon \u00e7do vler\u00eb\nq\u00eb pranon CIS-i: edhe 0, p\u00ebr nj\u00eb fatur\u00eb me vler\u00eb 0, dhe negative.", "examples": [ 1500 ] } }, "required": [ "type", "amount" ] }, "minItems": 1, "maxItems": 10, "uniqueItems": true } }, "required": [ "internalId", "lines", "payment_methods" ], "title": "NonCashInvoiceRequest" }, "OrderInvoice": { "type": "object", "properties": { "internalId": { "type": "string", "description": "Identifikuesi i fatur\u00ebs n\u00eb sistemin tuaj; sh\u00ebrben edhe si \u00e7el\u00ebs idempotence. I detyruesh\u00ebm.", "examples": [ "ORD-001" ] }, "client": { "type": "object", "description": "Bler\u00ebsi. Opsional, si te fatura cash: pa t\u00eb porosia l\u00ebshohet p\u00ebr klientin e rastit.\nMe `client.internal_id` merret nj\u00eb klient i ruajtur n\u00eb fature.al; ndryshe `client.name`\nb\u00ebhet i detyruesh\u00ebm sapo d\u00ebrgoni cil\u00ebndo fush\u00eb tjet\u00ebr t\u00eb `client`.", "properties": { "internal_id": { "type": [ "integer", "null" ], "description": "Id-ja e nj\u00eb klienti t\u00eb ruajtur n\u00eb fature.al. Kur e d\u00ebrgoni, bler\u00ebsi merret prej saj dhe fushat e tjera t\u00eb `client` nuk lexohen." }, "name": { "type": [ "string", "null" ], "description": "Emri i bler\u00ebsit.", "examples": [ "Klient i rastit" ] }, "id": { "type": [ "object", "null" ], "description": "Dokumenti i identifikimit t\u00eb bler\u00ebsit, si objekt me `type` dhe `id`.", "properties": { "type": { "type": [ "string", "null" ], "description": "Lloji i dokumentit: `NUIS` p\u00ebr nj\u00eb biznes shqiptar, `VAT` ose `TAX` p\u00ebr nj\u00eb biznes t\u00eb huaj, `ID`, `PASS` ose `SOC` p\u00ebr nj\u00eb person. Pa t\u00eb merret `NUIS`." }, "id": { "type": [ "string", "null" ], "description": "Numri i dokumentit t\u00eb identifikimit, p.sh. NIPT-i kur `type` \u00ebsht\u00eb `NUIS`.", "examples": [ "L62221018T" ] } } }, "address": { "type": [ "string", "null" ], "description": "Adresa e bler\u00ebsit; shkon te CIS-i. Nj\u00eb klient i em\u00ebruar e k\u00ebrkon, ose n\u00eb k\u00ebt\u00eb k\u00ebrkes\u00eb ose t\u00eb ruajtur m\u00eb par\u00eb te klienti n\u00eb fature.al." }, "city": { "type": [ "string", "null" ], "description": "Qyteti i bler\u00ebsit; shkon te CIS-i. Nj\u00eb klient i em\u00ebruar e k\u00ebrkon, ose n\u00eb k\u00ebt\u00eb k\u00ebrkes\u00eb ose t\u00eb ruajtur m\u00eb par\u00eb te klienti n\u00eb fature.al." }, "country": { "type": [ "string", "null" ], "description": "Shteti i bler\u00ebsit, kod ISO 3166-1 alpha-3, p.sh. `ALB`, `RKS`, `ITA`. Pa t\u00eb merret `ALB`." } } }, "lines": { "type": "array", "description": "Rreshtat e porosis\u00eb, t\u00eb pakt\u00ebn nj\u00eb, me t\u00eb nj\u00ebjtat fusha si te fatura cash.", "items": { "type": "object", "properties": { "product_name": { "type": "string", "description": "Emri i produktit ose i sh\u00ebrbimit.", "examples": [ "Kafe" ] }, "product_code": { "type": "string", "description": "Kodi i produktit n\u00eb katalogun tuaj.", "examples": [ "KAF-001" ] }, "unit": { "type": "string", "description": "Nj\u00ebsia mat\u00ebse, si tekst q\u00eb lexon njeriu.", "examples": [ "cope" ] }, "quantity": { "type": "number", "description": "Sasia." }, "price": { "type": "number", "description": "\u00c7mimi p\u00ebr nj\u00ebsi, me TVSH." }, "total": { "type": "number", "description": "Totali i rreshtit, me TVSH." }, "discount": { "type": [ "number", "null" ], "description": "Zbritja e rreshtit, n\u00eb p\u00ebrqindje mbi \u00e7mimin e nj\u00ebsis\u00eb, nga 0 deri n\u00eb 100. Opsionale:\npa t\u00eb, ose me vler\u00eb bosh, rreshti kalon si\u00e7 e d\u00ebrgoni. `price` mbetet \u00e7mimi i plot\u00eb i nj\u00ebsis\u00eb, nd\u00ebrsa `total` d\u00ebrgohet tashm\u00eb i ulur: `price`\nher\u00eb `quantity`, me zbritjen e hequr. Nj\u00eb `total` q\u00eb nuk p\u00ebrputhet me at\u00eb shif\u00ebr e\nrefuzon k\u00ebrkes\u00ebn me `400`, dhe `errors` thot\u00eb cili rresht dhe cila vler\u00eb pritej.", "examples": [ 10 ], "minimum": 0, "maximum": 100 }, "vat": { "type": "integer", "description": "Norma e TVSH-s\u00eb n\u00eb p\u00ebrqindje, si te fatura cash: `0`, `6`, `10` ose `20`. E detyrueshme. Kur biznesi juaj nuk \u00ebsht\u00eb n\u00eb skem\u00ebn e TVSH-s\u00eb, rreshti regjistrohet me TVSH `0` dhe\np\u00ebrjashtim `TAX_FREE`, sido q\u00eb ta d\u00ebrgoni k\u00ebt\u00eb fush\u00eb; k\u00ebrkesa nuk refuzohet.", "examples": [ 20 ] }, "vat_exempt_type": { "type": [ "string", "null" ], "description": "Lloji i p\u00ebrjashtimit nga TVSH-ja, kur rreshti \u00ebsht\u00eb i p\u00ebrjashtuar: `TYPE_1`, `TYPE_2`, `EXPORT_OF_GOODS` ose `TAX_FREE`." } }, "required": [ "product_name", "product_code", "unit", "quantity", "price", "total", "vat" ] }, "minItems": 1 }, "currency": { "type": [ "string", "null" ], "description": "Monedha e porosis\u00eb, kod ISO 4217; pa t\u00eb merret ALL.", "examples": [ "ALL" ] }, "exchange_rate": { "type": [ "number", "null" ], "description": "Sa lek\u00eb vlen nj\u00eb nj\u00ebsi e monedh\u00ebs s\u00eb porosis\u00eb. Pa t\u00eb merret 1.", "examples": [ 100.5 ] }, "supply_start_date": { "type": [ "string", "null" ], "description": "Fillimi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`, p\u00ebr porosi q\u00eb mbulojn\u00eb nj\u00eb interval.", "examples": [ "2026-09-01" ] }, "supply_end_date": { "type": [ "string", "null" ], "description": "Fundi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`.", "examples": [ "2026-09-30" ] }, "notes": { "type": [ "string", "null" ], "description": "Sh\u00ebnime q\u00eb shfaqen n\u00eb porosi, p.sh. tavolina.", "examples": [ "Tavolina 4" ] } }, "required": [ "internalId", "lines" ], "title": "OrderInvoice" }, "OrderInvoiceIssueResult": { "type": "object", "properties": { "id": { "type": "integer", "description": "Id-ja e fatur\u00ebs n\u00eb fature.al. Ruajeni pran\u00eb `internalId` tuaj.", "examples": [ 40323 ] }, "number": { "type": [ "string", "null" ], "description": "Numri i fatur\u00ebs, si `12\/2026`.", "examples": [ "12\/2026" ] }, "iic": { "type": [ "string", "null" ], "description": "Kodi identifikues i fatur\u00ebs, IIC (NSLF).", "examples": [ "3C7E9A1F52B84D0E6A2C4F8B1D9E7A35" ] }, "fic": { "type": [ "string", "null" ], "description": "Kodi q\u00eb kthen CIS-i kur regjistron fatur\u00ebn, FIC (NIVF). Null sa koh\u00eb fatura pret fiskalizimin e shtyr\u00eb.", "examples": [ "2f6c1e8a-9b3d-4c7e-a5f1-0d8b6e4c2a91" ] }, "tcrCode": { "type": [ "string", "null" ], "description": "Kodi TCR i pajisjes fiskale q\u00eb e l\u00ebshoi; null te faturat q\u00eb nuk l\u00ebshohen nga nj\u00eb TCR.", "examples": [ "xb131xb131" ] }, "businessCode": { "type": [ "string", "null" ], "description": "Kodi i nj\u00ebsis\u00eb s\u00eb biznesit n\u00ebn t\u00eb cil\u00ebn u l\u00ebshua fatura.", "examples": [ "bb123bb123" ] }, "operatorCode": { "type": [ "string", "null" ], "description": "Kodi i operatorit q\u00eb e l\u00ebshoi fatur\u00ebn.", "examples": [ "aa123aa123" ] }, "fiscalizedAt": { "type": "string", "description": "Data dhe ora e krijimit t\u00eb fatur\u00ebs, `YYYY-MM-DD HH:MM:SS`, or\u00eb lokale.", "examples": [ "2026-09-13 10:15:00" ] }, "verifyURL": { "type": [ "string", "null" ], "description": "URL-ja e verifikimit te administrata tatimore, ajo q\u00eb hap kodi QR.", "examples": [ "https:\/\/efiskalizimi-app.tatime.gov.al\/invoice-check\/#\/verify?iic=3C7E9A1F52B84D0E6A2C4F8B1D9E7A35&tin=L81306019C&crtd=2026-09-13T10:15:00+02:00&prc=53190.00" ] }, "pdf": { "type": "string", "description": "URL-ja p\u00ebr t\u00eb shkarkuar dokumentin. Te nj\u00eb e-fatur\u00eb q\u00eb ka tashm\u00eb EIC, tregon PDF-n\u00eb zyrtare\nt\u00eb platform\u00ebs s\u00eb e-faturave n\u00eb vend t\u00eb asaj t\u00eb fature.al.", "examples": [ "https:\/\/fature.al\/api\/v1\/invoice\/print\/40323" ] }, "eic": { "type": [ "string", "null" ], "description": "Kodi i e-fatur\u00ebs n\u00eb platform\u00ebn e e-faturave, EIC. \u00c7el\u00ebsi \u00ebsht\u00eb i pranish\u00ebm vet\u00ebm te nj\u00eb\ne-fatur\u00eb q\u00eb e ka tashm\u00eb; te \u00e7do fatur\u00eb tjet\u00ebr mungon fare, nuk vjen null.", "examples": [ "9b4e2d1c-6f7a-4b3c-8d2e-1f0a9c8b7d65" ] }, "payment_methods": { "type": "array", "description": "Nj\u00eb element p\u00ebr \u00e7do m\u00ebnyr\u00eb pagese, me shum\u00ebn q\u00eb u shlye me secil\u00ebn. E nj\u00ebjta list\u00eb q\u00eb kthen\n`GET \/invoice\/{id}\/details`.", "items": { "$ref": "#\/components\/schemas\/InvoicePaymentMethod" } }, "isOrderInvoice": { "type": "boolean", "description": "Gjithmon\u00eb true; \u00e7el\u00ebsi e sh\u00ebnon fatur\u00ebn si porosi.", "examples": [ true ] }, "summaryInvoiceId": { "type": [ "integer", "null" ], "description": "Id-ja e fatur\u00ebs p\u00ebrmbledh\u00ebse q\u00eb e mbylli k\u00ebt\u00eb porosi. \u00c7el\u00ebsi shfaqet vet\u00ebm pasi porosia\n\u00ebsht\u00eb mbyllur, ndaj nj\u00eb porosi e sapol\u00ebshuar nuk e mban.", "examples": [ 40330 ] } }, "required": [ "id", "number", "iic", "fic", "tcrCode", "businessCode", "operatorCode", "fiscalizedAt", "verifyURL", "pdf", "eic", "payment_methods", "isOrderInvoice", "summaryInvoiceId" ], "title": "OrderInvoiceIssueResult" }, "SettledOrderInvoice": { "type": "object", "properties": { "id": { "type": "integer", "description": "Id-ja e porosis\u00eb n\u00eb fature.al.", "examples": [ 40298 ] }, "number": { "type": [ "string", "null" ], "description": "Numri i fatur\u00ebs s\u00eb porosis\u00eb.", "examples": [ "9\/2026" ] }, "date": { "type": "string", "description": "Kur u l\u00ebshua porosia, `YYYY-MM-DD HH:MM:SS`.", "examples": [ "2026-09-12 18:20:00" ] }, "amountGross": { "type": "number", "description": "Totali i porosis\u00eb me TVSH, n\u00eb monedh\u00ebn e saj.", "examples": [ 540 ] }, "currency": { "type": [ "string", "null" ], "description": "Monedha e porosis\u00eb, ISO 4217.", "examples": [ "EUR" ] } }, "required": [ "id", "number", "date", "amountGross", "currency" ], "title": "SettledOrderInvoice" }, "SummaryInvoice": { "type": "object", "description": "Fatura permbledhese, ne formen e v2.\n\nCdo fushe tjeter eshte fjale per fjale ajo e v1, dhe nje test e mban ashtu.\nNdryshon vetem pagesa: ketu ajo jepet gjithmone si liste `payment_methods`,\nedhe kur fatura shlyhet me nje menyre te vetme, keshtu qe nje integrim i ri\nmesohet me nje forme te vetme ne vend te dyjave.\n\nLejohen vetem `BANKNOTE` dhe `CARD`, si tek v1.\n\nRregullat jane shkruar te plota dhe nuk merren nga klasa e v1, sepse\ngjeneruesi i dokumentacionit e lexon `rules()` si tekst dhe nga nje thirrje\n`parent::rules()` nuk merr dot asnje fushe. Shihni V2RequestRulesParityTest.", "properties": { "internalId": { "type": "string", "description": "Identifikuesi i fatur\u00ebs n\u00eb sistemin tuaj; sh\u00ebrben edhe si \u00e7el\u00ebs idempotence. I detyruesh\u00ebm.", "examples": [ "SUMMARY-2026-000021" ] }, "order_invoices": { "type": "array", "description": "IIC-t\u00eb e faturave porosi q\u00eb po mbyllen, t\u00eb pakt\u00ebn nj\u00eb. Rreshtat e p\u00ebrmbledh\u00ebses\nmerren nga k\u00ebto porosi, prandaj nuk d\u00ebrgohen n\u00eb k\u00ebrkes\u00eb.", "examples": [ [ "8FE72E2ACD1C500A83F8C89B4E2E3E1D" ] ], "items": { "type": "string", "description": "IIC-ja e nj\u00eb fature porosi q\u00eb po mbyllet.", "examples": [ "8FE72E2ACD1C500A83F8C89B4E2E3E1D" ] }, "minItems": 1 }, "currency": { "type": [ "string", "null" ], "description": "Monedha e fatur\u00ebs, kod ISO 4217; pa t\u00eb merret ALL.", "examples": [ "ALL" ] }, "exchange_rate": { "type": [ "number", "null" ], "description": "Sa lek\u00eb vlen nj\u00eb nj\u00ebsi e monedh\u00ebs s\u00eb fatur\u00ebs. Pa t\u00eb merret 1.", "examples": [ 100.5 ] }, "supply_start_date": { "type": [ "string", "null" ], "description": "Fillimi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`, p\u00ebr fatura q\u00eb mbulojn\u00eb nj\u00eb interval.", "examples": [ "2026-09-01" ] }, "supply_end_date": { "type": [ "string", "null" ], "description": "Fundi i periudh\u00ebs s\u00eb furnizimit, `YYYY-MM-DD`.", "examples": [ "2026-09-30" ] }, "invoice_discount_type": { "type": [ "string", "null" ], "description": "Si lexohet `invoice_discount_value`: `percent` si p\u00ebrqindje, `amount` si vler\u00eb fikse\nme TVSH. Zbritja mbi t\u00eb gjith\u00eb fatur\u00ebn vendoset te p\u00ebrmbledh\u00ebsja, jo te porosit\u00eb, t\u00eb\ncilat nuk e pranojn\u00eb; zbritjet e rreshtave vijn\u00eb bashk\u00eb me rreshtat q\u00eb kopjohen nga\nporosit\u00eb. Punon vet\u00ebm n\u00eb \u00e7ift me `invoice_discount_value`. Nj\u00ebra pa tjetr\u00ebn injorohet n\u00eb heshtje\ndhe fatura del pa zbritje.", "enum": [ "percent", "amount", null ], "examples": [ "percent" ] }, "invoice_discount_value": { "type": [ "number", "null" ], "description": "Vlera e zbritjes, e lexuar sipas `invoice_discount_type`: p\u00ebrqindje deri n\u00eb 100 kur\ntipi \u00ebsht\u00eb `percent`; vler\u00eb me TVSH n\u00eb monedh\u00ebn e fatur\u00ebs, deri n\u00eb totalin e\np\u00ebrmbledh\u00ebses, kur tipi \u00ebsht\u00eb `amount`. Zeroja e l\u00eb fatur\u00ebn pa zbritje.", "examples": [ 10 ], "minimum": 0 }, "payment_method": { "type": "string", "description": "M\u00ebnyra e pages\u00ebs n\u00eb form\u00ebn e v1. Nuk pranohet n\u00eb v2: d\u00ebrgojeni si element i\n`payment_methods`." }, "payment_methods": { "type": "array", "description": "List\u00eb me nj\u00eb element p\u00ebr \u00e7do m\u00ebnyr\u00eb pagese, deri n\u00eb 10. Nj\u00eb p\u00ebrmbledh\u00ebse e paguar\nme nj\u00eb m\u00ebnyr\u00eb t\u00eb vetme d\u00ebrgon nj\u00eb list\u00eb me nj\u00eb element. Shumat duhet t\u00eb mbledhin sakt\u00eb totalin e p\u00ebrmbledh\u00ebses, me zbritjen tashm\u00eb t\u00eb\nzbatuar, dhe e nj\u00ebjta m\u00ebnyr\u00eb nuk p\u00ebrs\u00ebritet dy her\u00eb.", "examples": [ [ { "type": "BANKNOTE", "amount": 1200 }, { "type": "CARD", "amount": 800 } ] ], "items": { "type": "object", "properties": { "type": { "type": "string", "description": "M\u00ebnyra e pages\u00ebs e k\u00ebtij elementi: `BANKNOTE` ose `CARD`.", "enum": [ "BANKNOTE", "CARD" ], "examples": [ "BANKNOTE" ] }, "amount": { "type": "number", "description": "Sa paguhet me k\u00ebt\u00eb m\u00ebnyr\u00eb, me TVSH, n\u00eb monedh\u00ebn e fatur\u00ebs. Pranon \u00e7do vler\u00eb q\u00eb\npranon CIS-i: edhe 0, p\u00ebr nj\u00eb p\u00ebrmbledh\u00ebse me vler\u00eb 0, dhe negative.", "examples": [ 1200 ] } }, "required": [ "type", "amount" ] }, "minItems": 1, "maxItems": 10, "uniqueItems": true } }, "required": [ "internalId", "order_invoices", "payment_methods" ], "title": "SummaryInvoice" }, "SummaryInvoiceIssueResult": { "type": "object", "properties": { "id": { "type": "integer", "description": "Id-ja e fatur\u00ebs n\u00eb fature.al. Ruajeni pran\u00eb `internalId` tuaj.", "examples": [ 40323 ] }, "number": { "type": [ "string", "null" ], "description": "Numri i fatur\u00ebs, si `12\/2026`.", "examples": [ "12\/2026" ] }, "iic": { "type": [ "string", "null" ], "description": "Kodi identifikues i fatur\u00ebs, IIC (NSLF).", "examples": [ "3C7E9A1F52B84D0E6A2C4F8B1D9E7A35" ] }, "fic": { "type": [ "string", "null" ], "description": "Kodi q\u00eb kthen CIS-i kur regjistron fatur\u00ebn, FIC (NIVF). Null sa koh\u00eb fatura pret fiskalizimin e shtyr\u00eb.", "examples": [ "2f6c1e8a-9b3d-4c7e-a5f1-0d8b6e4c2a91" ] }, "tcrCode": { "type": [ "string", "null" ], "description": "Kodi TCR i pajisjes fiskale q\u00eb e l\u00ebshoi; null te faturat q\u00eb nuk l\u00ebshohen nga nj\u00eb TCR.", "examples": [ "xb131xb131" ] }, "businessCode": { "type": [ "string", "null" ], "description": "Kodi i nj\u00ebsis\u00eb s\u00eb biznesit n\u00ebn t\u00eb cil\u00ebn u l\u00ebshua fatura.", "examples": [ "bb123bb123" ] }, "operatorCode": { "type": [ "string", "null" ], "description": "Kodi i operatorit q\u00eb e l\u00ebshoi fatur\u00ebn.", "examples": [ "aa123aa123" ] }, "fiscalizedAt": { "type": "string", "description": "Data dhe ora e krijimit t\u00eb fatur\u00ebs, `YYYY-MM-DD HH:MM:SS`, or\u00eb lokale.", "examples": [ "2026-09-13 10:15:00" ] }, "verifyURL": { "type": [ "string", "null" ], "description": "URL-ja e verifikimit te administrata tatimore, ajo q\u00eb hap kodi QR.", "examples": [ "https:\/\/efiskalizimi-app.tatime.gov.al\/invoice-check\/#\/verify?iic=3C7E9A1F52B84D0E6A2C4F8B1D9E7A35&tin=L81306019C&crtd=2026-09-13T10:15:00+02:00&prc=53190.00" ] }, "pdf": { "type": "string", "description": "URL-ja p\u00ebr t\u00eb shkarkuar dokumentin. Te nj\u00eb e-fatur\u00eb q\u00eb ka tashm\u00eb EIC, tregon PDF-n\u00eb zyrtare\nt\u00eb platform\u00ebs s\u00eb e-faturave n\u00eb vend t\u00eb asaj t\u00eb fature.al.", "examples": [ "https:\/\/fature.al\/api\/v1\/invoice\/print\/40323" ] }, "eic": { "type": [ "string", "null" ], "description": "Kodi i e-fatur\u00ebs n\u00eb platform\u00ebn e e-faturave, EIC. \u00c7el\u00ebsi \u00ebsht\u00eb i pranish\u00ebm vet\u00ebm te nj\u00eb\ne-fatur\u00eb q\u00eb e ka tashm\u00eb; te \u00e7do fatur\u00eb tjet\u00ebr mungon fare, nuk vjen null.", "examples": [ "9b4e2d1c-6f7a-4b3c-8d2e-1f0a9c8b7d65" ] }, "payment_methods": { "type": "array", "description": "Nj\u00eb element p\u00ebr \u00e7do m\u00ebnyr\u00eb pagese, me shum\u00ebn q\u00eb u shlye me secil\u00ebn. E nj\u00ebjta list\u00eb q\u00eb kthen\n`GET \/invoice\/{id}\/details`.", "items": { "$ref": "#\/components\/schemas\/InvoicePaymentMethod" } }, "isSummaryInvoice": { "type": "boolean", "description": "Gjithmon\u00eb true; \u00e7el\u00ebsi e sh\u00ebnon fatur\u00ebn si p\u00ebrmbledh\u00ebse.", "examples": [ true ] }, "settledOrderInvoices": { "type": "array", "description": "Porosit\u00eb q\u00eb u mbyll\u00ebn me k\u00ebt\u00eb fatur\u00eb.", "items": { "$ref": "#\/components\/schemas\/SettledOrderInvoice" } } }, "required": [ "id", "number", "iic", "fic", "tcrCode", "businessCode", "operatorCode", "fiscalizedAt", "verifyURL", "pdf", "eic", "payment_methods", "isSummaryInvoice", "settledOrderInvoices" ], "title": "SummaryInvoiceIssueResult" } }, "responses": { "AuthenticationException": { "description": "Unauthenticated", "content": { "application\/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "description": "Error overview." } }, "required": [ "message" ] } } } } } } }