Transaksione të pranuara ↙
—Të gjitha transaksionet e profilit SIMULIM
MË SHUMË QARTËSI. ÇDO DITË.
Puna jote, në fokus.
Një vend për shitjet, artikujt dhe kompanitë e tua.
Version demonstrimi
Provo lirshëm me të dhëna fiktive. Pa pagesa reale dhe pa fiskalizim në ATK.
DEMOMËNYRA E PUNËS
Ndrysho mënyrën e punës
Ndryshon pamjen e kompanisë. Kuponët, artikujt dhe çelësat API ruhen.
HAPËSIRA E KOMPANISË
Mirë se erdhe.
Hyr me llogarinë tënde të FiKS.
Administratorët krijojnë llogaritë për çdo kompani.
Siguria e llogarisë
Ndrysho fjalëkalimin fillestar për të vazhduar.
Llogaritë e kompanive
Zgjidh kompaninë aktive dhe krijo një llogari me email. Përdoruesi e ndryshon fjalëkalimin në hyrjen e parë.
Profili aktiv:
QENDRA E MONITORIMIT
Shitjet në billing. Kontrolli këtu.
Transaksionet dhe konfirmimet e kompanisë.
ERP / BILLING → FiKS
Puna e përditshme mbetet në sistemin tënd.
API-ja pranon transaksione pa sesion të hapur në shfletues. Këtu hyn për konfigurim, raportim ose rakordim.
- 01 Shitja në billing
- 02 Pranimi në FiKS
- 03 Konfirmimi ATK
- 04 Printimi dhe mbyllja
Aktualisht: API dhe arkiv funksional për prova; ATK dhe printeri në simulim. Për procesin real pa ndërhyrje duhet agjenti i integrimit dhe lidhjet e miratuara.
— Të pranuar gjithsej— Në pritje të konfirmimeve— Të mbyllur · simulim— Simulime të mëparshme
Në radhë / përpunim ⇄
—Në pritje të adapteritSimulime të përfunduara ✓
—Pa fiskalizim realKërkojnë rakordim !
—Pa ridërgim automatikRegjistri i transaksioneve 0
100 transaksionet më të fundit të profilit aktiv.
| REFERENCA | PIKA / POS | VLERA | STATUSI | PRANUAR MË |
|---|
⇄
Gati për transaksionin e parë
Transaksionet do të shfaqen pasi të pranohen në FiKS.
Tregtarët
Regjistro kompaninë dhe zgjidh ERP / Billing ose Arkë / Shitje.
Protokolli ATKModele nga skema publike Protobuf · Nënshkrim lokal provuesBurimi publik ↗
NJË KONTRATË E PËRBASHKËT
Lidh ERP-në përmes API-së.
Çdo tregtar ka endpoint-in dhe çelësin e vet API për kuponët nga ERP-ja. FiKS e kontrollon përkatësinë e tregtarit në server. URL-ja e ERP-së është vetëm informacion derisa të ndërtohet adapteri përkatës.
- Dërgo transaksionin me një referencë unike.
- Ruaj identifikuesin që kthen gateway.
- Lexo statusin dhe rakordo rezultatin.
Zgjidh tregtarin për endpoint-inJSON
Authorization: Bearer <ERP_API_KEY>
Idempotency-Key: <REFERENCE_UNIKE>
Content-Type: application/json
{
"external_id": "ERP-2026-00001",
"branch_id": "PR-01",
"pos_id": "POS-01",
"operator_id": "OP-01",
"type": "SALE",
"currency": "EUR",
"items": [{
"code": "SVC-01", "name": "Shërbim provues",
"unit": "cope", "quantity": "1",
"unit_price": "11.8000",
"tax_category": "STANDARD"
}],
"payments": [{"method": "BANK_TRANSFER",
"amount": "11.80"}],
"total": "11.80", "tax_total": "1.80"
}Konfirmimet dhe webhook-et
FiKS → dërguar → ATK pranuar → printuar → mbyllur. Këtu konfirmimet e agjentit pranohen vetëm në SIMULATION.
Agjenti i integrimit
Çelës i veçantë nga ai i ERP-së, për raportimin e statuseve të kuponit. Ruhet vetëm hash-i i tij.
Ky veprim e çaktivizon çelësin e mëparshëm të agjentit.
Webhook drejt ERP-së
Zgjidh tregtarin.
Pa konfigurim aktiv.
Dërgesat e webhook-ut
Nënshkrim HMAC-SHA256 · riprovime me vonesë · marrësi duhet të heqë dublikatat sipas event ID.
Për riprovime pa trafik në aplikacion, agjenti duhet të thërrasë periodikisht endpoint-in e dispatcher-it. Konfigurimi i një URL-je të re anulon dërgesat e vjetra në pritje.
Shitja ndodh në billing.
Procesi vazhdon në prapavijë.
- 01Billingu krijon skedarin
- 02Agjenti e merr nga folderi
- 03API-ja kontrollon dhe ruan
- 04Përpunimi fiskal konfirmohet
- 05Kuponi printohet dhe arkivohet
Arkitekturë e planifikuar për FTP/SFTP dhe folder lokal. Formati TXT ende nuk është verifikuar. Kjo demo nuk lexon FTP dhe nuk lidhet me printer real; duhet parser sipas billingut dhe adapter sipas pajisjes/SEF-it.
Dërgo JSON-in e ERP-së për testim
Vetëm profili aktiv. Shumat monetare dërgohen si tekst.
TERMINALI / SHITJE E RE
Artikujt
Zgjidh artikullin ose kërko me barkod.
Hap kompaninë dhe shto artikuj nga katalogu.
Katalogu i kompanisë
Çmimet përfshijnë TVSH. Artikujt ruhen veçmas për çdo kompani.
| KODI | EMRI | KATEGORIA | ÇMIMI | TVSH |
|---|
Raporti mujor i kuponëve
Sipas muajit kalendarik në Kosovë. Rezultatet aktuale janë simulime; nuk është raport tatimor X/Z.
Numri i kuponëve—
Vlera bruto—
Pa TVSH—
TVSH—