Greece-PayItemCase

Country selector

Understanding ftPayItemCase

The ftPayItemCase in the ‘cbPayItems’ object indicates the type of payment within the pay items block and defines how the Viva Fiscalisation processes the individual payment in terms of the receipt. The data type is Int64 and contains a country specific code which is a value following the ISO-3166-1-ALPHA-2 standard, converted from ASCII into hex and used as byte 8 and 7.

CCCC_vlll_gggg_xxPP

• CCCC – Country (ASCII of ISO 3166-1 alpha-2), e.g. GR → hex 4752
• vlll – Tagging version (current: 2000)
• gggg – Flag can change the basic behavior of a given type, but will live the overall semantical meaning of a type the same. (e.g. voiding of a receipt)
• xx= 00 | The first part of the xxPP section should be ever 00
• PP – payment type

Send the decimal Int64 in the API. Examples below show the human-readable hex; convert to decimal before sending.

cbPayItems (fields — common)

cbPayItems Array

cbPayItems array holds the payment details that the invoice includes.

Flag (gggg) — common

PP — Payment Type (per-country)

The PP code meaning is common, but specific notes / usage differ per country.
Choose a country above; only that country’s PP table will be shown.

Examples (per-country)

Each example shows: (a) the human-readable pattern, (b) what it means, and (c) the value you send to the API (decimal Int64).

{
  "cbPayItems": [
    {
      "amount": 400,
      "description": "Card",
      "position": 1,
      "currencyCode": "978",
      "moment": "2025-04-24T13:13:28Z",
      "ftPayItemCase": 5139205309155246084
    }
  ]
}

{
  "cbPayItems": [
    {
      "amount": 400,
      "description": "Card",
      "position": 1,
      "currencyCode": "978",
      "moment": "2025-04-24T13:13:28Z",
      "ftPayItemCase": 5283883447184523268
    }
  ]
}

{
  "cbPayItems": [
    {
      "amount": 400,
      "description": "Card",
      "position": 1,
      "currencyCode": "978",
      "moment": "2025-04-24T13:13:28Z",
      "ftPayItemCase": 4995371596056100868
    }
  ]
}

{
  "cbPayItems": [
    {
      "amount": 400,
      "description": "Card",
      "position": 1,
      "currencyCode": "978",
      "moment": "2025-04-24T13:13:28Z",
      "ftPayItemCase": 5788286605450018820
    }
  ]
}

{
  "cbPayItems": [
    {
      "amount": 400,
      "description": "Card",
      "position": 1,
      "currencyCode": "978",
      "moment": "2025-04-24T13:13:28Z",
      "ftPayItemCase": 4919373352344223748
    }
  ]
}

{
  "cbPayItems": [
    {
      "amount": 400,
      "description": "Card",
      "position": 1,
      "currencyCode": "978",
      "moment": "2025-04-24T13:13:28Z",
      "ftPayItemCase": 5067147715117318148
    }
  ]
}

{
  "cbPayItems": [
    {
      "amount": 400,
      "description": "Card",
      "position": 1,
      "currencyCode": "978",
      "moment": "2025-04-24T13:13:28Z",
      "ftPayItemCase": 4707422694881099780
    }
  ]
}

Conversion reminder

All CCCC_vlll_… show the human-friendly hex. Always send decimal Int64 in the API.