Mandarin

# Тестирование сервиса Самозанятых

Тестирование сервиса СМЗ возможно только в режиме sandbox, для подключения данного режима обратитесь в Службу поддержки (opens new window) Для получения определенного статуса чека необходимо использовать один из двух тестовых ИНН:

Параметр Описание
185796979287 устанавливается статус SUCCESS при регистрации чека.
058104954632 устанавливается статус FAILED при регистрации чека.

# Подключение самозанятого

Параметры запроса:

Параметр Обязательность Описание
inn Да Идентификационный номер налогоплательщика физического лица.
callback_url Да URL-адрес, на который будет отправлен ответ.
is_sandbox Да Параметр тестового режима: true;1;да;yes

Пример запроса:

curl --location 'https://api.psp.io/self-employed/v1/tin/bind' \
--header 'MID: 1234' \
--header 'Authorization: Bearer Nwii9xFAfHjAWkk6PPOFUmpheFe123' \
--data '{
    "is_sandbox": true,
    "inn": "185796979287",
    "callback_url": "https://webhook.site/28b30c34-9fbd-4e98-b1b7-e20a999d530b"
}'

В случае успешного выполнения, ответ будет включать в себя:

  • id: уникальный идентификатор запроса.
  • inn: привязанный идентификационный номер налогоплательщика.

Синхронный ответ:

{
  "id": "3ab4e73d-a197-4a2f-9b92-69ef07468b04",
  "inn": "185796979287"
}

Callback:

ОБРАТИТЕ ВНИМАНИЕ!

Необходимо заранее сообщить url для отправки коллбэков в Mandarin!

{
   "id": "80cf6b02-795f-486f-a515-562a41a87429",
   "inn": "185796979287",
   "status": 0,
   "message": null
}

Параметры Callback:

Параметр Тип Описание
id uuid Идентификатор запроса
inn string ИНН
status integer Статус ответа от СМЗ, возможные варианты:
0 - успех;
1 - завершен с ошибкой;
8 - окончен срок перманентного запроса в ФНС;
408 - ошибка timeout (долгий ожидание ответа от ФНС)
message string Текст ошибки на статусы: 1, 8, 408

# Проверка статуса самозанятого

При вызове метода проверки статуса (opens new window) самозанятого, нужно передавать параметры в querystring с результатами, которые вы хотите получить:

Query Params Value Description
is_sandbox true;
1;
да;
yes		 Параметр тестового режима, использовать можно любое из перечисленных значений
state ACTIVE;
NOT_SELF_EMPLOYEE		 Статус СМЗ, указать можно любой из этого списка (opens new window)

Пример запроса:

curl --location 'https://api.psp.io/self-employed/v1/tin/185796979287?is_sandbox=true&state=ACTIVE' \
--header 'MID: 1234' \
--header 'Authorization: Bearer Nwii9xFAfHjAWkk6PPOFUmpheFe123'

Пример ответа:

{
    "id": "test-d4dc85c1-765a-4865-bea6-01b215a333ed",
    "inn": "185796979287",
    "status": "ACTIVE"
}

# Формирование тестового чека

Параметры запроса:

Параметр Обязательность Описание
inn Да ИНН (идентификационный номер налогоплательщика), связанный с чеком.
цена Да Цена товара/услуги
title Да Название товара/услуги в чеке
is_sandbox Да Параметр тестового режима: true;1;да;yes

Пример запроса:

curl --location 'https://api.psp.io/self-employed/v1/receipts' \
--header 'MID: 1234' \
--header 'Authorization: Bearer Nwii9xFAfHjAWkk6PPOFUmpheFe123' \
--data '{
    "is_sandbox": true,
    "inn": "185796979287",
    "price": 100,
    "title": "Оплата заказа №1234"
}'

Синхронный ответ с тестовым ИНН 185796979287:

{
  "cheque_id": "20172zyc8z",
  "inn": "185796979287",
  "message": "",
  "session_id": "edccadd7-e5f9-4de2-8088-64e6adf0959b",
  "status": "success",
  "url": "https://lknpd.nalog.ru/api/v1/receipt/623406197779/20172zyc8z/print",
  "title": "Оплата заказа №1234"
}

Синхронный ответ с тестовым ИНН 058104954632:

{
  "cheque_id": null,
  "inn": "058104954632",
  "message": "Inactive TIN 058104954632 failed/ACTIVE",
  "session_id": "edccadd7-e5f9-4de2-8088-64e6adf0959b",
  "status": "failed",
  "url": null,
  "title": "Оплата заказа №1234"
}

Параметры ответа:

  • cheque_id - уникальный идентификатор созданного чека.
  • inn - ИНН, связанный с чеком.
  • message - дополнительная информация или сообщение об ошибке.
  • session_id - id созданного чека.
  • status - статус запроса, см. список статусов ниже.
  • url - URL-адрес для печати созданного чека.
  • title - Название товара/услуи, указанные в запросе.

Список статусов:

Статус Описание
success Чек успешно создан
failed Не удалось создать чек. Подробности ошибки можно проверить в полученном ответе (message).

← Типы операций →