{ "openapi": "3.1.0", "info": { "title": "fature.al Partner API", "version": "1.0", "description": "# fature.al Partner API\n\nWolt \u00ebsht\u00eb nj\u00eb platform\u00eb porosish dhe d\u00ebrgese ushqimi: klienti porosit n\u00eb aplikacionin e Wolt dhe\nporosia i mb\u00ebrrin restorantit ose dyqanit q\u00eb e p\u00ebrgatit. Ai restorant ose dyqan quhet k\u00ebtu nj\u00ebsia\n(venue). Ky dokument \u00ebsht\u00eb p\u00ebr software-in q\u00eb punon te nj\u00ebsia: programin e ark\u00ebs, t\u00eb kuzhin\u00ebs ose\nt\u00eb dyqanit q\u00eb i merr porosit\u00eb e Wolt dhe i p\u00ebrpunon.\n\nMe k\u00ebt\u00eb API sistemi juaj ndjek porosit\u00eb e Wolt t\u00eb nj\u00eb nj\u00ebsie t\u00eb vetme n\u00ebp\u00ebrmjet fature.al: lexon\nciklin e \u00e7do porosie nga feed-i i ngjarjeve, i kthen Wolt-it pranimin, refuzimin dhe gatishm\u00ebrin\u00eb,\ndhe merr fatur\u00ebn fiskale q\u00eb fature.al l\u00ebshon p\u00ebr \u00e7do porosi.\n\n\u00cbsht\u00eb dokument m\u00eb vete sepse token-i k\u00ebtu ka kuptim m\u00eb t\u00eb ngusht\u00eb: nj\u00eb nj\u00ebsi e vetme. Gjith\u00e7ka\ntjet\u00ebr, bearer token-i, \u00e7ifti `X-Client-Id` dhe `X-Client-Secret`, formati i p\u00ebrgjigjes dhe\nfjalorthi i fiskalizimit, punon nj\u00ebsoj si n\u00eb API-n\u00eb kryesore dhe shpjegohet te\n[`\/docs\/api`](\/docs\/api).\n\n## Serverat\n\n| Mjedisi | URL |\n| --- | --- |\n| **Live** | `https:\/\/fature.al\/api\/partner\/v1` |\n| **Sandbox** | `https:\/\/demo.fature.al\/api\/partner\/v1` |\n\n## Nj\u00eb token, nj\u00eb nj\u00ebsi\n\nBearer token-i zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme Wolt dhe \u00e7do endpoint punon vet\u00ebm mbi t\u00eb. Id-ja e nj\u00eb\nporosie q\u00eb i p\u00ebrket nj\u00eb nj\u00ebsie tjet\u00ebr p\u00ebrgjigjet me `404`, jo me `403`: nj\u00eb id e gabuar dhe nj\u00eb id\ne huaj nuk dallohen nga nj\u00ebra-tjetra.\n\nThirrni `GET \/ping` n\u00eb fillim: kthen kompanin\u00eb, nj\u00ebsin\u00eb e biznesit dhe nj\u00ebsin\u00eb Wolt me t\u00eb cilat\n\u00ebsht\u00eb lidhur token-i, pra konfirmon kredencialet dhe ju thot\u00eb mbi \u00e7far\u00eb po punoni.\n\n## Feed-i i ngjarjeve \u00ebsht\u00eb boshti\n\nThirrni `GET \/events` n\u00eb m\u00ebnyr\u00eb periodike me `next_cursor`-in e fundit q\u00eb keni marr\u00eb. Feed-i vet\u00ebm\nshtohet: asnj\u00eb ngjarje nuk ndryshon dhe asnj\u00eb nuk fshihet, ndaj asgj\u00eb nuk humbet gjat\u00eb koh\u00ebs q\u00eb\nsistemi juaj nuk punon. Dor\u00ebzimi \u00ebsht\u00eb t\u00eb pakt\u00ebn nj\u00eb her\u00eb (at-least-once), ndaj trajtojeni \u00e7iftin\n`(order_id, type)` si idempotent. \u00c7do ngjarje mban nj\u00eb snapshot t\u00eb shkurt\u00ebr t\u00eb porosis\u00eb n\u00eb at\u00eb\n\u00e7ast, q\u00eb zakonisht mjafton pa nj\u00eb thirrje t\u00eb dyt\u00eb.\n\n## \u00c7do shkrim k\u00ebrkon nj\u00eb Idempotency-Key\n\nTet\u00eb endpoint-et e veprimeve k\u00ebrkojn\u00eb header-in `Idempotency-Key`. Nj\u00eb k\u00ebrkes\u00eb pa t\u00eb refuzohet me\n**400**.\n\n- Nj\u00eb riprovim me t\u00eb nj\u00ebjtin \u00e7el\u00ebs kthen p\u00ebrs\u00ebritjen e p\u00ebrgjigjes s\u00eb par\u00eb, n\u00eb vend q\u00eb t'i d\u00ebrgoj\u00eb\n Wolt-it nj\u00eb veprim t\u00eb dyt\u00eb, dhe p\u00ebrs\u00ebritja mban header-in `Idempotent-Replayed: true`. \u00c7el\u00ebsat\n ruhen 24 or\u00eb.\n- Nj\u00eb thirrje e dyt\u00eb me t\u00eb nj\u00ebjtin \u00e7el\u00ebs, nd\u00ebrsa e para \u00ebsht\u00eb ende n\u00eb proces, refuzohet me **409**.\n- Ruhen vet\u00ebm rezultatet e suksesshme, ndaj nj\u00eb d\u00ebshtim kalimtar riprovohet pa rrezik me t\u00eb nj\u00ebjtin\n \u00e7el\u00ebs.\n\n## Gabimet\n\nNj\u00eb k\u00ebrkes\u00eb q\u00eb d\u00ebshton kthen t\u00eb nj\u00ebjtin format si pjesa tjet\u00ebr e API-s\u00eb, plus nj\u00eb `code` t\u00eb\nq\u00ebndruesh\u00ebm:\n\n```json\n{\"status\": false, \"message\": \"Porosia nuk u gjet.\", \"code\": \"order_not_found\"}\n```\n\nVendosni sipas `code`, jo sipas `message`: mesazhi \u00ebsht\u00eb i p\u00ebrkthyer dhe mund t\u00eb ndryshoj\u00eb.\n\n| Kodi | Statusi | Kuptimi |\n| --- | --- | --- |\n| `unauthenticated` | 401 | Token-i mungon ose nuk vlen |\n| `wolt_not_enabled` | 403 | Kompania nuk e ka modulin Wolt |\n| `forbidden` | 403 | P\u00ebrdoruesi i token-it nuk ka t\u00eb drejt\u00ebn Wolt |\n| `no_venue` | 403 | Token-i nuk zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme aktive |\n| `order_not_found` | 404 | Nuk ka porosi t\u00eb till\u00eb p\u00ebr k\u00ebt\u00eb nj\u00ebsi |\n| `invalid_transition` | 409 | Veprimi nuk lejohet p\u00ebr statusin aktual t\u00eb porosis\u00eb. Asgj\u00eb nuk i \u00ebsht\u00eb d\u00ebrguar Wolt-it |\n| `idempotency_key_required` | 400 | Header-i `Idempotency-Key` mungon |\n| `idempotency_in_progress` | 409 | Nj\u00eb thirrje me t\u00eb nj\u00ebjtin \u00e7el\u00ebs \u00ebsht\u00eb ende n\u00eb proces |\n| `invalid_data` | 422 | Body i k\u00ebrkes\u00ebs nuk kaloi validimin |\n| `action_failed` | 422 | Veprimi d\u00ebshtoi nga ana jon\u00eb dhe nuk u krye |\n| `wolt_upstream_error` | 502 | Wolt e refuzoi veprimin ose nuk u p\u00ebrgjigj. Riprovoni pa rrezik me t\u00eb nj\u00ebjtin \u00e7el\u00ebs |\n\nToken-i kontrollohet nga identifikimi i p\u00ebrgjithsh\u00ebm i API-s\u00eb para se k\u00ebrkesa t\u00eb arrij\u00eb k\u00ebtu, ndaj\nnj\u00eb `401` mund t\u00eb vij\u00eb edhe si `{\"message\": \"Unauthenticated.\"}`, pa `code`. D\u00ebrgoni header-in\n`Accept: application\/json` n\u00eb \u00e7do k\u00ebrkes\u00eb, q\u00eb nj\u00eb token i pavlefsh\u00ebm t\u00eb marr\u00eb `401` dhe jo nj\u00eb\nridrejtim.\n\n## Kufijt\u00eb e k\u00ebrkesave (rate limit)\n\nLeximet mbajn\u00eb ciklin e thirrjeve periodike t\u00eb feed-it, ndaj kan\u00eb kufirin m\u00eb t\u00eb gjer\u00eb; shkrimet i\nd\u00ebrgohen Wolt-it, ndaj kan\u00eb kufi m\u00eb t\u00eb ngusht\u00eb. T\u00eb dy num\u00ebrohen p\u00ebr token.\n\n| | Kufiri |\n| --- | --- |\n| Lexime (`GET`) | 180 n\u00eb minut\u00eb |\n| Shkrime (`POST`) | 60 n\u00eb minut\u00eb |\n\nMbi kufi p\u00ebrgjigja \u00ebsht\u00eb **429** me header-in `Retry-After`, q\u00eb thot\u00eb sa sekonda t\u00eb prisni." }, "servers": [ { "url": "https:\/\/fature.al\/api\/partner\/v1", "description": "Live" }, { "url": "https:\/\/demo.fature.al\/api\/partner\/v1", "description": "Sandbox" } ], "tags": [ { "name": "Wolt Partner API", "description": "Ana e nj\u00ebsis\u00eb (venue) n\u00eb nj\u00eb integrim me Wolt: lexoni feed-in e porosive, pranoni ose refuzoni \u00e7far\u00eb mb\u00ebrrin, \u00e7ojeni porosin\u00eb n\u00ebp\u00ebr marrjen nga korrieri dhe dor\u00ebzimin, dhe merrni fatur\u00ebn fiskale q\u00eb ajo l\u00ebshoi.\n\nFeed-i vet\u00ebm shtohet dhe \u00ebsht\u00eb i renditur, ndaj \u00ebsht\u00eb ai q\u00eb sistemi i nj\u00ebsis\u00eb duhet t\u00eb ndjek\u00eb p\u00ebr t\u00eb q\u00ebndruar n\u00eb hap. Endpoint-et e listimit jan\u00eb p\u00ebr t\u00eb plot\u00ebsuar historikun (backfill) dhe p\u00ebr t\u00eb treguar nj\u00eb snapshot." } ], "security": [ { "bearerAuth": [], "clientId": [], "clientSecret": [] }, { "bearerAuth": [] } ], "paths": { "\/wolt\/ping": { "get": { "operationId": "partner.wolt.ping", "description": "Verifikon token-in dhe kthen nj\u00ebsin\u00eb (venue) e vetme Wolt me t\u00eb cil\u00ebn \u00ebsht\u00eb lidhur. Thirreni\nt\u00eb par\u00ebn, q\u00eb t\u00eb konfirmoni kredencialet dhe t\u00eb shihni mbi cil\u00ebn kompani, nj\u00ebsi biznesi dhe\nnj\u00ebsi Wolt punon token-i.", "summary": "Kontrollo lidhjen", "tags": [ "Wolt Partner API" ], "responses": { "200": { "description": "Nj\u00ebsia (venue) mbi t\u00eb cil\u00ebn punon token-i: kompania, nj\u00ebsia e biznesit, id-ja e nj\u00ebsis\u00eb te Wolt, statusi i lidhjes dhe ora e serverit.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "$ref": "#\/components\/schemas\/WoltPingResult" } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "403": { "description": "Kompania nuk e ka modulin Wolt, p\u00ebrdoruesi i token-it nuk ka t\u00eb drejt\u00ebn Wolt, ose token-i nuk zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme aktive.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit: 180 lexime n\u00eb minut\u00eb p\u00ebr token. Riprovoni pas numrit t\u00eb sekondave n\u00eb header-in Retry-After.", "content": { "application\/json": { "schema": { "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" } } } } } } }, "\/wolt\/events": { "get": { "operationId": "partner.wolt.events", "description": "Boshti i integrimit. Thirreni k\u00ebt\u00eb endpoint n\u00eb m\u00ebnyr\u00eb periodike me `next_cursor`-in e fundit\nq\u00eb keni marr\u00eb, dhe merrni me radh\u00eb ngjarjet e ciklit t\u00eb porosive t\u00eb nj\u00ebsis\u00eb (venue). Feed-i\nvet\u00ebm shtohet, ndaj asgj\u00eb nuk humbet gjat\u00eb koh\u00ebs q\u00eb sistemi juaj nuk punon; dor\u00ebzimi \u00ebsht\u00eb\nt\u00eb pakt\u00ebn nj\u00eb her\u00eb (at-least-once), ndaj trajtojeni \u00e7iftin `(order_id, type)` si idempotent.\n\u00c7do ngjarje mban te `order` nj\u00eb snapshot t\u00eb shkurt\u00ebr t\u00eb porosis\u00eb n\u00eb at\u00eb \u00e7ast.", "summary": "Lexo feed-in e ngjarjeve", "tags": [ "Wolt Partner API" ], "parameters": [ { "name": "since", "in": "query", "description": "Cursor-i nga i cili vazhdohet; d\u00ebrgoni next_cursor-in e m\u00ebparsh\u00ebm. Parazgjedhja \u00ebsht\u00eb 0, fillimi i historikut t\u00eb ruajtur.", "schema": { "type": "integer", "default": 0 }, "example": 10420 }, { "name": "limit", "in": "query", "description": "Numri m\u00eb i madh i ngjarjeve q\u00eb kthehen, 1-200.", "schema": { "type": "integer", "default": 50 }, "example": 50 }, { "name": "types", "in": "query", "description": "Llojet e ngjarjeve q\u00eb p\u00ebrfshihen, t\u00eb ndara me presje, p.sh. order.received,order.ready.", "schema": { "type": "string" }, "example": "order.received,order.ready" } ], "responses": { "200": { "description": "Ngjarjet pas `since` te `events`, nga m\u00eb e vjetra te m\u00eb e reja, me `next_cursor` dhe `has_more`; `events` \u00ebsht\u00eb bosh kur nuk ka asgj\u00eb t\u00eb re.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "$ref": "#\/components\/schemas\/WoltEventsPage" } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "403": { "description": "Kompania nuk e ka modulin Wolt, p\u00ebrdoruesi i token-it nuk ka t\u00eb drejt\u00ebn Wolt, ose token-i nuk zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme aktive.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit: 180 lexime n\u00eb minut\u00eb p\u00ebr token. Riprovoni pas numrit t\u00eb sekondave n\u00eb header-in Retry-After.", "content": { "application\/json": { "schema": { "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" } } } } } } }, "\/wolt\/orders": { "get": { "operationId": "partner.wolt.orders.list", "description": "Porosit\u00eb e nj\u00ebsis\u00eb (venue), m\u00eb t\u00eb rejat t\u00eb parat.\n\nP\u00ebr t\u00eb shkuar m\u00eb prapa, d\u00ebrgoni `next_cursor`-in e p\u00ebrgjigjes s\u00eb m\u00ebparshme si `?cursor=`.\nNdaloni kur `has_more` \u00ebsht\u00eb `false`.\n\nKy \u00ebsht\u00eb nj\u00eb snapshot p\u00ebr listim dhe p\u00ebr plot\u00ebsim t\u00eb historikut. P\u00ebr t\u00eb q\u00ebndruar n\u00eb hap me\nnj\u00ebsin\u00eb n\u00eb koh\u00eb reale lexoni feed-in e ngjarjeve: ai vet\u00ebm shtohet dhe \u00ebsht\u00eb i renditur,\nndaj asgj\u00eb nuk humbet.", "summary": "Listo porosit\u00eb", "tags": [ "Wolt Partner API" ], "parameters": [ { "name": "cursor", "in": "query", "description": "Kthen porosit\u00eb m\u00eb t\u00eb vjetra se kjo id; d\u00ebrgoni next_cursor-in e m\u00ebparsh\u00ebm.", "schema": { "type": "integer" }, "example": 10420 }, { "name": "limit", "in": "query", "description": "Numri i porosive p\u00ebr k\u00ebrkes\u00eb, 1-100.", "schema": { "type": "integer", "default": 25 }, "example": 25 }, { "name": "status", "in": "query", "description": "Filtron sipas statusit t\u00eb Wolt, p.sh. received, acknowledged, ready, delivered.", "schema": { "type": "string" }, "example": "received" }, { "name": "from", "in": "query", "description": "Vet\u00ebm porosit\u00eb e marra n\u00eb k\u00ebt\u00eb dat\u00eb ose pas saj (YYYY-MM-DD).", "schema": { "type": "string" }, "example": "2026-08-01" }, { "name": "to", "in": "query", "description": "Vet\u00ebm porosit\u00eb e marra n\u00eb k\u00ebt\u00eb dat\u00eb ose para saj (YYYY-MM-DD).", "schema": { "type": "string" }, "example": "2026-08-31" } ], "responses": { "200": { "description": "Porosit\u00eb e nj\u00ebsis\u00eb te `orders`, nga m\u00eb e reja te m\u00eb e vjetra, me `next_cursor` dhe `has_more`; `orders` \u00ebsht\u00eb bosh kur nuk ka porosi.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "$ref": "#\/components\/schemas\/WoltOrdersPage" } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "403": { "description": "Kompania nuk e ka modulin Wolt, p\u00ebrdoruesi i token-it nuk ka t\u00eb drejt\u00ebn Wolt, ose token-i nuk zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme aktive.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit: 180 lexime n\u00eb minut\u00eb p\u00ebr token. Riprovoni pas numrit t\u00eb sekondave n\u00eb header-in Retry-After.", "content": { "application\/json": { "schema": { "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" } } } } } } }, "\/wolt\/orders\/{id}": { "get": { "operationId": "partner.wolt.orders.show", "description": "Kthen gjendjen e plot\u00eb t\u00eb nj\u00eb porosie, si\u00e7 e mban fature.al: kreun, pal\u00ebt, rreshtat, totalet dhe\nlidhjen fiskale. P\u00ebrdoreni kur snapshot-i i shkurt\u00ebr i feed-it ose i list\u00ebs nuk mjafton, p\u00ebr\nshembull p\u00ebr ta shfaqur porosin\u00eb n\u00eb kuzhin\u00eb me modifikuesit e zgjedhur, sh\u00ebnimin e klientit dhe\nzbritjet, ose p\u00ebr t\u00eb rilexuar gjendjen e tanishme pas nj\u00eb ngjarjeje. Objekti `order` \u00ebsht\u00eb i\nnj\u00ebjt\u00eb me at\u00eb q\u00eb kthen \u00e7do endpoint veprimi, ndaj nj\u00eb lexues i vet\u00ebm mjafton p\u00ebr t\u00eb dyja. Sa koh\u00eb\nporosia nuk ka fatur\u00eb, `invoice` \u00ebsht\u00eb `null` dhe rreshtat vijn\u00eb nga payload-i i Wolt; pas\nl\u00ebshimit t\u00eb fatur\u00ebs, rreshtat vijn\u00eb nga fatura fiskale dhe mbajn\u00eb produktin me t\u00eb cilin u\nfaturuan.", "summary": "Merr nj\u00eb porosi", "tags": [ "Wolt Partner API" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Id-ja e porosis\u00eb n\u00eb fature.al, nga feed-i ose nga lista e porosive.", "schema": { "type": "integer" }, "example": 8801 } ], "responses": { "200": { "description": "Porosia e plot\u00eb te `data.order`: kreu, pal\u00ebt, rreshtat, totalet dhe referenca e fatur\u00ebs.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "order": { "$ref": "#\/components\/schemas\/WoltOrderDetail" } }, "required": [ "order" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "403": { "description": "Kompania nuk e ka modulin Wolt, p\u00ebrdoruesi i token-it nuk ka t\u00eb drejt\u00ebn Wolt, ose token-i nuk zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme aktive.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "404": { "description": "Nuk ka porosi t\u00eb till\u00eb p\u00ebr k\u00ebt\u00eb nj\u00ebsi.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit: 180 lexime n\u00eb minut\u00eb p\u00ebr token. Riprovoni pas numrit t\u00eb sekondave n\u00eb header-in Retry-After.", "content": { "application\/json": { "schema": { "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" } } } } } } }, "\/wolt\/orders\/{id}\/invoice": { "get": { "operationId": "partner.wolt.orders.invoice", "description": "Kthen fatur\u00ebn fiskale t\u00eb l\u00ebshuar p\u00ebr porosin\u00eb: identifikuesit `IIC`, `FIC` dhe `EIC`,\nverifikimin n\u00ebp\u00ebrmjet `pdf_url`, klientin, shumat dhe rreshtat.\n\nObjekti i fatur\u00ebs \u00ebsht\u00eb i nj\u00ebjt\u00eb me at\u00eb t\u00eb `GET \/api\/v1\/invoice\/{id}\/details`, ndaj \u00e7do gj\u00eb e\nshkruar tashm\u00eb p\u00ebr at\u00eb endpoint punon k\u00ebtu pa ndryshim.\n\n## Sa koh\u00eb \u00ebsht\u00eb ende null\n\n`invoice` \u00ebsht\u00eb `null` sa koh\u00eb porosia nuk ka fatur\u00eb. Ndiqni `fiscal_state` n\u00eb vend q\u00eb t\u00eb\nth\u00ebrrisni pa kriter:\n\n| `fiscal_state` | Kuptimi |\n| --- | --- |\n| `pending` | Ende pa fatur\u00eb. Sh\u00ebnojeni porosin\u00eb gati q\u00eb t\u00eb l\u00ebshohet nj\u00eb |\n| `deferred` | E l\u00ebshuar, n\u00eb pritje t\u00eb CIS-it; `invoice` vjen me `fic: null`. P\u00ebrfundon vet\u00eb |\n| `fiscalised` | E kryer. `invoice` \u00ebsht\u00eb i plot\u00ebsuar |\n| `failed` | Duhet riprovuar |\n\nEdhe m\u00eb mir\u00eb, ndiqni ngjarjen `order.fiscalized` n\u00eb feed n\u00eb vend t\u00eb thirrjeve periodike.", "summary": "Merr fatur\u00ebn fiskale t\u00eb porosis\u00eb", "tags": [ "Wolt Partner API" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Id-ja e porosis\u00eb n\u00eb fature.al, nga feed-i ose nga lista e porosive.", "schema": { "type": "integer" }, "example": 8801 } ], "responses": { "200": { "description": "Gjendja fiskale te `fiscal_state` dhe fatura e plot\u00eb te `invoice`; `invoice` \u00ebsht\u00eb `null` sa koh\u00eb porosia nuk ka fatur\u00eb.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "$ref": "#\/components\/schemas\/WoltOrderInvoiceResult" } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "403": { "description": "Kompania nuk e ka modulin Wolt, p\u00ebrdoruesi i token-it nuk ka t\u00eb drejt\u00ebn Wolt, ose token-i nuk zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme aktive.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "404": { "description": "Nuk ka porosi t\u00eb till\u00eb p\u00ebr k\u00ebt\u00eb nj\u00ebsi.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit: 180 lexime n\u00eb minut\u00eb p\u00ebr token. Riprovoni pas numrit t\u00eb sekondave n\u00eb header-in Retry-After.", "content": { "application\/json": { "schema": { "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" } } } } } } }, "\/wolt\/orders\/{id}\/accept": { "post": { "operationId": "partner.wolt.orders.accept", "description": "Ia kalon Wolt-it pranimin. K\u00ebtu nuk l\u00ebshohet fatur\u00eb fiskale: ajo l\u00ebshohet kur porosia\nsh\u00ebnohet gati.\n\n`pickup_minutes` ka dy kuptime, sipas llojit t\u00eb porosis\u00eb:\n\n| Lloji i porosis\u00eb | \u00c7far\u00eb premton `pickup_minutes` |\n| --- | --- |\n| Marketplace | Kur do t\u00eb jet\u00eb gati ushqimi, q\u00eb Wolt t\u00eb nis\u00eb korrierin n\u00eb at\u00eb orar |\n| Self-delivery | **Koh\u00ebn e plot\u00eb t\u00eb dor\u00ebzimit** q\u00eb i premtohet klientit |\n\nNj\u00eb vler\u00eb e gabuar te nj\u00eb porosi marketplace d\u00ebrgon nj\u00eb korrier q\u00eb pret, ose l\u00eb ushqimin t\u00eb\nftohet.", "summary": "Prano nj\u00eb porosi", "tags": [ "Wolt Partner API" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Id-ja e porosis\u00eb n\u00eb fature.al, nga feed-i ose nga lista e porosive.", "schema": { "type": "integer" }, "example": 8801 }, { "name": "Idempotency-Key", "in": "header", "required": true, "description": "\u00c7el\u00ebsi i idempotenc\u00ebs: nj\u00eb \u00e7el\u00ebs unik, i juaji, p\u00ebr k\u00ebt\u00eb veprim. Nj\u00eb riprovim me t\u00eb nj\u00ebjtin \u00e7el\u00ebs kthen p\u00ebrs\u00ebritjen e p\u00ebrgjigjes s\u00eb par\u00eb, n\u00eb vend q\u00eb t'i d\u00ebrgoj\u00eb Wolt-it nj\u00eb veprim t\u00eb dyt\u00eb, dhe p\u00ebrs\u00ebritja mban header-in Idempotent-Replayed: true. Ruhet 24 or\u00eb.", "schema": { "type": "string" }, "example": "a2f1c9e4-5b60-4d7a-9c31-8e0f2b6d4a17" } ], "requestBody": { "content": { "application\/json": { "schema": { "type": "object", "properties": { "pickup_minutes": { "type": "integer", "description": "Minutat nga tani derisa porosia t\u00eb jet\u00eb gati, 5-180.", "examples": [ 20 ] } } } } } }, "responses": { "200": { "description": "Porosia e rifreskuar te `data.order`, me statusin `acknowledged`; `pickup_at` mban koh\u00ebn e premtuar Wolt-it, kur u premtua nj\u00eb e till\u00eb.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "order": { "$ref": "#\/components\/schemas\/WoltOrderDetail" } }, "required": [ "order" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "400": { "description": "Header-i Idempotency-Key mungon.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "403": { "description": "Kompania nuk e ka modulin Wolt, p\u00ebrdoruesi i token-it nuk ka t\u00eb drejt\u00ebn Wolt, ose token-i nuk zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme aktive.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "404": { "description": "Nuk ka porosi t\u00eb till\u00eb p\u00ebr k\u00ebt\u00eb nj\u00ebsi.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "409": { "description": "Statusi aktual i porosis\u00eb nuk e lejon k\u00ebt\u00eb veprim, ose nj\u00eb thirrje me t\u00eb nj\u00ebjtin Idempotency-Key \u00ebsht\u00eb ende n\u00eb proces. Asgj\u00eb nuk i \u00ebsht\u00eb d\u00ebrguar Wolt-it.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "422": { "description": "pickup_minutes \u00ebsht\u00eb jasht\u00eb intervalit 5-180, ose veprimi d\u00ebshtoi nga ana jon\u00eb dhe nuk u krye.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "502": { "description": "Wolt e refuzoi veprimin ose nuk u p\u00ebrgjigj. Riprovoni pa rrezik me t\u00eb nj\u00ebjtin Idempotency-Key.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit: 60 shkrime n\u00eb minut\u00eb p\u00ebr token. Riprovoni pas numrit t\u00eb sekondave n\u00eb header-in Retry-After.", "content": { "application\/json": { "schema": { "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" } } } } } } }, "\/wolt\/orders\/{id}\/confirm-preorder": { "post": { "operationId": "partner.wolt.orders.confirm-preorder", "description": "Konfirmon nj\u00eb porosi t\u00eb paraporositur, q\u00eb klienti e ka planifikuar p\u00ebr m\u00eb von\u00eb. Ajo q\u00ebndron\nn\u00eb pritje derisa Wolt ta l\u00ebshoj\u00eb n\u00eb p\u00ebrgatitje af\u00ebr orarit t\u00eb saj, dhe vet\u00ebm pas k\u00ebsaj mund\nt\u00eb sh\u00ebnohet gati.", "summary": "Konfirmo nj\u00eb porosi t\u00eb paraporositur", "tags": [ "Wolt Partner API" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Id-ja e porosis\u00eb n\u00eb fature.al, nga feed-i ose nga lista e porosive.", "schema": { "type": "integer" }, "example": 8801 }, { "name": "Idempotency-Key", "in": "header", "required": true, "description": "\u00c7el\u00ebsi i idempotenc\u00ebs: nj\u00eb \u00e7el\u00ebs unik, i juaji, p\u00ebr k\u00ebt\u00eb veprim. Nj\u00eb riprovim me t\u00eb nj\u00ebjtin \u00e7el\u00ebs kthen p\u00ebrs\u00ebritjen e p\u00ebrgjigjes s\u00eb par\u00eb, n\u00eb vend q\u00eb t'i d\u00ebrgoj\u00eb Wolt-it nj\u00eb veprim t\u00eb dyt\u00eb, dhe p\u00ebrs\u00ebritja mban header-in Idempotent-Replayed: true. Ruhet 24 or\u00eb.", "schema": { "type": "string" }, "example": "a2f1c9e4-5b60-4d7a-9c31-8e0f2b6d4a17" } ], "responses": { "200": { "description": "Porosia e rifreskuar te `data.order`, me statusin `preorder_confirmed`.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "order": { "$ref": "#\/components\/schemas\/WoltOrderDetail" } }, "required": [ "order" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "400": { "description": "Header-i Idempotency-Key mungon.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "403": { "description": "Kompania nuk e ka modulin Wolt, p\u00ebrdoruesi i token-it nuk ka t\u00eb drejt\u00ebn Wolt, ose token-i nuk zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme aktive.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "404": { "description": "Nuk ka porosi t\u00eb till\u00eb p\u00ebr k\u00ebt\u00eb nj\u00ebsi.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "409": { "description": "Statusi aktual i porosis\u00eb nuk e lejon k\u00ebt\u00eb veprim, ose nj\u00eb thirrje me t\u00eb nj\u00ebjtin Idempotency-Key \u00ebsht\u00eb ende n\u00eb proces. Asgj\u00eb nuk i \u00ebsht\u00eb d\u00ebrguar Wolt-it.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "422": { "description": "Veprimi d\u00ebshtoi nga ana jon\u00eb dhe nuk u krye.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "502": { "description": "Wolt e refuzoi veprimin ose nuk u p\u00ebrgjigj. Riprovoni pa rrezik me t\u00eb nj\u00ebjtin Idempotency-Key.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit: 60 shkrime n\u00eb minut\u00eb p\u00ebr token. Riprovoni pas numrit t\u00eb sekondave n\u00eb header-in Retry-After.", "content": { "application\/json": { "schema": { "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" } } } } } } }, "\/wolt\/orders\/{id}\/reject": { "post": { "operationId": "partner.wolt.orders.reject", "description": "E refuzon porosin\u00eb dhe ia kalon refuzimin Wolt-it. \u00cbsht\u00eb p\u00ebrfundimtar: nj\u00eb porosi e refuzuar\nnuk pranohet dot m\u00eb pas, dhe p\u00ebr t\u00eb nuk l\u00ebshohet fatur\u00eb fiskale.\n\n| Fusha | Sh\u00ebnime |\n| --- | --- |\n| `reason` | Tekst i lir\u00eb, deri n\u00eb 255 karaktere. **Wolt mund t'ia tregoj\u00eb klientit**, ndaj mbajeni t\u00eb p\u00ebrshtatsh\u00ebm |\n| `code` | `GENERIC`, `ITEMS_UNAVAILABLE` ose `VENUE_CLOSING_SOON`. Parazgjedhja \u00ebsht\u00eb `GENERIC` |\n\nT\u00eb dyja jan\u00eb opsionale, por nj\u00eb `code` i sakt\u00eb e ndihmon Wolt-in t'i ofroj\u00eb klientit nj\u00eb\nalternativ\u00eb t\u00eb arsyeshme n\u00eb vend t\u00eb nj\u00eb ndjese t\u00eb p\u00ebrgjithshme.", "summary": "Refuzo nj\u00eb porosi", "tags": [ "Wolt Partner API" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Id-ja e porosis\u00eb n\u00eb fature.al, nga feed-i ose nga lista e porosive.", "schema": { "type": "integer" }, "example": 8801 }, { "name": "Idempotency-Key", "in": "header", "required": true, "description": "\u00c7el\u00ebsi i idempotenc\u00ebs: nj\u00eb \u00e7el\u00ebs unik, i juaji, p\u00ebr k\u00ebt\u00eb veprim. Nj\u00eb riprovim me t\u00eb nj\u00ebjtin \u00e7el\u00ebs kthen p\u00ebrs\u00ebritjen e p\u00ebrgjigjes s\u00eb par\u00eb, n\u00eb vend q\u00eb t'i d\u00ebrgoj\u00eb Wolt-it nj\u00eb veprim t\u00eb dyt\u00eb, dhe p\u00ebrs\u00ebritja mban header-in Idempotent-Replayed: true. Ruhet 24 or\u00eb.", "schema": { "type": "string" }, "example": "a2f1c9e4-5b60-4d7a-9c31-8e0f2b6d4a17" } ], "requestBody": { "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/WoltRejectRequest" } } } }, "responses": { "200": { "description": "Porosia e rifreskuar te `data.order`, me statusin `rejected`; nuk l\u00ebshohet fatur\u00eb.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "order": { "$ref": "#\/components\/schemas\/WoltOrderDetail" } }, "required": [ "order" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "422": { "description": "Kodi i refuzimit nuk \u00ebsht\u00eb nj\u00eb nga GENERIC, ITEMS_UNAVAILABLE ose VENUE_CLOSING_SOON, ose veprimi d\u00ebshtoi nga ana jon\u00eb. Nj\u00eb d\u00ebshtim validimi shton objektin errors n\u00eb p\u00ebrgjigje.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "400": { "description": "Header-i Idempotency-Key mungon.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "403": { "description": "Kompania nuk e ka modulin Wolt, p\u00ebrdoruesi i token-it nuk ka t\u00eb drejt\u00ebn Wolt, ose token-i nuk zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme aktive.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "404": { "description": "Nuk ka porosi t\u00eb till\u00eb p\u00ebr k\u00ebt\u00eb nj\u00ebsi.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "409": { "description": "Statusi aktual i porosis\u00eb nuk e lejon k\u00ebt\u00eb veprim, ose nj\u00eb thirrje me t\u00eb nj\u00ebjtin Idempotency-Key \u00ebsht\u00eb ende n\u00eb proces. Asgj\u00eb nuk i \u00ebsht\u00eb d\u00ebrguar Wolt-it.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "502": { "description": "Wolt e refuzoi veprimin ose nuk u p\u00ebrgjigj. Riprovoni pa rrezik me t\u00eb nj\u00ebjtin Idempotency-Key.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit: 60 shkrime n\u00eb minut\u00eb p\u00ebr token. Riprovoni pas numrit t\u00eb sekondave n\u00eb header-in Retry-After.", "content": { "application\/json": { "schema": { "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" } } } } } } }, "\/wolt\/orders\/{id}\/ready": { "post": { "operationId": "partner.wolt.orders.ready", "description": "**Ky \u00ebsht\u00eb hapi q\u00eb l\u00ebshon fatur\u00ebn fiskale.** N\u00ebse porosia nuk ka ende fatur\u00eb, ajo l\u00ebshohet\ndhe fiskalizohet k\u00ebtu, ndaj sh\u00ebnimi gati \u00ebsht\u00eb \u00e7asti kur shitja b\u00ebhet dokument ligjor. Nj\u00eb\nthirrje e dyt\u00eb mbi nj\u00eb porosi q\u00eb e ka tashm\u00eb fatur\u00ebn nuk l\u00ebshon nj\u00eb t\u00eb dyt\u00eb.\n\n\u00c7far\u00eb vjen pas varet nga lloji i dor\u00ebzimit:\n\n| Lloji i dor\u00ebzimit | Pas sh\u00ebnimit gati |\n| --- | --- |\n| Marketplace | Porosin\u00eb e merr nj\u00eb korrier i Wolt |\n| Takeaway | Klienti e merr vet\u00eb; pastaj thirrni `delivered` |\n| Self-delivery | Thirrni `pickup-completed`, pastaj `courier-at-customer`, pastaj `delivered` |\n\nPorosia kalon n\u00eb statusin `ready`.", "summary": "Sh\u00ebno porosin\u00eb gati", "tags": [ "Wolt Partner API" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Id-ja e porosis\u00eb n\u00eb fature.al, nga feed-i ose nga lista e porosive.", "schema": { "type": "integer" }, "example": 8801 }, { "name": "Idempotency-Key", "in": "header", "required": true, "description": "\u00c7el\u00ebsi i idempotenc\u00ebs: nj\u00eb \u00e7el\u00ebs unik, i juaji, p\u00ebr k\u00ebt\u00eb veprim. Nj\u00eb riprovim me t\u00eb nj\u00ebjtin \u00e7el\u00ebs kthen p\u00ebrs\u00ebritjen e p\u00ebrgjigjes s\u00eb par\u00eb, n\u00eb vend q\u00eb t'i d\u00ebrgoj\u00eb Wolt-it nj\u00eb veprim t\u00eb dyt\u00eb, dhe p\u00ebrs\u00ebritja mban header-in Idempotent-Replayed: true. Ruhet 24 or\u00eb.", "schema": { "type": "string" }, "example": "a2f1c9e4-5b60-4d7a-9c31-8e0f2b6d4a17" } ], "responses": { "200": { "description": "Porosia e rifreskuar te `data.order`, me statusin `ready` dhe referenc\u00ebn e fatur\u00ebs te `invoice`; `fiscal_state` \u00ebsht\u00eb `fiscalised`, ose `deferred` kur CIS-i nuk u arrit.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "order": { "$ref": "#\/components\/schemas\/WoltOrderDetail" } }, "required": [ "order" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "400": { "description": "Header-i Idempotency-Key mungon.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "403": { "description": "Kompania nuk e ka modulin Wolt, p\u00ebrdoruesi i token-it nuk ka t\u00eb drejt\u00ebn Wolt, ose token-i nuk zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme aktive.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "404": { "description": "Nuk ka porosi t\u00eb till\u00eb p\u00ebr k\u00ebt\u00eb nj\u00ebsi.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "409": { "description": "Statusi aktual i porosis\u00eb nuk e lejon k\u00ebt\u00eb veprim, ose nj\u00eb thirrje me t\u00eb nj\u00ebjtin Idempotency-Key \u00ebsht\u00eb ende n\u00eb proces. Asgj\u00eb nuk i \u00ebsht\u00eb d\u00ebrguar Wolt-it.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "422": { "description": "Veprimi d\u00ebshtoi nga ana jon\u00eb dhe nuk u krye.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "502": { "description": "Wolt e refuzoi veprimin ose nuk u p\u00ebrgjigj. Riprovoni pa rrezik me t\u00eb nj\u00ebjtin Idempotency-Key.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit: 60 shkrime n\u00eb minut\u00eb p\u00ebr token. Riprovoni pas numrit t\u00eb sekondave n\u00eb header-in Retry-After.", "content": { "application\/json": { "schema": { "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" } } } } } } }, "\/wolt\/orders\/{id}\/pickup-completed": { "post": { "operationId": "partner.wolt.orders.pickup-completed", "description": "Hapi i par\u00eb i self-delivery: korrieri i vet\u00eb nj\u00ebsis\u00eb (venue) e mori porosin\u00eb. Vet\u00ebm p\u00ebr\nporosit\u00eb **self-delivery**, ku nj\u00ebsia dor\u00ebzon me korrierin e vet dhe jo me nj\u00eb korrier t\u00eb\nWolt. Porosit\u00eb marketplace dhe takeaway nuk e th\u00ebrrasin kurr\u00eb.\n\nKy **nuk** \u00ebsht\u00eb dor\u00ebzimi. Porosia kalon n\u00eb `picked_up` dhe mbetet e hapur gjat\u00eb\n`courier-at-customer` dhe `delivered`, ndaj q\u00ebndron n\u00eb tabel\u00ebn e porosive derisa dor\u00ebzimi t\u00eb\nkonfirmohet.", "summary": "Sh\u00ebno marrjen nga korrieri", "tags": [ "Wolt Partner API" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Id-ja e porosis\u00eb n\u00eb fature.al, nga feed-i ose nga lista e porosive.", "schema": { "type": "integer" }, "example": 8801 }, { "name": "Idempotency-Key", "in": "header", "required": true, "description": "\u00c7el\u00ebsi i idempotenc\u00ebs: nj\u00eb \u00e7el\u00ebs unik, i juaji, p\u00ebr k\u00ebt\u00eb veprim. Nj\u00eb riprovim me t\u00eb nj\u00ebjtin \u00e7el\u00ebs kthen p\u00ebrs\u00ebritjen e p\u00ebrgjigjes s\u00eb par\u00eb, n\u00eb vend q\u00eb t'i d\u00ebrgoj\u00eb Wolt-it nj\u00eb veprim t\u00eb dyt\u00eb, dhe p\u00ebrs\u00ebritja mban header-in Idempotent-Replayed: true. Ruhet 24 or\u00eb.", "schema": { "type": "string" }, "example": "a2f1c9e4-5b60-4d7a-9c31-8e0f2b6d4a17" } ], "responses": { "200": { "description": "Porosia e rifreskuar te `data.order`, me statusin `picked_up`.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "order": { "$ref": "#\/components\/schemas\/WoltOrderDetail" } }, "required": [ "order" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "400": { "description": "Header-i Idempotency-Key mungon.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "403": { "description": "Kompania nuk e ka modulin Wolt, p\u00ebrdoruesi i token-it nuk ka t\u00eb drejt\u00ebn Wolt, ose token-i nuk zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme aktive.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "404": { "description": "Nuk ka porosi t\u00eb till\u00eb p\u00ebr k\u00ebt\u00eb nj\u00ebsi.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "409": { "description": "Statusi aktual i porosis\u00eb nuk e lejon k\u00ebt\u00eb veprim, ose nj\u00eb thirrje me t\u00eb nj\u00ebjtin Idempotency-Key \u00ebsht\u00eb ende n\u00eb proces. Asgj\u00eb nuk i \u00ebsht\u00eb d\u00ebrguar Wolt-it.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "422": { "description": "Veprimi d\u00ebshtoi nga ana jon\u00eb dhe nuk u krye.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "502": { "description": "Wolt e refuzoi veprimin ose nuk u p\u00ebrgjigj. Riprovoni pa rrezik me t\u00eb nj\u00ebjtin Idempotency-Key.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit: 60 shkrime n\u00eb minut\u00eb p\u00ebr token. Riprovoni pas numrit t\u00eb sekondave n\u00eb header-in Retry-After.", "content": { "application\/json": { "schema": { "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" } } } } } } }, "\/wolt\/orders\/{id}\/courier-at-customer": { "post": { "operationId": "partner.wolt.orders.courier-at-customer", "description": "Hapi i dyt\u00eb i self-delivery: korrieri mb\u00ebrriti te klienti. Vet\u00ebm p\u00ebr porosit\u00eb\n**self-delivery**, dhe vet\u00ebm pas `pickup-completed`. Wolt e njofton klientin q\u00eb korrieri ka\nmb\u00ebrritur, ndaj d\u00ebrgojeni kur kjo \u00ebsht\u00eb e v\u00ebrtet\u00eb dhe jo paraprakisht.\n\nPorosia kalon n\u00eb `courier_at_customer`. Vet\u00eb dor\u00ebzimi konfirmohet ve\u00e7mas me `delivered`.", "summary": "Sh\u00ebno korrierin te klienti", "tags": [ "Wolt Partner API" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Id-ja e porosis\u00eb n\u00eb fature.al, nga feed-i ose nga lista e porosive.", "schema": { "type": "integer" }, "example": 8801 }, { "name": "Idempotency-Key", "in": "header", "required": true, "description": "\u00c7el\u00ebsi i idempotenc\u00ebs: nj\u00eb \u00e7el\u00ebs unik, i juaji, p\u00ebr k\u00ebt\u00eb veprim. Nj\u00eb riprovim me t\u00eb nj\u00ebjtin \u00e7el\u00ebs kthen p\u00ebrs\u00ebritjen e p\u00ebrgjigjes s\u00eb par\u00eb, n\u00eb vend q\u00eb t'i d\u00ebrgoj\u00eb Wolt-it nj\u00eb veprim t\u00eb dyt\u00eb, dhe p\u00ebrs\u00ebritja mban header-in Idempotent-Replayed: true. Ruhet 24 or\u00eb.", "schema": { "type": "string" }, "example": "a2f1c9e4-5b60-4d7a-9c31-8e0f2b6d4a17" } ], "responses": { "200": { "description": "Porosia e rifreskuar te `data.order`, me statusin `courier_at_customer`.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "order": { "$ref": "#\/components\/schemas\/WoltOrderDetail" } }, "required": [ "order" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "400": { "description": "Header-i Idempotency-Key mungon.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "403": { "description": "Kompania nuk e ka modulin Wolt, p\u00ebrdoruesi i token-it nuk ka t\u00eb drejt\u00ebn Wolt, ose token-i nuk zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme aktive.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "404": { "description": "Nuk ka porosi t\u00eb till\u00eb p\u00ebr k\u00ebt\u00eb nj\u00ebsi.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "409": { "description": "Statusi aktual i porosis\u00eb nuk e lejon k\u00ebt\u00eb veprim, ose nj\u00eb thirrje me t\u00eb nj\u00ebjtin Idempotency-Key \u00ebsht\u00eb ende n\u00eb proces. Asgj\u00eb nuk i \u00ebsht\u00eb d\u00ebrguar Wolt-it.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "422": { "description": "Veprimi d\u00ebshtoi nga ana jon\u00eb dhe nuk u krye.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "502": { "description": "Wolt e refuzoi veprimin ose nuk u p\u00ebrgjigj. Riprovoni pa rrezik me t\u00eb nj\u00ebjtin Idempotency-Key.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit: 60 shkrime n\u00eb minut\u00eb p\u00ebr token. Riprovoni pas numrit t\u00eb sekondave n\u00eb header-in Retry-After.", "content": { "application\/json": { "schema": { "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" } } } } } } }, "\/wolt\/orders\/{id}\/delivered": { "post": { "operationId": "partner.wolt.orders.delivered", "description": "Hapi i fundit, i p\u00ebrdorur n\u00eb dy raste:\n\n- **Takeaway**: klienti e ka marr\u00eb porosin\u00eb pasi u sh\u00ebnua gati.\n- **Self-delivery**: korrieri juaj e ka dor\u00ebzuar, pas `courier-at-customer`.\n\nPorosit\u00eb marketplace nuk kan\u00eb nevoj\u00eb p\u00ebr t\u00eb: i merr nj\u00eb korrier i Wolt dhe i mbyll Wolt.\n\nPorosia kalon n\u00eb `delivered` dhe del nga tabela e porosive aktive.", "summary": "Sh\u00ebno porosin\u00eb t\u00eb dor\u00ebzuar", "tags": [ "Wolt Partner API" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Id-ja e porosis\u00eb n\u00eb fature.al, nga feed-i ose nga lista e porosive.", "schema": { "type": "integer" }, "example": 8801 }, { "name": "Idempotency-Key", "in": "header", "required": true, "description": "\u00c7el\u00ebsi i idempotenc\u00ebs: nj\u00eb \u00e7el\u00ebs unik, i juaji, p\u00ebr k\u00ebt\u00eb veprim. Nj\u00eb riprovim me t\u00eb nj\u00ebjtin \u00e7el\u00ebs kthen p\u00ebrs\u00ebritjen e p\u00ebrgjigjes s\u00eb par\u00eb, n\u00eb vend q\u00eb t'i d\u00ebrgoj\u00eb Wolt-it nj\u00eb veprim t\u00eb dyt\u00eb, dhe p\u00ebrs\u00ebritja mban header-in Idempotent-Replayed: true. Ruhet 24 or\u00eb.", "schema": { "type": "string" }, "example": "a2f1c9e4-5b60-4d7a-9c31-8e0f2b6d4a17" } ], "responses": { "200": { "description": "Porosia e rifreskuar te `data.order`, me statusin `delivered`.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "order": { "$ref": "#\/components\/schemas\/WoltOrderDetail" } }, "required": [ "order" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "400": { "description": "Header-i Idempotency-Key mungon.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "403": { "description": "Kompania nuk e ka modulin Wolt, p\u00ebrdoruesi i token-it nuk ka t\u00eb drejt\u00ebn Wolt, ose token-i nuk zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme aktive.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "404": { "description": "Nuk ka porosi t\u00eb till\u00eb p\u00ebr k\u00ebt\u00eb nj\u00ebsi.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "409": { "description": "Statusi aktual i porosis\u00eb nuk e lejon k\u00ebt\u00eb veprim, ose nj\u00eb thirrje me t\u00eb nj\u00ebjtin Idempotency-Key \u00ebsht\u00eb ende n\u00eb proces. Asgj\u00eb nuk i \u00ebsht\u00eb d\u00ebrguar Wolt-it.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "422": { "description": "Veprimi d\u00ebshtoi nga ana jon\u00eb dhe nuk u krye.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "502": { "description": "Wolt e refuzoi veprimin ose nuk u p\u00ebrgjigj. Riprovoni pa rrezik me t\u00eb nj\u00ebjtin Idempotency-Key.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit: 60 shkrime n\u00eb minut\u00eb p\u00ebr token. Riprovoni pas numrit t\u00eb sekondave n\u00eb header-in Retry-After.", "content": { "application\/json": { "schema": { "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" } } } } } } }, "\/wolt\/orders\/{id}\/retry-fiscalize": { "post": { "operationId": "partner.wolt.orders.retry-fiscalize", "description": "P\u00ebrdoreni kur `fiscal_state` \u00ebsht\u00eb `deferred` ose `failed`, q\u00eb ndodh kur CIS-i nuk u arrit\nn\u00eb \u00e7astin q\u00eb u l\u00ebshua fatura. Riprovimi b\u00ebn at\u00eb q\u00eb i takon rastit:\n\n- porosia ka tashm\u00eb nj\u00eb fatur\u00eb t\u00eb pafiskalizuar, ndaj fiskalizohet ajo fatur\u00eb;\n- porosia nuk ka fare fatur\u00eb, ndaj l\u00ebshohet dhe fiskalizohet nj\u00eb tani.\n\n**Nj\u00eb porosi e refuzuar, e anuluar ose e rimbursuar nuk fiskalizohet dot** dhe thirrja\nrefuzohet. Riprovimi mbi nj\u00eb porosi tashm\u00eb t\u00eb fiskalizuar \u00ebsht\u00eb i pad\u00ebmsh\u00ebm dhe nuk ndryshon\nasgj\u00eb.", "summary": "Riprovo fiskalizimin", "tags": [ "Wolt Partner API" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Id-ja e porosis\u00eb n\u00eb fature.al, nga feed-i ose nga lista e porosive.", "schema": { "type": "integer" }, "example": 8801 }, { "name": "Idempotency-Key", "in": "header", "required": true, "description": "\u00c7el\u00ebsi i idempotenc\u00ebs: nj\u00eb \u00e7el\u00ebs unik, i juaji, p\u00ebr k\u00ebt\u00eb veprim. Nj\u00eb riprovim me t\u00eb nj\u00ebjtin \u00e7el\u00ebs kthen p\u00ebrs\u00ebritjen e p\u00ebrgjigjes s\u00eb par\u00eb, n\u00eb vend q\u00eb t'i d\u00ebrgoj\u00eb Wolt-it nj\u00eb veprim t\u00eb dyt\u00eb, dhe p\u00ebrs\u00ebritja mban header-in Idempotent-Replayed: true. Ruhet 24 or\u00eb.", "schema": { "type": "string" }, "example": "a2f1c9e4-5b60-4d7a-9c31-8e0f2b6d4a17" } ], "responses": { "200": { "description": "Porosia e rifreskuar te `data.order`; `fiscal_state` \u00ebsht\u00eb `fiscalised` kur fiskalizimi u krye, ose `deferred` kur fatura u l\u00ebshua por CIS-i nuk u arrit.", "content": { "application\/json": { "schema": { "type": "object", "properties": { "status": { "type": "boolean" }, "data": { "type": "object", "properties": { "order": { "$ref": "#\/components\/schemas\/WoltOrderDetail" } }, "required": [ "order" ] } }, "required": [ "status", "data" ] } } } }, "401": { "$ref": "#\/components\/responses\/AuthenticationException" }, "400": { "description": "Header-i Idempotency-Key mungon.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "403": { "description": "Kompania nuk e ka modulin Wolt, p\u00ebrdoruesi i token-it nuk ka t\u00eb drejt\u00ebn Wolt, ose token-i nuk zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme aktive.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "404": { "description": "Nuk ka porosi t\u00eb till\u00eb p\u00ebr k\u00ebt\u00eb nj\u00ebsi.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "409": { "description": "Statusi aktual i porosis\u00eb nuk e lejon k\u00ebt\u00eb veprim, ose nj\u00eb thirrje me t\u00eb nj\u00ebjtin Idempotency-Key \u00ebsht\u00eb ende n\u00eb proces. Asgj\u00eb nuk i \u00ebsht\u00eb d\u00ebrguar Wolt-it.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "422": { "description": "Veprimi d\u00ebshtoi nga ana jon\u00eb dhe nuk u krye.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "502": { "description": "Wolt e refuzoi veprimin ose nuk u p\u00ebrgjigj. Riprovoni pa rrezik me t\u00eb nj\u00ebjtin Idempotency-Key.", "content": { "application\/json": { "schema": { "$ref": "#\/components\/schemas\/PartnerError" } } } }, "429": { "description": "Kufiri i k\u00ebrkesave u arrit: 60 shkrime n\u00eb minut\u00eb p\u00ebr token. Riprovoni pas numrit t\u00eb sekondave n\u00eb header-in Retry-After.", "content": { "application\/json": { "schema": { "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" } } } } } } } }, "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": { "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_method": { "type": [ "string", "null" ], "description": "M\u00ebnyra e pages\u00ebs me t\u00eb cil\u00ebn u shlye fatura; te nj\u00eb pages\u00eb e ndar\u00eb, ajo me pjes\u00ebn m\u00eb t\u00eb madhe.", "examples": [ "ACCOUNT" ] }, "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_method", "lines" ], "title": "InvoiceDetail" }, "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" }, "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" }, "PartnerError": { "type": "object", "properties": { "status": { "type": "boolean", "description": "Gjithmon\u00eb `false`.", "examples": [ false ] }, "message": { "type": "string", "description": "Shpjegim i p\u00ebrkthyer; ruajeni n\u00eb log, por mos vendosni sipas tij.", "examples": [ "Porosia nuk u gjet." ] }, "code": { "type": "string", "description": "Arsyeja e q\u00ebndrueshme, e lexueshme nga makina: `unauthenticated` (token-i\nmungon ose nuk vlen), `wolt_not_enabled` (kompania nuk e ka modulin Wolt),\n`forbidden` (p\u00ebrdoruesi i token-it nuk ka t\u00eb drejt\u00ebn Wolt), `no_venue`\n(token-i nuk zgjidhet n\u00eb nj\u00eb nj\u00ebsi t\u00eb vetme aktive), `order_not_found` (nuk ka\nporosi t\u00eb till\u00eb p\u00ebr k\u00ebt\u00eb nj\u00ebsi), `invalid_transition` (veprimi nuk lejohet p\u00ebr\nstatusin aktual t\u00eb porosis\u00eb), `invalid_data` (body i k\u00ebrkes\u00ebs nuk kaloi\nvalidimin), `action_failed` (veprimi d\u00ebshtoi nga ana jon\u00eb), `wolt_upstream_error`\n(Wolt e refuzoi veprimin ose nuk u p\u00ebrgjigj), `idempotency_key_required`\n(header-i `Idempotency-Key` mungon), `idempotency_in_progress` (nj\u00eb thirrje me\nt\u00eb nj\u00ebjtin \u00e7el\u00ebs \u00ebsht\u00eb ende n\u00eb proces).", "examples": [ "order_not_found" ] } }, "required": [ "status", "message", "code" ], "title": "PartnerError" }, "WoltCustomer": { "type": "object", "properties": { "name": { "type": [ "string", "null" ], "description": "Emri i klientit ashtu si\u00e7 e shfaq Wolt (`consumer_name`); `null` kur Wolt nuk e d\u00ebrgon.", "examples": [ "Arben H." ] }, "phone": { "type": [ "string", "null" ], "description": "Numri i telefonit t\u00eb klientit. Wolt e jep vet\u00ebm p\u00ebr porosit\u00eb self-delivery, ku korrieri i\nnj\u00ebsis\u00eb duhet ta kontaktoj\u00eb; te porosit\u00eb me korrier t\u00eb Wolt \u00ebsht\u00eb `null`.", "examples": [ "+355692345678" ] }, "note": { "type": [ "string", "null" ], "description": "Sh\u00ebnimi q\u00eb klienti la me porosin\u00eb (`consumer_comment`); `null` kur nuk ka sh\u00ebnim.", "examples": [ "Pa qep\u00eb, ju lutem" ] } }, "required": [ "name", "phone", "note" ], "title": "WoltCustomer" }, "WoltEventsPage": { "type": "object", "properties": { "events": { "type": "array", "description": "Ngjarjet me id m\u00eb t\u00eb madhe se `since`, t\u00eb renditura sipas id-s\u00eb n\u00eb rritje, deri n\u00eb `limit` cop\u00eb\ndhe vet\u00ebm t\u00eb llojeve te `types` kur e keni d\u00ebrguar. Bosh kur nuk ka asgj\u00eb t\u00eb re pas cursor-it.", "items": { "$ref": "#\/components\/schemas\/WoltOrderEvent" } }, "next_cursor": { "type": "string", "description": "Cursor-i p\u00ebr thirrjen e radh\u00ebs: id-ja e ngjarjes s\u00eb fundit n\u00eb k\u00ebt\u00eb faqe, ose vet\u00eb `since` q\u00eb\nd\u00ebrguat kur faqja \u00ebsht\u00eb bosh. Ruajeni dhe d\u00ebrgojeni si `since` n\u00eb thirrjen tjet\u00ebr. Vjen si\nstring edhe pse \u00ebsht\u00eb num\u00ebr.", "examples": [ "10470" ] }, "has_more": { "type": "boolean", "description": "`true` kur pas `next_cursor` ka ende ngjarje, pra kur feed-i mbante m\u00eb shum\u00eb se `limit`;\nvazhdoni menj\u00ebher\u00eb me `since=next_cursor`. `false` kur jeni n\u00eb fund t\u00eb feed-it.", "examples": [ true ] } }, "required": [ "events", "next_cursor", "has_more" ], "title": "WoltEventsPage" }, "WoltInvoiceRef": { "type": "object", "properties": { "id": { "type": "integer", "description": "Id-ja e fatur\u00ebs n\u00eb fature.al.", "examples": [ 512430 ] }, "number": { "type": [ "string", "null" ], "description": "Numri i fatur\u00ebs, si `184\/2026`; `null` sa koh\u00eb nuk i \u00ebsht\u00eb caktuar ende.", "examples": [ "184\/2026" ] }, "state": { "type": "string", "description": "Gjendja fiskale, e nj\u00ebjt\u00eb me `fiscal_state` t\u00eb porosis\u00eb: `pending`, `deferred`, `fiscalised` ose\n`failed`. Brenda k\u00ebsaj reference \u00ebsht\u00eb praktikisht `deferred` ose `fiscalised`, sepse referenca\nekziston vet\u00ebm kur porosia ka fatur\u00eb.", "examples": [ "fiscalised" ] }, "fiscal_iic": { "type": [ "string", "null" ], "description": "IIC (NSLF) i fatur\u00ebs, kodi identifikues q\u00eb llogaritet me l\u00ebshimin; `null` vet\u00ebm kur fatura nuk\ne ka ende.", "examples": [ "B1D6E9F3A4C2E7D8F0A1B2C3D4E5F601" ] }, "fiscal_fic": { "type": [ "string", "null" ], "description": "FIC (NIVF) i fatur\u00ebs, kodi q\u00eb kthen CIS-i kur e regjistron; `null` sa koh\u00eb fatura pret\nfiskalizimin (`deferred`).", "examples": [ "3a9c6e1f-2b4d-4f8e-9c7a-5d1e0b2f4a6c" ] } }, "required": [ "id", "number", "state", "fiscal_iic", "fiscal_fic" ], "title": "WoltInvoiceRef" }, "WoltOrderCompact": { "type": "object", "properties": { "id": { "type": "integer", "description": "Id-ja e porosis\u00eb n\u00eb fature.al; p\u00ebrdoreni si `{id}` n\u00eb endpoint-et e porosis\u00eb dhe t\u00eb veprimeve.", "examples": [ 8801 ] }, "wolt_order_id": { "type": "string", "description": "Id-ja e porosis\u00eb te Wolt.", "examples": [ "66e1f3a2b4c5d6e7f8a9b0c1" ] }, "display_number": { "type": [ "string", "null" ], "description": "Numri i porosis\u00eb q\u00eb Wolt i tregon klientit (`order_number`); `null` kur Wolt nuk e ka d\u00ebrguar\nende.", "examples": [ "A7" ] }, "status": { "type": "string", "description": "Statusi i porosis\u00eb, si\u00e7 vjen nga Wolt: `received`, `acknowledged`, `preorder_confirmed`,\n`production`, `ready`, `picked_up`, `courier_at_customer`, `delivered`, `rejected`, `refunded`,\n`cancelled`, ...", "examples": [ "ready" ] }, "fiscal_state": { "type": "string", "description": "Gjendja fiskale, e nxjerr\u00eb nga fatura: `pending` (pa fatur\u00eb), `deferred` (fatura pret CIS-in),\n`fiscalised` (e regjistruar n\u00eb CIS) ose `failed` (l\u00ebshimi d\u00ebshtoi dhe porosia mbeti pa fatur\u00eb).", "examples": [ "fiscalised" ] }, "total_amount": { "type": "number", "description": "Totali i paguar nga klienti, n\u00eb monedh\u00ebn e porosis\u00eb (`currency`), n\u00eb nj\u00ebsi t\u00eb plota (lek\u00eb, jo\nqindarka).", "examples": [ 1550 ] }, "currency": { "type": "string", "description": "Kodi i monedh\u00ebs s\u00eb porosis\u00eb sipas ISO 4217; `ALL` kur Wolt nuk d\u00ebrgon monedh\u00eb.", "examples": [ "ALL" ] }, "received_at": { "type": [ "string", "null" ], "description": "Kur fature.al e regjistroi porosin\u00eb nga Wolt (ISO-8601 me offset-in e or\u00ebs lokale).", "examples": [ "2026-09-14T12:05:31+02:00" ] }, "pickup_at": { "type": [ "string", "null" ], "description": "Koha e premtuar Wolt-it gjat\u00eb pranimit (ISO-8601 me offset-in e or\u00ebs lokale): kur do t\u00eb jet\u00eb\ngati porosia te nj\u00eb porosi marketplace, ose kur do t'i dor\u00ebzohet klientit te nj\u00eb porosi\nself-delivery. `null` kur gjat\u00eb pranimit nuk u premtua koh\u00eb.", "examples": [ "2026-09-14T12:30:00+02:00" ] }, "delivery_type": { "type": [ "string", "null" ], "description": "Lloji i dor\u00ebzimit sipas Wolt (`delivery.type`): `homedelivery` me korrier, `takeaway` klienti e\nmerr vet\u00eb, `eatin` konsumim n\u00eb vend; `null` kur Wolt nuk e d\u00ebrgon.", "examples": [ "homedelivery" ] }, "self_delivery": { "type": "boolean", "description": "`true` kur nj\u00ebsia e dor\u00ebzon porosin\u00eb me korrierin e vet dhe jo me nj\u00eb korrier t\u00eb Wolt.", "examples": [ false ] }, "branch": { "type": [ "string", "null" ], "description": "Emri i nj\u00ebsis\u00eb s\u00eb biznesit q\u00eb mban lidhjen Wolt; `null` kur lidhja nuk ka nj\u00ebsi.", "examples": [ "Blloku" ] }, "invoice": { "anyOf": [ { "description": "Referenca e fatur\u00ebs fiskale t\u00eb lidhur, ose `null` sa koh\u00eb nuk \u00ebsht\u00eb l\u00ebshuar fatur\u00eb.", "$ref": "#\/components\/schemas\/WoltInvoiceRef" }, { "type": "null" } ] } }, "required": [ "id", "wolt_order_id", "display_number", "status", "fiscal_state", "total_amount", "currency", "received_at", "pickup_at", "delivery_type", "self_delivery", "branch", "invoice" ], "title": "WoltOrderCompact" }, "WoltOrderCompany": { "type": "object", "properties": { "tax_id": { "type": "string", "description": "NIPT-i i kompanis\u00eb q\u00eb klienti k\u00ebrkoi t\u00eb faturohet (`company_tax_id` te Wolt).", "examples": [ "L81420034K" ] }, "name": { "type": [ "string", "null" ], "description": "Emri i kompanis\u00eb ashtu si\u00e7 e dha klienti te Wolt (`company_name`); `null` kur Wolt d\u00ebrgon vet\u00ebm\nNIPT-in.", "examples": [ "Alfa Consulting shpk" ] }, "address": { "type": [ "string", "null" ], "description": "Adresa e kompanis\u00eb ashtu si\u00e7 e dha klienti te Wolt (`company_address`); `null` kur mungon.", "examples": [ "Rruga e Kavaj\u00ebs 112, Tiran\u00eb" ] } }, "required": [ "tax_id", "name", "address" ], "title": "WoltOrderCompany" }, "WoltOrderDetail": { "type": "object", "properties": { "id": { "type": "integer", "description": "Id-ja e porosis\u00eb n\u00eb fature.al; p\u00ebrdoreni si `{id}` n\u00eb endpoint-et e porosis\u00eb dhe t\u00eb veprimeve.", "examples": [ 8801 ] }, "wolt_order_id": { "type": "string", "description": "Id-ja e porosis\u00eb te Wolt.", "examples": [ "66e1f3a2b4c5d6e7f8a9b0c1" ] }, "display_number": { "type": [ "string", "null" ], "description": "Numri i porosis\u00eb q\u00eb Wolt i tregon klientit (`order_number`); `null` kur Wolt nuk e ka d\u00ebrguar\nende.", "examples": [ "A7" ] }, "status": { "type": "string", "description": "Statusi i porosis\u00eb, si\u00e7 vjen nga Wolt: `received`, `acknowledged`, `preorder_confirmed`,\n`production`, `ready`, `picked_up`, `courier_at_customer`, `delivered`, `rejected`, `refunded`,\n`cancelled`, ...", "examples": [ "ready" ] }, "fiscal_state": { "type": "string", "description": "Gjendja fiskale, e nxjerr\u00eb nga fatura: `pending` (pa fatur\u00eb), `deferred` (fatura pret CIS-in),\n`fiscalised` (e regjistruar n\u00eb CIS) ose `failed` (l\u00ebshimi d\u00ebshtoi dhe porosia mbeti pa fatur\u00eb).", "examples": [ "fiscalised" ] }, "total_amount": { "type": "number", "description": "Totali i paguar nga klienti, n\u00eb monedh\u00ebn e porosis\u00eb (`currency`), n\u00eb nj\u00ebsi t\u00eb plota (lek\u00eb, jo\nqindarka).", "examples": [ 1550 ] }, "currency": { "type": "string", "description": "Kodi i monedh\u00ebs s\u00eb porosis\u00eb sipas ISO 4217; `ALL` kur Wolt nuk d\u00ebrgon monedh\u00eb.", "examples": [ "ALL" ] }, "received_at": { "type": [ "string", "null" ], "description": "Kur fature.al e regjistroi porosin\u00eb nga Wolt (ISO-8601 me offset-in e or\u00ebs lokale).", "examples": [ "2026-09-14T12:05:31+02:00" ] }, "pickup_at": { "type": [ "string", "null" ], "description": "Koha e premtuar Wolt-it gjat\u00eb pranimit (ISO-8601 me offset-in e or\u00ebs lokale): kur do t\u00eb jet\u00eb\ngati porosia te nj\u00eb porosi marketplace, ose kur do t'i dor\u00ebzohet klientit te nj\u00eb porosi\nself-delivery. `null` kur gjat\u00eb pranimit nuk u premtua koh\u00eb.", "examples": [ "2026-09-14T12:30:00+02:00" ] }, "delivery_type": { "type": [ "string", "null" ], "description": "Lloji i dor\u00ebzimit sipas Wolt (`delivery.type`): `homedelivery` me korrier, `takeaway` klienti e\nmerr vet\u00eb, `eatin` konsumim n\u00eb vend; `null` kur Wolt nuk e d\u00ebrgon.", "examples": [ "homedelivery" ] }, "self_delivery": { "type": "boolean", "description": "`true` kur nj\u00ebsia e dor\u00ebzon porosin\u00eb me korrierin e vet dhe jo me nj\u00eb korrier t\u00eb Wolt.", "examples": [ false ] }, "branch": { "type": [ "string", "null" ], "description": "Emri i nj\u00ebsis\u00eb s\u00eb biznesit q\u00eb mban lidhjen Wolt; `null` kur lidhja nuk ka nj\u00ebsi.", "examples": [ "Blloku" ] }, "invoice": { "anyOf": [ { "description": "Referenca e fatur\u00ebs fiskale t\u00eb lidhur, ose `null` sa koh\u00eb nuk \u00ebsht\u00eb l\u00ebshuar fatur\u00eb.", "$ref": "#\/components\/schemas\/WoltInvoiceRef" }, { "type": "null" } ] }, "customer": { "description": "Klienti (konsumatori) i porosis\u00eb, ashtu si\u00e7 e d\u00ebrgon Wolt.", "$ref": "#\/components\/schemas\/WoltCustomer" }, "company": { "anyOf": [ { "description": "Kompania q\u00eb faturohet n\u00eb nj\u00eb porosi B2B, ose `null` p\u00ebr nj\u00eb porosi t\u00eb zakonshme.", "$ref": "#\/components\/schemas\/WoltOrderCompany" }, { "type": "null" } ] }, "preorder": { "anyOf": [ { "description": "T\u00eb dh\u00ebnat e paraporosis\u00eb, ose `null` p\u00ebr nj\u00eb porosi t\u00eb \u00e7astit.", "$ref": "#\/components\/schemas\/WoltPreorder" }, { "type": "null" } ] }, "lines": { "type": "array", "description": "Rreshtat e porosis\u00eb, n\u00eb radh\u00ebn e Wolt. Sa koh\u00eb porosia nuk ka fatur\u00eb vijn\u00eb nga payload-i i\nWolt, me produktin e zgjidhur nga lidhja e artikujve t\u00eb menys\u00eb; sapo l\u00ebshohet fatura, vijn\u00eb\nnga rreshtat e fatur\u00ebs fiskale dhe mbajn\u00eb produktin me t\u00eb cilin u faturuan.", "items": { "$ref": "#\/components\/schemas\/WoltOrderLine" } }, "totals": { "description": "P\u00ebrmbledhja e shumave t\u00eb porosis\u00eb, e nxjerr\u00eb nga payload-i i Wolt, ndaj e nj\u00ebjt\u00eb para dhe pas fiskalizimit.", "$ref": "#\/components\/schemas\/WoltOrderTotals" } }, "required": [ "id", "wolt_order_id", "display_number", "status", "fiscal_state", "total_amount", "currency", "received_at", "pickup_at", "delivery_type", "self_delivery", "branch", "invoice", "customer", "company", "preorder", "lines", "totals" ], "title": "WoltOrderDetail" }, "WoltOrderEvent": { "type": "object", "properties": { "id": { "type": "integer", "description": "Id-ja e ngjarjes, gjithmon\u00eb rrit\u00ebse; \u00ebsht\u00eb cursor-i i feed-it: d\u00ebrgoni m\u00eb t\u00eb madhen q\u00eb keni\npar\u00eb si `since`.", "examples": [ 10421 ] }, "type": { "type": "string", "description": "Lloji i ngjarjes: `order.received`, `order.accepted`, `order.in_production`,\n`order.preorder_confirmed`, `order.ready`, `order.picked_up`, `order.courier_at_customer`,\n`order.delivered`, `order.rejected`, `order.cancelled`, `order.fiscalized`,\n`order.fiscalization_failed` ose `order.updated` (nj\u00eb ndryshim statusi q\u00eb nuk ka lloj t\u00eb vetin).", "examples": [ "order.ready" ] }, "order_id": { "type": "integer", "description": "Id-ja n\u00eb fature.al e porosis\u00eb p\u00ebr t\u00eb cil\u00ebn \u00ebsht\u00eb ngjarja; e nj\u00ebjta me `order.id`.", "examples": [ 8801 ] }, "wolt_order_id": { "type": "string", "description": "Id-ja e porosis\u00eb te Wolt.", "examples": [ "66e1f3a2b4c5d6e7f8a9b0c1" ] }, "status": { "type": [ "string", "null" ], "description": "Statusi i porosis\u00eb n\u00eb \u00e7astin e ngjarjes, me t\u00eb nj\u00ebjtat vlera si `order.status`.", "examples": [ "ready" ] }, "occurred_at": { "type": [ "string", "null" ], "description": "Kur u regjistrua ngjarja n\u00eb fature.al (ISO-8601 me offset-in e or\u00ebs lokale).", "examples": [ "2026-09-14T12:24:10+02:00" ] }, "order": { "description": "Snapshot i shkurt\u00ebr i porosis\u00eb ashtu si\u00e7 ishte kur u regjistrua ngjarja; p\u00ebr gjendjen e tanishme thirrni `GET \/wolt\/orders\/{id}`.", "$ref": "#\/components\/schemas\/WoltOrderCompact" } }, "required": [ "id", "type", "order_id", "wolt_order_id", "status", "occurred_at", "order" ], "title": "WoltOrderEvent" }, "WoltOrderInvoiceResult": { "type": "object", "properties": { "fiscal_state": { "type": "string", "description": "Gjendja fiskale e porosis\u00eb, e nxjerr\u00eb nga fatura e saj: `pending` (ende pa fatur\u00eb), `deferred`\n(fatura \u00ebsht\u00eb l\u00ebshuar, por CIS-i nuk e ka regjistruar ende), `fiscalised` (CIS-i e ka\nregjistruar fatur\u00ebn) ose `failed` (nj\u00eb p\u00ebrpjekje p\u00ebr ta l\u00ebshuar d\u00ebshtoi dhe porosia mbeti pa\nfatur\u00eb).", "examples": [ "fiscalised" ] }, "invoice": { "anyOf": [ { "description": "Fatura e plot\u00eb e porosis\u00eb, ose `null` sa koh\u00eb porosia nuk ka fatur\u00eb (`fiscal_state` `pending` ose\n`failed`). N\u00eb gjendjen `deferred` fatura kthehet me `fic: null`. Kur p\u00ebrdoruesi i token-it \u00ebsht\u00eb\ni llojit operator, fatura kthehet vet\u00ebm n\u00ebse u l\u00ebshua nga ai vet\u00eb; p\u00ebrndryshe `invoice` vjen\n`null` edhe pse `fiscal_state` tregon fatur\u00eb.", "$ref": "#\/components\/schemas\/InvoiceDetail" }, { "type": "null" } ] } }, "required": [ "fiscal_state", "invoice" ], "title": "WoltOrderInvoiceResult" }, "WoltOrderLine": { "type": "object", "properties": { "name": { "type": "string", "description": "Emri i artikullit: pas l\u00ebshimit t\u00eb fatur\u00ebs, emri me t\u00eb cilin u faturua (emri i produktit t\u00eb\nlidhur, ose emri i artikullit te Wolt kur nuk ka lidhje); m\u00eb par\u00eb, emri i artikullit te Wolt.", "examples": [ "Pizza Margherita" ] }, "quantity": { "type": "number", "description": "Sasia e porositur (`count` te Wolt).", "examples": [ 2 ] }, "unit_price": { "type": "number", "description": "\u00c7mimi p\u00ebr nj\u00ebsi q\u00eb Wolt i ngarkoi klientit, n\u00eb monedh\u00ebn e porosis\u00eb.", "examples": [ 750 ] }, "total": { "type": "number", "description": "Totali i rreshtit pas zbritjes, n\u00eb monedh\u00ebn e porosis\u00eb; kjo \u00ebsht\u00eb vlera q\u00eb faturohet.", "examples": [ 1300 ] }, "discount": { "type": "number", "description": "Zbritja e zbatuar n\u00eb rresht (artikull, shport\u00eb dhe opsione s\u00eb bashku), n\u00eb monedh\u00ebn e porosis\u00eb;\n`total` \u00ebsht\u00eb tashm\u00eb pas saj. Pas l\u00ebshimit t\u00eb fatur\u00ebs merret nga payload-i i Wolt sipas\npozicionit t\u00eb rreshtit, dhe \u00ebsht\u00eb 0 kur rreshtat e fatur\u00ebs nuk p\u00ebrputhen nj\u00eb p\u00ebr nj\u00eb me ata t\u00eb\nWolt.", "examples": [ 200 ] }, "product": { "anyOf": [ { "description": "Produkti i lidhur n\u00eb fature.al, ose `null` kur artikulli i Wolt nuk \u00ebsht\u00eb lidhur me asnj\u00eb produkt.", "$ref": "#\/components\/schemas\/WoltProductRef" }, { "type": "null" } ] }, "options": { "type": "array", "description": "Modifikuesit dhe opsionet q\u00eb klienti zgjodhi p\u00ebr rreshtin, si\u00e7 i d\u00ebrgon Wolt: objekte me `group`\n(grupi i opsionit), `value` (opsioni i zgjedhur), `count` (sa her\u00eb) dhe `price` (shtesa e\n\u00e7mimit, n\u00eb monedh\u00ebn e porosis\u00eb, tashm\u00eb e p\u00ebrfshir\u00eb te `total`). Bosh kur nuk ka opsione, dhe\nbosh edhe pas l\u00ebshimit t\u00eb fatur\u00ebs kur rreshtat e fatur\u00ebs nuk p\u00ebrputhen me ata t\u00eb Wolt.", "examples": [ [ { "group": "Madh\u00ebsia", "value": "E madhe", "count": 1, "price": 0 } ] ], "items": {} } }, "required": [ "name", "quantity", "unit_price", "total", "discount", "product", "options" ], "title": "WoltOrderLine" }, "WoltOrderTotals": { "type": "object", "properties": { "subtotal_before_discount": { "type": "number", "description": "Totali i shport\u00ebs para \u00e7do zbritjeje, n\u00eb monedh\u00ebn e porosis\u00eb.", "examples": [ 1750 ] }, "discount": { "type": "number", "description": "Zbritja e plot\u00eb q\u00eb mori klienti nga promocionet te `campaigns`, n\u00eb monedh\u00ebn e porosis\u00eb.", "examples": [ 200 ] }, "total": { "type": "number", "description": "Totali i paguar nga klienti, n\u00eb monedh\u00ebn e porosis\u00eb; i nj\u00ebjt\u00eb me `total_amount` t\u00eb porosis\u00eb.", "examples": [ 1550 ] }, "currency": { "type": "string", "description": "Kodi i monedh\u00ebs sipas ISO 4217; `ALL` kur Wolt nuk d\u00ebrgon monedh\u00eb.", "examples": [ "ALL" ] }, "campaigns": { "type": "array", "description": "Em\u00ebrtimet e promocioneve t\u00eb Wolt q\u00eb u zbatuan n\u00eb porosi (`campaigns_applied[].campaign_name`),\nsi string-e pa dublikime; bosh kur nuk u zbatua asnj\u00eb.", "examples": [ [ "Java e pic\u00ebs" ] ], "items": {} } }, "required": [ "subtotal_before_discount", "discount", "total", "currency", "campaigns" ], "title": "WoltOrderTotals" }, "WoltOrdersPage": { "type": "object", "properties": { "orders": { "type": "array", "description": "Porosit\u00eb e faqes n\u00eb form\u00ebn e shkurt\u00ebr, t\u00eb renditura sipas id-s\u00eb n\u00eb zbritje (m\u00eb e reja e para),\nderi n\u00eb `limit` cop\u00eb dhe t\u00eb kufizuara nga filtrat `status`, `from` dhe `to` kur i keni d\u00ebrguar.\nBosh kur asnj\u00eb porosi nuk p\u00ebrputhet.", "items": { "$ref": "#\/components\/schemas\/WoltOrderCompact" } }, "next_cursor": { "type": "string", "description": "Cursor-i p\u00ebr faqen e radh\u00ebs: id-ja e porosis\u00eb m\u00eb t\u00eb vjet\u00ebr n\u00eb k\u00ebt\u00eb faqe, ose `0` kur faqja\n\u00ebsht\u00eb bosh. D\u00ebrgojeni si `cursor` p\u00ebr t\u00eb marr\u00eb porosit\u00eb m\u00eb t\u00eb vjetra se ajo. Vjen si string\nedhe pse \u00ebsht\u00eb num\u00ebr.", "examples": [ "8777" ] }, "has_more": { "type": "boolean", "description": "`true` kur ka porosi m\u00eb t\u00eb vjetra se `next_cursor` q\u00eb p\u00ebrputhen me filtrat; `false` kur kjo\n\u00ebsht\u00eb faqja e fundit.", "examples": [ true ] } }, "required": [ "orders", "next_cursor", "has_more" ], "title": "WoltOrdersPage" }, "WoltPingResult": { "type": "object", "properties": { "company": { "type": "string", "description": "Emri i kompanis\u00eb n\u00eb fature.al s\u00eb cil\u00ebs i takon lidhja Wolt.", "examples": [ "Pizzeria Era shpk" ] }, "branch": { "type": "string", "description": "Emri i nj\u00ebsis\u00eb s\u00eb biznesit (deg\u00ebs) me t\u00eb cil\u00ebn \u00ebsht\u00eb lidhur nj\u00ebsia Wolt.", "examples": [ "Blloku" ] }, "venue_id": { "type": "string", "description": "Id-ja e nj\u00ebsis\u00eb (venue) te Wolt, ajo me t\u00eb cil\u00ebn \u00ebsht\u00eb regjistruar lidhja.", "examples": [ "5f3a1b2c4d5e6f7a8b9c0d1e" ] }, "connection_status": { "type": "string", "description": "Statusi i lidhjes Wolt n\u00eb fature.al: `active`, `paused` ose `disconnected`. N\u00eb nj\u00eb p\u00ebrgjigje 200\n\u00ebsht\u00eb gjithmon\u00eb `active`, sepse token-i zgjidhet vet\u00ebm n\u00eb nj\u00eb lidhje aktive; nj\u00eb lidhje e\npezulluar ose e shk\u00ebputur kthen 403 me kodin `no_venue`.", "examples": [ "active" ] }, "server_time": { "type": "string", "description": "Ora e serverit n\u00eb \u00e7astin e p\u00ebrgjigjes, ISO-8601 me offset-in e or\u00ebs lokale. Krahasojeni me or\u00ebn\ntuaj kur lexoni `received_at`, `pickup_at` dhe `occurred_at`, q\u00eb vijn\u00eb n\u00eb t\u00eb nj\u00ebjtin format.", "examples": [ "2026-09-14T12:24:10+02:00" ] } }, "required": [ "company", "branch", "venue_id", "connection_status", "server_time" ], "title": "WoltPingResult" }, "WoltPreorder": { "type": "object", "properties": { "time": { "type": "string", "description": "Ora p\u00ebr t\u00eb cil\u00ebn klienti e planifikoi porosin\u00eb (`pre_order.preorder_time`), ISO-8601 ashtu si\u00e7\ne d\u00ebrgon Wolt.", "examples": [ "2026-09-14T18:30:00+02:00" ] }, "status": { "type": [ "string", "null" ], "description": "Statusi i paraporosis\u00eb te Wolt (`pre_order.pre_order_status`), ashtu si\u00e7 e d\u00ebrgon Wolt; `null`\nkur mungon.", "examples": [ "confirmed" ] } }, "required": [ "time", "status" ], "title": "WoltPreorder" }, "WoltProductRef": { "type": "object", "properties": { "code": { "type": "string", "description": "Kodi i produktit n\u00eb fature.al.", "examples": [ "PZ-MARG" ] }, "name": { "type": "string", "description": "Emri i produktit n\u00eb fature.al.", "examples": [ "Pizza Margherita" ] } }, "required": [ "code", "name" ], "title": "WoltProductRef" }, "WoltRejectRequest": { "type": "object", "description": "Body of the reject action. Kept as a FormRequest so the allowed reject codes\nare documented as an enum in the API docs, while failedValidation still emits\nthe partner envelope { status, message, code, errors } on bad input.", "properties": { "reason": { "type": [ "string", "null" ], "description": "Arsye e shkurt\u00ebr, e lexueshme nga njeriu; Wolt mund t'ia tregoj\u00eb klientit.", "examples": [ "Kitchen is closing" ], "maxLength": 255 }, "code": { "type": [ "string", "null" ], "description": "Kodi i arsyes, p\u00ebr makin\u00ebn. Parazgjedhja \u00ebsht\u00eb GENERIC.", "enum": [ "GENERIC", "ITEMS_UNAVAILABLE", "VENUE_CLOSING_SOON", null ], "examples": [ "ITEMS_UNAVAILABLE" ] } }, "title": "WoltRejectRequest" } }, "responses": { "AuthenticationException": { "description": "Unauthenticated", "content": { "application\/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "description": "Error overview." } }, "required": [ "message" ] } } } } } } }