Skip to main content

Аванс за робу и третман аванса

Harald Krondorfer
  • Updated

Следећи JSON примери показују како се у RetailForce-у може обрадити пријем аванса и накнадно поступање са тим авансом при испоруци или пружању услуга. Имајте у виду да се у RetailForce-у за авансе/претплате користи термин 'deposit'.

Имајте у виду да неке вредности својстава коришћене у примерима морају бити прилагођене како бисте могли да користите терет у свом систему (нпр. "UniqueClientId", "BookDate"). Примери су такође креирани за одређену земљу, што значи да пореске стопе, бруто и нето износи итд. такође морају бити прилагођени.

Верзија за корисника: 1.11.16.2546
DOM-верзија: 1.7.0

1. Примљен депозит/аванс

У првом кораку креира се потврда о пријему аванса:

  • Клијент уплаћује готовином 1.200 EUR за будућу испоруку или услугу.

Особине трансакције

Табела испод показује које особине треба подесити на које вредности како би се пословни случај исправно мапирао.

Особнина Вредност Опис
Тип документа "0" односно "[0] = потврда о уплати" за обраду путем готовинског пријема
Тип позиције "3" односно "[3] = Резервација" Примљени депозит се евидентира као ставка типа "3" (резервациона позиција).
Positions.BusinessTransactionType "7" односно "[7] = Депозит" Конкретан тип пословне трансакције (BusinessTransactionType) који се користи је "7" (депозит).
Positions.VatIdentification   Ако у одговарајућој земљи ПДВ већ мора бити приказан или уплаћен при пријему авансне уплате или депозита, мора се навести тачан ИД категорије ПДВ-а и ПДВ обрачунати у складу с тим.
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 – Депозит као ставка

У овој варијанти, аванс је укључен у коначну фактуру као негативна ставка (супротно од ставке у оригиналној коначној фактури).

Својства трансакције

Табела испод показује које особине треба подесити на које вредности како би се пословни случај исправно мапирао.

Својство Вредност Опис
Тип документа "0" односно "[0] = потврда о уплати" за обраду путем готовинског пријема
Тип позиција "0" односно "[0] = ставка" За позицију артикла 0 (артикла који је наручио купац и за који је уплаћен депозит)
Positions.BusinessTransactionType "0" односно "[0] = Приход" За позицију артикла 0 (артиکل који је наручио купац за који је уплаћена авансна уплата)
Positions.Type "3" односно "[3] = Резервација" За укључивање примљеног депозита користи се ставка 1 типа "3" (резервација) – као у првом примеру. Међутим, вредности (GrossValue, NetValue итд.) за ову ставку су негативне (!).
Positions.BusinessTransactionType "7" односно "[7] = Депозит" Конкретни тип пословне трансакције (BusinessTransactionType) који се користи у ставци 1 јесте "7" (депозит).
Positions.VatIdentification   ПДВ такође мора бити узета у обзир приликом поравнања депозита.
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 – Депозит као плаћање

У овој варијанти, депозит који је примљен приказан је као ставка плаћања у терету.

Својства трансакције

Табела испод показује које особине треба подесити на које вредности како би се пословни случај исправно мапирао.

Својство Вредност Опис
Тип документа "0" или "[0] = потврда о уплати" за обраду путем готовинског пријема
Тип позиције "0" односно "[0] = ставка" За позицију артикла 0 (артикла који је наручио купац и за који је уплаћена авансна уплата)
Positions.BusinessTransactionType "0" односно "[0] = Приход" За позицију артикла 0 (артиکل који је наручио купац за који је уплаћен депозит)
Payments.Type "0" односно "Готовином" Одељак "Плаћања" обухвата два ставка: 1. Преостали износ плаћен у готовини, и...
Тип уплата "6" или  "[6] = депозит"

... депозит примљен (позитиван!).

Рачунање:

Позиција 0: 2,979.90

Укупно позиција: 2,979.90

Плаћања: 1,779.90 (Готовина)

Уплате: 1.200,00 (Депозит)

Укупна уплата: 2,979.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": "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": {}
}

 

Овај чланак је аутоматски преведен.

Povezani članci

Komentari

Komentara: 0

Molimo prijavi se da biste komentarisali.

Powered by Zendesk