Kalo te përmbajtja

Shtojca A — Shifrarët e UJP-së

← Kthehu te përmbajtja


Kjo shtojcë përmban një shqyrtim referencial të të gjithë shifrarëve (tabelat cb_*) që eFakturaWin përdor për përputhshmëri me sistemin e-Faturë të UJP-së. Shifrarët janë vetëm për lexim — plotësohen gjatë nisjes së parë të aplikacionit dhe përdoren në lista zbritëse nëpër formularët. Pamja që vijon është nga UJP Phase 2 (3 maj 2026).

A.0. Si përditësohen shifrarët

Gjatë nisjes së parë të aplikacionit, funksioni Db_Codebooks.prg::PopulateCodebookSeeds() mbush të gjitha tabelat cb_* nga të dhëna seed të integruara (baked-in). Ato të dhëna seed merren nga UJP në momentin e ndërtimit të versionit.

Çdo rresht në tabelat e shifrarëve ka kolonën last_synced — të rezervuar për një funksion të ardhshëm Shërbim → Rifresko shifrarët, që do t'i tërheqë listat më të reja drejtpërdrejt nga API-i i UJP-së.

🚧 Rifreskimi automatik nga UJP ende nuk është implementuar. Deri atëherë, shifrarët mbeten „të ngrirë" në gjendjen nga momenti i instalimit; kjo shtojcë e dokumenton atë gjendje. Nëse UJP ndërkohë shton një kod të ri (p.sh. arsye të re refuzimi), nevojitet përmirësim i eFakturaWin që ai kod të jetë i disponueshëm në aplikacion.

💡 Tabelat lokale cb_* gjithmonë mund të shqyrtohen drejtpërdrejt në bazën SQLite eFakturaWin.db me një klient arbitrar SQLite. Ato janë burimi i së vërtetës për atë që është i disponueshëm në instalimin tuaj.


A.1. Shtetet

Kodet dyshkronjore ISO-3166 alpha-2 të shteteve. Përdoren në fushën „Shteti" të partnerit për të dalluar rezidentët (MK) nga jorezidentët (EDB e huaj + kodi i shtetit).

Ku shfaqet në aplikacion: Shifrarët → Partnerët → Futje/ndryshim → fusha Shteti.

UJP endpoint: GET /api/v1/countries

Shifrat (zgjedhje nga më të shpeshtat në tregtinë MK):

Kodi Emri
MK Maqedonia e Veriut
AL Shqipëria
AT Austria
BG Bullgaria
CH Zvicra
DE Gjermania
ES Spanja
FR Franca
GB Mbretëria e Bashkuar
GR Greqia
IT Italia
NL Holanda
RS Serbia
TR Turqia
US Shtetet e Bashkuara të Amerikës

Lista e plotë përmban ~200 shtete. Për një kod që nuk është këtu, shihni burimin e UJP-së: countries.json ose drejtpërdrejt GET /api/v1/countries.

Pamje nga UJP Phase 2 snapshot, 2026-05-03.


A.2. Monedhat

Kodet e monedhave. Shifrari i UJP-së përmban dy formate paralelisht: kodi treshkronjor ISO-4217 (EUR, USD, MKD…) dhe kodi treshifror ISO-numerik (978, 840…). eFakturaWin përdor kodet treshkronjore si bazë.

Ku shfaqet në aplikacion: Fatura → Kreu → fusha Monedha.

UJP endpoint: GET /api/v1/currency

Shifrat (zgjedhje nga më të shpeshtat):

Kodi Emri
MKD Denari maqedonas
EUR Euro
USD Dollari amerikan
GBP Funta britanike
CHF Franga zviceriane
CAD Dollari kanadez
AUD Dollari australian
JPY Jeni japonez
BGN Leva bullgare
156 yuani kinez (CNY)
643 rublja ruse (RUB)
941 dinari serb (RSD)
949 lira turke (TRY)

Lista e plotë përmban ~44 kode (përfshirë variantet treshkronjore dhe numerike). Për një monedhë që nuk është këtu, shihni burimin e UJP-së ose drejtpërdrejt GET /api/v1/currency.

Pamje nga UJP Phase 2 snapshot, 2026-05-03.


A.3. Grupet tatimore (Lloji TVSH)

