Skip to main content

Migrating from API v0 to PosSystem API (v2)

The legacy v0 SignatureCloud API (also referred to by its subdomain pattern signaturcloud-sandbox.*) and the original synchronous ifPOS.v0 fiskaltrust.Middleware API — primarily used in Austria (AT) and France (FR) — remain functional but no longer receive new features. All current and future development, including e-invoicing support and upcoming compliance capabilities, is available exclusively through the POSSystem API (v2), making migration strongly recommended.

Migrating to v2 gives you:

  • E-invoicing support — Access to e-invoicing features and all future compliance capabilities.
  • Alignment with fiskaltrust Middleware v2 — the POSSystemAPI interface is designed to remain largely stable when the middleware transitions from v1.2 to v2, making this migration valuable preparation.
  • Long-term supportability — v0 is considered deprecated; customers are encouraged to migrate as soon as possible.
  • Simpler authentication — PIN-based pairing for simpler, more secure authentication setup.
  • Modern and flexible API design — A modern, standard HTTP/REST API that works with any programming language or framework.
info

This guide is primarily targeted at PosCreators integrating cloud cashboxes in the AT, FR, and DE markets.

Prerequisites​

Before starting the migration, ensure you have:

  • An active fiskaltrust account (sandbox and/or production).
  • Access to the fiskaltrust.Portal to reconfigure CashBoxes.
  • An existing integration that successfully produces receipts against the v0 SignatureCloud API.
  • Access to a sandbox cashbox for testing your migrated integration before going live.
Market availability for local setups

The PosSystem API via Launcher 2.0 has market-specific constraints:

  • Austria (AT): Launcher 2.0 is not enabled by default. Contact fiskaltrust support to enable it for your account.
  • France (FR): Launcher 2.0 is not yet supported. The workaround is setting 2 cashboxes, one with the queue and one with the POSSystemAPI helper without a queue. French customers should contact fiskaltrust for more instructions if needed.

Cloud CashBox (base URL change)​

If your integration targets a Cloud CashBox (for example, your POS system calls the fiskaltrust cloud endpoint rather than a locally-running Middleware), the base URL changes as part of the migration:

Environmentv0 base URLv2 base URL
Sandboxhttps://signaturcloud-sandbox.fiskaltrust.fr (FR)https://possystem-api-sandbox.fiskaltrust.eu/v2
Sandboxhttps://signaturcloud-sandbox.fiskaltrust.at (AT)https://possystem-api-sandbox.fiskaltrust.eu/v2
Sandboxhttps://signaturcloud-sandbox.fiskaltrust.de (DE)https://possystem-api-sandbox.fiskaltrust.eu/v2
Productionhttps://signaturcloud.fiskaltrust.fr (FR)https://possystem-api.fiskaltrust.eu/v2
Productionhttps://signaturcloud.fiskaltrust.at (AT)https://possystem-api.fiskaltrust.eu/v2
Productionhttps://signaturcloud.fiskaltrust.de (DE)https://possystem-api.fiskaltrust.eu/v2
info

The v2 cloud endpoint uses a single, market-agnostic base URL for all markets (AT, FR, DE), with the actual market determined by values such as the ftCashBoxID, ftReceiptCase and your CashBox and queue configuration, not by the URL or host.

Replace all occurrences of the per-market v0 base URL in your integration with the single new URL above. Make sure to append /v2 to the path.

The path structure changes accordingly:

  • Sign - v0 path: /[json|xml]/sign; v2 path: /sign
  • Echo - v0 path: /[json|xml]/echo; v2 path: /echo
  • Journal - v0 path: /[json|xml]/journal; v2 path: /journal

Local CashBox​

Sandbox/admin access only

Local cashbox migration requires additional configuration steps that are currently only supported in sandbox environments under guidance from the fiskaltrust team.

The portal-side configuration requires adding a LocalPosSystemApi Helper to your CashBox and rebuilding it with Launcher 2.0. Rather than duplicating those steps here, follow the How to Configure the Local PosSystem API Helper with Launcher 2.0 guide, which covers:

  1. Adding a fiskaltrust.Middleware.Helper.LocalPosSystemApi Helper in the Portal.
  2. Configuring the Helper URL.
  3. Assigning the Helper to the relevant CashBox.
  4. Rebuilding the CashBox configuration.
  5. Downloading and running Launcher 2.0.

Authentication​

All v2 requests must include the following HTTP headers:

x-cashbox-id :   <your CashBox GUID>
x-cashbox-accesstoken : <your Access Token>
x-operation-id : a UUID randomly generated on your side

Both cashbox-id and accesstoken are available on the CashBox page in the fiskaltrust.Portal.

Case Values​

The integer values used for ftReceiptCase, ftChargeItemCase, and ftPayItemCase differ between the v0 and v2 interfaces. Updating these values is the most substantial part of the migration. You must remap all case values in your requests.

Development Plataform

The authoritative source for v2 case values and their mapping to v0 cases is the fiskaltrust Development Platform. It provides market-specific business case examples (AT, FR, DE) with the correct v2 ftReceiptCase, ftChargeItemCase, and ftPayItemCase values for each scenario. Use these examples as your reference when updating your integration.

A systematic approach to updating case values:

  1. List every ftReceiptCase, ftChargeItemCase, and ftPayItemCase value currently used in your integration.
  2. For each value, find the corresponding business case in the Development Platform for your market.
  3. Replace the v0 value with the v2 value shown in the platform example. Remove the country code (4154 for AT, 4445 for DE, and 4652 for FR), as it is no longer required.
  4. Repeat for all receipt types (including special receipts such as Start-Receipt, Stop-Receipt, daily/shift closings, and Zero-Receipts).
  5. If you don't find some values used in your integration in the table below, it seams that you just have to change the v0 with the v2 value.
  6. Important: You'll see, in certain cases, for the same value in v0, you now need to specify a more precise value. For example, with invoices, there was only one code in v0, but now there are several possible values. Your POS system must therefore integrate whether the invoice is issued for B2C, B2B, B2G, etc.

ftReceiptCase​

Austria (AT)

Fixed Mappings

v2 (in)v0 (out)Description
0x2000_0000_00000x4154_0000_0000_0000Unknown receipt type, threated the same way as a point-of-sale receipt type
0x2000_0000_00010x4154_0000_0000_0001Point-of-sale receipt type
0x2000_0000_00030x4154_0000_0000_0007Point-of-sale receipt type without fiskalisation obligation or with exemption
0x2000_0000_00040x4154_0000_0000_000FE-commerce receipt type
0x2000_0000_00050x4154_0000_0000_0009Delivery note receipt type
0x2000_0000_10000x4154_0000_0000_0008Unknown invoice type
0x2000_0000_10010x4154_0000_0000_0008B2C invoice type
0x2000_0000_10020x4154_0000_0000_0008B2B invoice type
0x2000_0000_10030x4154_0000_0000_0008B2G invoice type
0x2000_0000_20000x4154_0000_0000_0002Zero receipt dailyoperation type
0x2000_0000_20010x4154_0000_0000_0002(reserved) dailyoperation type
0x2000_0000_20100x4154_0000_0000_0002Shift closing dailyoperation type
0x2000_0000_20110x4154_0000_0000_0002Daily closing dailyoperation type
0x2000_0000_20120x4154_0000_0000_0005Monthly closing dailyoperation type
0x2000_0000_20130x4154_0000_0000_0006Yearly closing dailyoperation type
0x2000_0000_30000x4154_0000_0000_000DUnknown/unspecified protocol type
0x2000_0000_30010x4154_0000_0000_000DTechnical event protocol type
0x2000_0000_30020x4154_0000_0000_000DAudit event / accounting event protocol type
0x2000_0000_30030x4154_0000_0000_000EInternal usage / material consumption protocol type
0x2000_0000_30040x4154_0000_0000_000DOrder protocol type
0x2000_0000_30050x4154_0000_0000_000DPay protocol type
0x2000_0000_30100x4154_0000_0000_000DCopy receipt / re-print existing receipt protocol type => no implementation in v0
0x2000_0000_30110x4154_0000_0000_000DArchive receipt / archive all previouse data protocol type => no implementation in v0
0x2000_0000_40010x4154_0000_0000_0003Start-receipt lifecycle type
0x2000_0000_40020x4154_0000_0000_0004Stop-receipt lifecycle type
0x2000_0000_40110x4154_0000_0000_0002Start-scu-switch lifecycle type => no implementation in v0, using zeroreceipt
0x2000_0000_40120x4154_0000_0000_0002Stop-scu-switch lifecycle type => no implementation in v0, using zeroreceipt
0x2000_0000_40210x4154_0000_0000_0002Start-migration lifecycle type => no implementation in v0, using zeroreceipt
0x2000_0000_40220x4154_0000_0000_0002Stop-migration lifecycle type => no implementation in v0, using zeroreceipt

Dynamics Mappings

