Gabimet

This page

Gabimet kthehen me nje kod HTTP te zakonshem dhe nje trup JSON.

Trupi i gabimit#

{
  "status": false,
  "message": "Pershkrimi i gabimit",
  "errors": ["cfare shkoi keq"]
}

Ne nje deshtim validimi fusha errors eshte objekt i ndare sipas fushes, jo varg:

{
  "success": false,
  "message": "Te dhenat nuk jane te vlefshme",
  "errors": { "lines": ["Fatura duhet te kete te pakten nje rresht"] }
}

Ky eshte perjashtimi i vetem nga zarfi standard, dhe vlen per disa endpoint-e te v1. Prandaj lexoni gjithmone me pare kodin HTTP dhe pastaj fushat e trupit: nje program qe kontrollon vetem status e sheh nje 422 sikur te mos kete status fare.

Kodet qe perdor kjo API#

Kodi	Kuptimi	Cfare te beni
`400`	Te dhena te paplota	`errors` thote sakte cfare mungon. Zakonisht adresa ose qyteti i bleresit
`403`	Nuk lejohet	Abonimi ka mbaruar, ose llogaria nuk ka kete te drejte
`404`	Nuk u gjet	Burimi nuk ekziston, ose nuk i perket kompanise suaj
`409`	Ekziston tashme	Nje fature me kete `internalId` eshte leshuar ose po procesohet
`422`	Validimi deshtoi	Rregulloni te dhenat. Mos riprovoni te njejten kerkese
`429`	Kufiri u arrit	Prisni sa thote `Retry-After`
`500`	Gabim i papritur	Provoni perseri me vone
`503`	Fiskalizimi i paarritshem	Fatura eshte ruajtur. Mos e riprovoni

Dy kode qe nuk jane deshtime#

409 dhe 503 duken si gabime, por nuk kerkojne riprovim, dhe riprovimi i tyre ben dem:

409 do te thote qe fatura ekziston. Nje internalId i derguar dy here kthen 409 ne vend qe te leshoje nje fature te dyte, pra mbrojtja ka funksionuar.
503 do te thote qe sistemi i tatimeve nuk u arrit, por fatura u ruajt dhe fiskalizohet vete me vone. Lexoni gjendjen me POST /api/v1/invoice/details/{internalId}, ku fic mbetet null derisa te kryhet.

Ne te dyja rastet, nje cikel riprovimi vetem shton kerkesa qe nuk ndryshojne asgje.

Regjistrimi eshte falas.

Regjistrohu ne fature.al