Przejdź do głównej zawartości

Zaliczka na towary i sposób postępowania z zaliczkami

Harald Krondorfer
  • Zaktualizowano

Poniższe przykłady w formacie JSON pokazują, w jaki sposób w systemie RetailForce można obsłużyć otrzymanie zaliczki oraz późniejsze rozliczenie tej zaliczki po dostawie towaru lub wykonaniu usług. Należy pamiętać, że terminem używanym w systemie RetailForce w odniesieniu do zaliczek / przedpłat jest „deposit”.

Należy pamiętać, że niektóre wartości właściwości użyte w przykładach należy dostosować, aby można było wykorzystać payload w Państwa systemie (np. „uniqueClientId”, „BookDate”). Przykłady zostały również stworzone dla konkretnego kraju, co oznacza, że należy również dostosować stawki podatkowe, kwoty brutto i netto itp.

Release for users: 1.11.16.2546
Wersja DOM: 1.7.0

1. Otrzymanie zaliczki/wpłaty

W pierwszym etapie tworzone jest potwierdzenie otrzymania zaliczki:

  • Klient wpłaca gotówką kwotę 1 200 EUR z tytułu przyszłej dostawy lub usługi.

Właściwości transakcji

Poniższa tabela przedstawia, jakie właściwości należy ustawić na jakie wartości, aby poprawnie odzwierciedlić dany przypadek biznesowy.

Właściwość Wartość Opis
DocumentType „0” lub „[0] = Paragon” do rozliczenia poprzez wpływ gotówkowy
Typ pozycji „3” lub „[3] = Księgowanie” Otrzymana wpłata jest rejestrowana jako pozycja o typie „3” (pozycja księgowa).
Pozycje.BusinessTransactionType „7” lub „[7] = Depozyt” Konkretny typ transakcji biznesowej (BusinessTransactionType) to „7” (zaliczka).
Pozycje.VatIdentification   Jeżeli w danym kraju Vat musi zostać wykazany lub zapłacony już w momencie otrzymania zaliczki lub depozytu, należy podać prawidłowy ID kategorii Vat i odpowiednio obliczyć Vat.
Płatności.Typ „0” lub „Gotówka” Ponieważ w tym konkretnym przypadku mamy do czynienia z płatnością gotówkową, należy również odpowiednio określić metodę płatności.

Przykład:

{
	"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. Rozliczenie płatności końcowej

W momencie dostawy lub wykonania usług (np. gdy klient odbiera zamówiony towar) klient musi uregulować pozostałą kwotę pełnej wartości towaru:

  • Łączna wartość towarów/usług: 2 979,90 EUR
  • Biorąc pod uwagę zaliczkę w wysokości 1 200 EUR
  • Klient uiszcza również pozostałą kwotę (1 779,90 EUR) w gotówce

Kaucja może zostać uwzględniona w dokumencie końcowym na dwa różne sposoby:

Opcja 1 – Kaucja jako pozycja

W tym wariancie zaliczka jest uwzględniona w payload jako pozycja ujemna (odwrotność pozycji w pierwotnej treści payload).

Właściwości transakcji

Poniższa tabela przedstawia, jakie właściwości należy ustawić na jakie wartości, aby poprawnie odwzorować dany przypadek biznesowy.

Właściwość Wartość Opis
DocumentType „0” lub „[0] = Paragon” do rozliczenia za pomocą pokwitowania wpłaty gotówkowej
Typ pozycji „0” lub „[0] = pozycja” Dla pozycji towarowej nr 0 (towar zamówiony przez klienta, za który wpłacono zaliczkę)
BusinessTransactionType „0” lub „[0] = Revenue” Dla pozycji nr 0 (pozycja zamówiona przez klienta, za którą wpłacono zaliczkę)
Positions.Type „3” lub „[3] = Rezerwacja” W celu uwzględnienia otrzymanej zaliczki stosuje się pozycję nr 1 typu „3” (pozycja rezerwacyjna) – tak jak w pierwszym przykładzie. Jednak wartości (GrossValue, NetValue itp.) dla tej pozycji są ujemne (!)
Positions.BusinessTransactionType „7” lub „[7] = Zaliczka” Konkretny typ transakcji biznesowej (BusinessTransactionType) zastosowany w pozycji nr 1 to „7” (zaliczka).
Pozycje.VatIdentification   Przy rozliczaniu zaliczki należy również uwzględnić podatek Vat.
Płatności.Typ „0” lub „Gotówka”

W sekcji „Płatności” wykazana jest wyłącznie pozostała kwota płatności gotówkowej (Suma pozycji = Suma płatności).

Obliczenia:

Pozycja 0: 2 979,90

Pozycja 1: -1 200,00

Suma pozycji: 1 779,90

Płatności: 1 779,90 (gotówka)

Łączna kwota płatności: 1 779,90

Przykład:

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

 

Opcja 2 – Wpłata jako płatność

W tym wariancie otrzymana wpłata jest wykazana w payload jako pozycja płatności.

Właściwości transakcji

Poniższa tabela przedstawia, jakie właściwości należy ustawić na jakie wartości, aby poprawnie odwzorować dany przypadek biznesowy.

Właściwość Wartość Opis
DocumentType „0” lub „[0] = Paragon” do obsługi za pośrednictwem wpływu gotówkowego
Typ pozycji „0” lub „[0] = pozycja” Dla pozycji nr 0 (pozycja zamówiona przez klienta, za którą wpłacono zaliczkę)
BusinessTransactionType „0” lub „[0] = Revenue” Dla pozycji nr 0 (pozycja zamówiona przez klienta, za którą wpłacono zaliczkę)
Płatności.Typ „0” lub „Gotówka” Sekcja „Płatności” obejmuje dwie pozycje: 1. Pozostałą kwotę uregulowaną gotówką oraz...
Rodzaj płatności „6” lub „[6] = Zaliczka”

... otrzymana zaliczka (dodatnia!).

Obliczenia:

Pozycja 0: 2 979,90

Suma pozycji: 2 979,90

Płatności: 1 779,90 (gotówka)

Płatności: 1 200,00 (wpłata)

Łączna kwota płatności: 2 979,90
Płatności.VatPercent   Jeżeli w danym kraju Vat musi zostać wykazany lub zapłacony już w momencie otrzymania zaliczki lub depozytu, należy również odpowiednio określić już zadeklarowany Vat w obiekcie „Płatności”!
Płatności.TaxValue   Jeżeli w danym kraju Vat musi zostać wykazany lub zapłacony już w momencie otrzymania zaliczki lub depozytu, należy również odpowiednio określić już zadeklarowany Vat w obiekcie „Płatności”!

Przykład:

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

 

Ten artykuł został przetłumaczony automatycznie.

Powiązane artykuły

Komentarze

Komentarze: 0

Zaloguj się, aby dodać komentarz.

Oparte na technologii Zendesk