Preskoči na glavno vsebino

Predplačilo za blago in obravnava predplačil

Harald Krondorfer
  • Posodobljen

Naslednji primeri v formatu JSON prikazujejo, kako se v sistemu RetailForce obravnava prejem predplačila in nadaljnja obdelava tega predplačila ob dostavi 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.

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žna postavka).
Pozicije.BusinessTransactionType »7« oziroma »[7] = polog« Uporabljena vrsta poslovne transakcije (BusinessTransactionType) je „7“ (polog).
Positions.VatIdentification   Č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 prvotni 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] = Artikl« Za postavko 0 (artikl, ki ga je naročil stranka in za katerega je bil plačan polog)
BusinessTransactionType »0« oziroma »[0] = Revenue« Za postavko 0 (izdelek, 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), ki se uporablja 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 postavke = Skupaj plačila).

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] = postavka« Za postavko 0 (artikl, ki ga je naročil stranka 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.

Sorodni sklopi

Komentar

0 komentarjev

Za dodajanje komentarja prosimo kliknite Vpis.

Založba Zendesk