Preskočiť na hlavný obsah

Záloha na tovar a spracovanie záloh

Harald Krondorfer
  • Aktualizované

Nasledujúce príklady v formáte JSON ukazujú, ako je možné v systéme RetailForce spracovať prijatie zálohy a jej následné zaúčtovanie po dodaní tovaru alebo poskytnutí služieb. Upozorňujeme, že v systéme RetailForce sa pre zálohy/preddavky používa termín „deposit“.

Upozorňujeme, že niektoré hodnoty vlastností použité v príkladoch je potrebné upraviť, aby ste mohli payload použiť vo vašom systéme (napr. „uniqueClientId“, „BookDate“). Príklady boli vytvorené pre konkrétnu krajinu, čo znamená, že je potrebné upraviť aj daňové sadzby, hrubé a čisté sumy atď.

Release pre používateľov: 1.11.16.2546
Verzia DOM: 1.7.0

1. Prijatá záloha

V prvom kroku sa vytvorí potvrdenie o prijatí zálohy:

  • Zákazník vloží hotovostnú zálohu vo výške 1 200 EUR na budúcu dodávku alebo službu.

Vlastnosti transakcie

V tabuľke nižšie je uvedené, ktoré vlastnosti musia byť nastavené na aké hodnoty, aby bolo možné správne zmapovať obchodný prípad.

Vlastnosť Hodnota Popis
DocumentType „0“ resp. „[0] = Potvrdenka“ spracovať prostredníctvom pokladničného dokladu
Typ položky „3“ resp. „[3] = Účtovanie“ Prijatá záloha sa zaúčtuje ako riadok typu „3“ (rezervačná položka).
Pozície.BusinessTransactionType „7“ resp. „[7] = Záloha“ Konkrétny typ obchodnej transakcie (BusinessTransactionType) je „7“ (záloha).
Pozície.VatIdentification   Ak sa v príslušnej krajine musí DPH uviesť alebo zaplatiť už pri prijatí zálohy alebo vkladu, je potrebné uviesť správne ID kategórie Vat a Vat vypočítať zodpovedajúcim spôsobom.
Payments.Type „0“ resp. „Hotovosť“ Keďže v tomto konkrétnom prípade ide o platbu v hotovosti, je potrebné zodpovedajúcim spôsobom špecifikovať aj spôsob platby.

Prí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. Vyrovnanie konečnej platby

Po dodaní tovaru alebo poskytnutí služieb (napr. keď si zákazník vyzdvihne objednaný tovar) musí zákazník uhradiť zostatok v plnej hodnote tovaru:

  • Celková hodnota tovaru/služieb: 2 979,90 EUR
  • Po zohľadnení zálohy vo výške 1 200 EUR
  • Zákazník uhradí zostatok (1 779,90 EUR) tiež v hotovosti

Záloha môže byť zahrnutá v záverečnom doklade dvoma rôznymi spôsobmi:

Možnosť 1 – Záloha ako položka

V tejto variante je záloha zahrnutá v payloade ako záporná položka (opak položky v pôvodnom payloade).

Vlastnosti transakcie

V tabuľke nižšie je uvedené, ktoré vlastnosti musia byť nastavené na aké hodnoty, aby bolo možné správne zmapovať obchodný prípad.

Vlastnosť Hodnota Popis
DocumentType „0“ resp. „[0] = Potvrdenka“ spracovať prostredníctvom pokladničného dokladu
Typ položky „0“ resp. „[0] = Položka“ Pre položku č. 0 (položka objednaná zákazníkom, za ktorú bola zaplatená záloha)
BusinessTransactionType „0“ resp. „[0] = Revenue“ Pre pozíciu položky 0 (položka objednaná zákazníkom, za ktorú bola zaplatená záloha)
Pozície.Typ „3“ resp. „[3] = Rezervácia“ Na zahrnutie prijatého zálohu sa používa položka 1 typu „3“ (rezervačná pozícia) – ako v prvom príklade. Hodnoty (GrossValue, NetValue atď.) pre túto pozíciu sú však záporné (!)
BusinessTransactionType položky „7“ resp. „[7] = Záloha“ Konkrétny typ obchodnej transakcie (BusinessTransactionType) použitý v položke 1 je „7“ (záloha).
Pozície.VatIdentification   Pri vyúčtovaní zálohy je potrebné zohľadniť aj Vat.
Payments.Type „0“ resp. „Hotovosť“

V časti „Platby“ sa v hotovosti zobrazuje len zostávajúca platba (Celkový počet položiek = Celková suma platieb).

Výpočet:

Položka 0: 2 979,90

Položka 1: -1 200,00

Celkové pozície: 1 779,90

Platby: 1 779,90 (v hotovosti)

Celkové platby: 1 779,90

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

 

Variant 2 – Vklad ako platba

V tejto variante sa prijatý vklad zobrazuje v payload ako platobná položka.

Vlastnosti transakcie

V tabuľke nižšie je uvedené, ktoré vlastnosti musia byť nastavené na aké hodnoty, aby bolo možné správne zmapovať obchodný prípad.

Vlastnosť Hodnota Popis
DocumentType „0“ resp. „[0] = Potvrdenka“ spracovať prostredníctvom pokladničného dokladu
Typ položky „0“ resp. „[0] = Položka“ Pre položku č. 0 (tovar objednaný zákazníkom, za ktorý bola zaplatená záloha)
BusinessTransactionType „0“ resp. „[0] = Revenue“ Pre pozíciu položky 0 (položka objednaná zákazníkom, za ktorú bola zaplatená záloha)
Platby.Typ „0“ resp. „Hotovosť“ Sekcia „Platby“ obsahuje dve položky: 1. Zostatok zaplatený v hotovosti a...
Typ platby „6“ resp. „[6] = Záloha“

... prijatá záloha (kladná!).

Výpočet:

Pozícia 0: 2 979,90

Celkové pozície: 2 979,90

Platby: 1 779,90 (v hotovosti)

Platby: 1 200,00 (vklad)

Celkové platby: 2 979,90
Platby.VatPercent   Ak sa v príslušnej krajine musí DPH uviesť alebo zaplatiť už pri prijatí zálohy alebo vkladu, musí sa už deklarovaná DPH zodpovedajúcim spôsobom uviesť aj v objekte „Platby“!
Platby.TaxValue   Ak sa v príslušnej krajine musí DPH uviesť alebo zaplatiť už pri prijatí zálohy alebo preddavku, musí sa DPH, ktorá už bola deklarovaná, zodpovedajúcim spôsobom uviesť aj v objekte „Platby“!

Prí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ánok bol preložený automaticky.

Podobné články

Príspevky

0 komentárov

Ak chcete napísať komentár, prihlásiť sa.

Využíva technológiu Zendesk