Regjistrimi (v1)

Ne kete koleksion perfshihen endpoint-et qe ju lejojne te regjistroni nje kompani ne fature.al dhe te plotesoni te dhenat e nevojshme per ta bere gati per leshimin e faturave.

Workflow:

1. Regjistroni kompanine (POST /register).
2. Perditesoni njesine e biznesit (branch) me businessUnitCode, i cili merret nga self-care dhe ruhet te njesia e biznesit.
3. Perditesoni perdoruesin me operatorCode, i cili merret nga self-care.
4. Ngarkoni certifikaten elektronike se bashku me fjalekalimin perkates, te cilin e merrni nga e-Albania.
5. Ruani llogarite bankare qe kompania do te perdore per faturat pa para ne dore ose per faturat elektronike (eInvoice).

Nese kompania do te leshoje fatura me para ne dore: 6. Ruani pajisjen fiskale (fiscal device) dhe kodi i kthyer fiscalTcrCode duhet te ruhet te perdoruesi qe do te leshoje keto lloj faturash, njesoj si te pika 3.

Shtimi i perdoruesve te rinj: Mund te shtoni me shume perdorues nese eshte e nevojshme, por per secilin duhet te plotesohen:

• Nje email unik, p.sh. [email protected]
• Pajisja fiskale, sipas pikes 6
• Kodi i operatorit, sipas pikes 3

Shenim: Cdo perdorues do te operoje me api_token-in e vet, te cilin e merr pasi te regjistrohet.

Sandbox (vetem ne instancen DEMO): Per te testuar te gjithe flow-in e onboarding-ut pa krijuar nje kompani te re, perdorni NIPT-in sandbox L62221018T ne thirrjen POST /register. Sjellja:

• Nuk krijohet kompani e re; perdoruesi dhe njesia e biznesit krijohen nen kompanine ekzistuese sandbox L62221018T.
• Email-i qe dergoni shtohet me nje sufiks unik (+sandbox-XXXXXXXX) ne DB, keshtu qe mund ta riperseritni POST /register me te njejtin email pa goditur unique-key.
• POST /on-boarding/certificate ne DEMO kthen success per cdo certifikate (.p12 ose .pfx) dhe cdo fjalekalim, pa e validuar fjalekalimin apo NIPT-in brenda certifikates. Data expiresAt qe kthehet eshte +1 vit nga sot.
• Hapat e tjere (branch, user, bank-account, fiscal-device) ekzekutohen normalisht ne kompanine sandbox.

Ne PRODUCTION keto sjellje sandbox jane jo-aktive. NIPT L62221018T trajtohet si cdo NIPT tjeter.