Получение списка налогов по ФИО
Метод API предназначен для получения списка налогов по ФИО самозанятого.
Для вызова метода необходимо передать X-Login и X-Password в Headers запроса, в query параметрах указать name и lastname.
Также можно отфильтровать список налогов используя необязательный query параметр - middlename.
Запрос
Метод: GET https://business.selfwork.ru/selfemployed/business/v1/tax/list-by-fio
Query Parameters
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| lastname | string | Да | Фамилия |
| name | string | Да | Имя |
| middlename | string | Нет | Отчество |
Headers
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| X-Login | string | Да | Логин пользователя |
| X-Password | string | Да | Пароль пользователя |
Пример
- cURL
curl -X GET "https://business.selfwork.ru/selfemployed/business/v1/tax/list-by-fio?lastname=Петров&name=Иван&middlename=Сергеевич" \
-H "X-Login: your_login_here" \
-H "X-Password: your_password_here"
Ответы
- 200: OK
- 401: Unauthorized
- 500: Internal Server Error
Запрос выполнен успешно
[
{
"id": 0,
"period": 0,
"status": 0,
"sum": 0
}
]
Описание ответа:
| Ключ | Описание |
|---|---|
| id | Идентификатор налога |
| period | Период налога |
| status | Статус |
| sum | Сумма налога |
Не валидные авторизационные данные
{
"errorCode": 1,
"message": "Access denied"
}
Системная ошибка
{
"errorCode": 100,
"message": "Internal server error"
}
Описание ошибки:
| Ключ | Описание |
|---|---|
| errorCode | Код ошибки, вернувшийся с сервера |
| message | Сообщение сервера, описывающее ошибку |
Справочник статусов (status)
| Статус | Описание |
|---|---|
| 0 | Новый |
| 1 | Операция выплаты налога в обработке |
| 2 | Операция возврата налога на карту СЗ в обработке |
| 10 | Операция выплаты налога в успехе |
| 11 | Операция возврата налога на карту СЗ в успехе |
| 20 | Не удалось получить УИН из налоговой |
| 100 | Операция выплаты налога в ошибке |
| 101 | Операция возврата налога на карту СЗ в ошибке |