Naslednji primeri v formatu JSON prikazujejo, kako se v sistemu RetailForce obravnava prejem predplačila in nadaljnja obdelava tega predplačila ob dobavi blaga ali opravljenih storitvah. Upoštevajte, da se v sistemu RetailForce za predplačila uporablja izraz »deposit«.
Upoštevajte, da je treba nekatere vrednosti lastnosti, uporabljene v primerih, prilagoditi, da boste lahko uporabili payload v svojem sistemu (npr. »uniqueClientId«, »BookDate«). Primeri so bili ustvarjeni tudi za določeno državo, kar pomeni, da je treba prilagoditi tudi davčne stopnje, bruto in neto zneske itd.
Vse države ne podpirajo obeh variant: vrsta poslovne transakcije »7« (polog), ki se uporablja v koraku 1 in v možnosti 1, ni podprta v Španiji in na Hrvaškem. V Kanadi nista podprti niti vrsta poslovne transakcije »7« (polog) niti vrsta plačila »6« (polog). Katere vrste poslovne transakcije država podpira, je mogoče najti v značilnostih države (fiscalCountryProperties).
| Release za uporabnike: | 1.11.16.2546 |
| Različica DOM: | 1.7.0 |
1. Prejeto polog/predplačilo
V prvem koraku se ustvari potrdilo o prejetem predplačilu:
- Stranka opravi gotovinski polog v višini 1.200 EUR za prihodnjo dobavo ali storitev.
Lastnosti transakcije
Spodnja tabela prikazuje, katere lastnosti je treba nastaviti na katere vrednosti, da se poslovni primer pravilno prikaže.
| Lastnost | Vrednost | Opis |
| DocumentType | »0« oziroma »[0] = Potrdilo« | obdelati prek blagajniškega prejemka |
| Vrsta postavk | »3« oziroma »[3] = Knjižba« | Prejeti polog se evidentira kot postavka tipa „3“ (knjižbena postavka). |
| Pozicije.BusinessTransactionType | »7« oziroma »[7] = polog« | Uporabljena vrsta poslovne transakcije (BusinessTransactionType) je „7“ (polog). |
| Položaji.VatIdentification za DDV | Če je v zadevni državi treba Vat prikazati ali plačati že ob prejemu predplačila ali pologa, je treba navesti pravilno ID kategorije Vat in ustrezno izračunati Vat. | |
| Payments.Type | »0« oziroma »Gotovina« | Ker gre v tem konkretnem primeru za gotovinsko plačilo, je treba ustrezno navesti tudi način plačila. |
Primer:
{
"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. Poravnava končnega plačila
Ob dostavi ali opravljenih storitvah (npr. ko stranka prevzame naročeno blago) mora stranka poravnati neporavnani znesek v višini celotne vrednosti blaga:
- Skupna vrednost blaga/storitev: 2.979,90 EUR
- Ob upoštevanju pologa v višini 1.200 EUR
- Stranka plača preostanek (1.779,90 EUR) prav tako v gotovini
Polog se lahko v končni dokument vključi na dva različna načina:
Možnost 1 – Polog kot postavka
V tej varianti je polog vključen v payload kot negativna postavka (nasprotno od postavke v izvirni payload).
Lastnosti transakcije
Spodnja tabela prikazuje, katere lastnosti je treba nastaviti na katere vrednosti, da se poslovni primer pravilno prikaže.
| Lastnost | Vrednost | Opis |
| DocumentType | »0« oziroma »[0] = Potrdilo« | obdelati prek blagajniškega prejemka |
| Vrsta postavk | »0« oziroma »[0] = Artikla« | Za postavko 0 (artikl, ki ga je naročil kupec in za katerega je bil plačan polog) |
| BusinessTransactionType | »0« oziroma »[0] = Revenue« | Za postavko 0 (artikl, ki ga je naročil stranka in za katerega je bil plačan polog) |
| Pozicije.Vrsta | »3« oziroma »[3] = Rezervacija« | Za vključitev prejetega pologa se uporabi postavka 1 tipa „3“ (postavka rezervacije) – kot v prvem primeru. Vendar so vrednosti (GrossValue, NetValue itd.) za to postavko negativne (!) |
| Positions.BusinessTransactionType | »7« oziroma »[7] = polog« | Konkretna vrsta poslovne transakcije (BusinessTransactionType), uporabljena v postavki 1, je „7“ (polog). |
| Postavke.VatIdentification za DDV | Pri poravnavi pologa je treba upoštevati tudi Vat. | |
| Payments.Type | »0« oziroma »Gotovina« |
V razdelku »Plačila« je prikazano le preostalo plačilo v gotovini (Skupaj postavk = Skupaj plačil). Izračun: Položaj 0: 2.979,90 Položaj 1: -1.200,00 Skupaj postavke: 1.779,90 Plačila: 1.779,90 (gotovina) Skupna plačila: 1.779,90 |
Primer:
{
"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": {}
}
Možnost 2 – Polog kot plačilo
V tej varianti se prejeti polog prikaže kot plačilna postavka v payloadu.
Lastnosti transakcije
Spodnja tabela prikazuje, katere lastnosti je treba nastaviti na katere vrednosti, da se poslovni primer pravilno preslika.
| Lastnost | Vrednost | Opis |
| DocumentType | »0« oziroma »[0] = Potrdilo« | obdelati prek blagajniškega prejemka |
| Vrsta postavk | »0« oziroma »[0] = Artikl« | Za postavko 0 (artikl, ki ga je naročil kupec in za katerega je bil plačan polog) |
| BusinessTransactionType | »0« oziroma »[0] = Revenue« | Za postavko 0 (artikl, ki ga je naročil stranka in za katerega je bil plačan polog) |
| Plačila.Vrsta | »0« oziroma »Gotovina« | Oddelek »Plačila« vključuje dve postavki: 1. Preostali znesek, plačan v gotovini, in... |
| Vrsta plačila | »6« oziroma »[6] = Polog« |
... prejeti polog (pozitiven!). Izračun: Položaj 0: 2.979,90 Skupni znesek: 2.979,90 Plačila: 1.779,90 (gotovina) Plačila: 1.200,00 (polog) Skupna plačila: 2.979,90 |
| Plačila.VatPercent | Če je v zadevni državi treba Vat prikazati ali plačati že ob prejemu predplačila ali pologa, je treba že prijavljeni Vat ustrezno navesti tudi v objektu »Plačila«! | |
| Plačila.TaxValue | Če je v zadevni državi treba Vat prikazati ali plačati že ob prejemu predplačila ali pologa, je treba že prijavljeni Vat ustrezno navesti tudi v objektu »Plačila«! |
Primer:
{
"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": {}
}
Ta članek je bil samodejno preveden.
Komentar
0 komentarjev
Za dodajanje komentarja prosimo kliknite Vpis.