Body structure (JSON)

Required fields are in bold.

Field	Example	Type and format	Comments
{
"msgID"	16	int
"currency"	"UAH"	string
"totalAmount"	1200000	int	should be strictly equal to the sum of amounts of all items, and equal to the sum of amounts of all paid items
"zNumber"	4	int	shift number, should be unique for deviceID
"fiscalNum"	70113	int	optional parameter. Used only for offline cash registers
"receiptNumber"	1	int	receipt number, should be unique for the shift and deviceID
"parentFiscalNum"	3	int	fiscal number of the parent document; should be present in the database
"cashier"	"Cashier 1"	string
"dateTime"	"2026-03-02T15:35:21.076Z"	dateTime of ISO-8601 format	should be bigger than the datetime of the last document of the same shift
"location"			optional
{
"latitude"	6.500183676689106	float
"longitude"	120.76210479216934	float
"radius"	1000	int
},
"identity"
{
"fn"	"567765"	string	device token
"tin"	"1111111111"	string
"shopName"	"SHOP #1"	string
"shopAddress"	"Unknown st., 404"	string
},
}

Example:

{
  "msgID": 1656685688,
  "currency": "UAH",
  "totalAmount": 15000,
  "zNumber": 2,
  "receiptNumber": 2,
  "parentFiscalNum": "OA70604",
  "cashier": "John Doe",
  "dateTime": "2026-03-02T15:37:21.076Z",
  "location": {
    "latitude": 6.500183676689106,
    "longitude": 120.76210479216934,
    "radius": 1000
  },
  "items": [
    {
      "name": "Coca Cola 0.5L",
      "unit": "psc",
      "qty": 1000,
      "price": 15000,
      "amount": 15000,
      "taxes": [
        {
          "taxCode": "A",
          "taxRate": 2000,
          "taxBase": 12500,
          "taxAmount": 2500
        }
      ]
    }
  ],
  "payments": [
    {
      "type": "C",
      "amount": 15000,
      "change": 0
    }
  ],
  "taxTotals": [
    {
      "taxCode": "A",
      "taxRate": 2000,
      "taxAmount": 2500
    }
  ],
  "identity": {
    "fn": "SM00000144",
    "tin": "A24112025",
    "shopName": "First Shop",
    "shopAddress": "Central 11"
  }
}