{
    "name": "fature.al API",
    "version": "1.0.0",
    "description": "fature.al është platforma e faturimit dhe e fiskalizimit për bizneset në Shqipëri. Me këtë API\nsistemi juaj lëshon fatura të fiskalizuara pa u marrë vetë me certifikata, nënshkrim XML dhe SOAP:\ndërgoni faturën si JSON dhe merrni mbrapsht dokumentin e regjistruar te administrata tatimore, me\nkodet fiskale, URL-në e verifikimit dhe PDF-në.\n\nTermat e këtij dokumentacioni (fiskalizim, NIPT, TCR, IIC, FIC) shpjegohen te\n[Konceptet bazë](/api-reference/pages/concepts.html).\n\n## Në pak rreshta\n\n| | |\n| --- | --- |\n| Versioni për të ndërtuar | `v1` |\n| Versione në përdorim | `v1` dhe `v2`, krahas njëri-tjetrit |\n| Live | `https://fature.al/api/v1` |\n| Sandbox | `https://demo.fature.al/api/v1` |\n| Formati | JSON në kërkesë dhe në përgjigje, UTF-8 |\n| Identifikimi | Bearer token i përdoruesit; ofruesit e software-it dërgojnë edhe client id dhe client secret të aplikacionit |\n| Kufiri i përgjithshëm | 300 kërkesa në minutë për token, 120 në minutë për IP pa token; kalimi kthen `429` |\n\nVersioni është pjesë e rrugës: `/invoice/cash` do të thotë `https://fature.al/api/v1/invoice/cash`.\nNdërtoni kundrejt sandbox-it dhe kaloni në live duke ndryshuar vetëm adresën bazë.\n\n## Për kë është\n\n- **Programe kontabiliteti dhe ERP**, që e lëshojnë faturën aty ku bëhet shitja.\n- **Dyqane online**, që e kthejnë porosinë e paguar në faturë në të njëjtin çast.\n- **Programe arke, bari dhe restoranti**, me porosi që hapen dhe mbyllen me një pagesë.\n- **Ofrues software-i**, që e instalojnë të njëjtin program te shumë biznese, secili me identitetin e\n  vet fiskal.\n\n## Çfarë ju duhet para thirrjes së parë\n\n| Ju duhet | Ku e merrni |\n| --- | --- |\n| Një llogari në fature.al, me abonim që përfshin modulet që do të përdorni | `fature.al`, ose `demo.fature.al` për sandbox |\n| Një **API token** | Në panelin e fature.al, te **Konfigurime > API Tokens**. Token-i është i përdoruesit, jo i kompanisë |\n| **Client id** dhe **client secret** të aplikacionit, nëse jeni ofrues software-i | Nga fature.al, kur regjistrohet integrimi juaj. Shihni [Identifikimi](/api-reference/pages/authentication.html) |\n| Certifikata elektronike e biznesit, e ngarkuar në fature.al | Biznesi e merr nga e-Albania dhe e ngarkon një herë në panel |\n| Për fatura cash: një pajisje fiskale (TCR) e lidhur me përdoruesin e token-it | Konfigurohet nga biznesi në panel, ose nga ju me endpoint-et e regjistrimit |\n\nThirrja e parë e dobishme është `GET /account`: ju thotë me cilin biznes, njësi biznesi dhe pajisje\nfiskale po punoni.\n\n## Çfarë mbulon\n\n- **Faturat**: cash, jo-cash, e-faturë, porosi me përmbledhëse, bulk jo-cash dhe fletë shoqëruese\n  (WTN), me listë, detaje, anulim dhe PDF.\n- **Klientët dhe produktet**, si të dhëna që ndahen mes sistemit tuaj dhe fature.al.\n- **Arka fiskale**: hapja dhe mbyllja e balancës, hyrjet dhe daljet e parave.\n- **Llogaritë bankare dhe monedhat**, bashkë me kursin e ditës.\n- **Faturat e blerjes**, të tërhequra nga CIS-i.\n- **Raportet**, të llogaritura në server.\n- **Regjistrimi i kompanive**, për ofruesit që hapin llogari për klientët e tyre.\n\nNjë pamje e plotë është te [Çfarë mund të ndërtoni](/api-reference/pages/use-cases.html).\n\n## Si lexohet një përgjigje\n\nÇdo përgjigje është JSON. Lexoni së pari kodin HTTP. Në `200`, fusha `status` thotë nëse veprimi u\nkrye (`true`, rezultati te `data`) ose u refuzua (`false`, arsyeja te `message`). Në `422`, përgjigja\ne validimit përdor fushën `success` në vend të `status`, dhe `errors` është objekt sipas fushës.\n\n```json\n{\"status\": true, \"data\": {\"...\": \"...\"}}\n```\n\n```json\n{\"status\": false, \"message\": \"Përshkrimi i gabimit\", \"errors\": [\"Mesazhi për përdoruesin\"]}\n```\n\nTabela e plotë e kodeve është te [Gabimet](/api-reference/pages/errors.html).\n\n## Nga ku të filloni\n\n- [Konceptet bazë](/api-reference/pages/concepts.html) shpjegon fiskalizimin dhe termat.\n- [Fillimi i shpejtë](/api-reference/pages/quickstart.html) ju çon nga token-i te fatura e parë.\n- [Identifikimi](/api-reference/pages/authentication.html) mbulon token-in dhe kredencialet e\n  aplikacionit.",
    "documentation": "/api-reference/index.html",
    "api_versions": [
        {
            "name": "v2",
            "newer": true,
            "status": "paralel me v1"
        },
        {
            "name": "v1",
            "current": true
        }
    ],
    "surfaces": {
        "openapi": "/api-reference/openapi.json",
        "llms_txt": "/api-reference/llms.txt",
        "llms_full": "/api-reference/llms-full.txt",
        "markdown": "/api-reference/index.md",
        "search_index": "/api-reference/search-index.json",
        "postman": "/api-reference/postman.json",
        "sitemap": "/api-reference/sitemap.xml"
    },
    "endpoints": 116,
    "generator": "lusen",
    "mcp": {
        "transport": "stdio",
        "command": "php artisan lusen:mcp"
    }
}