Example of a request for fiscalization of a document

Example of a request for fiscalization of a document
Webhook

Request

Altegio sends this request to the fiscalization URL configured by your KKM integration; it is not an Altegio API endpoint.

Security

BearerPartnerUser

Acceptstringrequired

application/vnd.api.v2+json

Content-Typestringrequired

application/json

Authorizationstringrequired

Bearer partner_token

Bodyapplication/jsonrequired

idstring

Unique ID of the sales document

Example:"d72fece5-6825-4895-9395-0133195612a4"

datestring, (date-time)

Date and time the document was sent for printing (in ISO-8601 format)

Example:"2026-09-21T23:00:00.000-05:00"

document_idinteger, (int32)

Internal document identifier in the Altegio system

Example:239083104

typestring

Document type (list of possible values)

Enum:"sale""return"

Example:"sale"

print_receiptboolean

Whether to print a paper check at the checkout during fiscalization

Example:true

customerobject

Client entity

Example:

{
  "email": "customer@example.com",
  "phone": "+13155550175"
}

positionsArray of objects

List of positions in the check

Example:

[
  {
    "type": "service",
    "title": "Consultation",
    "price": 13.19,
    "quantity": 1,
    "discount_amount": 2.54,
    "vat": "ru_vat_10",
    "payment_method": "payment",
    "barcode": "12345"
  }
]

paymentsArray of objects

List of fees applied per check

Example:

[
  {
    "type": "card",
    "sum": 5.55
  },
  {
    "type": "cash",
    "sum": 4.55
  },
  {
    "type": "prepaid",
    "sum": 0.55
  }
]

taxstring

Type of taxation system (slug from the list of taxation systems)

Example:"ru_osn"

cashierobject

The Essence of a Cashier

Example:

{
  "uid": "4895-9395-0133195612a4",
  "name": "John Smith",
  "position": "Cashier"
}

posobject

Options for the connected POS terminal

Example:

{
  "enabled": true,
  "slip_count": 2
}

callback_urlstring

Link to update fiscal status

Example:"https://app.alteg.io/api/v1/integration/kkm/callback/"

custom_textstring

Arbitrary text for printing on a receipt

Example:"some custom text"

Payload

{
  "id": "d72fece5-6825-4895-9395-0133195612a4",
  "date": "2026-09-21T23:00:00.000-05:00",
  "document_id": 239083104,
  "type": "sale",
  "print_receipt": true,
  "customer": {
    "email": "customer@example.com",
    "phone": "+13155550175"
  },
  "positions": [
    { … }
  ],
  "payments": [
    { … },
    { … },
    { … }
  ],
  "tax": "ru_osn",
  "cashier": {
    "uid": "4895-9395-0133195612a4",
    "name": "John Smith",
    "position": "Cashier"
  },
  "pos": {
    "enabled": true,
    "slip_count": 2
  },
  "callback_url": "https://app.alteg.io/api/v1/integration/kkm/callback/",
  "custom_text": "some custom text"
}

Responses

OK

Bodyapplication/json

Response

{
  "id": "d72fece5-6825-4895-9395-0133195612a4",
  "status": "success",
  "code": 0,
  "message": "OK"
}