v2 (in)v0 (out)Description
0x2000_0000_00020x4154_0000_0000_000APayment transfer receipt type ; conditional. ChargeItems == [] && cash(PayItems) > 0 , pay-in to drawer/till
0x2000_0000_00020x4154_0000_0000_000BPayment transfer receipt type ; conditional. ChargeItems == [] && cash(PayItems) < 0 , pay-out from drawer/till
0x2000_0000_00020x4154_0000_0000_000CPayment transfer receipt type
0x2ooo_o8oo_00000x4154_0000_0000_0010IsSaleInForeignCountry flag recognized in any point-of-sale receipt type, v0 makes no difference between unknown, pos, pos with exemption
0x2ooo_o8oo_00010x4154_0000_0000_0010IsSaleInForeignCountry flag recognized in any point-of-sale receipt type, v0 makes no difference between unknown, pos, pos with exemption
0x2ooo_o8oo_00020x4154_0000_0000_0010IsSaleInForeignCountry flag recognized in any point-of-sale receipt type, v0 makes no difference between unknown, pos, pos with exemption
0x2ooo_o8oo_00030x4154_0000_0000_0010IsSaleInForeignCountry flag recognized in any point-of-sale receipt type, v0 makes no difference between unknown, pos, pos with exemption
0x2oo0_oo1o_2ooo0xoooo_oooo_oooo_ooooRequest additional SCU information / RKSV signing certificate information (type2)
0x2oo0_oo2o_2ooo0xoooo_oooo_oooo_ooooRequest download of SCU journal / no implementation in v0 (type2)
0x2oo0_oo4o_2ooo0xoooo_oooo_oooo_ooooRequest bypoass of SCU SCU journal / no implementation in v0 (type2)
0x2oo0_oo8o_2ooo0xoooo_oooo_oooo_ooooRequest execute SCU self-test / no implementation in v0 (type2)
0x2oo0_o1oo_2ooo0xoooo_oooo_oooo_ooooRequest masterdata update / no implementation in v0 (type2)
0x2oo0_oo1o_4ooo0xoooo_oooo_oooo_ooooQueue registration/de-registration only (no initial provision/no final de-provistion) of SCU / no implementation in v0 (type4)
0x2ooo_ooo1_oooo0xoooo_oooo_ooo1_oooov2 process late signing => v0 general failed receipt (type0,1)
0x2ooo_ooo2_oooo0xoooo_oooo_ooo2_oooov2 training mode => v0 general training receipt (type0,1,3)
0x2ooo_ooo4_oooo0xoooo_oooo_ooo4_oooov2 IsVoid => v0 general void receipt (type0,1)
0x2ooo_ooo8_oooo0xoooo_oooo_ooo8_oooov2 handwritten mode => v0 general handwritten receipt (type0,1)
0x2ooo_oo1o_oooo0xoooo_oooo_oo1o_oooov2 IssurIsSmallBusiness => v0 Germany small business, sales tax relief (type0,1)
0x2ooo_oo2o_oooo0xoooo_oooo_oo2o_oooov2 ReceiverIsBusiness => v0 Germany receiver is a company (type0,1)
0x2ooo_oo4o_oooo0xoooo_oooo_oo4o_oooov2 ReceiverIsKnown => v0 Germany receiver is known (type0,1)
0x2ooo_oo8o_oooo0xoooo_oooo_oo8o_oooov2 IsSaleInForeignCountry => v0 Germany no action required, handled as indirect translations (type0,1)
0x2ooo_o1oo_oooo0xoooo_oooo_oooo_oooov2 IsReturn/IsRefund => v0 no action required,
optional verify cbPreviouseReceiptReference set;
optional verify ChargeItem(Amount) == (-1)xcbPreviouseReceiptReference(ChargeItem(Amount));
optional verify ChargeItem(Quantity) == (-1)xcbPreviouseReceiptReference(ChargeItem(Quantity)); (type0,1)
0x2ooo_o8oo_oooo0xoooo_oooo_oooo_oooov2 Group by Position-Number => v0 not supported
0x2ooo_8ooo_oooo0xoooo_8ooo_oooo_oooov2 ReceiptRequest => v0 general receipt request
France (FR)
v2 (in)v0 (out)Description
0x2000_0000_00000x4652_0000_0000_0000Unknown receipt type, threated the same way as a point-of-sale receipt type
0x2ooo_o8oo_00000x4652_0000_0000_000EIsSaleInForeignCountry flag recognized in any point-of-sale receipt type, v0 makes no difference between unknown, pos, pos with exemption
0x2ooo_o8oo_00010x4652_0000_0000_000EIsSaleInForeignCountry flag recognized in any point-of-sale receipt type, v0 makes no difference between unknown, pos, pos with exemption
0x2ooo_o8oo_00020x4652_0000_0000_000EIsSaleInForeignCountry flag recognized in any point-of-sale receipt type, v0 makes no difference between unknown, pos, pos with exemption
0x2ooo_o8oo_00030x4652_0000_0000_000EIsSaleInForeignCountry flag recognized in any point-of-sale receipt type, v0 makes no difference between unknown, pos, pos with exemption
0x2000_0000_00010x4652_0000_0000_0001Point-of-sale receipt type
0x2000_0000_00020x4652_0000_0000_000APayment transfer receipt type ; conditional. ChargeItems == [] && cash(PayItems) > 0 , pay-in to drawer/till
0x2000_0000_00020x4652_0000_0000_000BPayment transfer receipt type ; conditional. ChargeItems == [] && cash(PayItems) < 0 , pay-out from drawer/till
0x2000_0000_00020x4652_0000_0000_000CPayment transfer receipt type
0x2000_0000_00030x4652_0000_0000_000EPoint-of-sale receipt type without fiskalisation obligation or with exemption => v0 France handles it in Foreign sales and chaines it into Bill
0x2000_0000_00040x4652_0000_0000_000EE-commerce receipt type => v0 France handles it in Foreign sales and chaines it into Bill
0x2000_0000_00050x4652_0000_0000_0009Delivery note receipt type
0x2000_0000_00060x4652_0000_0000_0008Bill receipt type
0x2000_0000_00070x4652_0000_0000_0008Proforma invoice receipt type
0x2000_0000_10000x4652_0000_0000_0003Unknown invoice type
0x2000_0000_10010x4652_0000_0000_0003B2C invoice type
0x2000_0000_10020x4652_0000_0000_0003B2B invoice type
0x2000_0000_10030x4652_0000_0000_0003B2G invoice type
0x2000_0000_20000x4652_0000_0000_000FZero receipt dailyoperation type
0x2000_0000_20010x4652_0000_0000_000F(reserved) dailyoperation type
0x2000_0000_20100x4652_0000_0000_0004Shift closing dailyoperation type
0x2000_0000_20110x4652_0000_0000_0005Daily closing dailyoperation type
0x2000_0000_20120x4652_0000_0000_0006Monthly closing dailyoperation type
0x2000_0000_20130x4652_0000_0000_0007Yearly closing dailyoperation type
0x2000_0000_30000x4652_0000_0000_0014Unknown/unspecified protocol type
0x2000_0000_30010x4652_0000_0000_0012Technical event protocol type
0x2000_0000_30020x4652_0000_0000_0013Audit event / accounting event protocol type
0x2000_0000_30030x4652_0000_0000_000DInternal usage / material consumption protocol type
0x2000_0000_30040x4652_0000_0000_0008Order protocol type
0x2000_0000_30050x4652_0000_0000_0002Pay protocol type => v0 france payment prove
0x2000_0000_30100x4652_0000_0000_0016Copy receipt / re-print existing receipt protocol type
0x2000_0000_30110x4652_0000_0000_0015Archive receipt / archive all previouse data protocol type
0x2000_0000_40010x4652_0000_0000_0010Start-receipt lifecycle type
0x2000_0000_40020x4652_0000_0000_0011Stop-receipt lifecycle type
0x2000_0000_40110x4652_0000_0000_000FStart-scu-switch lifecycle type => no implementation in v0, using zeroreceipt
0x2000_0000_40120x4652_0000_0000_000FStop-scu-switch lifecycle type => no implementation in v0, using zeroreceipt
0x2000_0000_40210x4652_0000_0000_000FStart-migration lifecycle type => no implementation in v0, using zeroreceipt
0x2000_0000_40220x4652_0000_0000_000FStop-migration lifecycle type => no implementation in v0, using zeroreceipt
0x2oo0_oo1o_2ooo0xoooo_oooo_oooo_ooooRequest additional SCU information / signing certificate information (type2)
0x2oo0_oo2o_2ooo0xoooo_oooo_oooo_ooooRequest download of SCU journal / no implementation in v0 (type2)
0x2oo0_oo4o_2ooo0xoooo_oooo_oooo_ooooRequest bypoass of SCU SCU journal / no implementation in v0 (type2)
0x2oo0_oo8o_2ooo0xoooo_oooo_oooo_ooooRequest execute SCU self-test / no implementation in v0 (type2)
0x2oo0_o1oo_2ooo0xoooo_oooo_oooo_ooooRequest masterdata update / no implementation in v0 (type2)
0x2oo0_oo1o_4ooo0xoooo_oooo_oooo_ooooClient registration/de-registration only (no initial provision/no final de-provistion) of SCU / no implementation in v0 (type4)
0x2ooo_ooo1_oooo0xoooo_oooo_ooo1_oooov2 process late signing => v0 general failed receipt (type0,1)
0x2ooo_ooo2_oooo0xoooo_oooo_ooo2_oooov2 training mode => v0 general training receipt (type0,1,3)
0x2ooo_ooo4_oooo0xoooo_oooo_ooo4_oooov2 IsVoid => v0 general void receipt (type0,1)
0x2ooo_ooo8_oooo0xoooo_oooo_oooo_oooov2 handwritten mode => v0 general handwritten receipt, no implementation in v0 (type0,1)
0x2ooo_oo1o_oooo0xoooo_oooo_oooo_oooov2 IssurIsSmallBusiness => v0 general small business, sales tax relief, no implementation in v0 France (type0,1)
0x2ooo_oo2o_oooo0xoooo_oooo_oooo_oooov2 ReceiverIsBusiness => v0 general receiver is a company, no implementation in v0 France (type0,1)
0x2ooo_oo4o_oooo0xoooo_oooo_oooo_oooov2 ReceiverIsKnown => v0 general receiver is known, no implementation in v0 France (type0,1)
0x2ooo_oo8o_oooo0xoooo_oooo_oooo_oooov2 IsSaleInForeignCountry => v0 general no action required, handled as indirect translations (type0,1)
0x2ooo_o1oo_oooo0xoooo_oooo_oooo_oooov2 IsReturn/IsRefund => v0 no action required,
optional verify cbPreviouseReceiptReference set;
optional verify ChargeItem(Amount) == (-1)xcbPreviouseReceiptReference(ChargeItem(Amount));
optional verify ChargeItem(Quantity) == (-1)xcbPreviouseReceiptReference(ChargeItem(Quantity)); (type0,1), no implementation in v0
0x2ooo_o8oo_oooo0xoooo_oooo_oooo_oooov2 Group by Position-Number => v0 not supported
0x2ooo_8ooo_oooo0xoooo_8ooo_oooo_oooov2 ReceiptRequest => v0 general receipt request
Germany (DE)
v2 (in)v0 (out)Description
0x2000_0000_00000x4445_0000_0000_0000Unknown receipt type, threated the same way as a point-of-sale receipt type
0x2ooo_o8oo_00000x4445_0000_0000_0015IsSaleInForeignCountry flag recognized in any point-of-sale receipt type, v0 makes no difference between unknown, pos, pos with exemption
0x2ooo_o8oo_00010x4445_0000_0000_0015IsSaleInForeignCountry flag recognized in any point-of-sale receipt type, v0 makes no difference between unknown, pos, pos with exemption
0x2ooo_o8oo_00020x4445_0000_0000_0015IsSaleInForeignCountry flag recognized in any point-of-sale receipt type, v0 makes no difference between unknown, pos, pos with exemption
0x2ooo_o8oo_00030x4445_0000_0000_0015IsSaleInForeignCountry flag recognized in any point-of-sale receipt type, v0 makes no difference between unknown, pos, pos with exemption
0x2ooo_o1oo_00030x4445_0000_0000_0016German "AVBelegstorno/Kassenbeleg-V1" which should not be used with TSE (technical saftey device), pos with exemption
0x2000_0000_00010x4445_0000_0000_0001Point-of-sale receipt type
0x2000_0000_00020x4445_0000_0000_0011Payment transfer receipt type
0x2000_0000_00030x4445_0000_0000_0015Point-of-sale receipt type without fiskalisation obligation or with exemption => v0 Germany handles it in Foreign sales
0x2000_0000_00040x4445_0000_0000_0015E-commerce receipt type => v0 Germany handles it in Foreign sales
0x2000_0000_00050x4445_0000_0000_000FDelivery note receipt type
0x2000_0000_10000x4445_0000_0000_000EUnknown invoice type
0x2000_0000_10010x4445_0000_0000_000DB2C invoice type
0x2000_0000_10020x4445_0000_0000_000CB2B invoice type
0x2000_0000_10030x4445_0000_0000_000EB2G invoice type
0x2000_0000_20000x4445_0001_0000_0002Zero receipt dailyoperation type
0x2000_0000_20010x4445_0001_0000_0002(reserved) dailyoperation type
0x2000_0000_20100x4445_0001_0000_0002Shift closing dailyoperation type
0x2000_0000_20110x4445_0001_0000_0007Daily closing dailyoperation type
0x2000_0000_20120x4445_0001_0000_0005Monthly closing dailyoperation type
0x2000_0000_20130x4445_0001_0000_0006Yearly closing dailyoperation type
0x2000_0000_30000x4445_0000_0000_0013Unknown/unspecified protocol type => v0 German "AVSonstige/Kassenbeleg-V1" requires ChargeItems != [] && PayItems != []
0x2000_0000_30000x4445_0000_0000_0013Unknown/unspecified protocol type => v0 German "SonstigerVorgang" requires ChargeItems == []
0x2000_0000_30010x4445_0000_0000_0014Technical event protocol type
0x2011_0000_30010x4445_0000_0000_0008German "Start-Transaction"
0x2021_0000_30010x4445_0000_0000_0009German "Update-Transaction"
0x2031_0000_30010x4445_0000_0000_000AGerman "Delta-Transaction"
0x2041_0000_30010x4445_0000_0000_000BGerman "Fail-Transaction" to close single open transaction
0x2040_0000_30010x4445_0001_0000_000BGerman "Fail-Transaction" to close multiple open transactions
0x2000_0000_30020x4445_0000_0000_0014Audit event / accounting event protocol type
0x2000_0000_30030x4445_0000_0000_0012Internal usage / material consumption protocol type
0x2000_0000_30040x4445_0000_0000_0010Order protocol type => v0 German "Bestellung-V1" requires ChargeItems != [] && PayItems == []
0x2000_0000_30040x4445_0000_0000_0010Order protocol type => v0 German "AVBestellung/Kassenbeleg-V1" requires PayItems != []
0x2000_0000_30050x4445_0000_0000_0010Pay protocol type => v0 German "AVBestellung/Kassenbeleg-V1" requires PayItems != []
0x2000_0000_30100x4445_0000_0000_0014Copy receipt / re-print existing receipt protocol type
0x2000_0000_30110x4445_0000_0000_0014Archive receipt / archive all previouse data protocol type
0x2000_0000_40010x4445_0001_0000_0003Start-receipt lifecycle type
0x2000_0000_40020x4445_0001_0000_0004Stop-receipt lifecycle type
0x2000_0000_40110x4445_0001_0000_0010Start-scu-switch lifecycle type
0x2000_0000_40120x4445_0001_0000_0011Stop-scu-switch lifecycle type
0x2000_0000_40210x4445_0001_0000_0010Start-migration lifecycle type
0x2000_0000_40220x4445_0001_0000_0011Stop-migration lifecycle type
0x2oo0_oo1o_2ooo0xoooo_ooo1_oo8o_ooooRequest additional SCU information / TSE (type2)
0x2oo0_oo2o_2ooo0xoooo_ooo1_o2oo_ooooRequest download of SCU journal / force TSE-TAR file download (type2)
0x2oo0_oo4o_2ooo0xoooo_ooo1_o4oo_ooooRequest bypoass of SCU SCU journal / bypass TSE-TAR file download (type2)
0x2oo0_oo8o_2ooo0xoooo_ooo1_o1oo_ooooRequest execute SCU self-test / execute TSE self-test (type2)
0x2oo0_o1oo_2ooo0xoooo_ooo1_o8oo_ooooRequest masterdata update (type2)
0x2oo0_oo1o_4ooo0xoooo_ooo1_o1oo_ooooClient registration/de-registration only (no initial provision/no final de-provistion) of SCU / ClientId registration/de-registration only for TSE (type4)
0x2oo0_oooo_0ooo0xoooo_ooo1_oooo_ooooImplicit flow for receipt type
0x2oo0_oooo_1ooo0xoooo_ooo1_oooo_ooooImplicit flow for invoice type
0x2oo0_oooo_3ooo0xoooo_ooo1_oooo_ooooImplicit flow for log type
0x2ooo_oooo_0ooo0xoooo_ooo0_oooo_ooooExplicit flow for receipt type , no effect , information only
0x2ooo_oooo_1ooo0xoooo_ooo0_oooo_ooooExplicit flow for invoice type , no effect , information only
0x2ooo_oooo_3ooo0xoooo_ooo0_oooo_ooooExplicit flow for log type , no effect , information only
0x2ooo_ooo1_oooo0xoooo_oooo_ooo1_oooov2 process late signing => v0 general failed receipt (type0,1)
0x2ooo_ooo2_oooo0xoooo_oooo_ooo2_oooov2 training mode => v0 general training receipt (type0,1,3)
0x2ooo_ooo4_oooo0xoooo_oooo_ooo4_oooov2 IsVoid => v0 general void receipt (type0,1)
0x2ooo_ooo8_oooo0xoooo_oooo_ooo8_oooov2 handwritten mode => v0 general handwritten receipt (type0,1)
0x2ooo_oo1o_oooo0xoooo_oooo_oo1o_oooov2 IssurIsSmallBusiness => v0 Germany small business, sales tax relief (type0,1)
0x2ooo_oo2o_oooo0xoooo_oooo_oo2o_oooov2 ReceiverIsBusiness => v0 Germany receiver is a company (type0,1)
0x2ooo_oo4o_oooo0xoooo_oooo_oo4o_oooov2 ReceiverIsKnown => v0 Germany receiver is known (type0,1)
0x2ooo_oo8o_oooo0xoooo_oooo_oo8o_oooov2 IsSaleInForeignCountry => v0 Germany no action required, handled as indirect translations (type0,1)
0x2ooo_o1oo_oooo0xoooo_oooo_oooo_oooov2 IsReturn/IsRefund => v0 no action required,
optional verify cbPreviouseReceiptReference set;
optional verify ChargeItem(Amount) == (-1)xcbPreviouseReceiptReference(ChargeItem(Amount));
optional verify ChargeItem(Quantity) == (-1)xcbPreviouseReceiptReference(ChargeItem(Quantity)); (type0,1)
0x2ooo_o8oo_oooo0xoooo_oooo_oooo_oooov2 Group by Position-Number => v0 not supported
0x2ooo_8ooo_oooo0xoooo_8ooo_oooo_oooov2 ReceiptRequest => v0 general receipt request

