Følgende JSON-eksempler viser, hvordan modtagelsen af et forskud og den efterfølgende behandling af dette forskud ved levering eller levering af tjenesteydelser kan håndteres i RetailForce. Bemærk, at det udtryk, der bruges i RetailForce for forskud/forudbetalinger, er »deposit«.
Bemærk, at visse egenskabsværdier, der anvendes i eksemplerne, skal tilpasses, så du kan anvende payload'en i dit system (f.eks. "uniqueClientId", "BookDate"). Eksemplerne er desuden udarbejdet for et specifikt land, hvilket betyder, at skattesatser, brutto- og nettobeløb m.m. også skal tilpasses.
Ikke alle lande understøtter begge varianter: forretningstransaktionstype "7" (Deposit), som anvendes i trin 1 og i mulighed 1, understøttes ikke i Spanien og Kroatien. I Canada understøttes hverken forretningstransaktionstype "7" (Deposit) eller betalingstype "6" (Deposit). Hvilke typer et land understøtter, kan findes i landekarakteristikaene (fiscalCountryProperties).
| Brugerreleaseversion: | 1.11.16.2546 |
| DOM-version: | 1.7.0 |
1. Indbetaling/forskud modtaget
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 et depositum, 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 kontant betaling, 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 restbeløbet
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 kortlægge 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] = Forudbetaling" | 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 Posten 1: -1.200,00 Samlet for 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" 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) |
| Payments.Type | "0" henholdsvis "Kontant" | Afsnittet "Betalinger" omfatter to poster: 1. Den resterende saldo, der er betalt kontant, og... |
| Betalings.Type | "6" henholdsvis "[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.