Pereiti prie pagrindinio turinio

Avansas už prekes ir avansų apskaita

Harald Krondorfer
  • Atnaujintas

Toliau pateikti JSON pavyzdžiai rodo, kaip „RetailForce“ sistemoje galima tvarkyti avanso gavimą ir tolesnį šio avanso apdorojimą pristatymo arba paslaugų teikimo metu. Atkreipkite dėmesį, kad „RetailForce“ sistemoje avansams / išankstiniams mokėjimams naudojamas terminas „deposit“.

Atkreipkite dėmesį, kad tam tikras pavyzdžiuose naudojamas savybių reikšmes reikia pakoreguoti, kad galėtumėte naudoti payload savo sistemoje (pvz., „uniqueClientId“, „BookDate“). Pavyzdžiai taip pat sukurti konkrečiai šaliai, o tai reiškia, kad mokesčių tarifus, bruto ir neto sumas ir pan. taip pat reikia pakoreguoti.

Vartotojo release versija: 1.11.16.2546
DOM versija: 1.7.0

1. Gautas užstatas/avansas

Pirmuoju žingsniu sukuriamas gauto avanso kvitas:

  • Klientas sumoka 1 200 EUR grynaisiais už būsimą prekių pristatymą ar paslaugą.

Sandorio savybės

Toliau pateiktoje lentelėje nurodyta, kokias savybes ir kokias reikšmes reikia nustatyti, kad verslo atvejis būtų teisingai atvaizduotas.

Savybė Vertė Aprašymas
DocumentType „0“ arba „[0] = Kvitą“ apdoroti per grynųjų pinigų kvitą
Pozicijų tipas „3“ arba „[3] = Įrašas“ Gautas indėlis įrašomas kaip „3“ tipo eilutė (rezervacijos pozicija).
Pozicijos.BusinessTransactionType „7“ arba „[7] = Avansas“ Naudojamas konkretus verslo sandorio tipas (BusinessTransactionType) yra „7“ (avansas).
Pozicijos.VatIdentification   Jei atitinkamoje šalyje Vat turi būti nurodytas arba sumokėtas gavus avansą ar užstatą, būtina nurodyti teisingą Vat kategorijos ID ir atitinkamai apskaičiuoti Vat.
Payments.Type „0“ arba „Grynieji“ Kadangi šiuo konkrečiu atveju mokėjimas atliekamas grynaisiais, atitinkamai turi būti nurodytas ir mokėjimo būdas.

Pavyzdys:

{
	"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. Galutinio mokėjimo atsiskaitymas

Pristatant prekes ar teikiant paslaugas (pvz., kai klientas pats atsiima užsakytas prekes), klientas privalo sumokėti likusią visos prekių vertės sumą:

  • Bendra prekių / paslaugų vertė: 2 979,90 EUR
  • Atsižvelgiant į 1 200 EUR užstatą
  • Klientas likusią sumą (1 779,90 EUR) taip pat sumoka grynaisiais

Užstatas į galutinį dokumentą gali būti įtrauktas dviem skirtingais būdais:

1 variantas – Avansas kaip atskira pozicija

Šiuo atveju avansas įtraukiamas į payload kaip neigiamas elementas (priešingas elementui pradiniame payload).

Sandorio savybės

Toliau pateiktoje lentelėje nurodyta, kokias savybes reikia nustatyti ir kokias reikšmes joms priskirti, kad verslo atvejis būtų teisingai atvaizduotas.

Savybė Vertė Aprašymas
DocumentType „0“ arba „[0] = Kvitą“ apdoroti per grynųjų pinigų kvitą
Pozicijų tipas „0“ arba „[0] = Prekė“ Prekės pozicijai 0 (kliento užsakyta prekė, už kurią sumokėtas avansas)
Pozicijos.BusinessTransactionType „0“ arba „[0] = Revenue“ Prekės pozicijai 0 (kliento užsakyta prekė, už kurią sumokėtas užstatas)
Pozicijos.Tipas „3“ atitinkamai „[3] = Rezervacija“ Norint įtraukti gautą avansą, naudojama 1 pozicija, kurios tipas yra „3“ (rezervacijos pozicija) – kaip ir pirmajame pavyzdyje. Tačiau šios pozicijos reikšmės (GrossValue, NetValue ir kt.) yra neigiamos (!)
Pozicijų.BusinessTransactionType „7“ arba „[7] = Avansas“ Konkretus verslo sandorio tipas (BusinessTransactionType), naudojamas 1-oje pozicijoje, yra „7“ (užstatas).
Pozicijos.VatIdentification   Atsiskaitant už avansą taip pat reikia atsižvelgti į Vat.
Payments.Type „0“ arba „Grynieji“

Skyriuje „Mokėjimai“ grynaisiais pinigais rodomas tik likęs mokėjimas (Bendras punktų skaičius = Bendras mokėjimų skaičius).

Skaičiavimas:

Pozicija 0: 2 979,90

Pozicija 1: -1 200,00

Pozicijų suma: 1 779,90

Mokėjimai: 1 779,90 (grynaisiais)

Iš viso mokėjimų: 1 779,90

Pavyzdys:

{
	"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 variantas – Įmoka kaip mokėjimas

Šiuo atveju gautas užstatas payload rodomas kaip mokėjimo eilutė.

Sandorio savybės

Toliau pateiktoje lentelėje nurodyta, kokias savybes ir kokias reikšmes reikia nustatyti, kad verslo atvejis būtų teisingai atvaizduotas.

Savybė Vertė Aprašymas
DocumentType „0“ arba „[0] = Kvitą“ apdoroti per grynųjų pinigų kvitą
Pozicijų tipas „0“ arba „[0] = Prekė“ Prekės pozicijai 0 (kliento užsakyta prekė, už kurią sumokėtas avansas)
Pozicijų.BusinessTransactionType „0“ arba „[0] = Revenue“ Prekės pozicijai 0 (kliento užsakyta prekė, už kurią sumokėtas užstatas)
Mokėjimai.Tipas „0“ arba „Grynieji“ Skyriuje „Mokėjimai“ yra dvi pozicijos: 1. Likusi suma, sumokėta grynaisiais, ir...
Mokėjimų tipas „6“ arba „[6] = Avansas“

... gautas užstatas (teigiamas!).

Apskaičiavimas:

Pozicija 0: 2 979,90

Bendros pozicijos: 2 979,90

Mokėjimai: 1 779,90 (grynaisiais)

Mokėjimai: 1 200,00 (indėlis)

Iš viso mokėjimų: 2 979,90
Mokėjimai.VatPercent   Jei atitinkamoje šalyje Vat turi būti nurodytas arba sumokėtas gavus avansą ar užstatą, jau deklaruotas Vat taip pat turi būti atitinkamai nurodytas objekte „Mokėjimai“!
Mokėjimai.TaxValue   Jei atitinkamoje šalyje Vat turi būti nurodytas arba sumokėtas jau gavus avansinį mokėjimą ar užstatą, jau deklaruotas Vat taip pat turi būti atitinkamai nurodytas objekte „Mokėjimai“!

Pavyzdys:

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

 

Šis straipsnis buvo išverstas automatiškai.

Susiję straipsniai

Komentarai

0 komentarų

Tam, kad paliktumėte komentarus prisijunkite

Powered by Zendesk