Objekt plaćanja "plaćanja" – RetailForce

Ovaj članak odnosi se na objekt Plaćanje ("payments") unutar objekta Dokument.

Potpuni opis DOM-a (modela objekata dokumenta) sustava RetailForce, kao i opis pojedinih elemenata, možete pronaći u odjeljku za preuzimanje na web-stranici sustava 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 iskaznicu.

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 stupcu "Type":

M ... obavezno / potrebno
M* ... obavezno / potrebno u određenim zemljama ili pod određenim uvjetima
R ... preporučeno
O... opcionalno

Elementi		Tip	Opis
iznos		M	Ukupno plaćanja
ISO kod valute		M	ISO 4217 kod valute
natpis		M	Naznaka načina plaćanja / sredstva plaćanja
jedinstveni čitljivi identifikator plaćanja		M	(proizvoljan) jedinstveni identifikator vrste plaćanja. Primjeri: "gotovina", "gotovinski plaćanje", "VISA", "gotovina-EUR",... Obratite pažnju: nije moguće koristiti 2 različite kratice valuta 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*
	ID vaučera	M*	Tipovi: MultiPurposeVoucher, SinglePurposeVoucher. Pažnja: `VoucherId` mora biti ugniježđen ispod `AdditionalFields` objekt.
	additionalProp1-x	M*
vrstaPlaćanja		M	Način plaćanja / Sredstvo plaćanja
~~isCash~~		-	Element "isCash" više nije podržan od 1. ožujka 2023. Vrsta plaćanja definira se elementom paymentType. Obratite pažnju: svojstvo "IsCash" uklonjeno je od verzije 1.7.6 sustava Fiscal Client!
datum stvaranja		O	Datum kada je tip uplate stvoren (ako je dostupan)
vatIdentification		M*	ID klase PDV-a (prema dodjeli RF-a), pogledajte: GET /api/v1/information/client/ {clientId}/getVatIdentification Pažnja: Za određene vrste plaćanja moraju se navesti informacije o PDV-u. Na primjer, za preduplate (depozit), vaučere,... Preporučujemo da uvijek uključite detalje o PDV-u.
vatPercent		M*	Postotak PDV-a / stopa PDV-a
vatPercent2		O	Drugi postotak / stopa PDV-a (za plaćanja s mješovitom stopom PDV-a)
porezniIznos		M*	Iznos PDV-a
taxValue2		O	Drugi iznos PDV-a (za uplate s 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*	Naznaka korisnika blagajne
	prvoIme	O	Prijezime korisnika blagajne
	prezime	O	Prezime korisnika blagajne
	porezniBroj	O/M*	Porezni broj korisnika blagajne Podaci o zemlji: u nekim zemljama (npr. Slovenija) mora se navesti porezni 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*	Porezni broj prodavača Podaci o zemlji: u nekim zemljama (npr. Slovenija) mora se navesti porezni broj blagajnika.
ID referencije terminala za plaćanje		O/M*	ID transakcije koji vraća platni terminal (ako je platni terminal integriran s POS sustavom i ID transakcije treba biti isprintan na dokumentu). Podaci o zemlji: Danska: paymentTerminalReferenceId mora biti uključen u zahtjev u slučaju kartičnih plaćanja. Dodatne informacije mogu se pronaći u točki 7 zahtjeva za blagajne u Danskoj .
podaciOkartici		O	Kviti iz terminala za kreditne kartice (bez vlastite funkcije ispisa) mogu se integrirati u kvit putem cardData. U zemljama u kojima se koriste "fiskalni pisači" (= sustav RetailForce kontrolira ispis dokumenata), informacije uključene u područje cardData ispisuju se kao slobodni tekstualni redovi nakon fiskalne računa. Ne postoji odvajanje između ta dva dijela. Podaci o zemlji: Grčka: Za obradu elektroničkih plaćanja u Grčkoj potrebna su dodatna polja, uključujući providerSignature, providerTransactionId i providerSignatureMessage, radi usklađenosti s lokalnim propisima.
	receiptCopyCount	O	Broj primjeraka računa
	potvrda	O	Niz redaka teksta računa
	maskiraniBrojKartice	O	Maskirani broj kartice radi sigurnosti (npr. ****1234)
	identifikacijski token	O	Jedinstveni identifikacijski token za transakciju
	broj kopija trgovca	O	Broj primjeraka računa trgovca
	trgovacPotvrda	O	Niz redaka teksta trgovačke potvrde
	vrstaKartice	O	Vrsta kartice za transakciju plaćanja (npr. VISA, MASTERCARD itd.)
	autorizacijski kod	O	Kod autorizacije za plaćanje
	ID terminala	O	ID terminala za plaćanje
	ID trgovca	O	ID (od akvizitera) trgovca
	transactionId	O	Jedinstveni ID transakcije
	potpisPružaoca	O/M*	Potpis pružatelja plaćanja za proces plaćanja u Grčkoj
	ID transakcije pružatelja	O/M*	ID transakcije pružatelja plaćanja za proces plaćanja u Grčkoj
	porukaPotpisaProvidera	O/M*	Poruka potpisa platnog pružatelja za postupak plaćanja u Grčkoj
	datumtransakcije	O	Datum transakcije plaćanja
	brojTransakcije	O	Broj transakcije elektroničke uplate

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

Ovaj je članak automatski preveden.

objekt-plaćanja

Povezani članci