ftChargeItemCase​

Austria (AT)
v2 (in)v0 (out)Description
0x2000_0000_00000x4154_0000_0000_0000Unknown chargeitem type, unknown type of service, unknown type of vat, future logic may detect vat-type from vat-rate
0x2000_oooo_oo010x4154_0000_0000_0001Unknown type of service, discounted1 type of vat
0x2000_oooo_oo020x4154_0000_0000_0002Unknown type of service, discounted2 type of vat
0x2000_oooo_oo030x4154_0000_0000_0003Unknown type of service, normal type of vat
0x2000_oooo_oo040x4154_0000_0000_0004Unknown type of service, superreduced1 type of vat
0x2000_oooo_oo050x4154_0000_0000_0005Unknown type of service, superreduced2 type of vat => not defined in v0, goto zero
0x2000_oooo_oo060x4154_0000_0000_0005Unknown type of service, parking type of vat => not defined in v0, goto zero
0x2000_oooo_oo070x4154_0000_0000_0005Unknown type of service, zero type of vat
0x2000_oooo_oo080x4154_0000_0000_0005Unknown type of service, not taxable type of vat => not defined in v0, goto zero
0x2000_oooo_5oo80x4154_0000_0000_0006Not taxable type of vat, reverse charge => v0 specific implementation
0x2000_oooo_oo110x4154_0000_0000_0008Supply of goods type of service, discounted1 type of vat
0x2000_oooo_oo120x4154_0000_0000_0009Supply of goods type of service, discounted2 type of vat
0x2000_oooo_oo130x4154_0000_0000_000ASupply of goods type of service, normal type of vat
0x2000_oooo_oo140x4154_0000_0000_000BSupply of goods type of service, superreduced1 type of vat
0x2000_oooo_oo150x4154_0000_0000_000CSupply of goods type of service, superreduced2 type of vat => not defined in v0, goto zero
0x2000_oooo_oo160x4154_0000_0000_000CSupply of goods type of service, parking type of vat => not defined in v0, goto zero
0x2000_oooo_oo170x4154_0000_0000_000CSupply of goods type of service, zero type of vat
0x2000_oooo_oo180x4154_0000_0000_000CSupply of goods type of service, not taxable type of vat => not defined in v0, goto zero
0x2000_oooo_oo210x4154_0000_0000_000DSupply of service type of service, discounted1 type of vat
0x2000_oooo_oo220x4154_0000_0000_000ESupply of service type of service, discounted2 type of vat
0x2000_oooo_oo230x4154_0000_0000_000FSupply of service type of service, normal type of vat
0x2000_oooo_oo240x4154_0000_0000_0010Supply of service type of service, superreduced1 type of vat
0x2000_oooo_oo250x4154_0000_0000_0011Supply of service type of service, superreduced2 type of vat => not defined in v0, goto zero
0x2000_oooo_oo260x4154_0000_0000_0011Supply of service type of service, parking type of vat => not defined in v0, goto zero
0x2000_oooo_oo270x4154_0000_0000_0011Supply of service type of service, zero type of vat
0x2000_oooo_oo280x4154_0000_0000_0011Supply of service type of service, not taxable type of vat => not defined in v0, goto zero
0x2000_oooo_oo310x4154_0000_0000_0001Tip to owner type of service, discounted1 type of vat
0x2000_oooo_oo320x4154_0000_0000_0002Tip to owner type of service, discounted2 type of vat
0x2000_oooo_oo330x4154_0000_0000_0003Tip to owner type of service, normal type of vat
0x2000_oooo_oo340x4154_0000_0000_0004Tip to owner type of service, superreduced1 type of vat
0x2000_oooo_oo350x4154_0000_0000_0005Tip to owner type of service, superreduced2 type of vat
0x2000_oooo_oo360x4154_0000_0000_0005Tip to owner type of service, parking type of vat
0x2000_oooo_oo370x4154_0000_0000_0005Tip to owner type of service, zero type of vat
0x2000_oooo_oo380x4154_0000_0000_0005Tip to employee type of service, not taxable type of vat
0x2000_oooo_oo410x4154_0000_0000_0001Single-use voucher type of service, discounted1 type of vat
0x2000_oooo_oo420x4154_0000_0000_0002Single-use voucher type of service, discounted2 type of vat
0x2000_oooo_oo430x4154_0000_0000_0003Single-use voucher type of service, normal type of vat
0x2000_oooo_oo440x4154_0000_0000_0004Single-use voucher type of service, superreduced1 type of vat
0x2000_oooo_oo450x4154_0000_0000_0005Single-use voucher type of service, superreduced2 type of vat
0x2000_oooo_oo460x4154_0000_0000_0005Single-use voucher type of service, parking type of vat
0x2000_oooo_oo470x4154_0000_0000_0005Single-use voucher type of service, zero type of vat
0x2000_oooo_oo480x4154_0000_0000_0021Multi-use voucher type of service, not taxable type of vat
0x2000_oooo_oo510x4154_0000_0000_0012Catalog service type of service, discounted1 type of vat
0x2000_oooo_oo520x4154_0000_0000_0013Catalog service type of service, discounted2 type of vat
0x2000_oooo_oo530x4154_0000_0000_0014Catalog service type of service, normal type of vat
0x2000_oooo_oo540x4154_0000_0000_0015Catalog service type of service, superreduced1 type of vat
0x2000_oooo_oo550x4154_0000_0000_0016Catalog service type of service, superreduced2 type of vat
0x2000_oooo_oo560x4154_0000_0000_0016Catalog service type of service, parking type of vat
0x2000_oooo_oo570x4154_0000_0000_0016Catalog service type of service, zero type of vat
0x2000_oooo_oo580x4154_0000_0000_0016Catalog service type of service, not taxable type of vat
0x2000_oooo_oo610x4154_0000_0000_0007Agency business type of service, discounted1 type of vat
0x2000_oooo_oo620x4154_0000_0000_0007Agency business type of service, discounted2 type of vat
0x2000_oooo_oo630x4154_0000_0000_0007Agency business type of service, normal type of vat
0x2000_oooo_oo640x4154_0000_0000_0007Agency business type of service, superreduced1 type of vat
0x2000_oooo_oo650x4154_0000_0000_0007Agency business type of service, superreduced2 type of vat
0x2000_oooo_oo660x4154_0000_0000_0007Agency business type of service, parking type of vat
0x2000_oooo_oo670x4154_0000_0000_0007Agency business type of service, zero type of vat
0x2000_oooo_oo680x4154_0000_0000_0021Receiveable of thired party type of service, not taxable type of vat
0x2000_oooo_oo710x4154_0000_0000_0017Own consumption type of service, discounted1 type of vat
0x2000_oooo_oo720x4154_0000_0000_0018Own consumption type of service, discounted2 type of vat
0x2000_oooo_oo730x4154_0000_0000_0019Own consumption type of service, normal type of vat
0x2000_oooo_oo740x4154_0000_0000_001AOwn consumption type of service, superreduced1 type of vat
0x2000_oooo_oo750x4154_0000_0000_001BOwn consumption type of service, superreduced2 type of vat
0x2000_oooo_oo760x4154_0000_0000_001BOwn consumption type of service, parking type of vat
0x2000_oooo_oo770x4154_0000_0000_001BOwn consumption type of service, zero type of vat
0x2000_oooo_oo780x4154_0000_0000_001BOwn consumption type of service, not taxable type of vat
0x2000_oooo_oo810x4154_0000_0000_0001Grant (unreal) type of service, discounted1 type of vat
0x2000_oooo_oo820x4154_0000_0000_0002Grant (unreal) type of service, discounted2 type of vat
0x2000_oooo_oo830x4154_0000_0000_0003Grant (unreal) type of service, normal type of vat
0x2000_oooo_oo840x4154_0000_0000_0004Grant (unreal) type of service, superreduced1 type of vat
0x2000_oooo_oo850x4154_0000_0000_0005Grant (unreal) type of service, superreduced2 type of vat
0x2000_oooo_oo860x4154_0000_0000_0005Grant (unreal) type of service, parking type of vat
0x2000_oooo_oo870x4154_0000_0000_0005Grant (unreal) type of service, zero type of vat
0x2000_oooo_oo880x4154_0000_0000_0005Grant (real) type of service, not taxable type of vat
0x2000_oooo_oo980x4154_0000_0000_0022Receiveable type of service, not taxable type of vat
0x2000_oooo_ooA80x4154_0000_0000_0023Cash transfer type of service, not taxable type of vat
0x2000_ooo8_oo000x4154_0000_0000_0020Downpayment, unknown type of service, unknown type of vat
0x2000_ooo8_oo010x4154_0000_0000_001CDownpayment, unknown type of service, discounted1 type of vat
0x2000_ooo8_oo020x4154_0000_0000_001DDownpayment, unknown type of service, discounted2 type of vat
0x2000_ooo8_oo030x4154_0000_0000_001EDownpayment, unknown type of service, normal type of vat
0x2000_ooo8_oo040x4154_0000_0000_001FDownpayment, unknown type of service, superreduced1 type of vat
0x2000_ooo8_oo050x4154_0000_0000_0020Downpayment, unknown type of service, superreduced2 type of vat => not defined in v0, goto zero
0x2000_ooo8_oo060x4154_0000_0000_0020Downpayment, unknown type of service, parking type of vat => not defined in v0, goto zero
0x2000_ooo8_oo070x4154_0000_0000_0020Downpayment, unknown type of service, zero type of vat
0x2000_ooo8_oo080x4154_0000_0000_0020Downpayment, unknown type of service, not taxable type of vat => not defined in v0, goto zero
0x2000_ooo8_oo110x4154_0000_0000_001CDownpayment, supply of goods type of service, discounted1 type of vat
0x2000_ooo8_oo120x4154_0000_0000_001DDownpayment, supply of goods type of service, discounted2 type of vat
0x2000_ooo8_oo130x4154_0000_0000_001EDownpayment, supply of goods type of service, normal type of vat
0x2000_ooo8_oo140x4154_0000_0000_001FDownpayment, supply of goods type of service, superreduced1 type of vat
0x2000_ooo8_oo150x4154_0000_0000_0020Downpayment, supply of goods type of service, superreduced2 type of vat => not defined in v0, goto zero
0x2000_ooo8_oo160x4154_0000_0000_0020Downpayment, supply of goods type of service, parking type of vat => not defined in v0, goto zero
0x2000_ooo8_oo170x4154_0000_0000_0020Downpayment, supply of goods type of service, zero type of vat
0x2000_ooo8_oo180x4154_0000_0000_0020Downpayment, supply of goods type of service, not taxable type of vat => not defined in v0, goto zero
0x2000_ooo8_oo210x4154_0000_0000_001CDownpayment, supply of service type of service, discounted1 type of vat
0x2000_ooo8_oo220x4154_0000_0000_001DDownpayment, supply of service type of service, discounted2 type of vat
0x2000_ooo8_oo230x4154_0000_0000_001EDownpayment, supply of service type of service, normal type of vat
0x2000_ooo8_oo240x4154_0000_0000_001FDownpayment, supply of service type of service, superreduced1 type of vat
0x2000_ooo8_oo250x4154_0000_0000_0020Downpayment, supply of service type of service, superreduced2 type of vat => not defined in v0, goto zero
0x2000_ooo8_oo260x4154_0000_0000_0020Downpayment, supply of service type of service, parking type of vat => not defined in v0, goto zero
0x2000_ooo8_oo270x4154_0000_0000_0020Downpayment, supply of service type of service, zero type of vat
0x2000_ooo8_oo280x4154_0000_0000_0020Downpayment, supply of service type of service, not taxable type of vat => not defined in v0, goto zero
0x2ooo_ooo1_oooo0xoooo_oooo_oooo_oooov2 IsVoid => v0 general void => no implementation in v0
0x2ooo_ooo2_oooo0xoooo_oooo_oooo_oooov2 IsReturn/Refund => v0 general refund => no implementation in v0
0x2ooo_ooo4_oooo0xoooo_oooo_oooo_oooov2 Discount => v0 general discount => no implementation in v0
0x2ooo_oo10_oooo0xoooo_oooo_oooo_oooov2 Returnable => v0 general returnable => no implementation in v0
0x2ooo_oo20_oooo0xoooo_oooo_oooo_oooov2 Take Away => v0 take away => no implementation in v0
France (FR)
v2 (in)v0 (out)Description
0x2000_0000_00000x4652_0000_0000_0000Unknown chargeitem type, unknown type of service, unknown type of vat, future logic may detect vat-type from vat-rate
0x2000_oooo_oo010x4652_0000_0000_0001Unknown type of service, discounted1 type of vat
0x2000_oooo_oo020x4652_0000_0000_0002Unknown type of service, discounted2 type of vat
0x2000_oooo_oo030x4652_0000_0000_0003Unknown type of service, normal type of vat
0x2000_oooo_oo040x4652_0000_0000_0004Unknown type of service, superreduced1 type of vat
0x2000_oooo_oo050x4652_0000_0000_0005Unknown type of service, superreduced2 type of vat => not defined in v0, goto zero
0x2000_oooo_oo060x4652_0000_0000_0005Unknown type of service, parking type of vat => not defined in v0, goto zero
0x2000_oooo_oo070x4652_0000_0000_0005Unknown type of service, zero type of vat
0x2000_oooo_oo080x4652_0000_0000_0005Unknown type of service, not taxable type of vat => not defined in v0, goto zero
0x2000_oooo_5oo80x4652_0000_0000_0006Not taxable type of vat, reverse charge => v0 specific implementation
0x2000_oooo_oo110x4652_0000_0000_0008Supply of goods type of service, discounted1 type of vat
0x2000_oooo_oo120x4652_0000_0000_0009Supply of goods type of service, discounted2 type of vat
0x2000_oooo_oo130x4652_0000_0000_000ASupply of goods type of service, normal type of vat
0x2000_oooo_oo140x4652_0000_0000_000BSupply of goods type of service, superreduced1 type of vat
0x2000_oooo_oo150x4652_0000_0000_000CSupply of goods type of service, superreduced2 type of vat => not defined in v0, goto zero
0x2000_oooo_oo160x4652_0000_0000_000CSupply of goods type of service, parking type of vat => not defined in v0, goto zero
0x2000_oooo_oo170x4652_0000_0000_000CSupply of goods type of service, zero type of vat
0x2000_oooo_oo180x4652_0000_0000_000CSupply of goods type of service, not taxable type of vat => not defined in v0, goto zero
0x2000_oooo_oo210x4652_0000_0000_000DSupply of service type of service, discounted1 type of vat
0x2000_oooo_oo220x4652_0000_0000_000ESupply of service type of service, discounted2 type of vat
0x2000_oooo_oo230x4652_0000_0000_000FSupply of service type of service, normal type of vat
0x2000_oooo_oo240x4652_0000_0000_0010Supply of service type of service, superreduced1 type of vat
0x2000_oooo_oo250x4652_0000_0000_0011Supply of service type of service, superreduced2 type of vat => not defined in v0, goto zero
0x2000_oooo_oo260x4652_0000_0000_0011Supply of service type of service, parking type of vat => not defined in v0, goto zero
0x2000_oooo_oo270x4652_0000_0000_0011Supply of service type of service, zero type of vat
0x2000_oooo_oo280x4652_0000_0000_0011Supply of service type of service, not taxable type of vat => not defined in v0, goto zero
0x2000_oooo_oo310x4652_0000_0000_0001Tip to owner type of service, discounted1 type of vat
0x2000_oooo_oo320x4652_0000_0000_0002Tip to owner type of service, discounted2 type of vat
0x2000_oooo_oo330x4652_0000_0000_0003Tip to owner type of service, normal type of vat
0x2000_oooo_oo340x4652_0000_0000_0004Tip to owner type of service, superreduced1 type of vat
0x2000_oooo_oo350x4652_0000_0000_0005Tip to owner type of service, superreduced2 type of vat
0x2000_oooo_oo360x4652_0000_0000_0005Tip to owner type of service, parking type of vat
0x2000_oooo_oo370x4652_0000_0000_0005Tip to owner type of service, zero type of vat
0x2000_oooo_oo380x4652_0000_0000_0005Tip to employee type of service, not taxable type of vat
0x2000_oooo_oo410x4652_0000_0000_0001Single-use voucher type of service, discounted1 type of vat
0x2000_oooo_oo420x4652_0000_0000_0002Single-use voucher type of service, discounted2 type of vat
0x2000_oooo_oo430x4652_0000_0000_0003Single-use voucher type of service, normal type of vat
0x2000_oooo_oo440x4652_0000_0000_0004Single-use voucher type of service, superreduced1 type of vat
0x2000_oooo_oo450x4652_0000_0000_0005Single-use voucher type of service, superreduced2 type of vat
0x2000_oooo_oo460x4652_0000_0000_0005Single-use voucher type of service, parking type of vat
0x2000_oooo_oo470x4652_0000_0000_0005Single-use voucher type of service, zero type of vat
0x2000_oooo_oo480x4652_0000_0000_0021Multi-use voucher type of service, not taxable type of vat
0x2000_oooo_oo510x4652_0000_0000_0012Catalog service type of service, discounted1 type of vat
0x2000_oooo_oo520x4652_0000_0000_0013Catalog service type of service, discounted2 type of vat
0x2000_oooo_oo530x4652_0000_0000_0014Catalog service type of service, normal type of vat
0x2000_oooo_oo540x4652_0000_0000_0015Catalog service type of service, superreduced1 type of vat
0x2000_oooo_oo550x4652_0000_0000_0016Catalog service type of service, superreduced2 type of vat
0x2000_oooo_oo560x4652_0000_0000_0016Catalog service type of service, parking type of vat
0x2000_oooo_oo570x4652_0000_0000_0016Catalog service type of service, zero type of vat
0x2000_oooo_oo580x4652_0000_0000_0016Catalog service type of service, not taxable type of vat
0x2000_oooo_oo610x4652_0000_0000_0007Agency business type of service, discounted1 type of vat
0x2000_oooo_oo620x4652_0000_0000_0007Agency business type of service, discounted2 type of vat
0x2000_oooo_oo630x4652_0000_0000_0007Agency business type of service, normal type of vat
0x2000_oooo_oo640x4652_0000_0000_0007Agency business type of service, superreduced1 type of vat
0x2000_oooo_oo650x4652_0000_0000_0007Agency business type of service, superreduced2 type of vat
0x2000_oooo_oo660x4652_0000_0000_0007Agency business type of service, parking type of vat
0x2000_oooo_oo670x4652_0000_0000_0007Agency business type of service, zero type of vat
0x2000_oooo_oo680x4652_0000_0000_0021Receiveable of thired party type of service, not taxable type of vat
0x2000_oooo_oo710x4652_0000_0000_0017Own consumption type of service, discounted1 type of vat
0x2000_oooo_oo720x4652_0000_0000_0018Own consumption type of service, discounted2 type of vat
0x2000_oooo_oo730x4652_0000_0000_0019Own consumption type of service, normal type of vat
0x2000_oooo_oo740x4652_0000_0000_001AOwn consumption type of service, superreduced1 type of vat
0x2000_oooo_oo750x4652_0000_0000_001BOwn consumption type of service, superreduced2 type of vat
0x2000_oooo_oo760x4652_0000_0000_001BOwn consumption type of service, parking type of vat
0x2000_oooo_oo770x4652_0000_0000_001BOwn consumption type of service, zero type of vat
0x2000_oooo_oo780x4652_0000_0000_001BOwn consumption type of service, not taxable type of vat
0x2000_oooo_oo810x4652_0000_0000_0001Grant (unreal) type of service, discounted1 type of vat
0x2000_oooo_oo820x4652_0000_0000_0002Grant (unreal) type of service, discounted2 type of vat
0x2000_oooo_oo830x4652_0000_0000_0003Grant (unreal) type of service, normal type of vat
0x2000_oooo_oo840x4652_0000_0000_0004Grant (unreal) type of service, superreduced1 type of vat
0x2000_oooo_oo850x4652_0000_0000_0005Grant (unreal) type of service, superreduced2 type of vat
0x2000_oooo_oo860x4652_0000_0000_0005Grant (unreal) type of service, parking type of vat
0x2000_oooo_oo870x4652_0000_0000_0005Grant (unreal) type of service, zero type of vat
0x2000_oooo_oo880x4652_0000_0000_0005Grant (real) type of service, not taxable type of vat
0x2000_oooo_oo980x4652_0000_0000_0022Receiveable type of service, not taxable type of vat
0x2000_oooo_ooA80x4652_0000_0000_0022Cash transfer type of service, not taxable type of vat
0x2000_ooo8_oo000x4652_0000_0000_0020Downpayment, unknown type of service, unknown type of vat
0x2000_ooo8_oo010x4652_0000_0000_001CDownpayment, unknown type of service, discounted1 type of vat
0x2000_ooo8_oo020x4652_0000_0000_001DDownpayment, unknown type of service, discounted2 type of vat
0x2000_ooo8_oo030x4652_0000_0000_001EDownpayment, unknown type of service, normal type of vat
0x2000_ooo8_oo040x4652_0000_0000_001FDownpayment, unknown type of service, superreduced1 type of vat
0x2000_ooo8_oo050x4652_0000_0000_0020Downpayment, unknown type of service, superreduced2 type of vat => not defined in v0, goto zero
0x2000_ooo8_oo060x4652_0000_0000_0020Downpayment, unknown type of service, parking type of vat => not defined in v0, goto zero
0x2000_ooo8_oo070x4652_0000_0000_0020Downpayment, unknown type of service, zero type of vat
0x2000_ooo8_oo080x4652_0000_0000_0020Downpayment, unknown type of service, not taxable type of vat => not defined in v0, goto zero
0x2000_ooo8_oo110x4652_0000_0000_001CDownpayment, supply of goods type of service, discounted1 type of vat
0x2000_ooo8_oo120x4652_0000_0000_001DDownpayment, supply of goods type of service, discounted2 type of vat
0x2000_ooo8_oo130x4652_0000_0000_001EDownpayment, supply of goods type of service, normal type of vat
0x2000_ooo8_oo140x4652_0000_0000_001FDownpayment, supply of goods type of service, superreduced1 type of vat
0x2000_ooo8_oo150x4652_0000_0000_0020Downpayment, supply of goods type of service, superreduced2 type of vat => not defined in v0, goto zero
0x2000_ooo8_oo160x4652_0000_0000_0020Downpayment, supply of goods type of service, parking type of vat => not defined in v0, goto zero
0x2000_ooo8_oo170x4652_0000_0000_0020Downpayment, supply of goods type of service, zero type of vat
0x2000_ooo8_oo180x4652_0000_0000_0020Downpayment, supply of goods type of service, not taxable type of vat => not defined in v0, goto zero
0x2000_ooo8_oo210x4652_0000_0000_001CDownpayment, supply of service type of service, discounted1 type of vat
0x2000_ooo8_oo220x4652_0000_0000_001DDownpayment, supply of service type of service, discounted2 type of vat
0x2000_ooo8_oo230x4652_0000_0000_001EDownpayment, supply of service type of service, normal type of vat
0x2000_ooo8_oo240x4652_0000_0000_001FDownpayment, supply of service type of service, superreduced1 type of vat
0x2000_ooo8_oo250x4652_0000_0000_0020Downpayment, supply of service type of service, superreduced2 type of vat => not defined in v0, goto zero
0x2000_ooo8_oo260x4652_0000_0000_0020Downpayment, supply of service type of service, parking type of vat => not defined in v0, goto zero
0x2000_ooo8_oo270x4652_0000_0000_0020Downpayment, supply of service type of service, zero type of vat
0x2000_ooo8_oo280x4652_0000_0000_0020Downpayment, supply of service type of service, not taxable type of vat => not defined in v0, goto zero
0x2ooo_ooo1_oooo0xoooo_oooo_oooo_oooov2 IsVoid => v0 general void => no implementation in v0
0x2ooo_ooo2_oooo0xoooo_oooo_oooo_oooov2 IsReturn/Refund => v0 general refund => no implementation in v0
0x2ooo_ooo4_oooo0xoooo_oooo_oooo_oooov2 Discount => v0 general discount => no implementation in v0
0x2ooo_oo10_oooo0xoooo_oooo_oooo_oooov2 Returnable => v0 general returnable => no implementation in v0
0x2ooo_oo20_oooo0xoooo_oooo_oooo_oooov2 Take Away => v0 take away => no implementation in v0
Germany (DE)
v2 (in)v0 (out)Description
0x2000_0000_00000x4445_0000_0000_0000Unknown chargeitem type, unknown type of service, unknown type of vat, future logic may detect vat-type from vat-rate
0x2000_oooo_oo010x4445_0000_0000_0002Unknown type of service, discounted1 type of vat
0x2000_oooo_oo020x4445_0000_0000_0007Unknown type of service, discounted2 type of vat => not defined in v0, goto unknown
0x2000_oooo_oo030x4445_0000_0000_0001Unknown type of service, normal type of vat
0x2000_oooo_oo040x4445_0000_0000_0003Unknown type of service, superreduced1 type of vat
0x2000_oooo_oo050x4445_0000_0000_0004Unknown type of service, superreduced2 type of vat
0x2000_oooo_oo060x4445_0000_0000_0007Unknown type of service, parking type of vat => not defined in v0, goto unknown
0x2000_oooo_oo070x4445_0000_0000_0006Unknown type of service, zero type of vat
0x2000_oooo_oo080x4445_0000_0000_0005Unknown type of service, not taxable type of vat
0x2000_oooo_oo110x4445_0000_0000_0012Supply of goods type of service, discounted1 type of vat
0x2000_oooo_oo120x4445_0000_0000_0017Supply of goods type of service, discounted2 type of vat => not defined in v0, goto unknown
0x2000_oooo_oo130x4445_0000_0000_0011Supply of goods type of service, normal type of vat
0x2000_oooo_oo140x4445_0000_0000_0013Supply of goods type of service, superreduced1 type of vat
0x2000_oooo_oo150x4445_0000_0000_0014Supply of goods type of service, superreduced2 type of vat
0x2000_oooo_oo160x4445_0000_0000_0017Supply of goods type of service, parking type of vat => not defined in v0, goto unknown
0x2000_oooo_oo170x4445_0000_0000_0016Supply of goods type of service, zero type of vat
0x2000_oooo_oo180x4445_0000_0000_0015Supply of goods type of service, not taxable type of vat
0x2000_oooo_oo210x4445_0000_0000_001ASupply of service type of service, discounted1 type of vat
0x2000_oooo_oo220x4445_0000_0000_001FSupply of service type of service, discounted2 type of vat => not defined in v0, goto unknown
0x2000_oooo_oo230x4445_0000_0000_0019Supply of service type of service, normal type of vat
0x2000_oooo_oo240x4445_0000_0000_001BSupply of service type of service, superreduced1 type of vat
0x2000_oooo_oo250x4445_0000_0000_001CSupply of service type of service, superreduced2 type of vat
0x2000_oooo_oo260x4445_0000_0000_001FSupply of service type of service, parking type of vat => not defined in v0, goto unknown
0x2000_oooo_oo270x4445_0000_0000_001ESupply of service type of service, zero type of vat
0x2000_oooo_oo280x4445_0000_0000_001DSupply of service type of service, not taxable type of vat
0x2000_oo1o_ooo10x4445_0000_0000_0022Returnable type of service, discounted1 type of vat
0x2000_oo1o_ooo20x4445_0000_0000_0027Returnable type of service, discounted2 type of vat => not defined in v0, goto unknown
0x2000_oo1o_ooo30x4445_0000_0000_0021Returnable type of service, normal type of vat
0x2000_oo1o_ooo40x4445_0000_0000_0023Returnable type of service, superreduced1 type of vat
0x2000_oo1o_ooo50x4445_0000_0000_0024Returnable type of service, superreduced2 type of vat
0x2000_oo1o_ooo60x4445_0000_0000_0027Returnable type of service, parking type of vat => not defined in v0, goto unknown
0x2000_oo1o_ooo70x4445_0000_0000_0026Returnable type of service, zero type of vat
0x2000_oo1o_ooo80x4445_0000_0000_0025Returnable type of service, not taxable type of vat
0x2000_oo12_ooo10x4445_0000_0000_002AReturnable refund type of service, discounted1 type of vat
0x2000_oo12_ooo20x4445_0000_0000_002FReturnable refund type of service, discounted2 type of vat => not defined in v0, goto unknown
0x2000_oo12_ooo30x4445_0000_0000_0029Returnable refund type of service, normal type of vat
0x2000_oo12_ooo40x4445_0000_0000_002BReturnable refund type of service, superreduced1 type of vat
0x2000_oo12_ooo50x4445_0000_0000_002CReturnable refund type of service, superreduced2 type of vat
0x2000_oo12_ooo60x4445_0000_0000_0027Returnable refund type of service, parking type of vat => not defined in v0, goto unknown
0x2000_oo12_ooo70x4445_0000_0000_002EReturnable refund type of service, zero type of vat
0x2000_oo12_ooo80x4445_0000_0000_002DReturnable refund type of service, not taxable type of vat
0x2000_ooo4_ooo10x4445_0000_0000_0032Discount (amount < 0) type of service, discounted1 type of vat
0x2000_ooo4_ooo20x4445_0000_0000_0037Discount (amount < 0) type of service, discounted2 type of vat => not defined in v0, goto unknown
0x2000_ooo4_ooo30x4445_0000_0000_0031Discount (amount < 0) type of service, normal type of vat
0x2000_ooo4_ooo40x4445_0000_0000_0033Discount (amount < 0) type of service, superreduced1 type of vat
0x2000_ooo4_ooo50x4445_0000_0000_0034Discount (amount < 0) type of service, superreduced2 type of vat
0x2000_ooo4_ooo60x4445_0000_0000_0037Discount (amount < 0) type of service, parking type of vat => not defined in v0, goto unknown
0x2000_ooo4_ooo70x4445_0000_0000_0036Discount (amount < 0) type of service, zero type of vat
0x2000_ooo4_ooo80x4445_0000_0000_0035Discount (amount < 0) type of service, not taxable type of vat
0x2000_ooo4_ooo10x4445_0000_0000_003ADiscount (amount > 0) type of service, discounted1 type of vat
0x2000_ooo4_ooo20x4445_0000_0000_003FDiscount (amount > 0) type of service, discounted2 type of vat => not defined in v0, goto unknown
0x2000_ooo4_ooo30x4445_0000_0000_0039Discount (amount > 0) type of service, normal type of vat
0x2000_ooo4_ooo40x4445_0000_0000_003BDiscount (amount > 0) type of service, superreduced1 type of vat
0x2000_ooo4_ooo50x4445_0000_0000_003CDiscount (amount > 0) type of service, superreduced2 type of vat
0x2000_ooo4_ooo60x4445_0000_0000_0037Discount (amount > 0) type of service, parking type of vat => not defined in v0, goto unknown
0x2000_ooo4_ooo70x4445_0000_0000_003EDiscount (amount > 0) type of service, zero type of vat
0x2000_ooo4_ooo80x4445_0000_0000_003DDiscount (amount > 0) type of service, not taxable type of vat
0x2000_oooo_oo810x4445_0000_0000_0042Grant (unreal) type of service, discounted1 type of vat
0x2000_oooo_oo820x4445_0000_0000_0047Grant (unreal) type of service, discounted2 type of vat => not defined in v0, goto unknown
0x2000_oooo_oo830x4445_0000_0000_0041Grant (unreal) type of service, normal type of vat
0x2000_oooo_oo840x4445_0000_0000_0043Grant (unreal) type of service, superreduced1 type of vat
0x2000_oooo_oo850x4445_0000_0000_0044Grant (unreal) type of service, superreduced2 type of vat
0x2000_oooo_oo860x4445_0000_0000_0047Grant (unreal) type of service, parking type of vat => not defined in v0, goto unknown
0x2000_oooo_oo870x4445_0000_0000_0046Grant (unreal) type of service, zero type of vat
0x2000_oooo_oo880x4445_0000_0000_0049Grant (real) type of service, not taxable type of vat => _0045 will not be reachable from v2
0x2000_oooo_oo310x4445_0000_0000_0052Tip to owner type of service, discounted1 type of vat
0x2000_oooo_oo320x4445_0000_0000_0057Tip to owner type of service, discounted2 type of vat => not defined in v0, goto unknown
0x2000_oooo_oo330x4445_0000_0000_0051Tip to owner type of service, normal type of vat
0x2000_oooo_oo340x4445_0000_0000_0053Tip to owner type of service, superreduced1 type of vat
0x2000_oooo_oo350x4445_0000_0000_0054Tip to owner type of service, superreduced2 type of vat
0x2000_oooo_oo360x4445_0000_0000_0057Tip to owner type of service, parking type of vat => not defined in v0, goto unknown
0x2000_oooo_oo370x4445_0000_0000_0056Tip to owner type of service, zero type of vat
0x2000_oooo_oo380x4445_0000_0000_0059Tip to employee type of service, not taxable type of vat => _0055 will not be reachable from v2
0x2000_oooo_oo410x4445_0000_0000_0062Single-use voucher (amount > 0) type of service, discounted1 type of vat
0x2000_oooo_oo420x4445_0000_0000_0067Single-use voucher (amount > 0) type of service, discounted2 type of vat => not defined in v0, goto unknown
0x2000_oooo_oo430x4445_0000_0000_0061Single-use voucher (amount > 0) type of service, normal type of vat
0x2000_oooo_oo440x4445_0000_0000_0063Single-use voucher (amount > 0) type of service, superreduced1 type of vat
0x2000_oooo_oo450x4445_0000_0000_0064Single-use voucher (amount > 0) type of service, superreduced2 type of vat
0x2000_oooo_oo460x4445_0000_0000_0067Single-use voucher (amount > 0) type of service, parking type of vat => not defined in v0, goto unknown
0x2000_oooo_oo470x4445_0000_0000_0066Single-use voucher (amount > 0) type of service, zero type of vat
0x2000_oooo_oo480x4445_0000_0000_0060Multi-use voucher (amount > 0) type of service, not taxable type of vat
0x2000_oooo_oo410x4445_0000_0000_006ASingle-use voucher (amount > 0) type of service, discounted1 type of vat
0x2000_oooo_oo420x4445_0000_0000_006FSingle-use voucher (amount < 0) type of service, discounted2 type of vat => not defined in v0, goto unknown
0x2000_oooo_oo430x4445_0000_0000_0069Single-use voucher (amount < 0) type of service, normal type of vat
0x2000_oooo_oo440x4445_0000_0000_006BSingle-use voucher (amount < 0) type of service, superreduced1 type of vat
0x2000_oooo_oo450x4445_0000_0000_006CSingle-use voucher (amount < 0) type of service, superreduced2 type of vat
0x2000_oooo_oo460x4445_0000_0000_006FSingle-use voucher (amount < 0) type of service, parking type of vat => not defined in v0, goto unknown
0x2000_oooo_oo470x4445_0000_0000_006ESingle-use voucher (amount < 0) type of service, zero type of vat
0x2000_oooo_oo480x4445_0000_0000_0068Multi-use voucher (amount < 0) type of service, not taxable type of vat
0x2000_oooo_oo910x4445_0000_0000_0072Receiveable (amount > 0), discounted1 type of vat
0x2000_oooo_oo920x4445_0000_0000_0077Receiveable (amount > 0), discounted2 type of vat => not defined in v0, goto unknown
0x2000_oooo_oo930x4445_0000_0000_0071Receiveable (amount > 0), normal type of vat
0x2000_oooo_oo940x4445_0000_0000_0073Receiveable (amount > 0), superreduced1 type of vat
0x2000_oooo_oo950x4445_0000_0000_0074Receiveable (amount > 0), superreduced2 type of vat
0x2000_oooo_oo960x4445_0000_0000_0077Receiveable (amount > 0), parking type of vat => not defined in v0, goto unknown
0x2000_oooo_oo970x4445_0000_0000_0076Receiveable (amount > 0), zero type of vat
0x2000_oooo_oo980x4445_0000_0000_0075Receiveable (amount > 0), not taxable type of vat
0x2000_oooo_oo910x4445_0000_0000_007AReceiveable (amount < 0), discounted1 type of vat
0x2000_oooo_oo920x4445_0000_0000_007FReceiveable (amount < 0), discounted2 type of vat => not defined in v0, goto unknown
0x2000_oooo_oo930x4445_0000_0000_0079Receiveable (amount < 0), normal type of vat
0x2000_oooo_oo940x4445_0000_0000_007BReceiveable (amount < 0), superreduced1 type of vat
0x2000_oooo_oo950x4445_0000_0000_007CReceiveable (amount < 0), superreduced2 type of vat
0x2000_oooo_oo960x4445_0000_0000_007FReceiveable (amount < 0), parking type of vat => not defined in v0, goto unknown
0x2000_oooo_oo970x4445_0000_0000_007EReceiveable (amount < 0), zero type of vat
0x2000_oooo_oo980x4445_0000_0000_007DReceiveable (amount < 0), not taxable type of vat
0x2000_ooo8_ooo10x4445_0000_0000_0082Downpayment (amount < 0) type of service, discounted1 type of vat
0x2000_ooo8_ooo20x4445_0000_0000_0087Downpayment (amount < 0) type of service, discounted2 type of vat => not defined in v0, goto unknown
0x2000_ooo8_ooo30x4445_0000_0000_0081Downpayment (amount < 0) type of service, normal type of vat
0x2000_ooo8_ooo40x4445_0000_0000_0083Downpayment (amount < 0) type of service, superreduced1 type of vat
0x2000_ooo8_ooo50x4445_0000_0000_0084Downpayment (amount < 0) type of service, superreduced2 type of vat
0x2000_ooo8_ooo60x4445_0000_0000_0087Downpayment (amount < 0) type of service, parking type of vat => not defined in v0, goto unknown
0x2000_ooo8_ooo70x4445_0000_0000_0086Downpayment (amount < 0) type of service, zero type of vat
0x2000_ooo8_ooo80x4445_0000_0000_0085Downpayment (amount < 0) type of service, not taxable type of vat
0x2000_ooo8_ooo10x4445_0000_0000_008ADownpayment (amount > 0) type of service, discounted1 type of vat
0x2000_ooo8_ooo20x4445_0000_0000_008FDownpayment (amount > 0) type of service, discounted2 type of vat => not defined in v0, goto unknown
0x2000_ooo8_ooo30x4445_0000_0000_0089Downpayment (amount > 0) type of service, normal type of vat
0x2000_ooo8_ooo40x4445_0000_0000_008BDownpayment (amount > 0) type of service, superreduced1 type of vat
0x2000_ooo8_ooo50x4445_0000_0000_008CDownpayment (amount > 0) type of service, superreduced2 type of vat
0x2000_ooo8_ooo60x4445_0000_0000_0087Downpayment (amount > 0) type of service, parking type of vat => not defined in v0, goto unknown
0x2000_ooo8_ooo70x4445_0000_0000_008EDownpayment (amount > 0) type of service, zero type of vat
0x2000_ooo8_ooo80x4445_0000_0000_008DDownpayment (amount > 0) type of service, not taxable type of vat
0x2000_oooo_ooA80x4445_0000_0000_0097 X TODO different cash transfersCash transfer type of service, not taxable type of vat
0x2000_oooo_5oo80x4445_0000_0000_00A1Not taxable type of vat, reverse charge => v0 specific implementation
0x2000_oooo_oo610x4445_0000_0000_00A2Agency business type of service, discounted1 type of vat
0x2000_oooo_oo620x4445_0000_0000_00A2Agency business type of service, discounted2 type of vat
0x2000_oooo_oo630x4445_0000_0000_00A2Agency business type of service, normal type of vat
0x2000_oooo_oo640x4445_0000_0000_00A2Agency business type of service, superreduced1 type of vat
0x2000_oooo_oo650x4445_0000_0000_00A2Agency business type of service, superreduced2 type of vat
0x2000_oooo_oo660x4445_0000_0000_00A2Agency business type of service, parking type of vat
0x2000_oooo_oo670x4445_0000_0000_00A2Agency business type of service, zero type of vat
0x2000_oooo_oo510x4445_0000_0000_0002Catalog service type of service, discounted1 type of vat => not defined in v0, use unknown
0x2000_oooo_oo520x4445_0000_0000_0007Catalog service type of service, discounted2 type of vat => not defined in v0, use unknown
0x2000_oooo_oo530x4445_0000_0000_0001Catalog service type of service, normal type of vat => not defined in v0, use unknown
0x2000_oooo_oo540x4445_0000_0000_0003Catalog service type of service, superreduced1 type of vat => not defined in v0, use unknown
0x2000_oooo_oo550x4445_0000_0000_0004Catalog service type of service, superreduced2 type of vat => not defined in v0, use unknown
0x2000_oooo_oo560x4445_0000_0000_0007Catalog service type of service, parking type of vat => not defined in v0, use unknown
0x2000_oooo_oo570x4445_0000_0000_0006Catalog service type of service, zero type of vat => not defined in v0, use unknown
0x2000_oooo_oo580x4445_0000_0000_0005Catalog service type of service, not taxable type of vat => not defined in v0, use unknown
0x2000_oooo_oo710x4445_0000_0000_0042Own consumption type of service, discounted1 type of vat => not defined in v0, use grant
0x2000_oooo_oo720x4445_0000_0000_0047Own consumption type of service, discounted2 type of vat => not defined in v0, use grant
0x2000_oooo_oo730x4445_0000_0000_0041Own consumption type of service, normal type of vat => not defined in v0, use grant
0x2000_oooo_oo740x4445_0000_0000_0043Own consumption type of service, superreduced1 type of vat => not defined in v0, use grant
0x2000_oooo_oo750x4445_0000_0000_0044Own consumption type of service, superreduced2 type of vat => not defined in v0, use grant
0x2000_oooo_oo760x4445_0000_0000_0047Own consumption type of service, parking type of vat => not defined in v0, use grant
0x2000_oooo_oo770x4445_0000_0000_0046Own consumption type of service, zero type of vat => not defined in v0, use grant
0x2000_oooo_oo780x4445_0000_0000_0045Own consumption type of service, not taxable type of vat => not defined in v0, use grant
0x2ooo_oo2o_oooo0xoooo_oooo_ooo1_oooov2 Take Away
0x2ooo_ooo1_oooo0xoooo_oooo_oooo_oooov2 IsVoid => v0 general void => no implementation in v0
0x2ooo_ooo2_oooo0xoooo_oooo_oooo_oooov2 IsReturn/Refund => v0 general refund => no implementation in v0
0x2ooo_ooo4_oooo0xoooo_oooo_oooo_oooov2 Discount => v0 general discount => no implementation in v0
0x2ooo_oo10_oooo0xoooo_oooo_oooo_oooov2 Returnable => v0 general returnable => no implementation in v0

