Salt la conținutul principal

Avans pentru bunuri și tratarea avansurilor

Harald Krondorfer
  • Actualizat

Următoarele exemple JSON ilustrează modul în care se poate gestiona în RetailForce primirea unui avans și tratarea ulterioară a acestuia la livrarea mărfurilor sau la prestarea serviciilor. Vă rugăm să rețineți că termenul utilizat în RetailForce pentru avansuri/plăți anticipate este „depozit”.

Vă rugăm să rețineți că anumite valori ale proprietăților utilizate în exemple trebuie ajustate pentru a putea utiliza payload-ul în sistemul dumneavoastră (de exemplu, „uniqueClientId”, „BookDate”). Exemplele au fost, de asemenea, create pentru o țară specifică, ceea ce înseamnă că ratele de impozitare, sumele brute și nete etc. trebuie, de asemenea, ajustate.

Release pentru utilizatori: 1.11.16.2546
Versiune DOM: 1.7.0

1. Primirea avansului/plății inițiale

În primul pas se creează o chitanță pentru avansul primit:

  • Clientul efectuează o depunere în numerar de 1.200 EUR pentru o livrare sau un serviciu viitor.

Proprietățile tranzacției

Tabelul de mai jos arată ce proprietăți trebuie setate la ce valori pentru a reflecta corect cazul de afaceri.

Proprietate Valoare Descriere
DocumentType „0” resp. „[0] = Chitanță” de procesat prin intermediul chitanței de încasare
Tip de poziție „3” sau „[3] = Înregistrare” Un depozit primit este înregistrat ca o poziție de tip „3” (poziție de înregistrare).
Poziții.BusinessTransactionType „7” sau „[7] = Depozit” Tipul specific de tranzacție comercială (BusinessTransactionType) utilizat este „7” (avans).
Poziții.VatIdentification   Dacă, în țara respectivă, Vat-ul trebuie deja indicat sau plătit la primirea unei plăți în avans sau a unui avans, trebuie specificat ID-ul corect al categoriei de Vat, iar Vat-ul trebuie calculat în consecință.
Payments.Type „0” sau „Numerar” Deoarece acest caz particular implică o plată în numerar, trebuie specificată și metoda de plată corespunzătoare.

Exemplu:

{
	"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. Achitarea plății finale

La livrarea sau prestarea serviciilor (de exemplu, atunci când clientul ridică bunurile comandate), clientul trebuie să achite soldul restant din valoarea totală a bunurilor:

  • Valoarea totală a mărfurilor/serviciilor: 2.979,90 EUR
  • Ținând cont de avansul de 1.200 EUR
  • Clientul plătește și soldul (1.779,90 EUR) în numerar

Avansul poate fi inclus în documentul final în două moduri diferite:

Opțiunea 1 – Avansul ca element de factură

În această variantă, avansul este inclus în payload ca element negativ (opusul elementului din payload-ul inițial).

Proprietățile tranzacției

Tabelul de mai jos arată ce proprietăți trebuie setate la ce valori pentru a mapa corect cazul de afaceri.

Proprietate Valoare Descriere
DocumentType „0” resp. „[0] = Chitanță” de procesat prin intermediul chitanței de încasare
Tip de poziție „0” sau „[0] = Articol” Pentru poziția de articol 0 (articolul comandat de client pentru care s-a plătit un avans)
Tipuri de BusinessTransactionType „0” sau „[0] = Revenue” Pentru poziția 0 a articolului (articolul comandat de client pentru care s-a plătit un avans)
Poziții.Tip „3” resp. „[3] = Rezervare” Pentru a include avansul primit, se utilizează poziția 1 de tip „3” (poziție de rezervare) – ca în primul exemplu. Cu toate acestea, valorile (GrossValue, NetValue etc.) pentru această poziție sunt negative (!)
Tipuri de poziții.BusinessTransactionType „7” resp. „[7] = Avans” Tipul specific de tranzacție comercială (BusinessTransactionType) utilizat în poziția 1 este „7” (avans).
Poziții.VatIdentification   Vat-ul trebuie, de asemenea, luat în considerare la decontarea avansului.
Payments.Type „0” sau „Numerar”

În secțiunea „Plăți”, doar plata rămasă este afișată în numerar (Total articole = Total plăți).

Calcul:

Poziția 0: 2.979,90

Poziția 1: -1.200,00

Total poziții: 1.779,90

Plăți: 1.779,90 (în numerar)

Total plăți: 1.779,90

Exemplu:

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

 

Opțiunea 2 – Depozit ca plată

În această variantă, depozitul primit este afișat ca element de plată în payload.

Proprietățile tranzacției

Tabelul de mai jos arată ce proprietăți trebuie setate la ce valori pentru a mapa corect cazul de afaceri.

Proprietate Valoare Descriere
DocumentType „0” sau „[0] = Chitanță” de gestionat prin intermediul chitanței de încasare
Tip de poziție „0” sau „[0] = Articol” Pentru poziția de articol 0 (articolul comandat de client pentru care s-a plătit un avans)
Tipuri de BusinessTransactionType „0” sau „[0] = Revenue” Pentru poziția 0 a articolului (articolul comandat de client pentru care s-a plătit un avans)
Payments.Type „0” sau „Numerar” Secțiunea „Plăți” include două elemente: 1. Soldul rămas plătit în numerar și...
Tipul plății „6” sau „[6] = Avans”

... depozitul primit (pozitiv!).

Calcul:

Poziția 0: 2.979,90

Total poziții: 2.979,90

Plăți: 1.779,90 (numerar)

Plăți: 1.200,00 (Depozit)

Total plăți: 2.979,90
Plăți.VatPercent   Dacă, în țara respectivă, Vat-ul trebuie deja indicat sau plătit la primirea unei plăți în avans sau a unui depozit, Vat-ul care a fost deja declarat trebuie, de asemenea, specificat corespunzător în obiectul Plăți!
Plăți.TaxValue   Dacă, în țara respectivă, Vat-ul trebuie deja indicat sau plătit la primirea unei plăți în avans sau a unui avans, Vat-ul care a fost deja declarat trebuie, de asemenea, specificat corespunzător în obiectul „Plăți”!

Exemplu:

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

 

Acest articol a fost tradus automat.

Articole conexe

Comentarii

0 comentarii

Vă rugăm să vă autentificați pentru a lăsa un comentariu.

Susținut de Zendesk