Sljedeći JSON primjeri pokazuju kako se u RetailForceu može obraditi primitak pologa i naknadno obračunavanje tog pologa prilikom isporuke ili pružanja usluga. Imajte na umu da se u RetailForceu za pologe / preduplate koristi pojam 'deposit'.
Imajte na umu da se određene vrijednosti svojstava korištene u primjerima moraju prilagoditi kako biste mogli koristiti teret u svom sustavu (npr. "UniqueClientId", "BookDate"). Primjeri su također izrađeni za određenu zemlju, što znači da se i porezne stope, bruto i neto iznosi itd. moraju prilagoditi.
| Verzija za korisnika: | 1.11.16.2546 |
| DOM-verzija: | 1.7.0 |
1. Primljeni depozit/akontacija
U prvom koraku stvara se potvrda o primljenoj predujamtini:
- Kupac uplati gotovinski polog od 1.200 EUR za buduću isporuku ili uslugu.
Svojstva transakcije
Tablica u nastavku prikazuje koje atribute treba postaviti na koje vrijednosti kako bi se poslovni slučaj ispravno mapirao.
| Svojstvo | Vrijednost | Opis |
| Tip dokumenta | "0" odnosno "[0] = Potvrda o uplati" | za podmirenje gotovinskim računom |
| Tip položaja | "3" odnosno "[3] = Rezervacija" | Primljeni polog evidentira se kao stavka vrste "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 primitka preduplate 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. Podmirenje konačne uplate
Prilikom isporuke ili pružanja usluga (npr. kada kupac preuzima naručene proizvode), kupac mora podmiriti preostali iznos u punoj vrijednosti proizvoda:
- Ukupna vrijednost robe/usluga: 2.979,90 EUR
- Uzimajući u obzir polog od 1.200 EUR
- Kupac plaća preostali iznos (1.779,90 EUR) i u gotovini
Pojam "depozit" može se uključiti u konačni dokument na dva različita načina:
Opcija 1 – depozit kao stavka
U ovoj varijanti polog se uključuje u konačni iznos kao negativna stavka (suprotno od stavke u izvornom iznosu).
Svojstva transakcije
Tablica u nastavku prikazuje koje se svojstva moraju postaviti na koje vrijednosti kako bi se poslovni slučaj ispravno mapirao.
| Svojstvo | Vrijednost | Opis |
| Tip dokumenta | "0" odnosno "[0] = Potvrda o uplati" | za podmirenje gotovinskim računom |
| Tip položaja | "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 stavke 0 (stavka koju je naručio kupac za koju je uplaćena polog) |
| Positions.Type | "3" odnosno "[3] = Rezervacija" | Za uključivanje primljenog depozita koristi se stavka 1 tipa "3" (rezervacijska stavka) – kao u prvom primjeru. Međutim, vrijednosti (GrossValue, NetValue itd.) za ovu stavku su negativne (!) |
| Positions.BusinessTransactionType | "7" odnosno "[7] = Avans" | Specifična vrsta poslovne transakcije (BusinessTransactionType) koja se koristi u stavci 1 je "7" (depozit). |
| Positions.VatIdentification | PDV se također mora uzeti u obzir prilikom namire depozita. | |
| Payments.Type | "0" odnosno "Gotovina" |
U odjeljku "Isplate" prikazana je samo preostala isplata u gotovini (Ukupno stavki = Ukupno isplata). Proračun: Stavka 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 prikazuje se kao stavka plaćanja u teretu.
Svojstva transakcije
Tablica u nastavku prikazuje koje svojstvo treba postaviti na koje vrijednosti kako bi se ispravno mapirao poslovni slučaj.
| Svojstvo | Vrijednost | Opis |
| Tip dokumenta | "0" odnosno "[0] = Potvrda" | za podmirenje gotovinskim računom |
| Tip stavke | "0" odnosno "[0] = stavka" | Za stavku pozicije 0 (artikl koji je naručio kupac za koji je uplaćena avansna uplata) |
| Positions.BusinessTransactionType | "0" odnosno "[0] = Prihod" | Za stavku 0 (artikal koji je naručio kupac za koji je uplaćena polog) |
| 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 isplata: 2.979,90 |
| Isplate.StopaPDV-a | Ako se u relevantnoj zemlji PDV već mora prikazati ili uplatiti prilikom primitka preduplate 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 primitka predujma 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 je članak automatski preveden.
Komentari
0 komentara
Molimo Prijavite se kako bi ostavili komentar.