ftPayItemCase​

Austria (AT)
v2 (in)v0 (out)Description
0x2000_0000_00000x4154_0000_0000_0000Unknown payitem type
0x2000_oooo_oo010x4154_0000_0000_0001Cash payment
0x2000_oo1o_oo010x4154_0000_0000_0002Cash payment, in foreign currency
0x2000_oooo_oo020x4154_0000_0000_0007Non-cash payment => v0 online payment, not rksv relevant payments
0x2000_oooo_oo030x4154_0000_0000_0003Crossed check payment
0x2000_oooo_oo040x4154_0000_0000_0004Debit card payment
0x2000_oooo_oo050x4154_0000_0000_0005Credit card payment
0x2000_oooo_oo060x4154_0000_0000_0006Voucher payment
0x2000_oooo_oo070x4154_0000_0000_0007Online payment
0x2000_oooo_oo080x4154_0000_0000_0008Loyality program, customer card payment
0x2000_oooo_oo090x4154_0000_0000_000BAccounts receiveable
0x2000_oooo_oo0A0x4154_0000_0000_000CSepa wire transfer
0x2000_oooo_oo0B0x4154_0000_0000_000DOther wire/bank transer
0x2000_oooo_oo0C0x4154_0000_0000_000ETransfer to cashbook, amount negativ => v0 cashbook expense
0x2000_oooo_oo0C0x4154_0000_0000_000ETransfer to cashbook, amount positiv => v0 cashbook contribution
0x2000_oooo_oo0D0x4154_0000_0000_0011Internal / material consumption
0x2000_oooo_oo0E0x4154_0000_0000_000BGrant => v0 accounts receiveable
0x2000_oooo_oo0F0x4154_0000_0000_0006Ticket restaurant => v0 voucher
0x2000_ooo8_oo090x4154_0000_0000_0010Accounts receiveable, downpayment flag => v0 levy / downpayment
0x2000_oo2o_oo010x4154_0000_0000_0012Cash payment, change flag => v0 change / tip
0x2000_oo4o_oo010x4154_0000_0040_0012Cash payment, tip flag => v0 change / tip
France (FR)
v2 (in)v0 (out)Description
0x2000_0000_00000x4652_0000_0000_0000Unknown payitem type
0x2000_oooo_oo010x4652_0000_0000_0001Cash payment
0x2000_oo1o_oo010x4652_0000_0000_0002Cash payment, in foreign currency
0x2000_oooo_oo020x4652_0000_0000_0007Non-cash payment => v0 online payment, not rksv relevant payments
0x2000_oooo_oo030x4652_0000_0000_0003Crossed check payment
0x2000_oooo_oo040x4652_0000_0000_0004Debit card payment
0x2000_oooo_oo050x4652_0000_0000_0005Credit card payment
0x2000_oooo_oo060x4652_0000_0000_0006Voucher payment
0x2000_oooo_oo070x4652_0000_0000_0007Online payment
0x2000_oooo_oo080x4652_0000_0000_0008Loyality program, customer card payment
0x2000_oooo_oo090x4652_0000_0000_000BAccounts receiveable
0x2000_oooo_oo0A0x4652_0000_0000_000CSepa wire transfer
0x2000_oooo_oo0B0x4652_0000_0000_000DOther wire/bank transer
0x2000_oooo_oo0C0x4652_0000_0000_000ETransfer to cashbook, amount negativ => v0 cashbook expense
0x2000_oooo_oo0C0x4652_0000_0000_000ETransfer to cashbook, amount positiv => v0 cashbook contribution
0x2000_oooo_oo0D0x4652_0000_0000_0011Internal / material consumption
0x2000_oooo_oo0E0x4652_0000_0000_000BGrant => v0 accounts receiveable
0x2000_oooo_oo0F0x4652_0000_0000_0006Ticket restaurant => v0 voucher
0x2000_ooo8_oo090x4652_0000_0000_0010Accounts receiveable, downpayment flag => v0 levy / downpayment
0x2000_oo2o_oo010x4652_0000_0000_0012Cash payment, change flag => v0 change / tip
0x2000_oo4o_oo010x4652_0000_0040_0012Cash payment, tip flag => v0 change / tip
Germany (DE)
v2 (in)v0 (out)Description
0x2000_0000_00000x4445_0000_0000_0000Unknown payitem type
0x2000_oooo_oo010x4445_0000_0000_0001Cash payment
0x2000_oo1o_oo010x4445_0000_0000_0002Cash payment, in foreign currency
0x2000_oooo_oo020x4445_0000_0000_0007Non-cash payment => v0 online payment, not rksv relevant payments
0x2000_oooo_oo030x4445_0000_0000_0003Crossed check payment
0x2000_oooo_oo040x4445_0000_0000_0004Debit card payment
0x2000_oooo_oo050x4445_0000_0000_0005Credit card payment
0x2000_oooo_oo060x4445_0000_0000_000DVoucher payment
0x2000_oooo_oo070x4445_0000_0000_0006Online payment
0x2000_oooo_oo080x4445_0000_0000_0007Loyality program, customer card payment
0x2000_oooo_oo090x4445_0000_0000_000EAccounts receiveable
0x2000_oooo_oo0A0x4445_0000_0000_0008Sepa wire transfer
0x2000_oooo_oo0B0x4445_0000_0000_0009Other wire/bank transer
0x2000_oooo_oo0C0x4445_0000_0000_0012Transfer to ... [cashbook / vault / owner / employee], amount negativ, ??? MoneyGroup == "EmptyTill" => v0 cash transfer to empty till
0x2000_oooo_oo0C0x4445_0000_0000_0013Transfer to ... [cashbook / vault / owner / employee], MoneyGroup == ??? "Owner" => v0 cash transfer to owner
0x2000_oooo_oo0C0x4445_0000_0000_0014Transfer to ... [cashbook / vault / owner / employee], MoneyGroup == ??? "Till", => v0 cash transfer from/to till
0x2000_oooo_oo0C0x4445_0000_0000_0015Transfer to ... [cashbook / vault / owner / employee], MoneyGroup == ??? "Employee" => v0 cash transfer to employee
0x2000_oooo_oo0C0x4445_0000_0000_0016Transfer to ... [cashbook / vault / owner / employee], MoneyGroup == ??? "Cashbook" => v0 cash transfer from/to cashbook
0x2000_oooo_oo0C0x4445_0000_0000_0017Transfer to ... [cashbook / vault / owner / employee], MoneyGroup == ??? "CashDifference" => v0 cash difference in till
0x2000_oooo_oo0D0x4445_0000_0000_000AInternal / material consumption
0x2000_oooo_oo0E0x4445_0000_0000_0011Grant => v0 (real)grant
0x2000_oooo_oo0F0x4445_0000_0000_0006Ticket restaurant => v0 voucher
0x2000_ooo8_oo090x4445_0000_0000_000FAccounts receiveable, downpayment flag => v0 downpayment
0x2000_oo2o_oo010x4445_0000_0000_000BCash payment, change flag => v0 change
0x2000_oo3o_oo010x4445_0000_0000_000CCash payment, in foreign currency, change flag => v0 change in foreign currency
0x2000_oo4o_oo010x4445_0000_0040_0012Cash payment, tip flag => v0 tip to employee

