Прескачане към основното съдържание

Авансово плащане за стоки и обработка на авансовите плащания

Harald Krondorfer
  • Обновено

Следващите примери в JSON показват как в RetailForce може да се обработи получаването на авансово плащане и последващото му отчитане при доставка или предоставяне на услуги. Моля, имайте предвид, че терминът, използван в RetailForce за авансови плащания, е „депозит“.

Моля, имайте предвид, че някои стойности на свойствата, използвани в примерите, трябва да бъдат коригирани, за да можете да използвате payload във вашата система (например „uniqueClientId“, „BookDate“). Примерите са създадени и за конкретна държава, което означава, че данъчните ставки, брутните и нетните суми и т.н. също трябва да бъдат коригирани.

Release for users: 1.11.16.2546
Версия на DOM: 1.7.0

1. Получен депозит/аванс

В първата стъпка се създава разписка за получената авансова вноска:

  • Клиентът внася в брой 1 200 EUR за бъдеща доставка или услуга.

Характеристики на транзакцията

Таблицата по-долу показва кои характеристики трябва да бъдат зададени на кои стойности, за да се отрази правилно бизнес случаят.

Характеристика Стойност Описание
DocumentType „0“ съответно „[0] = Квитанция“ да се обработва чрез касова разписка
Тип позиции „3“ съответно „[3] = Запис“ Получен депозит се записва като позиция от тип „3“ (позиция за резервация).
Позиции.BusinessTransactionType „7“ съответно „[7] = Депозит“ Конкретният тип бизнес транзакция (BusinessTransactionType), който се използва, е „7“ (депозит).
Позиции.VatIdentification по ДДС   Ако в съответната държава Vat трябва да бъде посочен или платен още при получаване на авансово плащане или депозит, трябва да се посочи правилният ID на категорията по Vat и Vat да се изчисли съответно.
Payments.Type „0“ съответно „В брой“ Тъй като в този конкретен случай става въпрос за плащане в брой, начинът на плащане също трябва да бъде посочен съответно.

Пример:

{
	"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. Уреждане на окончателното плащане

При доставка или предоставяне на услуги (например когато клиентът вземе поръчаните стоки), клиентът трябва да уреди остатъка от пълната стойност на стоките:

  • Обща стойност на стоките/услугите: 2 979,90 EUR
  • Като се вземе предвид депозитът от 1 200 EUR
  • Клиентът заплаща остатъка (1 779,90 EUR) също в брой

Депозитът може да бъде включен в окончателния документ по два различни начина:

Вариант 1 – Депозит като позиция

При този вариант авансовото плащане се включва в payload-а като отрицателна позиция (противоположна на позицията в първоначалния payload).

Свойства на транзакцията

Таблицата по-долу показва кои свойства трябва да бъдат зададени на кои стойности, за да се отрази правилно бизнес случаят.

Свойство Стойност Описание
DocumentType „0“ съответно „[0] = Квитанция“ да се обработва чрез касова разписка
Тип позиции „0“ съответно „[0] = Артикул“ За позиция 0 (артикулът, поръчан от клиента, за който е платен депозит)
Позиции.BusinessTransactionType „0“ съответно „[0] = Revenue“ За позиция 0 (артикулът, поръчан от клиента, за който е платен депозит)
Позиции.Тип „3“ съответно „[3] = Резервация“ За да се включи полученият депозит, се използва позиция 1 от тип „3“ (позиция за резервация) – както в първия пример. Стойностите (GrossValue, NetValue и др.) за тази позиция обаче са отрицателни (!)
Тип на позицията: BusinessTransactionType „7“ съответно „[7] = Депозит“ Конкретният тип бизнес транзакция (BusinessTransactionType), използван в позиция 1, е „7“ (депозит).
Позиции.VatIdentification по ДДС   Vat също трябва да се вземе предвид при уреждането на депозита.
Payments.Type „0“ съответно „В брой“

В раздела „Плащания“ се показва само остатъчното плащане в брой (Общо позиции = Общо плащания).

Изчисление:

Позиция 0: 2 979,90

Позиция 1: -1 200,00

Общо позиции: 1 779,90

Плащания: 1 779,90 (в брой)

Общо плащания: 1 779,90

Пример:

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

 

Вариант 2 – Депозит като плащане

При този вариант полученият депозит се показва като платежна позиция в payload-а.

Свойства на транзакцията

Таблицата по-долу показва кои свойства трябва да бъдат зададени на кои стойности, за да се отрази правилно бизнес случаят.

Свойство Стойност Описание
DocumentType „0“ или „[0] = Квитанция“ за обработка чрез касова разписка
Тип позиция „0“ или „[0] = Артикул“ За позиция 0 (артикулът, поръчан от клиента, за който е платен аванс)
BusinessTransactionType „0“ или „[0] = Revenue“ За позиция 0 (артикулът, поръчан от клиента, за който е платен депозит)
Плащания.Тип „0“ или „В брой“ Разделът „Плащания“ включва две позиции: 1. Остатъкът, платен в брой, и...
Тип плащане „6“ или „[6] = Депозит“

... полученият депозит (положителен!).

Изчисление:

Позиция 0: 2 979,90

Общо позиции: 2 979,90

Плащания: 1 779,90 (в брой)

Плащания: 1 200,00 (депозит)

Общо плащания: 2 979,90
Плащания.VatPercent   Ако в съответната държава Vat трябва да бъде посочен или платен още при получаване на авансово плащане или депозит, вече декларираният Vat също трябва да бъде посочен съответно в обекта „Плащания“!
Плащания.TaxValue   Ако в съответната държава Vat трябва да бъде посочен или платен още при получаване на авансово плащане или депозит, вече декларираният Vat също трябва да бъде посочен съответно в обекта „Плащания“!

Пример:

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

 

Тази статия е преведена автоматично.

Подобни статии

Коментари

0 коментара

Влезте в услугата, за да оставите коментар.

Powered by Zendesk