Přeskočit do hlavního obsahu

Záloha na zboží a zacházení se zálohami

Harald Krondorfer
  • Aktualizováno

Následující příklady ve formátu JSON ukazují, jak lze v systému RetailForce zpracovat přijetí zálohy a následné zpracování této zálohy při dodání zboží nebo poskytnutí služeb. Upozorňujeme, že termín používaný v systému RetailForce pro zálohy / předplatby je „deposit“.

Upozorňujeme, že některé hodnoty vlastností použité v příkladech je nutné upravit, abyste mohli datovou náplň použít ve svém systému (např. „UniqueClientId“, „BookDate“). Příklady byly rovněž vytvořeny pro konkrétní zemi, což znamená, že je nutné upravit také daňové sazby, hrubé a čisté částky atd.

Verze pro uživatele: 1.11.16.2546
Verze DOM: 1.7.0

1. Přijetí zálohy

V prvním kroku se vytvoří potvrzení o přijaté záloze:

  • Zákazník provede hotovostní vklad ve výši 1 200 EUR za budoucí dodávku nebo službu.

Vlastnosti transakce

Níže uvedená tabulka ukazuje, které vlastnosti je třeba nastavit na jaké hodnoty, aby byl obchodní případ správně zmapován.

Vlastnost Hodnota Popis
DocumentType „0“ resp. „[0] = Příjmový doklad“ zpracovat prostřednictvím hotovostního příjmu
Typ položky „3“ resp. „[3] = Účtování“ Přijatá záloha se zaúčtuje jako položka typu „3“ (rezervační položka).
Položky.Typ obchodní transakce „7“ resp. „[7] = Záloha“ Konkrétní použitý typ obchodní transakce (BusinessTransactionType) je „7“ (záloha).
Pozice.IdentifikaceDPH   Pokud v dané zemi musí být Vat uvedena nebo zaplacena již při přijetí zálohy nebo vkladu, je nutné zadat správné ID kategorie Vat a Vat odpovídajícím způsobem vypočítat.
Payments.Type „0“ resp. „Hotovost“ Jelikož se v tomto konkrétním případě jedná o platbu v hotovosti, je třeba odpovídajícím způsobem zadat i způsob platby.

Příklad:

{
	"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. Úhrada konečné platby

Při dodání zboží nebo poskytnutí služeb (např. když si zákazník vyzvedne objednané zboží) musí zákazník uhradit zbývající částku v plné hodnotě zboží:

  • Celková hodnota zboží/služeb: 2 979,90 EUR
  • S přihlédnutím k záloze ve výši 1 200 EUR
  • Zákazník uhradí zbývající částku (1 779,90 EUR) rovněž v hotovosti

Záloha může být v konečném dokladu uvedena dvěma různými způsoby:

Varianta 1 – Záloha jako položka

V této variantě je záloha zahrnuta do datové části jako záporná položka (opačná k položce v původní datové části).

Vlastnosti transakce

Níže uvedená tabulka ukazuje, které vlastnosti musí být nastaveny na jaké hodnoty, aby bylo možné správně zmapovat daný obchodní případ.

Vlastnost Hodnota Popis
DocumentType „0“ resp. „[0] = Příjmový doklad“ zpracovat prostřednictvím hotovostního příjmu
Typ položky „0“ resp. „[0] = Položka“ Pro položku č. 0 (položka objednaná zákazníkem, za kterou byla zaplacena záloha)
Typ obchodní transakce „0“ resp. „[0] = Tržba“ Pro pozici položky 0 (položka objednaná zákazníkem, za kterou byla zaplacena záloha)
Pozice.Typ „3“ resp. „[3] = Rezervace“ K zahrnutí přijaté zálohy se použije položka 1 typu „3“ (rezervační položka) – stejně jako v prvním příkladu. Hodnoty (GrossValue, NetValue atd.) pro tuto položku jsou však záporné (!)
Positions.BusinessTransactionType „7“ resp. „[7] = Záloha“ Konkrétní typ obchodní transakce (BusinessTransactionType) použitý v položce 1 je „7“ (záloha).
Položky.IdentifikaceDPH   Při vypořádání zálohy je třeba zohlednit také Vat.
Payments.Type „0“ resp. „Hotovost“

V části „Payments“ je v hotovosti zobrazena pouze zbývající platba (Total Items = Total Payments).

Výpočet:

Položka 0: 2 979,90

Položka 1: -1 200,00

Celkem: 1 779,90

Platby: 1 779,90 (v hotovosti)

Celkové platby: 1 779,90

Příklad:

{
	"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": {}
}

 

Varianta 2 – Vklad jako platba

V této variantě se přijatý vklad zobrazuje v datové části jako platební položka.

Vlastnosti transakce

Níže uvedená tabulka ukazuje, které vlastnosti musí být nastaveny na jaké hodnoty, aby bylo možné správně zmapovat daný obchodní případ.

Vlastnost Hodnota Popis
Typ dokumentu „0“ resp. „[0] = Příjmový doklad“ zpracovat prostřednictvím hotovostní příjmové stvrzenky
Typ položky „0“ resp. „[0] = Položka“ Pro položku č. 0 (položka objednaná zákazníkem, za kterou byla zaplacena záloha)
Typ obchodní transakce „0“ resp. „[0] = Tržba“ Pro pozici položky 0 (položka objednaná zákazníkem, za kterou byla zaplacena záloha)
Payments.Type „0“ resp. „Hotovost“ Sekce „Platby“ obsahuje dvě položky: 1. Zbývající částka zaplacená v hotovosti a...
Typ platby „6“ resp. „[6] = Záloha“

... přijatá záloha (kladná!).

Výpočet:

Položka 0: 2 979,90

Celkové pozice: 2 979,90

Platby: 1 779,90 (hotovost)

Platby: 1 200,00 (vklad)

Celkové platby: 2 979,90
Payments.VatPercent   Pokud v dané zemi musí být Vat uvedena nebo zaplacena již při přijetí zálohy nebo vkladu, musí být již deklarovaná Vat odpovídajícím způsobem uvedena také v objektu „Platby“!
Platby.DaňováHodnota   Pokud v dané zemi musí být Vat uvedena nebo zaplacena již při přijetí zálohy nebo vkladu, musí být již deklarovaná Vat odpovídajícím způsobem uvedena také v objektu „Platby“!

Příklad:

{
	"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": {}
}

 

Tento článek byl přeložen automaticky.

Související články

Komentáře

0 komentářů

Prosím přihlaste se, abyste mohli napsat komentář.

Používá technologie Zendesk