Key differences highlighted:

  1. The base URL changes.
  2. All case numeric values must be remapped.
  3. ftReceiptCaseData is now an object keyed by market code instead of a raw string.
Important

For the ftReceiptCaseFlag, ftChargeItemCaseFlag, and ftPayItemCaseFlag fields, replace every lowercase letter o in flag values with the digit 0 (zero). Examples:

  • 0x2oo0_oo8o_2ooo → 0x2000_0080_2000
  • 0xoooo_oooo_oooo_oooo → 0x0000_0000_0000_0000

ftReceiptCaseData Format​

The ftReceiptCaseData field changes from a JSON-encoded string in v0 to a market-keyed JSON object in v2.

  • v0 format: the entire value is a JSON string embedded as a string field.
{
  "ftReceiptCase": "...",
  "ftReceiptCaseData": "{\"Code\":\"20\", \"Message\":\"Archivage fiscal de période\", \"Information\":\"\"}"
}
  • v2 format: the value is a plain JSON object with a market key ("FR", "AT", "DE") whose value is a JSON-encoded string.
{
  "ftReceiptCase": "...",
  "ftReceiptCaseData": {
    "FR": "{\"Code\": \"20\", \"Message\": \"Archivage fiscal de période\", \"Information\": \"\"}"
  }
}

