Die nachfolgenden JSON-Beispiele zeigen, wie der Erhalt einer Anzahlung sowie die spätere Berücksichtigung der erhaltenen Anzahlung, bei Lieferung / Leistung in RetailForce abgebildet werden kann.
Bitte beachten Sie, dass bestimmte, in den Beispielen verwendete Werte von Eigenschaften angepasst werden müssen, damit Sie den Payload in Ihrem System verwenden können (z.B. "UniqueClientId", "BookDate"). Auch wurden die Beispiele für ein bestimmtes Land erstellt, das bedeutet, dass auch Steuersätze, Brutto,- Nettobeträge etc. angepasst werden müssen.
| Verwendete Release-Version: | 1.11.16.2546 |
| DOM-Version: | 1.7.0 |
1. Erhalt Anzahlung
Im ersten Schritt wird ein Beleg über eine erhaltene Anzahlung erstellt:
- Kunde tätigt eine Anzahlung in Bar in der Höhe von EUR 1.200 für eine spätere Lieferung/Leistung.
Eigenschaften Geschäftsfall
Die nachfolgende Tabelle zeigt, welche Eigenschaften mit welchen Werten gesetzt werden müssen, um den Geschäftsfall korrekt abzubilden.
| Eigenschaft | Wert | Beschreibung |
| DocumentType | "0" bzw. "[0] = Receipt" | Darstellung eines Kassenbeleges |
| Positions.Type | "3" bzw. "[3] = Booking" | Eine erhaltene Anzahlung wird durch eine Position vom Typ "3" (Buchungsposition) abgebildet. |
| Positions.BusinessTransactionType | "7" bzw. "[7] = Deposit" | Als konkreter Geschäftsfall (BusinessTransactionType) wird "7" (Anzahlung) verwendet. |
| Positions.VatIdentification | Wenn im entsprechenden Land beim Erhalt einer Vorauszahlung / Anzahlung bereits die MwSt. auszuweisen bzw. abzuführen ist, muss die korrekte ID der MwSt.-Kategorie angegeben, sowie die MwSt. entsprechend berechnet werden. | |
| Payments.Type | "0" bzw. "Cash" | Da es sich im konkreten Fall um eine Barzahlung handelt, ist auch die Zahlungsmethode entsprechend zu definieren. |
Beispiel:
{
"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": "Anzahlung zu Bestellung",
"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. Abwicklung Restzahlung
Bei Lieferung und Leistung (Kunde holt z.B. bestellte Ware ab) muss der Kunde den noch offenen Betrag des vollen Warenwertes begleichen:
- Gesamtwert der Lieferung/Leistung: EUR 2.979,90
- Berücksichtigung der Anzahlung von EUR 1.200
- Kunde bezahlt den Rest (EUR 1.779.90) ebenfalls in Bar
Die Anzahlung kann auf zwei unterschiedliche Arten im finalen Dokument berücksichtigt werden:
Variante 1 - Anzahlung als Position
In dieser Variante wird die Anzahlung als negative Position (Umkehr der Position im ursprünglichen Payload) in den Payload aufgenommen.
Eigenschaften Geschäftsfall
Die nachfolgende Tabelle zeigt, welche Eigenschaften mit welchen Werten gesetzt werden müssen, um den Geschäftsfall korrekt abzubilden.
| Eigenschaft | Wert | Beschreibung |
| DocumentType | "0" bzw. "[0] = Receipt" | Darstellung eines Kassenbeleges |
| Positions.Type | "0" bzw. "[0] = Item" | Für die Artikel-Position 0 (Artikel, welcher vom Kunden bestellt wurde und für den die Anzahlung getätigt wurde) |
| Positions.BusinessTransactionType | "0" bzw. "[0] = Revenue" | Für die Artikel-Position 0 (Artikel, welcher vom Kunden bestellt wurde und für den die Anzahlung getätigt wurde) |
| Positions.Type | "3" bzw. "[3] = Booking" | Zur Berücksichtigung der erhaltenen Anzahlung wird die Position 1 vom Typ "3" (Buchungsposition) - wie im ersten Beispiel verwendet. Die Werte (GrossValue, NetValue,...) der Position sind allerdings negativ (!) |
| Positions.BusinessTransactionType | "7" bzw. "[7] = Deposit" | Als konkreter Geschäftsfall (BusinessTransactionType) wird in Position 1 "7" (Anzahlung) verwendet. |
| Positions.VatIdentification | Auch bei der "Auflösung" der Anzahlung muss die MwSt. entsprechend berücksichtigt werden. | |
| Payments.Type | "0" bzw. "Cash" | Im Payments-Bereich wird lediglich die Restzahlung in Bar abgebildet (Summe Positions = Summe Payments). Berechnung: Position 0: 2.979,90 Position 1: -1.200,00 Summe Positionen: 1.779,90 Payments: 1.779,90 (Cash) Summe Payments 1.779,90 |
Beispiel:
{
"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": "Anzahlung zu Rechnung",
"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": {}
}
Variante 2 - Anzahlung als Zahlung
In dieser Variante wird die erhaltene Anzahlung als Payments-Position im Payload abgebildet.
Eigenschaften Geschäftsfall
Die nachfolgende Tabelle zeigt, welche Eigenschaften mit welchen Werten gesetzt werden müssen, um den Geschäftsfall korrekt abzubilden.
| Eigenschaft | Wert | Beschreibung |
| DocumentType | "0" bzw. "[0] = Receipt" | Darstellung eines Kassenbeleges |
| Positions.Type | "0" bzw. "[0] = Item" | Für die Artikel-Position 0 (Artikel, welcher vom Kunden bestellt wurde und für den die Anzahlung getätigt wurde) |
| Positions.BusinessTransactionType | "0" bzw. "[0] = Revenue" | Für die Artikel-Position 0 (Artikel, welcher vom Kunden bestellt wurde und für den die Anzahlung getätigt wurde) |
| Payments.Type | "0" bzw. "Cash" | Im Payments-Bereich sind zwei Positionen enthalten: 1. Restzahlung in Bar sowie... |
| Payments.Type | "6" bzw. "[6] = Deposit" | ... die erhaltene Anzahlung (positiv!). Berechnung: Position 0: 2.979,90 Summe Positionen: 2.979,90 Payments: 1.779,90 (Cash) Payments: 1.200,00 (Deposit) Summe Payments 2.979,90 |
| Payments.VatPercent | Wenn im entsprechenden Land beim Erhalt einer Vorauszahlung / Anzahlung bereits die MwSt. auszuweisen bzw. abzuführen ist, muss die bereits deklarierte MwSt. auch entsprechend im Payments-Objekt angegeben werden! | |
| Payments.TaxValue | Wenn im entsprechenden Land beim Erhalt einer Vorauszahlung / Anzahlung bereits die MwSt. auszuweisen bzw. abzuführen ist, muss die bereits deklarierte MwSt. auch entsprechend im Payments-Objekt angegeben werden! |
Beispiel:
{
"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": {}
}
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.