User authentication and session management for B2B integrations
Business Management (1.0.0)
Full-featured B2B API for business operations.
Base URL: https://api.alteg.io/api
V1 will be gradually deprecated. We recommend using V2 API for new integrations. V1 endpoints are maintained for backward compatibility, but new features will be released in V2 only.
Download OpenAPI description
Overview
Languages
Servers
Mock server
https://developer.alteg.io/_mock/en/b2b-v1/openapi/
Production
https://api.alteg.io/api/v1/
Request
Types of all transactions with location account
| Meaning | Description |
|---|---|
| 0 | Sale operation (active for documents with types "Visit" and "Client account replenishment") |
| 1 | Sale return operation (active for documents with types "Visit" and "Client account replenishment") |
| 2 | Correction operation |
| 4 | Shift opening operation – Opens a new POS shift |
| 5 | Shift closing operation – Closes the current POS shift |
| 9 | Get POS status – Retrieves the current status of the POS device |
| 11 | Get POS team status – Retrieves the status of all POS devices connected to the team |
| 12 | Correction operation |
| 13 | Print X-report – Prints a non-fiscal summary report of the current shift |
| 6 | Cash deposit – Registers a cash-in transaction in the POS |
| 7 | Cash withdrawal – Registers a cash-out transaction in the POS |
Document Types
| Meaning | Description |
|---|---|
| 1 | Sale of products |
| 2 | Provision of services |
| 3 | Arrival of products |
| 4 | Products write-off |
| 5 | Transfer of products |
| 6 | Inventory |
| 7 | Visit |
| 8 | Consumables write-off |
| 9 | Client account replenishment |
Security
BearerPartnerUser
- Mock serverhttps://developer.alteg.io/_mock/en/b2b-v1/openapi/kkm_transactions/{location_id}/print_document_bill
- Productionhttps://api.alteg.io/api/v1/kkm_transactions/{location_id}/print_document_bill
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
'https://developer.alteg.io/_mock/en/b2b-v1/openapi/kkm_transactions/{location_id}/print_document_bill' \
-H 'Accept: application/vnd.api.v2+json' \
-H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>' \
-H 'Content-Type: */*' \
-d '[object Object]'OK
Array of objects with data
Example: {"kkm_type":0,"kkm_transactions":[{"id":1954,"print_date":"2026-09-21T23:00:00.000-05:00","printed_count":0,"sum":0,"type":{"id":0,"title":"Sale operation"},"status":{"id":2,"title":"Sent for printing"},"document":{"id":164,"type":9,"type_title":"Deposit replenishment"},"cashier":{"id":1138453,"name":"Jack Smith"}}],"status":2,"bill_json":[{}]}
Response
application/json
{ "success": true, "data": { "kkm_type": 0, "kkm_transactions": [ … ], "status": 2, "bill_json": [ … ] }, "meta": [] }
Request
A list of tax systems and VAT available for a country can be obtained by requesting the country ID for which the list is to be obtained. The country ID can be obtained from list of countries.
The list is an array of tax systems with a nested VAT array for each tax system.
The taxation system has the following structure:
| Field | Type | Description |
|---|---|---|
| title | string | Name of taxation system |
| slug | string | Code name for the taxation system |
| vats | Array of objects(Vat[]) | List of available VAT for the taxation system |
VAT has the following structure:
| Field | Type | Description |
|---|---|---|
| title | string | Title VAT |
| slug | string | Code name VAT |
Security
BearerPartnerUser
- Mock serverhttps://developer.alteg.io/_mock/en/b2b-v1/openapi/integration/kkm/references/tax_system/{country_id}
- Productionhttps://api.alteg.io/api/v1/integration/kkm/references/tax_system/{country_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://developer.alteg.io/_mock/en/b2b-v1/openapi/integration/kkm/references/tax_system/1 \
-H 'Accept: application/vnd.api.v2+json' \
-H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>' \
-H 'Content-Type: string'OK
Array of objects with data
Example: [{"title":"General DOS","slug":"ru_osn","vats":[{"title":"0%","slug":"ru_vat_0"},{"title":"10%","slug":"ru_vat_10"},{"title":"20%","slug":"ru_vat_20"},{"title":"is not a subject to a tax","slug":"ru_vat_none"}]},{"title":"Simplified simplified tax system (Income)","slug":"ru_usn","vats":[{"title":"is not a subject to a tax","slug":"ru_vat_none"}]},{"title":"Simplified simplified tax system (Income minus Expense)","slug":"ru_usnr","vats":[{"title":"is not a subject to a tax","slug":"ru_vat_none"}]},{"title":"Single tax on imputed income UTII","slug":"ru_envd","vats":[{"title":"is not a subject to a tax","slug":"ru_vat_none"}]},{"title":"Unified agricultural tax UST","slug":"ru_esn","vats":[{"title":"is not a subject to a tax","slug":"ru_vat_none"}]},{"title":"Patent taxation system","slug":"ru_psn","vats":[{"title":"is not a subject to a tax","slug":"ru_vat_none"}]}]
Response
application/json
{ "success": true, "data": [ { … }, { … }, { … }, { … }, { … }, { … } ], "meta": { "count": 6 } }
- Mock serverhttps://developer.alteg.io/_mock/en/b2b-v1/openapi/integration/kkm/callback
- Productionhttps://api.alteg.io/api/v1/integration/kkm/callback
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://developer.alteg.io/_mock/en/b2b-v1/openapi/integration/kkm/callback \
-H 'Accept: application/vnd.api.v2+json' \
-H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>' \
-H 'Conetnt-Type: string' \
-H 'Content-Type: application/json' \
-d '{}'