Sljedeći JSON primjeri pokazuju kako se u RetailForceu može obraditi potvrda o primitku avansa i naknadno obračunavanje tog avansa prilikom isporuke ili pružanja usluga. Imajte na umu da se u RetailForceu za avanse / predplaćanja koristi termin 'deposit'.
Imajte na umu da se određene vrijednosti svojstava korištene u primjerima moraju prilagoditi kako biste mogli koristiti payload u svom sistemu (npr. "UniqueClientId", "BookDate"). Primjeri su također kreirani za određenu zemlju, što znači da se porezne stope, bruto i neto iznosi itd. također moraju prilagoditi.
| Verzija za korisnika: | 1.11.16.2546 |
| DOM-verzija: | 1.7.0 |
1. Primljeni depozit/akontacija
U prvom koraku kreira se potvrda o primljenoj akontaciji:
- Kupac vrši gotovinski depozit od 1.200 EUR za buduću isporuku ili uslugu.
Osobine transakcije
Tabela ispod prikazuje koje osobine moraju biti postavljene na koje vrijednosti kako bi se poslovni slučaj ispravno mapirao.
| Svojstvo | Vrijednost | Opis |
| Tip dokumenta | "0" odnosno "[0] = Potvrda o uplati" | za obrađivanje putem gotovinskog računa |
| Tip pozicije | "3" odnosno "[3] = Rezervacija" | Prijem depozita se evidentira kao stavka tipa "3" (rezervacijska pozicija). |
| Positions.BusinessTransactionType | "7" odnosno "[7] = depozit" | Konkretna vrsta poslovne transakcije (BusinessTransactionType) koja se koristi je "7" (depozit). |
| Positions.VatIdentification | Ako se u relevantnoj zemlji PDV već mora prikazati ili uplatiti prilikom prijema avansa ili depozita, mora se navesti ispravan ID kategorije PDV-a i PDV izračunati u skladu s tim. | |
| Payments.Type | "0" odnosno "Gotovina" | Budući da ovaj konkretan slučaj uključuje gotovinsko plaćanje, način plaćanja također mora biti odgovarajuće naveden. |
Primjer:
{
"ModelVersion": "1.7.0",
"UniqueClientId": "3e2c0cdf-e72c-43ea-a050-686eb0eb3853",
"UniqueCashRegisterId": null,
"ApplicationVersion": "1.0.0",
"ApplicationVersionId": null,
"ApplicationVersionPrevious": null,
"FiscalModuleVersion": "1.11.0.0",
"FiscalCountryModuleVersion": null,
"SoftwareName": "RetailForce neverPOS",
"RetailForceReceiptId": null,
"AdditionalFields": {},
"AutomaticVatCalculation": 0,
"AllowedVatDeviation": 0.01,
"PrintCount": null,
"TerminalSlaveId": null,
"FooterGraphicIndex": null,
"DocumentGuid": "026f0809-88b8-48c2-9e96-6f3ba37f48ff",
"DocumentId": "0026",
"CreateDate": "2026-06-01T13:30:08+02:00",
"BookDate": "2026-06-01T13:30:08+02:00",
"AccountingDate": "2026-06-01T13:30:08+02:00",
"DocumentNumber": "202500026",
"DocumentNumberSeries": "SI",
"CancellationDocument": false,
"FailedToPay": false,
"DocumentReference": null,
"IsTraining": false,
"TestCaseNumber": null,
"DocumentType": 0,
"DocumentTypeCaption": "POS-Receipt",
"User": {
"Id": "1",
"Caption": "User01",
"FirstName": "Joe",
"LastName": "Dowe",
"TaxNumber": null,
"DateOfEntry": "2025-09-23T15:11:08.6041978+02:00"
},
"SalesPerson": null,
"AllocationGroups": [],
"CustomerCount": null,
"Partner": null,
"Notes": null,
"PaymentTerms": null,
"ServicePeriodStart": null,
"ServicePeriodEnd": null,
"PositionCount": 1,
"DocumentIssueType": null,
"Coupon": null,
"ServiceType": null,
"IsEcommerceTransaction": null,
"TaxPositions": null,
"FiscalDocumentNumber": 0,
"FiscalDocumentRevision": 0,
"FiscalDocumentStartTime": 0,
"Positions": [
{
"PositionNumber": 0,
"Caption": "Downpayment for Order",
"Type": 3,
"BusinessTransactionType": 7,
"PayOutType": null,
"VatIdentification": 1,
"VatPercent": 200.0,
"NetValue": 1000.00,
"GrossValue": 1200.00,
"TaxValue": 200.00,
"AdditionalFields": {},
"ExternalIdentifier": []
}
],
"Payments": [
{
"Amount": 1200.00,
"CurrencyIsoCode": "EUR",
"Caption": "Bar",
"UniqueReadablePaymentIdentifier": "BAR",
"ForeignAmount": 0,
"ForeignAmountExchangeRate": 0,
"AdditionalFields": {},
"PaymentType": 0,
"CreateDate": null,
"VatIdentification": null,
"VatPercent": null,
"VatPercent2": null,
"TaxValue": null,
"TaxValue2": null,
"ExternalIdentifier": [],
"User": null,
"SalesPerson": null,
"PaymentTerminalReferenceId": null,
"CardData": null
}
],
"AdditionalHeader": [],
"AdditionalFooter": [],
"FiscalAdditionalFields": {}
}
2. Poravnanje konačne uplate
Prilikom isporuke ili pružanja usluga (npr. kada kupac preuzima naručene robe), kupac mora podmiriti preostali dug u punom iznosu vrijednosti robe:
- Ukupna vrijednost robe/usluga: EUR 2,979.90
- Uzimajući u obzir depozit od 1.200 EUR
- Kupac plaća preostali iznos (EUR 1.779,90) i u gotovini
Depozit se može uključiti u konačni dokument na dva različita načina:
Opcija 1 – Depozit kao stavka
U ovoj varijanti, avans se uključuje u konačni dokument kao negativna stavka (suprotno od stavke u izvornom dokumentu).
Svojstva transakcije
Tabela u nastavku prikazuje koje osobine moraju biti postavljene na koje vrijednosti kako bi se poslovni slučaj ispravno mapirao.
| Svojstvo | Vrijednost | Opis |
| Tip dokumenta | "0" odnosno "[0] = Potvrda o uplati" | za obrađivanje putem gotovinskog računa |
| Tip pozicije | "0" odnosno "[0] = stavka" | Za poziciju artikla 0 (artikl koji je naručio kupac i za koji je uplaćena avansna uplata) |
| Positions.BusinessTransactionType | "0" odnosno "[0] = Prihod" | Za poziciju artikla 0 (artikl koji je naručio kupac za koji je uplaćena avansna uplata) |
| Positions.Type | "3" odnosno "[3] = Rezervacija" | Za uključivanje primljenog depozita koristi se stavka 1 tipa "3" (rezervacija) – kao u prvom primjeru. Međutim, vrijednosti (GrossValue, NetValue itd.) za ovu stavku su negativne (!). |
| Positions.BusinessTransactionType | "7" odnosno "[7] = Avans" | Specifični tip poslovne transakcije (BusinessTransactionType) koji se koristi u stavci 1 je "7" (depozit). |
| Positions.VatIdentification | PDV se također mora uzeti u obzir prilikom poravnanja depozita. | |
| Payments.Type | "0" odnosno "Gotovina" |
U odjeljku "Isplate" prikazana je samo preostala isplata u gotovini (Ukupno stavki = Ukupno isplata). Proračun: Pozicija 0: 2,979.90 Pozicija 1: -1,200.00 Ukupno pozicija: 1,779.90 Uplate: 1,779.90 (gotovina) Ukupna isplata: 1,779.90 |
Primjer:
{
"ModelVersion": "1.7.0",
"UniqueClientId": "3e2c0cdf-e72c-43ea-a050-686eb0eb3853",
"UniqueCashRegisterId": null,
"ApplicationVersion": "1.0.0",
"ApplicationVersionId": null,
"ApplicationVersionPrevious": null,
"FiscalModuleVersion": "1.11.0.0",
"FiscalCountryModuleVersion": null,
"SoftwareName": "RetailForce neverPOS",
"RetailForceReceiptId": null,
"AdditionalFields": {},
"AutomaticVatCalculation": 0,
"AllowedVatDeviation": 0.01,
"PrintCount": null,
"TerminalSlaveId": null,
"FooterGraphicIndex": null,
"DocumentGuid": "215f0809-88b8-48c2-9e96-6f3ba37f48ff",
"DocumentId": "0021",
"CreateDate": "2025-10-09T12:50:08+02:00",
"BookDate": "2025-10-09T12:50:08+02:00",
"AccountingDate": "2025-10-09T12:50:08+02:00",
"ProcessStartDate": "2025-10-09T12:50:08+02:00",
"DocumentNumber": "202500021",
"DocumentNumberSeries": "SI",
"CancellationDocument": false,
"FailedToPay": false,
"DocumentReference": null,
"IsTraining": false,
"TestCaseNumber": null,
"DocumentType": 0,
"DocumentTypeCaption": "POS-Receipt",
"User": {
"Id": "1",
"Caption": "User01",
"FirstName": "Joe",
"LastName": "Dowe",
"TaxNumber": null,
"DateOfEntry": "2025-09-23T15:11:08.6041978+02:00"
},
"SalesPerson": null,
"AllocationGroups": [],
"CustomerCount": null,
"Partner": null,
"Notes": null,
"PaymentTerms": null,
"ServicePeriodStart": null,
"ServicePeriodEnd": null,
"PositionCount": 2,
"DocumentIssueType": null,
"Coupon": null,
"ServiceType": null,
"IsEcommerceTransaction": null,
"TaxPositions": null,
"FiscalDocumentNumber": 0,
"FiscalDocumentRevision": 0,
"FiscalDocumentStartTime": 0,
"Positions": [
{
"PositionNumber": 0,
"ItemCaption": "RENOXA KnowPal 15.6 Untel Lore Ultra- Z9 399J 32GB RAM 512GB SSD RTX 3060 W11P",
"ItemShortCaption": "RENOXA KnowPal",
"ItemSerialNumber": null,
"Type": 0,
"Quantity": 2.0,
"QuantityUnit": {
"Id": "STK"
},
"ItemType": 0,
"ItemId": "RKP156UZ9",
"ItemTaxType": 0,
"InHouse": true,
"ItemGroupId": "1000",
"ItemGroupCaption": "Notebooks",
"BusinessTransactionType": 0,
"CostPrice": 2979.90,
"BaseNetValue": 2483.25,
"BaseGrossValue": 2979.90,
"BaseTaxValue": 496.65,
"Discounts": [],
"VatIdentification": 1,
"VatPercent": 20.0,
"NetValue": 2483.25,
"GrossValue": 2979.90,
"TaxValue": 496.65,
"AdditionalFields": {},
"ExternalIdentifier": []
},
{
"PositionNumber": 1,
"Caption": "Downpayment for Order",
"Type": 3,
"BusinessTransactionType": 7,
"PayOutType": null,
"VatIdentification": 1,
"VatPercent": 20.0,
"NetValue": -1000.00,
"GrossValue": -1200.00,
"TaxValue": -200.00,
"AdditionalFields": {},
"ExternalIdentifier": []
}
],
"Payments": [
{
"Amount": 1779.90,
"CurrencyIsoCode": "EUR",
"Caption": "Bar",
"UniqueReadablePaymentIdentifier": "Cash",
"ForeignAmount": 0,
"ForeignAmountExchangeRate": 0,
"AdditionalFields": {},
"PaymentType": 0,
"CreateDate": null,
"VatIdentification": null,
"VatPercent": null,
"VatPercent2": null,
"TaxValue": null,
"TaxValue2": null,
"ExternalIdentifier": [],
"User": null,
"SalesPerson": null,
"PaymentTerminalReferenceId": null,
"CardData": null
}
],
"AdditionalHeader": [],
"AdditionalFooter": [],
"FiscalAdditionalFields": {}
}
Opcija 2 – Depozit kao plaćanje
U ovoj varijanti, primljeni depozit se prikazuje kao stavka plaćanja u teretu.
Osobine transakcije
Tabela ispod prikazuje koje osobine moraju biti postavljene na koje vrijednosti kako bi se ispravno mapirao poslovni slučaj.
| Svojstvo | Vrijednost | Opis |
| Tip dokumenta | "0" odnosno "[0] = Potvrda" | za obrađivanje putem gotovinskog računa |
| Tip pozicije | "0" odnosno "[0] = stavka" | Za poziciju artikla 0 (artikl koji je naručio kupac i za koji je uplaćena avansna uplata) |
| Positions.BusinessTransactionType | "0" odnosno "[0] = Prihod" | Za poziciju artikla 0 (artikl koji je naručio kupac za koji je uplaćena avansna uplata) |
| Uplate.Tip | "0" odnosno "Gotovina" | Odjeljak "Plaćanja" uključuje dvije stavke: 1. Preostali iznos plaćen u gotovini, i... |
| Payments.Type | "6" odnosno "[6] = depozit" |
... depozit primljen (pozitivan!). Proračun: Pozicija 0: 2,979.90 Ukupno pozicija: 2,979.90 Isplate: 1,779.90 (gotovina) Uplate: 1,200.00 (Depozit) Ukupna uplata: 2.979,90 |
| Isplate.StopaPDV-a | Ako se u relevantnoj zemlji PDV već mora prikazati ili uplatiti prilikom prijema avansa ili depozita, PDV koji je već prijavljen također se mora odgovarajuće navesti u objektu Plaćanja! | |
| Uplate.PorezniIznos | Ako se u relevantnoj zemlji PDV već mora prikazati ili platiti prilikom prijema avansa ili depozita, PDV koji je već prijavljen također se mora odgovarajuće navesti u objektu Plaćanja! |
Primjer:
{
"ModelVersion": "1.7.0",
"UniqueClientId": "3e2c0cdf-e72c-43ea-a050-686eb0eb3853",
"UniqueCashRegisterId": null,
"ApplicationVersion": "1.0.0",
"ApplicationVersionId": null,
"ApplicationVersionPrevious": null,
"FiscalModuleVersion": "1.11.0.0",
"FiscalCountryModuleVersion": null,
"SoftwareName": "RetailForce neverPOS",
"RetailForceReceiptId": null,
"AdditionalFields": {},
"AutomaticVatCalculation": 0,
"AllowedVatDeviation": 0.01,
"PrintCount": null,
"TerminalSlaveId": null,
"FooterGraphicIndex": null,
"DocumentGuid": "026f0809-88b8-48c2-9e96-6f3ba37f48ff",
"DocumentId": "0026",
"CreateDate": "2026-06-10T14:39:08+02:00",
"BookDate": "2026-06-10T14:39:08+02:00",
"AccountingDate": "2026-06-10T14:39:08+02:00",
"DocumentNumber": "202500026",
"DocumentNumberSeries": "SI",
"CancellationDocument": false,
"FailedToPay": false,
"DocumentReference": null,
"IsTraining": false,
"TestCaseNumber": null,
"DocumentType": 0,
"DocumentTypeCaption": "POS-Receipt",
"User": {
"Id": "1",
"Caption": "User01",
"FirstName": "Joe",
"LastName": "Dowe",
"TaxNumber": null,
"DateOfEntry": "2025-09-23T15:11:08.6041978+02:00"
},
"SalesPerson": null,
"AllocationGroups": [],
"CustomerCount": null,
"Partner": null,
"Notes": null,
"PaymentTerms": null,
"ServicePeriodStart": null,
"ServicePeriodEnd": null,
"PositionCount": 1,
"DocumentIssueType": null,
"Coupon": null,
"ServiceType": null,
"IsEcommerceTransaction": null,
"TaxPositions": null,
"FiscalDocumentNumber": 0,
"FiscalDocumentRevision": 0,
"FiscalDocumentStartTime": 0,
"Positions": [
{
"PositionNumber": 0,
"ItemCaption": "RENOXA KnowPal 15.6 Untel Lore Ultra- Z9 399J 32GB RAM 512GB SSD RTX 3060 W11P",
"ItemShortCaption": "RENOXA KnowPal",
"ItemSerialNumber": null,
"Type": 0,
"Quantity": 2.0,
"QuantityUnit": {
"Id": "STK"
},
"ItemType": 0,
"ItemId": "RKP156UZ9",
"ItemTaxType": 0,
"InHouse": true,
"ItemGroupId": "1000",
"ItemGroupCaption": "Notebooks",
"BusinessTransactionType": 0,
"CostPrice": 2979.90,
"BaseNetValue": 2483.25,
"BaseGrossValue": 2979.90,
"BaseTaxValue": 496.65,
"Discounts": [],
"VatIdentification": 1,
"VatPercent": 20.0,
"NetValue": 2483.25,
"GrossValue": 2979.90,
"TaxValue": 496.65,
"AdditionalFields": {},
"ExternalIdentifier": []
}
],
"Payments": [
{
"Amount": 1779.90,
"CurrencyIsoCode": "EUR",
"Caption": "Bar",
"UniqueReadablePaymentIdentifier": "Cash",
"ForeignAmount": 0,
"ForeignAmountExchangeRate": 0,
"AdditionalFields": {},
"PaymentType": 0,
"CreateDate": null,
"VatIdentification": null,
"VatPercent": null,
"VatPercent2": null,
"TaxValue": null,
"TaxValue2": null,
"ExternalIdentifier": [],
"User": null,
"SalesPerson": null,
"PaymentTerminalReferenceId": null,
"CardData": null
},
{
"Amount": 1200.00,
"CurrencyIsoCode": "EUR",
"Caption": "Anzahlung",
"UniqueReadablePaymentIdentifier": "Deposit",
"ForeignAmount": 0,
"ForeignAmountExchangeRate": 0,
"AdditionalFields": {},
"PaymentType": 6,
"CreateDate": null,
"VatIdentification": 1,
"VatPercent": 20.0,
"VatPercent2": null,
"TaxValue": 200.00,
"TaxValue2": null,
"ExternalIdentifier": [],
"User": null,
"SalesPerson": null,
"PaymentTerminalReferenceId": null,
"CardData": null
}
],
"AdditionalHeader": [],
"AdditionalFooter": [],
"FiscalAdditionalFields": {}
}
Ovaj članak je automatski preveden.
Comments
0 comments
Please sign in to leave a comment.