Objekt plaćanja "plaćanja" – RetailForce

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
~~isCash~~		-	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 plaćanja 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 kase
	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.
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 prodavača Podaci o zemlji: u nekim zemljama (npr. Slovenija) mora biti naveden poreski broj blagajnika.
ID referencije platnog terminala		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: Danska: paymentTerminalReferenceId mora biti uključen u zahtjev u slučaju kartičnih plaćanja. Dodatne informacije možete pronaći u tački 7 zahtjeva za blagajne u Danskoj .
podaci o kartici		O	Kvittance sa terminala za kreditne kartice (bez vlastite funkcije štampe) mogu se integrisati u kvittancu 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 linije slobodnog teksta nakon fiskalnog računa. Ne postoji razdvajanje između ta dva dijela. Podaci o zemlji: Grčka: Za obradu elektronskih plaćanja u Grčkoj potrebna su dodatna polja, uključujući providerSignature, providerTransactionId i providerSignatureMessage, radi usklađenosti sa lokalnim propisima.
	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
	ID terminala	O	ID terminala za plaćanje
	ID trgovca	O	ID (od akvizitera) trgovca
	transactionId	O	Jedinstveni ID transakcije
	providerSignature	O/M*	Potpis pružatelja plaćanja za proces plaćanja u Grčkoj
	ID pružatelja transakcije	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

Napomena: Od 1. marta 2023. godine, polje "IsCash" je uklonjeno iz modela objekata. I dalje se može slati, ali više ne pokreće funkciju. Tipovi plaćanja se kontroliraju putem polja "PaymentType".

Ovaj članak je automatski preveden.

objekt-plaćanja

Related articles