Normat themelore të TVSH-së. Nga Phase 2 (maj 2026) UJP riemërtoi kodet e vjetra (A018, B005, V010, G000) në DDV-A / DDV-B / DDV-V / DDV-G.

Ku shfaqet në aplikacion: Fatura → Artikujt → kolona Lloji TVSH.

UJP endpoint: GET /api/v1/tax-groups

Shifrat:

Kodi Emri Norma Përshkrimi
DDV-A TVSH 18% 18% Norma standarde – 18%
DDV-B TVSH 5% 5% Normë e preferuar tatimore – 5%
DDV-V TVSH 10% 10% Normë e preferuar tatimore - 10%
DDV-G TVSH 0% 0% Normë zero tatimore - 0%

Pamje nga UJP Phase 2 snapshot, 2026-05-03.


A.4. Treguesi TVSH

Klasifikim më i detajuar i trajtimit të TVSH-së për çdo artikull — tatueshmëri standarde, e liruar, detyrim i bartur, jashtë fushës, etj. Çdo tregues është i lidhur me saktësisht një grup tatimor (taxGroupCode).

Ku shfaqet në aplikacion: Fatura → Artikujt → kolona Treguesi TVSH.

UJP endpoint: GET /api/v1/tax-indicators

Shifrat:

Kodi Grupi tatimor Emri Efekti TVSH
DDV-A DDV-A Tatim standard me normën e përgjithshme tatimore prej 18% STANDARD
DDV-B DDV-B Tatim standard me normën e preferuar tatimore prej 5% STANDARD
DDV-V DDV-V Tatim standard me normën e preferuar tatimore prej 10% STANDARD
DDV-G DDV-G Nuk është subjekt i TVSH-së NULA
DDV-7-I DDV-G Eksport - Qarkullim i liruar nga TVSH me të drejtë të zbritjes së tatimit të paraprak OSLOBODEN
DDV-8 DDV-G Qarkullim i liruar nga TVSH me të drejtë të zbritjes së tatimit të paraprak OSLOBODEN
DDV-9 DDV-G Qarkullim i liruar nga TVSH pa të drejtë të zbritjes së tatimit të paraprak OSLOBODEN
DDV-10-13 DDV-G Qarkullim i mallrave që nuk është objekt tatimimi në vend OSLOBODEN
DDV-10-14 DDV-G Qarkullim i shërbimeve që nuk është objekt tatimimi në vend OSLOBODEN
DDV-11-A DDV-A Qarkullim në vend për të cilin tatimin e llogarit marrësi i qarkullimit me normën e përgjithshme tatimore prej 18% (bartje e detyrimit tatimor sipas nenit 32-a të LTVSH) PRENESEN
DDV-11-V DDV-V Qarkullim në vend për të cilin tatimin e llogarit marrësi i qarkullimit me normën e preferuar tatimore prej 10% (bartje e detyrimit tatimor sipas nenit 32-a të LTVSH) PRENESEN
DDV-11-B DDV-B Qarkullim në vend për të cilin tatimin e llogarit marrësi i qarkullimit me normën e preferuar tatimore prej 5% (bartje e detyrimit tatimor sipas nenit 32-a të LTVSH) PRENESEN

💡 Efekti TVSH (vatImpact): STANDARD = TVSH e zakonshme llogaritet; NULA = nuk është subjekt i TVSH-së; OSLOBODEN = i liruar nga TVSH; PRENESEN = detyrim tatimor i bartur (reverse charge, neni 32-a).

Pamje nga UJP Phase 2 snapshot, 2026-05-03.


A.5. Lloji i pagesës

Shifrar i llojeve të pagesave. Përdoret për qëllim informativ në e-faturë.

Ku shfaqet në aplikacion: Fatura → Kreu → fusha Lloji i pagesës.

UJP endpoint: GET /api/v1/payment-types

Shifrat:

Kodi Përshkrimi
P10 Pagesë në dorë
P11 Pagesë me kartë
P12 Pagesë përmes bankës
P13 Pagesë me këste
P14 Pagesë bankare online
P15 Pagesë përmes aplikacionit mobil
P16 Dhënie pa shpërblim
P17 Kompensim
P18 Pagesë me kupon vlere
P19 Instrumente të tjera pagese

