Följande JSON-exempel visar hur mottagandet av en handpenning och den efterföljande hanteringen av denna handpenning vid leverans eller tillhandahållande av tjänster kan hanteras i RetailForce. Observera att den term som används i RetailForce för handpenningar/förskottsbetalningar är ”deposit”.
Observera att vissa egenskapsvärden som används i exemplen måste justeras så att du kan använda payloaden i ditt system (t.ex. ”uniqueClientId”, ”BookDate”). Exemplen har dessutom skapats för ett specifikt land, vilket innebär att skattesatser, brutto- och nettobelopp m.m. också måste justeras.
| Användarrelease: | 1.11.16.2546 |
| DOM-version: | 1.7.0 |
1. Insättning/handpenning mottagen
I det första steget skapas ett kvitto för den mottagna handpenningen:
- Kunden gör en kontant insättning på 1 200 EUR för en framtida leverans eller tjänst.
Transaktionsegenskaper
Tabellen nedan visar vilka egenskaper som måste ställas in på vilka värden för att affärsfallet ska kunna avbildas korrekt.
| Egenskap | Värde | Beskrivning |
| DocumentType | "0" resp. "[0] = Kvitto" | ska hanteras via kontantkvitto |
| Positionstyp | "3" resp. "[3] = Bokning" | En mottagen insättning registreras som en post av typ "3" (bokningspost). |
| Positioner.BusinessTransactionType | "7" resp. "[7] = Insättning" | Den specifika affärstransaktionstypen (BusinessTransactionType) som används är "7" (handpenning). |
| Positions.VatIdentification | Om Vat i det aktuella landet redan måste redovisas eller betalas vid mottagandet av en förskottsbetalning eller handpenning, måste rätt Vat-ID anges och Vat-skatten beräknas därefter. | |
| Payments.Type | "0" resp. "Kontanter" | Eftersom det i detta specifika fall rör sig om en kontantbetalning måste även betalningssättet anges i enlighet därmed. |
Exempel:
{
"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. Reglering av slutbetalningen
Vid leverans eller tillhandahållande av tjänster (t.ex. när kunden hämtar de varor som denne har beställt) måste kunden reglera det utestående beloppet för varornas fulla värde:
- Totalt värde på varorna/tjänsterna: 2 979,90 EUR
- Med hänsyn till handpenningen på 1 200 EUR
- betalar kunden även resterande belopp (1 779,90 EUR) kontant
Depositionen kan inkluderas i slutdokumentet på två olika sätt:
Alternativ 1 – Handpenningen som en post
I detta fall inkluderas handpenningen i payloaden som en negativ post (motsatsen till posten i det ursprungliga payloadet).
Transaktionsegenskaper
Tabellen nedan visar vilka egenskaper som måste ställas in på vilka värden för att affärsfallet ska kunna mappas korrekt.
| Egenskap | Värde | Beskrivning |
| DocumentType | "0" resp. "[0] = Kvitto" | ska hanteras via kontantkvitto |
| Positionstyp | "0" resp. "[0] = Artikel" | För artikelposition 0 (den artikel som kunden har beställt och för vilken en handpenning har betalats) |
| Positions.BusinessTransactionType | "0" resp. "[0] = Revenue" | För artikelposition 0 (den artikel som kunden har beställt och för vilken en handpenning har betalats) |
| Positions.Type | "3" resp. "[3] = Bokning" | För att inkludera den mottagna handpenningen används post 1 av typ "3" (bokningspost) – precis som i det första exemplet. Värdena (GrossValue, NetValue osv.) för denna post är dock negativa (!) |
| Positions.BusinessTransactionType | "7" resp. "[7] = Handpenning" | Den specifika affärstransaktionstypen (BusinessTransactionType) som används i post 1 är ”7” (handpenning). |
| Positions.VatIdentification | Vat måste också beaktas när handpenningen avräknas. | |
| Payments.Type | "0" respektive "Kontant" |
I avsnittet ”Payments” visas endast den återstående betalningen i kontanter (Total Items = Total Payments). Beräkning: Position 0: 2 979,90 Position 1: -1 200,00 Totalt: 1 779,90 Betalningar: 1 779,90 (kontant) Totala utbetalningar: 1 779,90 |
Exempel:
{
"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": {}
}
Alternativ 2 – Insättning som betalning
I denna variant visas den mottagna insättningen som en betalningspost i payloaden.
Transaktionsegenskaper
Tabellen nedan visar vilka egenskaper som måste ställas in på vilka värden för att affärsfallet ska mappas korrekt.
| Egenskap | Värde | Beskrivning |
| DocumentType | "0" eller "[0] = Kvitto" | ska hanteras via kontantkvitto |
| Positions.Type | "0" eller "[0] = Artikel" | För artikelposition 0 (den artikel som kunden har beställt och för vilken en handpenning har betalats) |
| Positions.BusinessTransactionType | "0" eller "[0] = Revenue" | För artikelposition 0 (den artikel som kunden har beställt och för vilken en handpenning har betalats) |
| Payments.Type | "0" eller "Kontanter" | Avsnittet ”Payments” innehåller två poster: 1. Det återstående beloppet som betalats kontant, och... |
| Betalningstyp | "6" eller "[6] = Handpenning" |
... den mottagna insättningen (positiv!). Beräkning: Position 0: 2 979,90 Totalt: 2 979,90 Betalningar: 1 779,90 (kontanter) Utbetalningar: 1 200,00 (Insättning) Totala betalningar: 2 979,90 |
| Payments.VatPercent | Om Vat i det aktuella landet redan måste redovisas eller betalas vid mottagandet av en förskottsbetalning eller deposition, måste den Vat som redan har deklarerats också anges i enlighet därmed i objektet Betalningar! | |
| Betalningar.TaxValue | Om Vat i det aktuella landet redan måste redovisas eller betalas vid mottagande av en förskottsbetalning eller handpenning, måste den Vat som redan har deklarerats också anges i enlighet därmed i objektet Betalningar! |
Exempel:
{
"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": {}
}
Den här artikeln har översatts automatiskt.
Kommentarer
0 kommentarer
logga in för att lämna en kommentar.