Følgende JSON-eksempler viser, hvordan modtagelsen af et forskud og den efterfølgende håndtering af dette forskud ved levering eller levering af tjenesteydelser kan håndteres i RetailForce. Bemærk venligst, at det udtryk, der anvendes i RetailForce for forskud/forudbetalinger, er »deposit«.
Bemærk, at visse egenskabsværdier, der anvendes i eksemplerne, skal tilpasses, så du kan anvende payloadet i dit system (f.eks. "uniqueClientId", "BookDate"). Eksemplerne er desuden udarbejdet for et bestemt land, hvilket betyder, at skattesatser, brutto- og nettobeløb m.m. også skal tilpasses.
| Brugerreleaseversion: | 1.11.16.2546 |
| DOM-version: | 1.7.0 |
1. Modtaget depositum/forskud
I det første trin oprettes en kvittering for den modtagne forskudsbetaling:
- Kunden indbetaler kontant 1.200 EUR til en fremtidig levering eller ydelse.
Transaktionsegenskaber
Tabellen nedenfor viser, hvilke egenskaber der skal indstilles til hvilke værdier for at afspejle forretningssagen korrekt.
| Egenskab | Værdi | Beskrivelse |
| DocumentType | "0" henholdsvis "[0] = Kvittering" | skal håndteres via kasseindtægt |
| Positions.Type | "3" henholdsvis "[3] = Bogføring" | En modtaget indbetaling registreres som en linjepost af typen "3" (bogføringspost). |
| Positions.BusinessTransactionType | "7" henholdsvis "[7] = Indbetaling" | Den specifikke BusinessTransactionType, der anvendes, er "7" (depositum). |
| Positions.VatIdentification | Hvis der i det pågældende land allerede skal angives eller betales Vat ved modtagelse af et forskud eller en forudbetaling, skal den korrekte Vat-ID angives, og Vat-beløbet beregnes i overensstemmelse hermed. | |
| Payments.Type | "0" henholdsvis "Kontant" | Da der i dette konkrete tilfælde er tale om en kontantbetaling, skal betalingsmetoden også angives i overensstemmelse hermed. |
Eksempel:
{
"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. Afregning af den endelige betaling
Ved levering eller levering af tjenesteydelser (f.eks. når kunden afhenter de varer, vedkommende har bestilt), skal kunden afregne det udestående beløb svarende til varernes fulde værdi:
- Samlet værdi af varerne/ydelserne: 2.979,90 EUR
- Under hensyntagen til depositummet på 1.200 EUR
- betaler kunden ligeledes restbeløbet (1.779,90 EUR) kontant
Depositummet kan medtages i det endelige dokument på to forskellige måder:
Mulighed 1 – Depositum som en post
I denne variant medtages forskuddet i payloaden som en negativ post (det modsatte af posten i den oprindelige payload).
Transaktionsegenskaber
Tabellen nedenfor viser, hvilke egenskaber der skal indstilles til hvilke værdier for at afspejle forretningssagen korrekt.
| Egenskab | Værdi | Beskrivelse |
| DocumentType | "0" henholdsvis "[0] = Kvittering" | skal håndteres via kasseindtægt |
| Positions.Type | "0" henholdsvis "[0] = Vare" | For vareposition 0 (den vare, som kunden har bestilt, og for hvilken der er betalt et depositum) |
| Positions.BusinessTransactionType | "0" henholdsvis "[0] = Revenue" | For vareposition 0 (den vare, som kunden har bestilt, og for hvilken der er betalt et depositum) |
| Positions.Type | "3" henholdsvis "[3] = Forudbestilling" | For at medtage det modtagne depositum anvendes post 1 af typen "3" (reservationspost) – som i det første eksempel. Værdierne (GrossValue, NetValue osv.) for denne post er dog negative (!) |
| Positions.BusinessTransactionType | "7" henholdsvis "[7] = Depositum" | Den specifikke forretningstransaktionstype (BusinessTransactionType), der anvendes i post 1, er "7" (depositum). |
| Positions.VatIdentification | Der skal også tages højde for Vat, når depositummet afregnes. | |
| Payments.Type | "0" henholdsvis "Kontant" |
I afsnittet "Payments" vises kun den resterende betaling i kontanter (Total Items = Total Payments). Beregning: Posten 0: 2.979,90 Position 1: -1.200,00 Samlede positioner: 1.779,90 Betalinger: 1.779,90 (kontant) Samlede betalinger: 1.779,90 |
Eksempel:
{
"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": {}
}
Mulighed 2 – Indbetaling som betaling
I denne variant vises den modtagne indbetaling som en betalingspost i payloaden.
Transaktionsegenskaber
Tabellen nedenfor viser, hvilke egenskaber der skal indstilles til hvilke værdier for at kortlægge forretningsscenariet korrekt.
| Egenskab | Værdi | Beskrivelse |
| DocumentType | "0" eller "[0] = Kvittering" | skal håndteres via kontantkvittering |
| Positions.Type | "0" eller "[0] = Vare" | For vareposition 0 (den vare, som kunden har bestilt, og for hvilken der er betalt et depositum) |
| Positions.BusinessTransactionType | "0" eller "[0] = Revenue" | For vareposition 0 (den vare, som kunden har bestilt, og for hvilken der er betalt et depositum) |
| Payments.Type | "0" eller "Kontant" | Afsnittet "Betalinger" indeholder to poster: 1. Den resterende saldo, der er betalt kontant, og... |
| Betalingsform | "6" eller "[6] = Depositum" |
... det modtagne depositum (positivt!). Beregning: Position 0: 2.979,90 Samlede positioner: 2.979,90 Betalinger: 1.779,90 (kontant) Indbetalinger: 1.200,00 (indskud) Samlede betalinger: 2.979,90 |
| Betalinger.VatPercent | Hvis Vat i det pågældende land allerede skal angives eller betales ved modtagelse af et forskud eller et depositum, skal den Vat, der allerede er angivet, også specificeres i overensstemmelse hermed i objektet "Betalinger"! | |
| Betalinger.TaxValue | Hvis Vat i det pågældende land allerede skal angives eller betales ved modtagelse af et forskud eller en depositum, skal den Vat, der allerede er angivet, også specificeres i overensstemmelse hermed i objektet "Betalinger"! |
Eksempel:
{
"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": {}
}
Denne artikel er oversat automatisk.
Kommentarer
0 kommentarer
Log ind for at kommentere.