Key points:

  • The outer field is now a JSON object, not a string.
  • The inner value (per market key) remains a JSON-encoded string of the market-specific payload.
  • Use the two-letter ISO market code as the key ("FR", "AT", "DE").

Examples by Market​

Austria (AT)

"ftReceiptCaseData": {
  "AT": "{\"Code\": \"20\", \"Message\": \"Jahresbeleg\", \"Information\": \"\"}"
}

France (FR)

"ftReceiptCaseData": {
  "FR": "{\"Code\": \"20\", \"Message\": \"Archivage fiscal de période\", \"Information\": \"\"}"
}

Germany (DE)

"ftReceiptCaseData": {
  "DE": "{\"Code\": \"20\", \"Message\": \"Jahresabschluss\", \"Information\": \"\"}"
}

Multi-market (combined)

"ftReceiptCaseData": {
  "AT": "{\"Code\": \"20\", \"Message\": \"Jahresbeleg\", \"Information\": \"\"}",
  "FR": "{\"Code\": \"20\", \"Message\": \"Archivage fiscal de période\", \"Information\": \"\"}"
}
warning

If ftReceiptCaseData is not needed for a particular receipt, pass an empty object ({}) or omit the field entirely. Do not pass a bare empty string ("") as the top-level value — that was valid in v0 but is no longer accepted at the outer level in v2.

The inner string value for a given market key may be an empty string ("") when no additional case data is required for that market.

ReceiptRequest​

The v2 ReceiptRequest is a superset of the v0 model. Most existing fields are directly reusable. The key differences are:

Fieldv0v2
cbReceiptReferenceOptional in some flowsRequired — must be a unique string per request
CurrencyNot presentAdded — ISO 4217 currency code (default: EUR)
DecimalPrecisionMultiplierNot presentAdded — controls integer vs. floating-point amounts (default: 1, i.e. floating-point)
ftPosSystemIDOptionalRecommended — identifies your POS software

All other fields (ftCashBoxID, cbTerminalID, cbReceiptMoment, cbChargeItems, cbPayItems, ftReceiptCase, etc.) carry over unchanged.

ReceiptResponse​

The ReceiptResponse structure is largely compatible. Verify that your receipt printing logic correctly handles:

  • ftSignatures — format and type values are unchanged; ensure all entries are printed as required by national regulations.
  • ftState — error flag interpretation is unchanged; check your error-handling code still covers all states.

Echo example​

Request:

POST /v2/echo
{
  "message": "test"
}

Response:

{
  "message": "test"
}