Emehmon Sync API Documentation

Introduction

This API gives you access to all the features of Emehmon Sync programmatically.

Base URL: https://api.emehmon.uz

This documentation aims to provide all the information you need to work with our API.

**Xizmat Safari (XF) API** — отдельный сервис (бронирование госкомандировок, интеграция МВД ↔ E-mehmon) со своей документацией: https://sandbox-api.emehmon.uz/sandbox/xf/docs

## Authentication (HMAC)
Every request must include these headers:
    - `X-User-Name`: API username
    - `X-User-Ts`: Unix timestamp (seconds)
    - `X-User-Request-Id`: UUID (required, unique)
    - `X-User-Hash`: hex HMAC-SHA256 signature

Signature formula:
`X-User-Hash = HMAC_SHA256( X-User-Name + X-User-Ts + X-User-Request-Id, secret )`

Notes:
- TTL is 5 minutes (server rejects old timestamps)
- Replay protection is enabled using `(username, timestamp, request_id)`

---

## Response format

### Success
```json
{
    "code": 200,
    "message": "success",
    "data": {},
    "request_id": "uuid"
}

## Error
```json
{
  "code": 401,
  "message": "Request time expired",
  "error_code": "REQUEST_TIME_EXPIRED",
  "meta": {},
  "request_id": "uuid"
}
```
"meta" may contain validation details (e.g. { "field": "date" }).

## Errors
| HTTP | error_code             | When                                            |
| ---: | ---------------------- | ----------------------------------------------- |
|  401 | `MISSING_AUTH_HEADERS` | Required auth headers are missing               |
|  401 | `INVALID_TIMESTAMP`    | `X-User-Ts` is not numeric                      |
|  401 | `REQUEST_TIME_EXPIRED` | Timestamp is outside TTL window                 |
|  401 | `INVALID_REQUEST_ID`   | `X-User-Request-Id` is invalid format           |
|  403 | `USER_NOT_FOUND`       | Username not found or inactive                  |
|  403 | `IP_DENY`              | Client IP not in `allowed_ips` (if enabled)     |
|  403 | `REPLAY_ATTACK`        | Duplicate `(username, timestamp, request_id)`   |
|  403 | `INVALID_SIGNATURE`    | `X-User-Hash` does not match expected signature |
|  403 | `ACCESS_DENIED`        | User has no permission for this action          |
|  404 | `ROUTE_NOT_FOUND`      | Unknown path — check the URL against the list   |
|  405 | `METHOD_NOT_ALLOWED`   | Wrong HTTP method (e.g. `GET` instead of `POST`) |
|  422 | `VALIDATION_ERROR`     | Request body validation failed                  |
|  500 | `INTERNAL_ERROR`       | Unhandled server error                          |

Authenticating requests

This API is not authenticated.

CRM Hotel API

Хеш-версии справочников — чтобы понять, нужно ли перечитывать содержимое.

GET

https://api.emehmon.uz

/sync/v1/crm/dictionaries-meta

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Headers

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/crm/dictionaries-meta" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "locale": "ru",
        "known": [
            "countries",
            "regions",
            "districts",
            "room-types",
            "visit-types",
            "guest-types",
            "passport-types",
            "visa-types",
            "payment-types"
        ],
        "versions": {
            "countries": {
                "version": "0563a7d5a3cf",
                "count": 250
            },
            "regions": {
                "version": "423847f4b3bc",
                "count": 14
            },
            "room-types": {
                "version": "5709ead1a80e",
                "count": 6
            },
            "visit-types": {
                "version": "1c9f0b2d7e41",
                "count": 4
            },
            "guest-types": {
                "version": "8e2a6f1b3c05",
                "count": 5
            },
            "passport-types": {
                "version": "b7d4e9a2c611",
                "count": 8
            },
            "visa-types": {
                "version": "d3f8a1c5e972",
                "count": 12
            },
            "payment-types": {
                "version": "f19c4b7e2a38",
                "count": 6
            }
        }
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Справочник по имени. Локализация — `Accept-Language: ru | uz | en`. Только `districts` поддерживает фильтр `?region_id=`.

GET

https://api.emehmon.uz

/sync/v1/crm/dictionaries/{name}

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

URL Parameters

name

string

required

Имя справочника: countries, regions, districts, room-types, visit-types, guest-types, passport-types, visa-types, payment-types.

Example:

countries

Query Parameters

region_id

integer

Только для districts — фильтр по региону.

Example:

1726

Headers

URL Parameters

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/crm/dictionaries/countries?region_id=1726" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "name": "countries",
        "locale": "ru",
        "count": 2,
        "items": [
            {
                "id": 173,
                "name": "Узбекистан",
                "code": "UZB"
            },
            {
                "id": 231,
                "name": "Без гражданства",
                "code": ""
            }
        ]
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Карточка вашей гостиницы: реквизиты, лицензия, депозит и флаг `can_register_listok` с причинами блокировки.

GET

https://api.emehmon.uz

/sync/v1/crm/hotel

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Headers

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/crm/hotel" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "hotel_id": 1234,
        "name": "Hotel Example",
        "inn": "300123456",
        "stars": 4,
        "address": "Tashkent, Amir Temur 1",
        "region_id": 1726,
        "district_id": 1726269,
        "phone": "+998 71 200 00 00",
        "email": "info@example.uz",
        "manager": "Иванов И.И.",
        "license": {
            "number": "TR-12345",
            "expires_at": "2027-12-31",
            "is_valid": true
        },
        "deposit": 4500000,
        "can_register_listok": true,
        "blocking_reasons": []
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Список номеров гостиницы с типами. `room_type_name` локализуется по `Accept-Language`.

GET

https://api.emehmon.uz

/sync/v1/crm/hotel/rooms

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Headers

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/crm/hotel/rooms" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "count": 2,
        "items": [
            {
                "id": 1011,
                "room_number": "101",
                "room_type_id": 1,
                "room_type_name": "Стандарт"
            },
            {
                "id": 1012,
                "room_number": "201",
                "room_type_id": 2,
                "room_type_name": "Люкс"
            }
        ]
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Действующий прайс: одна запись на `room_type_id` (самая свежая).

GET

https://api.emehmon.uz

/sync/v1/crm/hotel/prices

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Headers

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/crm/hotel/prices" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "count": 1,
        "items": [
            {
                "price_id": 8821,
                "room_type_id": 1,
                "room_type_name": "Стандарт",
                "beds": 2,
                "capacity": 2,
                "uzs": 450000,
                "usd": 38,
                "uzs_noresident": 550000,
                "usd_noresident": 48,
                "breakfast": true,
                "dt": "2026-05-01",
                "created_at": "2026-05-01 09:15:32"
            }
        ]
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Список фото гостиницы: главное (`is_main`) первым, затем по убыванию `id`.

GET

https://api.emehmon.uz

/sync/v1/crm/hotel/photos

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Headers

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/crm/hotel/photos" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "count": 1,
        "items": [
            {
                "photo_id": 5577,
                "filename": "123_661b3a8f4c12d.png",
                "storage_path": "hotelimages/123_661b3a8f4c12d.png",
                "room_type_id": 1,
                "is_main": true,
                "created_at": "2026-05-22 13:45:10"
            }
        ]
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Обновление прайса (batch). Каждый элемент создаёт новую запись; действующая цена — самая свежая по room_type_id.

PUT

https://api.emehmon.uz

/sync/v1/crm/hotel/prices

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Body Parameters

items

object[]

required

Массив цен (1..50). Каждая запись — новая строка истории в tb_room_prices; действует самая свежая на пару (гостиница, тип номера). Количество элементов в поле value должно быть не менее 1. Количество элементов в поле value не может превышать 50.

room_type_id

integer

required

Значение поля value должно быть не менее 1.

Example:

uzs

number

Значение поля value должно быть не менее 0.

Example:

usd

number

Значение поля value должно быть не менее 0.

Example:

uzs_noresident

number

Значение поля value должно быть не менее 0.

Example:

usd_noresident

number

Значение поля value должно быть не менее 0.

Example:

beds

integer

Значение поля value должно быть не менее 1. Значение поля value не может превышать 20.

Example:

capacity

integer

Значение поля value должно быть не менее 1. Значение поля value не может превышать 20.

Example:

breakfast

boolean

Example:

true

Headers

Body

{ "items": [ { "room_type_id": 16, "uzs": 39, "usd": 84, "uzs_noresident": 12, "usd_noresident": 77, "beds": 5, "capacity": 13, "breakfast": true } ] }

Received response

Example request:

curl --request PUT \
    "https://api.emehmon.uz/sync/v1/crm/hotel/prices" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH" \
    --data "{
    \"items\": [
        {
            \"room_type_id\": 16,
            \"uzs\": 39,
            \"usd\": 84,
            \"uzs_noresident\": 12,
            \"usd_noresident\": 77,
            \"beds\": 5,
            \"capacity\": 13,
            \"breakfast\": true
        }
    ]
}"

Загрузка одного фото гостиницы (multipart/form-data).

POST

https://api.emehmon.uz

/sync/v1/crm/hotel/photos

Headers

Example:

application/json

Content-Type

Example:

multipart/form-data

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Body Parameters

photo

file

required

Файл изображения: jpeg или png, размером ≤ 2 MB. Must be a file. Поле value должно содержать изображение. Размер файла в поле value не может превышать 2048 Кбайт.

Example:

/tmp/php2nQaGY

room_type_id

integer

ID типа номера, к которому относится фото (необязательно). Значение поля value должно быть не менее 1.

Example:

is_main

boolean

Сделать фото основным для гостиницы (предыдущее основное сбрасывается).

Example:

false

Headers

Body

Received response

Example request:

curl --request POST \
    "https://api.emehmon.uz/sync/v1/crm/hotel/photos" \
    --header "Accept: application/json" \
    --header "Content-Type: multipart/form-data" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH" \
    --form "room_type_id=1"\
    --form "is_main="\
    --form "photo=@/tmp/php2nQaGY"

DELETE sync/v1/crm/hotel/photos/{id}

DELETE

https://api.emehmon.uz

/sync/v1/crm/hotel/photos/{id}

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

URL Parameters

string

required

The ID of the photo.

Example:

564

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.emehmon.uz/sync/v1/crm/hotel/photos/564" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Может ли гостиница регистрировать листовки (статус, лицензия, депозит).

GET

https://api.emehmon.uz

/sync/v1/crm/listok/check-can-create

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Headers

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/crm/listok/check-can-create" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "can_create": true,
        "blocking_reasons": [],
        "deposit": 4500000,
        "license_expires_at": "2027-12-31",
        "deposit_alert": null
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Pre-flight проверка на дубликаты по паспорту.

POST

https://api.emehmon.uz

/sync/v1/crm/listok/check-duplicate

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Body Parameters

passportNumber

string

required

Серия и номер паспорта для проверки активной листовки в этой и других гостиницах. Количество символов в поле value не может превышать 50.

Example:

AB1234567

Headers

Body

{ "passportNumber": "AB1234567" }

Received response

Example request:

curl --request POST \
    "https://api.emehmon.uz/sync/v1/crm/listok/check-duplicate" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH" \
    --data "{
    \"passportNumber\": \"AB1234567\"
}"

Поиск гостя во внешних базах до регистрации листовки. Ветку выбирает `id_citizen`: - иностранец → база Погран.Службы, ответ содержит `person_id` и визовые поля; - местный (173 — UZ, 231 — БГ) → база МВД по связке `passportNumber` + `datebirth`, ответ содержит `pinfl`, ФИО, пол, дату выдачи паспорта и место рождения. Метода «ПИНФЛ по одному номеру паспорта» не существует — дата рождения нужна как второй ключ поиска. Не найден местный — 422 `PERSON_NOT_FOUND_IN_MVD`, не найден иностранец — 422 `PERSON_NOT_FOUND_IN_SGB`. Ограничения строже, чем у остальных методов — он отдаёт ПИНФЛ и ФИО: 15 запросов в минуту и 300 в сутки на гостиницу (429 `TOO_MANY_REQUESTS` с `meta.scope: "person_lookup"`), а серия подряд идущих «не найден» временно закрывает метод — 429 `LOOKUP_TEMPORARILY_BLOCKED` с `meta.retry_after`. Блокируется только поиск: регистрация и выселение работают как обычно. Если реальный поток заселений упирается в лимит — напишите нам, поднимем пороги.

POST

https://api.emehmon.uz

/sync/v1/crm/listok/person-lookup

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Body Parameters

passportNumber

string

required

Серия и номер документа без пробелов — как у иностранца, так и у гражданина УзБ. Количество символов в поле value не может превышать 50.

Example:

AB1234567

datebirth

string

required

Дата рождения, ISO 8601 (YYYY-MM-DD). Обязательна: для местных это второй ключ поиска в базе МВД. Поле value должно содержать корректную дату.

Example:

1990-05-15

id_citizen

integer

required

Код гражданства из справочника /dictionaries/countries. 173 (UZ) и 231 (БГ) отправляют запрос в базу МВД (ответ с pinfl), остальные — в базу Погран.Службы (ответ с person_id).

Example:

Headers

Body

{ "passportNumber": "AB1234567", "datebirth": "1990-05-15", "id_citizen": 76 }

Received response

Example request:

curl --request POST \
    "https://api.emehmon.uz/sync/v1/crm/listok/person-lookup" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH" \
    --data "{
    \"passportNumber\": \"AB1234567\",
    \"datebirth\": \"1990-05-15\",
    \"id_citizen\": 76
}"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "pinfl": "31234567890123",
        "surname": "NASIROV",
        "firstname": "AXROR",
        "lastname": "IBRAGIMOVICH",
        "datebirth": "1987-08-16",
        "sex": "M",
        "datePassport": "2018-07-18",
        "passportIssuedBy": "ТОШКЕНТ ШАҲАР ЯККАСАРОЙ ТУМАН ИИБ",
        "birthPlace": "TOSHKENT SHAHRI",
        "source": "mvd"
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Список листовок гостиницы с фильтрами. Сортировка — `id DESC`. Текущие проживающие (то же множество, что «текущие зарегистрированные» в кабинете emehmon.uz): `?active=1` — листовки без выселения (`dateVisitOff IS NULL`). Для сверки с PMS выгружайте страницами: `?active=1&per_page=200&page=N`, число страниц — `ceil(total / per_page)`.

GET

https://api.emehmon.uz

/sync/v1/crm/listok

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Query Parameters

date_from

string

Фильтр: дата заселения от (Y-m-d). Must be a valid date in the format Y-m-d.

Example:

2026-05-01

date_to

string

Фильтр: дата заселения до (Y-m-d), не раньше date_from. Must be a valid date in the format Y-m-d. В поле value должна быть дата после или равная date_from.

Example:

2026-05-31

passport

string

Фильтр по серии/номеру паспорта. Количество символов в поле value не может превышать 50.

Example:

AB1234567

surname

string

Фильтр по фамилии (частичное совпадение). Количество символов в поле value не может превышать 100.

Example:

Каримов

active

boolean

1 — только активные (не выселенные, dateVisitOff IS NULL) листовки; 0 — только выселенные. То же множество, что «текущие зарегистрированные» в кабинете.

Example:

true

page

integer

Номер страницы (с 1). Значение поля value должно быть не менее 1.

Example:

per_page

integer

Размер страницы (1..200, по умолчанию 50). Значение поля value должно быть не менее 1. Значение поля value не может превышать 200.

Example:

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/crm/listok?date_from=2026-05-01&date_to=2026-05-31&passport=AB1234567&surname=%D0%9A%D0%B0%D1%80%D0%B8%D0%BC%D0%BE%D0%B2&active=1&page=1&per_page=50" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "total": 1,
        "page": 1,
        "per_page": 50,
        "items": [
            {
                "listok_id": 8826912,
                "regNum": "1726-2026-00012345",
                "surname": "MUSTERMANN",
                "firstname": "MAX",
                "lastname": null,
                "pinfl": null,
                "id_citizen": 5,
                "id_country": 5,
                "id_countryFrom": 5,
                "id_passporttype": 1,
                "id_visittype": 2,
                "id_guest": 1,
                "id_person": "1234567890",
                "id_visatype": 3,
                "passportNumber": "C01X00T47",
                "datePassport": "2021-03-15",
                "datebirth": "1985-07-12",
                "sex": "M",
                "datevisiton": "2026-08-30 14:30:00",
                "datevisitoff": null,
                "wdays": 3,
                "lived_days": null,
                "propiska": "101",
                "room_type_id": 1,
                "visaNumber": null,
                "dateVisaOn": null,
                "dateVisaOff": null,
                "kppNumber": null,
                "dateKPP": null,
                "amount": null,
                "payed": 0,
                "paytp": null,
                "summa": null,
                "real_summa": null,
                "real_days": null,
                "registered_via": 2,
                "created_at": "2026-08-30 14:30:12",
                "updated_at": "2026-08-30 14:30:12"
            }
        ]
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Карточка одной листовки. 404 если не существует; 403 если в другой гостинице.

GET

https://api.emehmon.uz

/sync/v1/crm/listok/{id}

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

URL Parameters

integer

required

listok_id из списка.

Example:

8826912

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/crm/listok/8826912" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "listok_id": 8826912,
        "regNum": "1726-2026-00012345",
        "surname": "MUSTERMANN",
        "firstname": "MAX",
        "lastname": null,
        "pinfl": null,
        "id_citizen": 5,
        "id_country": 5,
        "id_countryFrom": 5,
        "id_passporttype": 1,
        "id_visittype": 2,
        "id_guest": 1,
        "id_person": "1234567890",
        "id_visatype": 3,
        "passportNumber": "C01X00T47",
        "datePassport": "2021-03-15",
        "datebirth": "1985-07-12",
        "sex": "M",
        "datevisiton": "2026-08-30 14:30:00",
        "datevisitoff": null,
        "wdays": 3,
        "lived_days": null,
        "propiska": "101",
        "room_type_id": 1,
        "visaNumber": null,
        "dateVisaOn": null,
        "dateVisaOff": null,
        "kppNumber": null,
        "dateKPP": null,
        "amount": null,
        "payed": 0,
        "paytp": null,
        "summa": null,
        "real_summa": null,
        "real_days": null,
        "registered_via": 2,
        "created_at": "2026-08-30 14:30:12",
        "updated_at": "2026-08-30 14:30:12"
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Регистрация (заселение) гостя. Для граждан УзБ и БГ (`id_citizen` 173 / 231) `pinfl` можно не присылать: система сама поищет человека в базе МВД по `passportNumber` + `datebirth`. Нашли — регистрация проходит, найденные данные приходят в `resolved_person` (у гостя с присланным `pinfl` и у иностранца там `null`). Не нашли — 422 `PINFL_REQUIRED_FOR_LOCAL` с `meta.pinfl_lookup_attempted = true`.

POST

https://api.emehmon.uz

/sync/v1/crm/listok

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Body Parameters

surname

string

required

Фамилия — латиницей, как в машиночитаемой зоне паспорта. Количество символов в поле value не может превышать 50.

Example:

MUSTERMANN

firstname

string

required

Имя — латиницей, как в машиночитаемой зоне паспорта. Количество символов в поле value не может превышать 50.

Example:

MAX

lastname

string

Отчество, если есть в документе. Если не передано — сохраняется как "XXX". Количество символов в поле value не может превышать 50.

Example:

ERWIN

id_citizen

integer

required

Гражданство: id из справочника /dictionaries/countries. Определяет ветку обязательных полей: 173 (UZ) и 231 (БГ) — «местные», требуют pinfl; все остальные — иностранцы, требуют id_person. Значение поля value должно быть не менее 1.

Example:

passportNumber

string

required

Серия и номер документа без пробелов. В паре с гостиницей проверяется на активный дубль — 422 LISTOK_DUPLICATE_ACTIVE. Количество символов в поле value не может превышать 50.

Example:

C01X00T47

datePassport

string

required

Дата выдачи документа, ISO 8601 (YYYY-MM-DD). Должна быть строго позже datebirth — иначе 422 PASSPORT_DATE_BEFORE_BIRTHDAY. Must be a valid date in the format Y-m-d.

Example:

2021-03-15

datebirth

string

required

Дата рождения, ISO 8601 (YYYY-MM-DD). Must be a valid date in the format Y-m-d.

Example:

1985-07-12

datevisiton

string

required

Дата и время фактического заселения, ISO 8601 datetime. Время местное, ташкентское (UTC+5): сервер не переводит часовые пояса и записывает присланные часы и минуты как есть, поэтому пересчитывать время в UTC нельзя — заезд запишется на 5 часов раньше. От этого значения считаются срок проживания и турсбор. Принимается только в интервале от 12 часов назад до текущего момента; будущее время не принимается. Вне интервала — 422 CHECKIN_DATE_OUT_OF_WINDOW, границы приходят в meta.min_allowed и meta.max_allowed. Некорректный формат — 422 VALIDATION_ERROR с meta.field = datevisiton. Поле value должно содержать корректную дату.

Example:

2026-05-22T14:30:00+05:00

wdays

integer

required

Планируемое число суток проживания (1..365). Фактический срок пересчитывается при выселении. Значение поля value должно быть не менее 1. Значение поля value не может превышать 365.

Example:

sex

string

required

Пол: M — мужской, W — женский.

Must be one of:

Example:

id_visittype

integer

required

Цель визита: id из справочника /dictionaries/visit-types. Значение поля value должно быть не менее 1.

Example:

id_guest

integer

required

Тип гостя: id из справочника /dictionaries/guest-types. Значение поля value должно быть не менее 1.

Example:

id_person

string

Идентификатор лица в системе Погран.Службы — СТРОКА (число тоже принимается и приводится к строке). ОБЯЗАТЕЛЕН для иностранцев (id_citizen ∉ {173, 231}) — иначе 422 PERSON_ID_REQUIRED_FOR_FOREIGNER. Получают заранее через POST /listok/person-lookup, где то же значение приходит в поле person_id числом. Дополнительно проверяется в Погран.Службе: если person_id не подтверждён — 422 PERSON_NOT_FOUND_IN_SGB. Количество символов в поле value не может превышать 255.

Example:

12345

propiska

string

Номер комнаты, в которую заселён гость. Список номеров гостиницы — GET /hotel/rooms. Количество символов в поле value не может превышать 50.

Example:

101

id_country

integer

Страна рождения: id из /dictionaries/countries. Если не передано — подставляется id_citizen. Значение поля value должно быть не менее 1.

Example:

id_countryFrom

integer

Страна прибытия (откуда приехал гость): id из /dictionaries/countries. Если не передано — подставляется id_citizen. Значение поля value должно быть не менее 1.

Example:

id_passporttype

integer

Тип документа: id из /dictionaries/passport-types. По умолчанию 1 (паспорт). Значение 2 (военный билет) снимает требование pinfl для местных. Значение поля value должно быть не менее 1.

Example:

passportIssuedBy

string

Орган, выдавший документ (свободный текст). Количество символов в поле value не может превышать 255.

Example:

Bundesdruckerei

pinfl

string

ПИНФЛ (14 цифр). Нужен для местных граждан (id_citizen ∈ {173 — UZ, 231 — БГ}), кроме военного билета (id_passporttype=2). Если не прислать, система сама попробует найти человека в базе МВД по связке passportNumber + datebirth: нашли — регистрация проходит и найденные данные возвращаются в поле resolved_person ответа; не нашли — 422 PINFL_REQUIRED_FOR_LOCAL. Можно прислать отдельным полем, даже если основной документ не паспорт (напр. водительские права). Количество символов в поле value не может превышать 14.

Example:

31234567890123

amount

number

Сумма проживания в UZS, если гостиница ведёт её в CRM. На расчёт турсбора не влияет — он считается при выселении. Значение поля value должно быть не менее 0.

Example:

1350000

lived_days

integer

Фактически прожитые сутки, если известны заранее. Обычно не передаётся: заполняется при выселении. Значение поля value должно быть не менее 0.

Example:

payed

integer

Признак оплаты проживания: 0 — не оплачено, 1 — оплачено. Значение поля value должно быть не менее 0.

Example:

id_visatype

integer

Тип визы: id из /dictionaries/visa-types. Для безвизовых гражданств не передаётся. Значение поля value должно быть не менее 0.

Example:

visaNumber

string

Номер визы. Количество символов в поле value не может превышать 50.

Example:

V1234567

dateVisaOn

string

Дата начала действия визы, ISO 8601 (YYYY-MM-DD). Must be a valid date in the format Y-m-d.

Example:

2026-05-01

dateVisaOff

string

Дата окончания действия визы, ISO 8601 (YYYY-MM-DD). Must be a valid date in the format Y-m-d.

Example:

2026-06-01

visaIssuedBy

string

Орган, выдавший визу (свободный текст). Количество символов в поле value не может превышать 255.

Example:

Consulate of Uzbekistan in Berlin

kppNumber

string

Номер КПП пересечения границы. Для гостиничной листовки необязателен (в отличие от self-listok). Количество символов в поле value не может превышать 50.

Example:

KPP-12345

dateKPP

string

Дата пересечения границы, ISO 8601 (YYYY-MM-DD). Must be a valid date in the format Y-m-d.

Example:

2026-05-20

bookingId

integer

ID брони в emehmon.uz, если заселение идёт по существующей брони. Сами брони через API не создаются. Значение поля value должно быть не менее 1.

Example:

45012

children

object[]

Дети, проживающие с гостем по его документу. Каждый элемент — {full_name, gen, birth_day}.

crm_actor_id

string

ID сотрудника CRM, проводящего регистрацию. Информационная метка для аудита — мы её не проверяем. Количество символов в поле value не может превышать 64.

Example:

op-42

crm_actor_name

string

ФИО сотрудника CRM, проводящего регистрацию. Информационная метка для аудита — мы её не проверяем. Количество символов в поле value не может превышать 120.

Example:

Анвар Хамракулов

Headers

Body

{ "surname": "MUSTERMANN", "firstname": "MAX", "lastname": "ERWIN", "id_citizen": 76, "passportNumber": "C01X00T47", "datePassport": "2021-03-15", "datebirth": "1985-07-12", "datevisiton": "2026-05-22T14:30:00+05:00", "wdays": 3, "sex": "M", "id_visittype": 2, "id_guest": 1, "id_person": "12345", "propiska": "101", "id_country": 76, "id_countryFrom": 76, "id_passporttype": 1, "passportIssuedBy": "Bundesdruckerei", "pinfl": "31234567890123", "amount": 1350000, "lived_days": 0, "payed": 0, "id_visatype": 3, "visaNumber": "V1234567", "dateVisaOn": "2026-05-01", "dateVisaOff": "2026-06-01", "visaIssuedBy": "Consulate of Uzbekistan in Berlin", "kppNumber": "KPP-12345", "dateKPP": "2026-05-20", "bookingId": 45012, "children": [ { "full_name": "b", "gen": "W", "birth_day": "2026-09-22" } ], "crm_actor_id": "op-42", "crm_actor_name": "\u0410\u043d\u0432\u0430\u0440 \u0425\u0430\u043c\u0440\u0430\u043a\u0443\u043b\u043e\u0432" }

Received response

Example request:

curl --request POST \
    "https://api.emehmon.uz/sync/v1/crm/listok" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH" \
    --data "{
    \"surname\": \"MUSTERMANN\",
    \"firstname\": \"MAX\",
    \"lastname\": \"ERWIN\",
    \"id_citizen\": 76,
    \"passportNumber\": \"C01X00T47\",
    \"datePassport\": \"2021-03-15\",
    \"datebirth\": \"1985-07-12\",
    \"datevisiton\": \"2026-05-22T14:30:00+05:00\",
    \"wdays\": 3,
    \"sex\": \"M\",
    \"id_visittype\": 2,
    \"id_guest\": 1,
    \"id_person\": \"12345\",
    \"propiska\": \"101\",
    \"id_country\": 76,
    \"id_countryFrom\": 76,
    \"id_passporttype\": 1,
    \"passportIssuedBy\": \"Bundesdruckerei\",
    \"pinfl\": \"31234567890123\",
    \"amount\": 1350000,
    \"lived_days\": 0,
    \"payed\": 0,
    \"id_visatype\": 3,
    \"visaNumber\": \"V1234567\",
    \"dateVisaOn\": \"2026-05-01\",
    \"dateVisaOff\": \"2026-06-01\",
    \"visaIssuedBy\": \"Consulate of Uzbekistan in Berlin\",
    \"kppNumber\": \"KPP-12345\",
    \"dateKPP\": \"2026-05-20\",
    \"bookingId\": 45012,
    \"crm_actor_id\": \"op-42\",
    \"crm_actor_name\": \"Анвар Хамракулов\",
    \"children\": [
        {
            \"full_name\": \"b\",
            \"gen\": \"W\",
            \"birth_day\": \"2026-09-22\"
        }
    ]
}"

Обновление листовки в grace-period (5 минут после создания).

PATCH

https://api.emehmon.uz

/sync/v1/crm/listok/{id}

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

URL Parameters

string

required

The ID of the listok.

Example:

564

Body Parameters

surname

string

Фамилия — латиницей, как в паспорте. Количество символов в поле value не может превышать 50.

Example:

MUSTERMANN

firstname

string

Имя — латиницей, как в паспорте. Количество символов в поле value не может превышать 50.

Example:

MAX

id_citizen

integer

Гражданство: id из /dictionaries/countries. Значение поля value должно быть не менее 1.

Example:

passportNumber

string

Серия и номер документа без пробелов. Количество символов в поле value не может превышать 50.

Example:

C01X00T47

datePassport

string

Дата выдачи документа, ISO 8601 (YYYY-MM-DD). Must be a valid date in the format Y-m-d.

Example:

2021-03-15

sex

string

Пол: M — мужской, W — женский.

Must be one of:

Example:

id_visittype

integer

Цель визита: id из /dictionaries/visit-types. Значение поля value должно быть не менее 1.

Example:

id_guest

integer

Тип гостя: id из /dictionaries/guest-types. Значение поля value должно быть не менее 1.

Example:

propiska

string

Номер комнаты гостя. Список номеров — GET /hotel/rooms. Количество символов в поле value не может превышать 50.

Example:

101

crm_actor_id

string

ID сотрудника CRM, внёсшего правку. Информационная метка для аудита. Количество символов в поле value не может превышать 64.

Example:

op-42

crm_actor_name

string

ФИО сотрудника CRM, внёсшего правку. Информационная метка для аудита. Количество символов в поле value не может превышать 120.

Example:

Анвар Хамракулов

Headers

URL Parameters

Body

{ "surname": "MUSTERMANN", "firstname": "MAX", "id_citizen": 76, "passportNumber": "C01X00T47", "datePassport": "2021-03-15", "sex": "M", "id_visittype": 2, "id_guest": 1, "propiska": "101", "crm_actor_id": "op-42", "crm_actor_name": "\u0410\u043d\u0432\u0430\u0440 \u0425\u0430\u043c\u0440\u0430\u043a\u0443\u043b\u043e\u0432" }

Received response

Example request:

curl --request PATCH \
    "https://api.emehmon.uz/sync/v1/crm/listok/564" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH" \
    --data "{
    \"surname\": \"MUSTERMANN\",
    \"firstname\": \"MAX\",
    \"id_citizen\": 76,
    \"passportNumber\": \"C01X00T47\",
    \"datePassport\": \"2021-03-15\",
    \"sex\": \"M\",
    \"id_visittype\": 2,
    \"id_guest\": 1,
    \"propiska\": \"101\",
    \"crm_actor_id\": \"op-42\",
    \"crm_actor_name\": \"Анвар Хамракулов\"
}"

Выселение (checkout) с расчётом турсбора.

POST

https://api.emehmon.uz

/sync/v1/crm/listok/{id}/checkout

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

URL Parameters

string

required

The ID of the listok.

Example:

564

Body Parameters

sum

number

required

Итоговая сумма к оплате в UZS. Значение поля value должно быть не менее 0.

Example:

350000

payment_type_id

integer

required

Способ оплаты — код из справочника /sync/v1/crm/dictionaries/payment-types: 1 — другое, 2 — наличные, 3 — карта Humo, 4 — Uzcard, 5 — перечисление, 6 — договор.

Must be one of:

Example:

Headers

URL Parameters

Body

{ "sum": 350000, "payment_type_id": 2 }

Received response

Example request:

curl --request POST \
    "https://api.emehmon.uz/sync/v1/crm/listok/564/checkout" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH" \
    --data "{
    \"sum\": 350000,
    \"payment_type_id\": 2
}"

Список самостоятельных регистраций гостиницы с фильтрами. Сортировка — `id DESC`.

GET

https://api.emehmon.uz

/sync/v1/crm/self-listok

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Query Parameters

date_from

string

Фильтр: дата заселения от (Y-m-d). Must be a valid date in the format Y-m-d.

Example:

2026-05-01

date_to

string

Example:

2026-05-31

passport

string

Фильтр по серии/номеру паспорта. Количество символов в поле value не может превышать 50.

Example:

AB7654321

surname

string

Фильтр по фамилии (частичное совпадение). Количество символов в поле value не может превышать 100.

Example:

Каримов

page

integer

Номер страницы (с 1). Значение поля value должно быть не менее 1.

Example:

per_page

integer

Example:

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/crm/self-listok?date_from=2026-05-01&date_to=2026-05-31&passport=AB7654321&surname=%D0%9A%D0%B0%D1%80%D0%B8%D0%BC%D0%BE%D0%B2&page=1&per_page=50" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "total": 1,
        "page": 1,
        "per_page": 50,
        "items": [
            {
                "self_listok_id": 8821934,
                "regNum": "1726-2026-S-00001",
                "surname": "KARIMOV",
                "firstname": "AZIZ",
                "lastname": null,
                "id_citizen": 173,
                "id_country": 173,
                "id_countryFrom": null,
                "id_passporttype": 1,
                "id_visittype": 2,
                "id_guest": 1,
                "id_person": null,
                "id_visatype": null,
                "passportNumber": "AA1234567",
                "passportIssuedBy": null,
                "datePassport": "2020-01-01",
                "datebirth": "1990-01-01",
                "sex": "M",
                "datevisiton": "2026-08-30 14:30:00",
                "datevisitoff": "2026-09-04 14:30:00",
                "wdays": 5,
                "visaNumber": null,
                "dateVisaOn": null,
                "dateVisaOff": null,
                "visaIssuedBy": null,
                "kppNumber": "KPP-99",
                "dateKPP": "2026-08-30",
                "direction": "Tashkent - Samarkand",
                "a_address": null,
                "a_id_region": null,
                "a_id_district": null,
                "summa": 22500,
                "mzrp": 412000,
                "prc": 5,
                "registered_via": 2,
                "hsh": "a94a8fe5ccb19ba61c4c0873d391e987982fbbd3",
                "created_at": "2026-08-30 14:31:08",
                "updated_at": "2026-08-30 14:31:08"
            }
        ]
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Карточка одной самостоятельной регистрации. 404 если не существует; 403 если в другой гостинице.

GET

https://api.emehmon.uz

/sync/v1/crm/self-listok/{id}

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

URL Parameters

integer

required

self_listok_id из списка.

Example:

8821934

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/crm/self-listok/8821934" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "self_listok_id": 8821934,
        "regNum": "1726-2026-S-00001",
        "surname": "KARIMOV",
        "firstname": "AZIZ",
        "lastname": null,
        "id_citizen": 173,
        "id_country": 173,
        "id_countryFrom": null,
        "id_passporttype": 1,
        "id_visittype": 2,
        "id_guest": 1,
        "id_person": null,
        "id_visatype": null,
        "passportNumber": "AA1234567",
        "passportIssuedBy": null,
        "datePassport": "2020-01-01",
        "datebirth": "1990-01-01",
        "sex": "M",
        "datevisiton": "2026-08-30 14:30:00",
        "datevisitoff": "2026-09-04 14:30:00",
        "wdays": 5,
        "visaNumber": null,
        "dateVisaOn": null,
        "dateVisaOff": null,
        "visaIssuedBy": null,
        "kppNumber": "KPP-99",
        "dateKPP": "2026-08-30",
        "direction": "Tashkent - Samarkand",
        "a_address": null,
        "a_id_region": null,
        "a_id_district": null,
        "summa": 22500,
        "mzrp": 412000,
        "prc": 5,
        "registered_via": 2,
        "hsh": "a94a8fe5ccb19ba61c4c0873d391e987982fbbd3",
        "created_at": "2026-08-30 14:31:08",
        "updated_at": "2026-08-30 14:31:08"
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

POST sync/v1/crm/self-listok

POST

https://api.emehmon.uz

/sync/v1/crm/self-listok

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Body Parameters

surname

string

required

Фамилия — латиницей, как в машиночитаемой зоне паспорта. Количество символов в поле value не может превышать 50.

Example:

MUSTERMANN

firstname

string

required

Имя — латиницей, как в машиночитаемой зоне паспорта. Количество символов в поле value не может превышать 50.

Example:

MAX

lastname

string

Отчество, если есть в документе. Количество символов в поле value не может превышать 50.

Example:

ERWIN

id_citizen

integer

required

Гражданство: id из справочника /dictionaries/countries. 173 (UZ) и 231 (БГ) — «местные», требуют pinfl; остальные — иностранцы, требуют id_person. Значение поля value должно быть не менее 1.

Example:

passportNumber

string

required

Серия и номер документа без пробелов. Количество символов в поле value не может превышать 50.

Example:

C01X00T47

datePassport

string

required

Example:

2021-03-15

datebirth

string

required

Дата рождения, ISO 8601 (YYYY-MM-DD). Must be a valid date in the format Y-m-d.

Example:

1985-07-12

datevisiton

string

required

Дата и время начала проживания, ISO 8601 datetime. Время местное, ташкентское (UTC+5): сервер не переводит часовые пояса и записывает присланные часы и минуты как есть, поэтому пересчитывать время в UTC нельзя. Дата выезда считается как datevisiton + wdays — отдельного checkout у self-listok нет. Принимается только в интервале от 12 часов назад до текущего момента; будущее время не принимается. Вне интервала — 422 CHECKIN_DATE_OUT_OF_WINDOW, границы приходят в meta.min_allowed и meta.max_allowed. Некорректный формат — 422 VALIDATION_ERROR с meta.field = datevisiton. Поле value должно содержать корректную дату.

Example:

2026-05-22T14:30:00+05:00

wdays

integer

required

Число суток проживания (1..365). Вместе с datevisiton задаёт дату выезда. Значение поля value должно быть не менее 1. Значение поля value не может превышать 365.

Example:

sex

string

required

Пол: M — мужской, W — женский.

Must be one of:

Example:

id_visittype

integer

required

Цель визита: id из справочника /dictionaries/visit-types. Значение поля value должно быть не менее 1.

Example:

id_guest

integer

required

Тип гостя: id из справочника /dictionaries/guest-types. Значение поля value должно быть не менее 1.

Example:

kppNumber

string

required

Номер КПП пересечения границы. Обязателен для self-listok (нет гостиничного посредника) — иначе 422 KPP_REQUIRED_FOR_SELF_LISTOK. Количество символов в поле value не может превышать 50.

Example:

KPP-12345

id_person

string

Идентификатор лица в системе Погран.Службы — СТРОКА (число тоже принимается и приводится к строке). ОБЯЗАТЕЛЕН для иностранцев (id_citizen ∉ {173, 231}) — иначе 422 PERSON_ID_REQUIRED_FOR_FOREIGNER. Получают заранее через POST /listok/person-lookup, где то же значение приходит в поле person_id числом. Если Погран.Служба не подтверждает — 422 PERSON_NOT_FOUND_IN_SGB. Количество символов в поле value не может превышать 255.

Example:

12345

id_country

integer

Example:

id_countryFrom

integer

Страна прибытия: id из /dictionaries/countries. Если не передано — подставляется id_citizen. Значение поля value должно быть не менее 1.

Example:

id_passporttype

integer

Example:

passportIssuedBy

string

Орган, выдавший документ (свободный текст). Количество символов в поле value не может превышать 255.

Example:

Bundesdruckerei

pinfl

string

ПИНФЛ (14 цифр). Нужен для местных граждан (id_citizen ∈ {173 — UZ, 231 — БГ}), кроме военного билета (id_passporttype=2). Если не прислать, система сама попробует найти человека в базе МВД по связке passportNumber + datebirth: нашли — регистрация проходит и найденные данные возвращаются в resolved_person; не нашли — 422 PINFL_REQUIRED_FOR_LOCAL. Количество символов в поле value не может превышать 14.

Example:

31234567890123

dateKPP

string

Дата пересечения границы, ISO 8601 (YYYY-MM-DD). Must be a valid date in the format Y-m-d.

Example:

2026-05-20

direction

string

Маршрут поездки (свободный текст). Количество символов в поле value не может превышать 255.

Example:

Tashkent → Samarkand

id_visatype

integer

Example:

visaNumber

string

Номер визы. Количество символов в поле value не может превышать 50.

Example:

V1234567

dateVisaOn

string

Дата начала действия визы, ISO 8601 (YYYY-MM-DD). Must be a valid date in the format Y-m-d.

Example:

2026-05-01

dateVisaOff

string

Дата окончания действия визы, ISO 8601 (YYYY-MM-DD). Must be a valid date in the format Y-m-d.

Example:

2026-06-01

visaIssuedBy

string

Орган, выдавший визу (свободный текст). Количество символов в поле value не может превышать 255.

Example:

Consulate of Uzbekistan in Berlin

children

object[]

Дети, проживающие с туристом по его документу. Каждый элемент — {full_name, gen, birth_day}.

crm_actor_id

string

Example:

op-42

crm_actor_name

string

Example:

Анвар Хамракулов

Headers

Body

{ "surname": "MUSTERMANN", "firstname": "MAX", "lastname": "ERWIN", "id_citizen": 76, "passportNumber": "C01X00T47", "datePassport": "2021-03-15", "datebirth": "1985-07-12", "datevisiton": "2026-05-22T14:30:00+05:00", "wdays": 3, "sex": "M", "id_visittype": 2, "id_guest": 1, "kppNumber": "KPP-12345", "id_person": "12345", "id_country": 76, "id_countryFrom": 76, "id_passporttype": 1, "passportIssuedBy": "Bundesdruckerei", "pinfl": "31234567890123", "dateKPP": "2026-05-20", "direction": "Tashkent \u2192 Samarkand", "id_visatype": 3, "visaNumber": "V1234567", "dateVisaOn": "2026-05-01", "dateVisaOff": "2026-06-01", "visaIssuedBy": "Consulate of Uzbekistan in Berlin", "children": [ { "full_name": "b", "gen": "M", "birth_day": "2026-09-22" } ], "crm_actor_id": "op-42", "crm_actor_name": "\u0410\u043d\u0432\u0430\u0440 \u0425\u0430\u043c\u0440\u0430\u043a\u0443\u043b\u043e\u0432" }

Received response

Example request:

curl --request POST \
    "https://api.emehmon.uz/sync/v1/crm/self-listok" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH" \
    --data "{
    \"surname\": \"MUSTERMANN\",
    \"firstname\": \"MAX\",
    \"lastname\": \"ERWIN\",
    \"id_citizen\": 76,
    \"passportNumber\": \"C01X00T47\",
    \"datePassport\": \"2021-03-15\",
    \"datebirth\": \"1985-07-12\",
    \"datevisiton\": \"2026-05-22T14:30:00+05:00\",
    \"wdays\": 3,
    \"sex\": \"M\",
    \"id_visittype\": 2,
    \"id_guest\": 1,
    \"kppNumber\": \"KPP-12345\",
    \"id_person\": \"12345\",
    \"id_country\": 76,
    \"id_countryFrom\": 76,
    \"id_passporttype\": 1,
    \"passportIssuedBy\": \"Bundesdruckerei\",
    \"pinfl\": \"31234567890123\",
    \"dateKPP\": \"2026-05-20\",
    \"direction\": \"Tashkent → Samarkand\",
    \"id_visatype\": 3,
    \"visaNumber\": \"V1234567\",
    \"dateVisaOn\": \"2026-05-01\",
    \"dateVisaOff\": \"2026-06-01\",
    \"visaIssuedBy\": \"Consulate of Uzbekistan in Berlin\",
    \"crm_actor_id\": \"op-42\",
    \"crm_actor_name\": \"Анвар Хамракулов\",
    \"children\": [
        {
            \"full_name\": \"b\",
            \"gen\": \"M\",
            \"birth_day\": \"2026-09-22\"
        }
    ]
}"

PATCH sync/v1/crm/self-listok/{id}

PATCH

https://api.emehmon.uz

/sync/v1/crm/self-listok/{id}

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

URL Parameters

string

required

The ID of the self listok.

Example:

564

Body Parameters

surname

string

Фамилия — латиницей, как в паспорте. Количество символов в поле value не может превышать 50.

Example:

MUSTERMANN

firstname

string

Имя — латиницей, как в паспорте. Количество символов в поле value не может превышать 50.

Example:

MAX

id_citizen

integer

Гражданство: id из /dictionaries/countries. Значение поля value должно быть не менее 1.

Example:

passportNumber

string

Серия и номер документа без пробелов. Количество символов в поле value не может превышать 50.

Example:

C01X00T47

datePassport

string

Дата выдачи документа, ISO 8601 (YYYY-MM-DD). Must be a valid date in the format Y-m-d.

Example:

2021-03-15

sex

string

Пол: M — мужской, W — женский.

Must be one of:

Example:

id_visittype

integer

Цель визита: id из /dictionaries/visit-types. Значение поля value должно быть не менее 1.

Example:

id_guest

integer

Тип гостя: id из /dictionaries/guest-types. Значение поля value должно быть не менее 1.

Example:

datevisiton

string

Дата и время начала проживания, ISO 8601 datetime. Время местное, ташкентское (UTC+5) — часовые пояса сервер не переводит. Принимается только в интервале от 12 часов назад до текущего момента; будущее время не принимается. Вне интервала — 422 CHECKIN_DATE_OUT_OF_WINDOW, границы приходят в meta.min_allowed и meta.max_allowed. Некорректный формат — 422 VALIDATION_ERROR с meta.field = datevisiton. Поле value должно содержать корректную дату.

Example:

2026-05-22T14:30:00+05:00

wdays

integer

Example:

kppNumber

string

Номер КПП пересечения границы. Количество символов в поле value не может превышать 50.

Example:

KPP-12345

dateKPP

string

Дата пересечения границы, ISO 8601 (YYYY-MM-DD). Must be a valid date in the format Y-m-d.

Example:

2026-05-20

direction

string

Маршрут поездки (свободный текст). Количество символов в поле value не может превышать 255.

Example:

Tashkent → Samarkand

id_visatype

integer

Тип визы: id из /dictionaries/visa-types. Значение поля value должно быть не менее 0.

Example:

visaNumber

string

Номер визы. Количество символов в поле value не может превышать 50.

Example:

V1234567

dateVisaOn

string

Дата начала действия визы, ISO 8601 (YYYY-MM-DD). Must be a valid date in the format Y-m-d.

Example:

2026-05-01

dateVisaOff

string

Дата окончания действия визы, ISO 8601 (YYYY-MM-DD). Must be a valid date in the format Y-m-d.

Example:

2026-06-01

visaIssuedBy

string

Орган, выдавший визу (свободный текст). Количество символов в поле value не может превышать 255.

Example:

Consulate of Uzbekistan in Berlin

children

object

Дети, проживающие с туристом по его документу. Каждый элемент — {full_name, gen, birth_day}.

crm_actor_id

string

Example:

op-42

crm_actor_name

string

Example:

Анвар Хамракулов

Headers

URL Parameters

Body

{ "surname": "MUSTERMANN", "firstname": "MAX", "id_citizen": 76, "passportNumber": "C01X00T47", "datePassport": "2021-03-15", "sex": "M", "id_visittype": 2, "id_guest": 1, "datevisiton": "2026-05-22T14:30:00+05:00", "wdays": 3, "kppNumber": "KPP-12345", "dateKPP": "2026-05-20", "direction": "Tashkent \u2192 Samarkand", "id_visatype": 3, "visaNumber": "V1234567", "dateVisaOn": "2026-05-01", "dateVisaOff": "2026-06-01", "visaIssuedBy": "Consulate of Uzbekistan in Berlin", "children": null, "crm_actor_id": "op-42", "crm_actor_name": "\u0410\u043d\u0432\u0430\u0440 \u0425\u0430\u043c\u0440\u0430\u043a\u0443\u043b\u043e\u0432" }

Received response

Example request:

curl --request PATCH \
    "https://api.emehmon.uz/sync/v1/crm/self-listok/564" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH" \
    --data "{
    \"surname\": \"MUSTERMANN\",
    \"firstname\": \"MAX\",
    \"id_citizen\": 76,
    \"passportNumber\": \"C01X00T47\",
    \"datePassport\": \"2021-03-15\",
    \"sex\": \"M\",
    \"id_visittype\": 2,
    \"id_guest\": 1,
    \"datevisiton\": \"2026-05-22T14:30:00+05:00\",
    \"wdays\": 3,
    \"kppNumber\": \"KPP-12345\",
    \"dateKPP\": \"2026-05-20\",
    \"direction\": \"Tashkent → Samarkand\",
    \"id_visatype\": 3,
    \"visaNumber\": \"V1234567\",
    \"dateVisaOn\": \"2026-05-01\",
    \"dateVisaOff\": \"2026-06-01\",
    \"visaIssuedBy\": \"Consulate of Uzbekistan in Berlin\",
    \"crm_actor_id\": \"op-42\",
    \"crm_actor_name\": \"Анвар Хамракулов\"
}"

Сводка турсбора: помесячные суммы (ГТ/МТ/СТ) + итог. Разрез — по дате выезда, листки без выезда в суммы не входят.

GET

https://api.emehmon.uz

/sync/v1/crm/finance/tourist-tax

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Query Parameters

year

integer

required

Год (обязательно). Значение поля value должно быть не менее 2015. Значение поля value не может превышать 2100.

Example:

2026

month

integer

Месяц 1..12. Без него — весь год с разбивкой по месяцам. Значение поля value должно быть между 1 и 12.

Example:

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/crm/finance/tourist-tax?year=2026&month=7" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "year": 2026,
        "month": 7,
        "basis": "checkout",
        "months": [
            {
                "month": 7,
                "listok_qty": 412,
                "self_qty": 8,
                "real_days": 1180,
                "gt_sum": 17800000,
                "mt_sum": 420000,
                "st_sum": 230000,
                "total": 18450000
            }
        ],
        "total": {
            "listok_qty": 412,
            "self_qty": 8,
            "real_days": 1180,
            "gt_sum": 17800000,
            "mt_sum": 420000,
            "st_sum": 230000,
            "total": 18450000
        }
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Детализация турсбора за месяц: построчно по гостям (гостиничные и самостоятельные регистрации), с пагинацией.

GET

https://api.emehmon.uz

/sync/v1/crm/finance/tourist-tax/details

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Query Parameters

year

integer

required

Год (обязательно). Значение поля value должно быть не менее 2015. Значение поля value не может превышать 2100.

Example:

2026

month

integer

required

Месяц 1..12 (обязательно). Значение поля value должно быть между 1 и 12.

Example:

page

integer

Номер страницы (с 1). Значение поля value должно быть не менее 1.

Example:

per_page

integer

Example:

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/crm/finance/tourist-tax/details?year=2026&month=7&page=1&per_page=50" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "total": 420,
        "page": 1,
        "per_page": 50,
        "items": [
            {
                "source": "listok",
                "listok_id": 8826912,
                "regNum": "1726-2026-00012345",
                "surname": "MUSTERMANN",
                "firstname": "MAX",
                "lastname": null,
                "id_citizen": 5,
                "citizenship": "Германия",
                "is_local": false,
                "datevisiton": "2026-07-01 14:00:00",
                "datevisitoff": "2026-07-05 10:00:00",
                "days": 4,
                "prc": 5,
                "mzrp": 412000,
                "tax_sum": 82400
            }
        ]
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Абонентская плата: начисления (тариф, скидка, к оплате, регистраций), оплаты за период и текущий баланс гостиницы.

GET

https://api.emehmon.uz

/sync/v1/crm/finance/subscription

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Query Parameters

year

integer

required

Год (обязательно). Значение поля value должно быть не менее 2015. Значение поля value не может превышать 2100.

Example:

2026

month

integer

Месяц 1..12. Без него — весь год с разбивкой по месяцам. Значение поля value должно быть между 1 и 12.

Example:

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/crm/finance/subscription?year=2026&month=7" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "year": 2026,
        "month": 7,
        "accruals": [
            {
                "period": "2026-07",
                "tariff": 500000,
                "discount_percent": 0,
                "total": 500000,
                "registrations": 42,
                "accrued_at": "2026-08-01 03:00:00"
            }
        ],
        "accrued_total": 500000,
        "payments_total": 250000,
        "current_deposit": 1500000
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Подсчёт регистраций по дате заезда: за год — помесячно, за месяц — по дням.

GET

https://api.emehmon.uz

/sync/v1/crm/finance/registrations

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Query Parameters

year

integer

required

Год (обязательно). Значение поля value должно быть не менее 2015. Значение поля value не может превышать 2100.

Example:

2026

month

integer

Месяц 1..12. Без него — весь год с разбивкой по месяцам. Значение поля value должно быть между 1 и 12.

Example:

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/crm/finance/registrations?year=2026&month=7" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "OK",
    "data": {
        "year": 2026,
        "month": 7,
        "basis": "checkin",
        "items": [
            {
                "day": 1,
                "listok_qty": 14,
                "self_qty": 1,
                "total": 15
            },
            {
                "day": 2,
                "listok_qty": 9,
                "self_qty": 0,
                "total": 9
            }
        ],
        "total": {
            "listok_qty": 412,
            "self_qty": 8,
            "total": 420
        }
    },
    "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

Sync API

COATO: Common hotels info by region/district code

POST

https://api.emehmon.uz

/sync/v1/coato/common

Returns hotel list by SOATO/COATO code.

Headers

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Example:

application/json

Content-Type

Example:

application/json

Body Parameters

oblastsoatocode

string

required

SOATO/COATO code.

Example:

"1726"

Response Fields

code

integer

message

string

data

string[]

request_id

string

Headers

Body

{ "oblastsoatocode": "\"1726\"" }

Received response

Example request:

curl --request POST \
    "https://api.emehmon.uz/sync/v1/coato/common" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --data "{
    \"oblastsoatocode\": \"\\\"1726\\\"\"
}"

Example response:

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "hotel_id": 123,
            "hotel_district": "Tashkent",
            "hotel_name": "Example Hotel",
            "hotel_type": "Hotel",
            "hotel_status": "Active",
            "hotel_stars": 3,
            "hotel_inn": "123456789",
            "hotel_rooms": 10,
            "hotel_beds": 20,
            "hotel_address": "Street 1",
            "hotel_local_qty": 5,
            "hotel_foreign_qty": 2,
            "hotel_phone": "+998...",
            "hotel_manager": "Manager Name"
        }
    ],
    "request_id": "e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d311"
}

COATO: Common hotels info by region/district code with period stats

POST

https://api.emehmon.uz

/sync/v1/coato/common-with-period

Returns hotel list by COATO code with additional fields: location (geo), check_in_qty (arrivals count) and check_out_qty (departures count) for the given period.

Access restricted to specific API users (configured in sync.mip.allowed_users). Only specific COATO codes are allowed (configured in sync.mip.allowed_coato). Maximum date interval is configurable (default: 7 days).

Headers

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Example:

application/json

Content-Type

Example:

application/json

Body Parameters

oblastsoatocode

string

required

SOATO/COATO district code (must be in allowed list).

Example:

"1726269"

date_from

string

required

Start date (Y-m-d).

Example:

"2026-04-01"

date_to

string

required

End date (Y-m-d).

Example:

"2026-04-07"

Response Fields

code

integer

message

string

data

string[]

request_id

string

Headers

Body

{ "oblastsoatocode": "\"1726269\"", "date_from": "\"2026-04-01\"", "date_to": "\"2026-04-07\"" }

Received response

Example request:

curl --request POST \
    "https://api.emehmon.uz/sync/v1/coato/common-with-period" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --data "{
    \"oblastsoatocode\": \"\\\"1726269\\\"\",
    \"date_from\": \"\\\"2026-04-01\\\"\",
    \"date_to\": \"\\\"2026-04-07\\\"\"
}"

Example response:

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "hotel_id": 123,
            "hotel_district": "Mirzo Ulugbek",
            "hotel_name": "Example Hotel",
            "hotel_type": "Hotel",
            "hotel_status": "Active",
            "hotel_stars": 3,
            "hotel_inn": "123456789",
            "hotel_rooms": 10,
            "hotel_beds": 20,
            "hotel_address": "Street 1",
            "hotel_local_qty": 5,
            "hotel_foreign_qty": 2,
            "hotel_phone": "+998...",
            "hotel_manager": "Manager Name",
            "location": "41.311081,69.279737",
            "check_in_qty": 15,
            "check_out_qty": 8
        }
    ],
    "request_id": "e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31"
}

COATO: Details (check-in/check-out lists)

POST

https://api.emehmon.uz

/sync/v1/coato/details

Returns two arrays: check_in and check_out for the given date and COATO code.

Headers

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Example:

application/json

Content-Type

Example:

application/json

Body Parameters

oblastsoatocode

string

required

SOATO/COATO code.

Example:

"1726"

date

string

required

Date (Y-m-d).

Example:

"2026-01-20"

Response Fields

code

integer

message

string

data

string[]

request_id

string

Headers

Body

{ "oblastsoatocode": "\"1726\"", "date": "\"2026-01-20\"" }

Received response

Example request:

curl --request POST \
    "https://api.emehmon.uz/sync/v1/coato/details" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --data "{
    \"oblastsoatocode\": \"\\\"1726\\\"\",
    \"date\": \"\\\"2026-01-20\\\"\"
}"

Example response:

{
    "code": 200,
    "message": "success",
    "data": {
        "check_out": [
            {
                "hotel_id": 1,
                "listok_id": 10,
                "name": "John Doe",
                "sex": "M",
                "birthdate": "1990-01-01",
                "birthcountry": 860,
                "arrival_from": 643,
                "citizen": 860,
                "check_in": "2026-01-18 12:00:00",
                "check_out": "2026-01-20 09:00:00",
                "children": null
            }
        ],
        "check_in": [
            {
                "hotel_id": 2,
                "listok_id": 11,
                "name": "Jane Doe",
                "sex": "W",
                "birthdate": "1995-05-05",
                "birthcountry": 860,
                "arrival_from": 398,
                "citizen": 860,
                "check_in": "2026-01-20 14:00:00",
                "check_out": null,
                "children": null
            }
        ]
    },
    "request_id": "e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31"
}

Hisob Palata: Hotels list (paged)

POST

https://api.emehmon.uz

/sync/v1/hp/hotels

Headers

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Example:

application/json

Content-Type

Example:

application/json

Body Parameters

page

integer

required

Page number (1..).

Example:

per_page

integer

required

Per page (1..500).

Example:

Response Fields

code

integer

message

string

data

string[]

request_id

string

Headers

Body

{ "page": 1, "per_page": 50 }

Received response

Example request:

curl --request POST \
    "https://api.emehmon.uz/sync/v1/hp/hotels" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --data "{
    \"page\": 1,
    \"per_page\": 50
}"

Example response:

{
  "code": 200,
  "message": "success",
  "data": {
    "total_count": 1000,
    "rows": [
      {"hotel_id":1,"hotel_name":"Example","hotel_inn":"123","hotel_type":"Hotel","hotel_status":"Active","hotel_stars":3,"hotel_rooms":10,"hotel_beds":20,"region_id":"17","region_name":"Tashkent","district_id":"1726","district_name":"District","hotel_address":"Street 1","hotel_local_qty":5,"hotel_foreign_qty":2,"hotel_manager":"Manager","hotel_phone":"+998..."},
    ]
  },
  "request_id": "e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31"

Hisob Palata: Clients list (paged)

POST

https://api.emehmon.uz

/sync/v1/hp/clients

Headers

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Example:

application/json

Content-Type

Example:

application/json

Body Parameters

page

integer

required

Page number (1..).

Example:

per_page

integer

required

Per page (1..500).

Example:

date_from

string

required

Start date (Y-m-d).

Example:

"2026-01-01"

date_to

string

required

End date (Y-m-d).

Example:

"2026-01-31"

Response Fields

code

integer

message

string

data

string[]

request_id

string

Headers

Body

{ "page": 1, "per_page": 50, "date_from": "\"2026-01-01\"", "date_to": "\"2026-01-31\"" }

Received response

Example request:

curl --request POST \
    "https://api.emehmon.uz/sync/v1/hp/clients" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --data "{
    \"page\": 1,
    \"per_page\": 50,
    \"date_from\": \"\\\"2026-01-01\\\"\",
    \"date_to\": \"\\\"2026-01-31\\\"\"
}"

Example response:

{
    "code": 200,
    "message": "success",
    "data": {
        "total_count": 12345,
        "rows": [
            {
                "listok_id": 1,
                "hotel_id": 10,
                "hotel_inn": "123",
                "hotel_name": "Example",
                "name": "DOE JOHN",
                "pinfl": "**masked**",
                "gender": "M",
                "birthdate": "1990-01-01",
                "birthcountry": "Uzbekistan",
                "arrival_from": "Kazakhstan",
                "citizen": "Uzbekistan",
                "check_in": "2026-01-10 12:00:00",
                "check_out": "2026-01-12 09:00:00",
                "children": null,
                "region_id": "17",
                "region_name": "Tashkent",
                "district_id": "1726",
                "district_name": "District",
                "guest_goal": "Tourism"
            }
        ]
    },
    "request_id": "e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31"
}

Sync API Meta

Errors catalog

GET

https://api.emehmon.uz

/sync/v1/meta/errors

Полный список публичных error_code, возвращаемых Sync API и CRM Hotel API. Каждая запись содержит группу (auth / authz / idempotency / crm.hotel / crm.listok / crm.assets / system), HTTP-статус, машиночитаемый error_code и краткое описание.

Источник правды — App\Support\ErrorCatalog::all(). Расширение списка считается обратно-совместимым изменением и не требует версионирования.

Headers

Example:

application/json

Content-Type

Example:

application/json

X-User-Name

Example:

apistatuser@emehmon.uz

X-User-Ts

Example:

1769053020

X-User-Request-Id

Example:

e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31

X-User-Hash

Example:

PLACEHOLDER_HASH

Headers

Received response

Example request:

curl --request GET \
    --get "https://api.emehmon.uz/sync/v1/meta/errors" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --header "X-User-Name: apistatuser@emehmon.uz" \
    --header "X-User-Ts: 1769053020" \
    --header "X-User-Request-Id: e7b8c3a4-9f2d-4c6a-8e51-6a9b2c4f7d31" \
    --header "X-User-Hash: PLACEHOLDER_HASH"

Example response:

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "group": "auth",
            "http": 401,
            "error_code": "MISSING_AUTH_HEADERS",
            "message": "Missing authentication headers"
        },
        {
            "group": "authz",
            "http": 403,
            "error_code": "HOTEL_MISMATCH",
            "message": "Requested hotel does not match API user"
        },
        {
            "group": "crm.listok",
            "http": 422,
            "error_code": "LISTOK_DUPLICATE_ACTIVE",
            "message": "Active listok for this passport already exists in this hotel"
        }
    ]
}