Načini plaćanja i slanje računa kupcu (API)

Koju vrednost šalješ u payments[].type i kako račun stiže kupcu na mejl. Ostala polja su u referenci API-ja.

Vrednosti za način plaćanja

Način plaćanja šalješ u polju type svake stavke niza payments. API prihvata vrednost bez obzira na velika i mala slova, pa važe i oblici iz druge kolone. U odgovoru se vraća vrednost iz prve kolone.

ŠalješPrihvata se iU kasi i na računu
cashCashGotovina
cardCardPlatna kartica
checkCheckČek
wire_transferwireTransfer, WireTransferPrenos na račun
voucherVoucherVaučer
mobile_moneymobileMoney, MobileMoneyInstant plaćanje
otherOtherDrugo bezgotovinsko plaćanje

Kupac je platio na dva načina? Pošalji dve stavke u payments, svaku sa svojim iznosom. Zbir plaćanja mora da bude jednak zbiru stavki računa.

API prihvata još četiri vrednosti: virman, mobile, factoring i account. Ne koristi ih. Nijedna nije način plaćanja koji Poreska uprava poznaje: za prenos šalji wire_transfer, za instant plaćanje mobile_money.

Koju vrednost da pošalješ

Kartica preko payment gateway-acard
IPS QR kod ili instant plaćanjemobile_money (u kasi „Instant plaćanje")
Uplatnica ili prenos na računwire_transfer
Drugo bezgotovinskoother

Ovo su vrednosti koje kasa koristi za iste načine plaćanja. Za plaćanje pouzećem, i kad nisi siguran koji način plaćanja ide na račun, pitaj knjigovođu firme za koju izdaješ račune.

Kako račun ide kupcu na mejl

Postoje dva načina:

  • Odmah pri izdavanju: u zahtev za račun dodajsettings.sendToEmail sa adresom kupca. Prima jednu adresu, bez kopija. U odgovoru polje emailSentTo pokazuje na koju adresu je mejl poslat.
  • Posle izdavanja: pozovi POST /receipt/send-email sa brojem računa (invoiceNumber) i adresom kupca (email). Ovde možeš da dodaš i kopiju (cc) i skrivenu kopiju (bcc), obe kao niz adresa. Istim pozivom račun šalješ ponovo, na primer kad kupac traži.
POST https://api.fiscomm.rs/receipt/send-email
Authorization: Bearer <tvoj-api-kljuc>
Content-Type: application/json

{
  "invoiceNumber": "<invoiceNumber iz odgovora na račun>",
  "email": "kupac@primer.rs",
  "cc": ["prodaja@primer.rs"],
  "bcc": ["arhiva@primer.rs"]
}

Odgovor je success i correlationId. Uspeh znači da je mejl prihvaćen za slanje, ne da je stigao u sanduče kupca.

Slanje mejlom mora da bude uključeno za firmu (vidi cenovnik). Na demo nalogu je uključeno. Ako nije, oba načina vraćaju grešku 403. Pazi kod prvog načina: kad je settings.sendToEmail u zahtevu, a slanje nije uključeno, ni račun se ne izdaje.

Kupac dobija račun, a kopija (bcc) ne stiže

Proveri ovim redom:

  1. Gde šalješ bcc. Kopije postoje samo na POST /receipt/send-email.settings.sendToEmail pri izdavanju računa ne šalje ni cc ni bcc.
  2. Oblik polja. cc i bcc su nizovi adresa (["arhiva@primer.rs"]), ne jedan string.
  3. Ista adresa. Adresa iz bcc koja je već u email ilicc se izbacuje, da isti primalac ne dobije dva mejla.
  4. Neželjena pošta na adresi kopije.

Ako je sve to u redu, a kopija i dalje ne stiže, piši na podrska@fiscomm.rs i pošalji correlationId iz odgovora i broj računa.

Sledeći korak

Isprobaj plaćanja i slanje mejla na demo nalogu.

Otvori nalog