Ugrás a fő tartalomhoz

Árukra fizetett előleg és az előlegek kezelése

Harald Krondorfer
  • Frissítve

Az alábbi JSON-példák bemutatják, hogyan kezelhető a RetailForce rendszerben az előleg beérkezése, valamint az előleg szállítás vagy szolgáltatásnyújtás utáni feldolgozása. Felhívjuk figyelmét, hogy a RetailForce rendszerben az előlegek/előzetes befizetések megnevezése „deposit”.

Felhívjuk figyelmét, hogy a példákban szereplő bizonyos tulajdonságértékeket módosítania kell ahhoz, hogy a payloadot a saját rendszerében is felhasználhassa (pl. „uniqueClientId”, „BookDate”). A példák egy adott országra vonatkoznak, ami azt jelenti, hogy az adókulcsokat, a bruttó és nettó összegeket stb. is módosítani kell.

Felhasználói release verziója: 1.11.16.2546
DOM-verzió: 1.7.0

1. Beérkezett előleg/letét

Az első lépésben a beérkezett előlegre vonatkozó nyugta készül:

  • Az ügyfél 1 200 EUR-t fizet be készpénzben egy jövőbeli szállítás vagy szolgáltatás ellenértékeként.

Tranzakciós tulajdonságok

Az alábbi táblázat bemutatja, mely tulajdonságokat milyen értékekre kell beállítani az üzleti eset helyes leképezéséhez.

Jellemző Érték Leírás
DocumentType „0” illetve „[0] = Nyugta” készpénzbevételen keresztül kezelendő
Tételek típusa „3” vagy „[3] = Könyvelés” A beérkezett betétet „3” típusú tételként (könyvelési tétel) rögzítik.
Pozíciók.BusinessTransactionType „7” illetve „[7] = Betét” A használt konkrét üzleti tranzakciótípus (BusinessTransactionType) „7” (előleg).
Pozíciók.VatIdentification   Ha az adott országban az előleg vagy az előleg befizetésekor már fel kell tüntetni vagy meg kell fizetni az áfát, akkor meg kell adni a megfelelő áfa-kategória ID-jét, és az áfát ennek megfelelően ki kell számítani.
Payments.Type „0” illetve „Készpénz” Mivel ebben az esetben készpénzes fizetésről van szó, a fizetési módot is ennek megfelelően kell megadni.

Példa:

{
	"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. A végső fizetés rendezése

A szállítás vagy a szolgáltatásnyújtáskor (pl. amikor az ügyfél átveszi a megrendelt árut) az ügyfélnek ki kell egyenlítenie az áru teljes értékének fennmaradó részét:

  • Az áruk/szolgáltatások teljes értéke: 2 979,90 EUR
  • Figyelembe véve az 1 200 EUR előleget
  • Az ügyfél a fennmaradó összeget (1 779,90 EUR) szintén készpénzben fizeti ki

Az előleg kétféle módon szerepelhet a végszámlán:

1. lehetőség – Az előleg tételként

Ebben a változatban az előleget negatív tételként szerepeltetik a payload-ban (az eredeti payload-ban szereplő tétel ellentéte).

Tranzakciós tulajdonságok

Az alábbi táblázat bemutatja, mely tulajdonságokat milyen értékekre kell beállítani az üzleti eset helyes leképezéséhez.

Tulajdonság Érték Leírás
DocumentType „0” illetve „[0] = Nyugta” készpénzbevételen keresztül kezelendő
Tételek típusa „0” vagy „[0] = Tétel” A 0. tételpozícióhoz (az ügyfél által megrendelt tétel, amelyre előleget fizettek)
Pozíciók.BusinessTransactionType „0” illetve „[0] = Revenue” A 0. tételpozíció esetében (az ügyfél által megrendelt tétel, amelyre előleget fizettek)
Pozíciók.Típus „3” illetve „[3] = Foglalás” A beérkezett előleg feltüntetéséhez a „3” típusú 1. tételt (foglalási tétel) használjuk – az első példához hasonlóan. Azonban ennek a tételnek az értékei (GrossValue, NetValue stb.) negatívak (!)
Pozíciók.BusinessTransactionType „7” illetve „[7] = Előleg” Az 1. tételben használt konkrét üzleti tranzakciótípus (BusinessTransactionType) a „7” (előleg).
Pozíciók.VatIdentification   Az előleg kiegyenlítésekor a Vat-ot is figyelembe kell venni.
Payments.Type „0” illetve „Készpénz”

A „Payments” szakaszban csak a fennmaradó fizetési összeg jelenik meg készpénzben (Total Items = Total Payments).

Számítás:

0. tétel: 2 979,90

1. tétel: -1 200,00

Pozíciók összesen: 1 779,90

Kifizetések: 1 779,90 (készpénz)

Összes kifizetés: 1 779,90

Példa:

{
	"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. lehetőség – Befizetés fizetésként

Ebben a változatban a beérkezett betét fizetési tételként jelenik meg a payload-ban.

Tranzakciós tulajdonságok

Az alábbi táblázat bemutatja, mely tulajdonságokat milyen értékekre kell beállítani az üzleti eset helyes leképezéséhez.

Tulajdonság Érték Leírás
DocumentType „0” vagy „[0] = Nyugta” készpénzbevétel útján kezelendő
Tételek típusa „0” vagy „[0] = Tétel” A 0. tételhez (az ügyfél által megrendelt, amelyre előleget fizetett)
Pozíciók.BusinessTransactionType „0” vagy „[0] = Revenue” A 0. tételhez (az ügyfél által megrendelt tétel, amelyre előleget fizettek)
Fizetések.Típus „0” vagy „Készpénz” A „Fizetések” szakasz két tételt tartalmaz: 1. A készpénzben kifizetett fennmaradó összeg, és...
Fizetési típus „6” vagy „[6] = Előleg”

... a beérkezett betét (pozitív!).

Számítás:

0. pozíció: 2 979,90

Pozíciók összesen: 2 979,90

Kifizetések: 1 779,90 (készpénz)

Kifizetések: 1 200,00 (betét)

Összes kifizetés: 2 979,90
Kifizetések.VatPercent   Ha az adott országban az előleg vagy a letét beérkezésekor már fel kell tüntetni vagy meg kell fizetni a Vat-ot, akkor a már bevallott Vat-ot is ennek megfelelően meg kell adni a Kifizetések objektumban!
Kifizetések.TaxValue   Ha az adott országban az előleg vagy a letét beérkezésekor már fel kell tüntetni vagy meg kell fizetni a Vat-ot, akkor a már bevallott Vat-ot is ennek megfelelően meg kell adni a Kifizetések objektumban!

Példa:

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

 

Ezt a cikket automatikusan lefordították.

Kapcsolódó cikkek

Hozzászólások

0 hozzászólás

Hozzászólások írásához jelentkezzen be.

Szolgáltató: Zendesk