Pamje nga UJP Phase 2 snapshot, 2026-05-03.


A.6. Lloji i dokumentit

Shifrar i llojeve të dokumenteve që mund të dërgohen përmes API-it të UJP-së. Aktualisht është aktivizuar vetëm fatura e zakonshme.

Ku shfaqet në aplikacion: Fatura → Kreu → fusha Lloji i dokumentit.

UJP endpoint: GET /api/v1/document-types

Shifrat:

Kodi Emri Kërkon nënshkrim Ka artikuj Ka referencë
100 Faturë po po jo

Pamje nga UJP Phase 2 snapshot, 2026-05-03.


A.7. Lloji i dokumentit të lidhur

Shifrar i llojeve të dokumenteve te të cilat mund të referohet një faturë (porosi, deklaratë doganore, profaturë, etj.). Përdoret në fushën „Dok. i lidhur" në kreun e faturës.

Ku shfaqet në aplikacion: Fatura → Kreu → fusha Dok. i lidhur.

UJP endpoint: GET /api/v1/ref-document-types

Shifrat:

Kodi Emri Përshkrimi
SYS Nga sistemi Fletëdërgesë dhe fletëkthim, sqarim për të njëjtat, fletë peshe — referohet në ID-në e dokumentit të lidhur të lëshuar përmes sistemit e-faturë
JN Dokument për prokurim publik —
C_D Deklaratë doganore —
C_R Vendim nga Drejtoria Doganore —
GRD Dokumente ndërtimi —
TRN Dokumente transporti p.sh. CMR, fletëdërgesë, dokument shoqërues për mallra të padoganuara
KUP Referencë e blerësit Referencë sipas llojeve të blerësve të preferuar
NAR Porosi Dokument me të cilin bëhet porosia zyrtare e mallit ose shërbimit
FIS Faturë fiskale Plotësohet në rast shitje ambulante kur paguhet në dorë dhe lëshohet faturë fiskale dhe Faturë në dorë
PRO Profaturë Dokument i lëshuar para realizimit të shitjes
PON Ofertë Ofertë e dorëzuar te blerësi
DOC Dokumente të tjera —

Pamje nga UJP Phase 2 snapshot, 2026-05-03.


A.8. Arsyeja e zhvlerësimit (anulimit)

Arsyet zyrtare të UJP-së gjatë zhvlerësimit të një fature të dërguar. Zgjidhet në dritaren „Anulim" para konfirmimit.

Ku shfaqet në aplikacion: Lista e faturave → klik i djathtë → Anulo (Storno) → listë zbritëse Arsyeja. 🚧 (Aktivizohet me S1 — funksioni i anulimit është në zhvillim.)

UJP endpoint: GET /api/v1/void-reasons

Shifrat:

Kodi Arsyeja
S-1 Blerës i gabuar
S-2 Anulim i kontratës
S-3 Malli është kthyer tërësisht
S-4 Faturim i dyfishtë i të njëjtit qarkullim
S-5 Tjetër

Pamje nga UJP Phase 2 snapshot, 2026-05-03.


A.9. Arsyeja e refuzimit

Arsyet zyrtare të UJP-së për refuzimin e një fature hyrëse. Zgjidhet në dritaren „Refuzim i faturës hyrëse" para konfirmimit.

Ku shfaqet në aplikacion: Faturat hyrëse → Refuzo → listë zbritëse Arsyeja e refuzimit. (Shih edhe §9.9 Refuzimi.)

UJP endpoint: GET /api/v1/reject-reasons

Shifrat:

Kodi Arsyeja
O-1 TVSH e llogaritur gabimisht (bazë tatimore e papërshtatshme, normë TVSH, tregues tatimor i parregullt etj.)
O-2 Gabim në porosi (sasia, çmimi, përshkrimi i qarkullimit dhe të tjera)
O-3 Të dhëna të gabuara për blerës (edb, emri, adresa dhe të tjera)
O-4 Qarkullimi nuk është kryer
O-5 Faturë dyfish
O-6 Datë e gabuar (lëshim/qarkullim)
O-7 Tjetër

Pamje nga UJP Phase 2 snapshot, 2026-05-03.


← Kthehu te përmbajtja | Më parë: PBSh ←