Ovaj članak se odnosi na objekt Plaćanje ("payments") unutar objekta Dokument.
Potpuni opis RetailForce DOM-a (modela objekata dokumenta), kao i opis pojedinačnih elemenata, možete pronaći u odjeljku za preuzimanje na web stranici RetailForce (Object model documentation.pdf) u odgovarajućem direktoriju za verzije.
Objekt plaćanja naravno može sadržavati nekoliko različitih plaćanja (= različitih sredstava plaćanja - PaymentType) za jednu vaučer.
objekt-plaćanja
Sljedeći objekt plaćanja sadrži primjere podataka.
"payments": [
{
"amount": 120.00,
"currencyIsoCode": "EUR",
"caption": "BAR",
"uniqueReadablePaymentIdentifier": "BARZAHLUNG",
"foreignAmount": 0,
"foreignAmountExchangeRate": 0,
"additionalFields": {
"voucherId": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
"paymentType": "cash",
"createDate": "2023-04-25T15:08:11.57+01:00",
"vatIdentification": 1,
"vatPercent": 20,
"vatPercent2": 10,
"taxValue": 20.00,
"taxValue2": 10.00,
"externalIdentifier": [
"string"
],
"user": {
"id": "user01",
"caption": "user01",
"firstName": "Manuela",
"lastName": "Musterfrau",
"taxNumber": "123456789"
},
"salesPerson": {
"id": "VK01",
"caption": "Franz",
"firstName": "Franz",
"lastName": "Österreicher",
"taxNumber": "234567890"
},
"paymentTerminalReferenceId": "string",
"cardData": {
"receiptCopyCount": 2,
"receipt": ["line1", "line2"],
"cardNumberMasked": "****1234",
"identificationToken": "token123",
"merchantCopyCount": 1,
"merchantReceipt": ["merchant line1"],
"cardType": "VISA",
"authorizationCode": "AUTH123",
"terminalId": "TERM001",
"merchantId": "MERCH001",
"transactionId": "TRX123456",
"providerSignature": "signature_string",
"providerTransactionId": "PROV_TRX_001",
"providerSignatureMessage": "signature_message",
"transactionDate": "2023-04-25T15:08:11.57+01:00",
"transactionNumber": "12345"
}
}
],Sljedeći objekt plaćanja sadrži primjere podataka.
Informacije u koloni "Type":
- M ... obavezno / potrebno
- M* ... obavezno / potrebno u određenim zemljama ili pod određenim uslovima
- R ... preporučeno
- O... opcionalno
| Elementi | Tip | Opis | |
| iznos | M | Ukupno plaćanja | |
| ISO kod valute | M | ISO 4217 kod valute | |
| natpis | M | Naziv načina plaćanja / sredstva plaćanja | |
| jedinstveni čitljivi identifikator plaćanja | M |
(proizvoljni) jedinstveni identifikator vrste plaćanja. Primjeri: "gotovina", "gotovinski plaćaj", "VISA", "gotovina-EUR",...
Pažnja:
nije moguće koristiti 2 različite skraćenice za valutu za isti jedinstveni čitljivi identifikator plaćanja unutar jednog dnevnog izvoda (Z-izvoda)! Ako se koristi više valuta, za svaku valutu mora se koristiti jedinstveni čitljivi identifikator plaćanja. Npr. "CashEUR", "CashUSD", "CashDKK", "Cash payment EUR",...
|
|
| iznosu stranoj valuti | O | Ukupno ako je plaćanje izvršeno u stranoj valuti | |
| foreignAmountExchangeRate | O | Tečaj stranih valuta | |
| dodatnaPolja | M* | ||
| broj vaučera | M* | Tipovi: MultiPurposeVoucher, SinglePurposeVoucher. Pažnja: VoucherId mora biti ugniježđen ispod AdditionalFields objekt. |
|
| additionalProp1-x | M* | ||
| tipPlaćanja | M | Način plaćanja / Sredstvo plaćanja | |
| - |
Element "isCash" više nije podržan od 1. marta 2023. Vrsta plaćanja se definiše elementom paymentType.
Pažnja:
Svojstvo "IsCash" je uklonjeno od verzije 1.7.6 Fiscala Clienta!
|
||
| createDate | O | Datum kada je tip uplate kreiran (ako je dostupan) | |
| vatIdentification | M* |
ID klase PDV-a (prema dodjeli RF), pogledajte: GET /api/v1/information/client/ {clientId}/getVatIdentification
Pažnja:
Za određene vrste plaćanja moraju biti navedene informacije o PDV-u. Na primjer, za avanse (depozit), vaučere,...
Preporučujemo da uvijek uključite detalje o PDV-u. |
|
| vatPercent | M* | PDV procenat / stopa | |
| vatPercent2 | O | Drugi PDV postotak / stopa (za uplate s mješovitim PDV stopama) | |
| poreznaVrijednost | M* | Iznos PDV-a | |
| taxValue2 | O | Drugi iznos PDV-a (za uplate sa mješovitim stopama PDV-a) | |
| externalIdentifier | O | ||
| korisnik | O/M* | Podaci o korisniku blagajne (može se navesti ako se razlikuju od podataka u zaglavlju dokumenta ili u stavkama). | |
| id | O/M* | ID kod korisnika blagajne | |
| natpis | O/M* | Naziv korisnika kase | |
| prvoIme | O | Prijezime korisnika kase | |
| prezime | O | Prezime korisnika kase | |
| porezniBroj | O/M* |
Poreski broj korisnika kase
Podaci o zemlji:
u nekim zemljama (npr. Slovenija) mora se navesti poreski broj blagajnika. Slovenija: u glavi dokumenta se uzima u obzir samo korisnik.poreskiBroj, a ne vrijednost u plaćanju.
|
|
| prodavač | O/M* | Podaci o prodavaču (može se navesti ako se razlikuju od podataka u zaglavlju dokumenta ili u pojedinačnim stavkama) | |
| id | O/M* | ID broj prodavača | |
| natpis | O/M* | Naziv prodavača | |
| prvoIme | O | Prijezime prodavača | |
| prezime | O | Prezime prodavača | |
| porezniBroj | O/M* |
Poreski broj prodavca
Podaci o zemlji:
u nekim zemljama (npr. Slovenija) mora biti naveden poreski broj kasira. Slovenija: vrednuje se samo user.taxNumber u zaglavlju dokumenta, a ne vrijednost u plaćanju.
|
|
| referenceIdplatnogterminala | O/M* |
ID transakcije koji vraća platni terminal (ako je platni terminal integrisan sa POS sistemom i ID transakcije treba biti odštampan na dokumentu). Podaci o zemlji:
|
|
| cardData | O/M* |
Kvittanci sa terminala za kreditne kartice (bez vlastite funkcije štampe) mogu se integrirati u kvitanciju putem cardData. U zemljama gdje se koriste "fiskalni printeri" (= sistem RetailForce kontroliše štampanje dokumenata), informacije uključene u područje cardData štampaju se kao slobodni tekstualni redovi nakon fiskalne računa. Ne postoji razdvajanje između ta dva dijela. Podaci o zemlji:
Napomena: Odluka AADE A.1155/2023 predviđa potpis pružatelja usluga ili ECR token, ovisno o primjenjivoj grčkoj arhitekturi za integraciju plaćanja. Ovaj regulatorni zahtjev sam po sebi ne utvrđuje da su sva tri polja iz RetailForcea (providerSignature, providerTransactionId i providerSignatureMessage) obavezna u svakoj transakciji kartičnog plaćanja. Njihova primjenjivost ovisi o scenariju integracije. |
|
| receiptCopyCount | O | Broj kopija računa | |
| potvrda | O | Niz redova teksta računa | |
| maskiraniBrojKartice | O | Maskirani broj kartice radi sigurnosti (npr., ****1234) | |
| identifikacijskiToken | O | Jedinstveni identifikacijski token za transakciju | |
| broj kopija trgovca | O | Broj kopija računa trgovca | |
| trgovacPotvrda | O | Niz redova teksta trgovačkog računa | |
| tipKartice | O | Tip kartice za transakciju plaćanja (npr. VISA, MASTERCARD itd.) | |
| autorizacijski kod | O | Kod za autorizaciju plaćanja | |
| terminalId | O/M* | ID terminala za plaćanje | |
| ID trgovca | O | ID (od akvizitera) trgovca | |
| transactionId | O/M* | Jedinstveni ID transakcije | |
| potpisPružatelja | O/M* | Potpis pružatelja usluge plaćanja za proces plaćanja u Grčkoj | |
| ID transakcije pružatelja usluga | O/M* | transactionId pružatelja usluge plaćanja za proces plaćanja u Grčkoj | |
| providerSignatureMessage | O/M* | Poruka potpisa platnog provajdera za proces plaćanja u Grčkoj | |
| transactionDate | O | Datum transakcije plaćanja | |
| brojTransakcije | O | Broj transakcije elektronskog plaćanja | |
Ovaj članak je automatski preveden.
Comments
0 comments
Please sign in to leave a comment.