Integracija preko webhook-a
PrestaShop porudžbina postaje fiskalni račun
PrestaShop pošalje porudžbinu u svom obliku, Tezga je pročita, izda račun, fiskalizuje ga preko V-PFR-a i u odgovoru vrati broj računa, verifikacioni link i PDF. Porudžbinu ne moraš da prepakuješ.
POST https://pos.narbiz.com/api/integrations/order?provider=prestashop
Šta Tezga čita iz porudžbine
- id ili reference
- broj porudžbine; isti broj nikad ne pravi drugi račun
- customer.company, firstname, lastname
- kupac na računu: naziv firme ili ime i prezime
- customer.siret
- PIB kupca, za račun firmi
- customer.email
- mejl kupca
- payment
- način plaćanja iz porudžbine
- order_rows (ili associations.order_rows)
- stavke: naziv, šifra, količina i cena sa PDV-om
Primer tela, uz zaglavlje X-Tezga-Api-Key
{
"id": "1042",
"reference": "XKBKNABJK",
"payment": "Plaćanje karticom",
"customer": {
"company": "Primer d.o.o.",
"siret": "123456789",
"email": "kupac@primer.rs"
},
"order_rows": [
{
"product_name": "Majica, plava, M",
"product_reference": "MAJ-PL-M",
"product_quantity": 2,
"unit_price_tax_incl": 1990
}
]
}Dve stvari da znaš pre povezivanja
Stopa je 20 odsto
Iz PrestaShop oblika Tezga svaku stavku čita sa stopom od 20 odsto. Ako prodaješ i robu po 10 ili 0 odsto, modul treba da šalje opšti oblik porudžbine (provider=custom), gde svaka stavka nosi svoju stopu.
Veza je jednosmerna
Porudžbinu šalje PrestaShop; Tezga je ne povlači sama. Broj računa stiže u odgovoru, a upis u porudžbinu radi modul. Povlačenje i upis nazad postoje samo za WooCommerce i Shopify.
Isto kao u svakoj vezi
- Isti broj porudžbine vraća isti račun, i kad dva zahteva stignu istovremeno.
- Telo zahteva može dodatno da se potpiše HMAC-SHA256 tajnom, a API ključ da se veže za IP adresu servera prodavnice.
- Kad V-PFR Poreske uprave ne odgovara, račun se ne gubi: Tezga sama ponavlja fiskalizaciju i javlja ishod webhook-om, ako si ga podesio.
Česta pitanja
Kako se PrestaShop povezuje sa fiskalnom kasom?
Preko webhook-a: PrestaShop, najčešće preko modula, pošalje porudžbinu na Tezgin API, a Tezga izda i fiskalizuje račun preko V-PFR-a i u odgovoru vrati broj računa, verifikacioni link i PDF.
Da li Tezga upisuje broj računa nazad u PrestaShop porudžbinu?
Ne sama. Broj računa, verifikacioni link i PDF stižu u odgovoru na zahtev, pa ih modul koji šalje porudžbinu može upisati u porudžbinu. Automatski upis nazad i povlačenje porudžbina postoje samo u gotovim vezama za WooCommerce i Shopify.
Šta ako prodajem robu po stopi od 10 odsto?
PrestaShop oblik porudžbine Tezga čita sa stopom od 20 odsto za svaku stavku. Ako imaš stavke po 10 ili 0 odsto, modul treba da šalje opšti oblik porudžbine (provider=custom), u kom svaka stavka nosi svoju stopu. Ako firma nije u sistemu PDV-a, sve stavke se ionako evidentiraju kao oslobođene.
Poveži PrestaShop i prestani da prekucavaš
Veze sa web prodavnicama su u paketu Biznis. Povezivanje radimo zajedno sa tobom ili sa programerom koji ti održava prodavnicu.