💼
API Самозанятые
Бизнес API
Бизнес API
  • Главная
  • Быстрый старт
  • Основы работы с API
  • Создание пользователя
  • Аутентификация
  • Системные запросы
    • Получение отчета агента
    • Получение актуального баланс
    • Получение списка новостей сервиса
    • Получение захолдированной суммы на выплату налога
    • Получение технической информацию о API
  • ЭДО
    • Создание договора
    • Создание документа
    • Отправить документ на подпись
    • Подписание документа
    • Расторжение договора
    • Получение детальной информации по документу
    • Получение списка документов агента
    • Получение списка документов самозанятого
    • Получение списка договоров самозанятого
    • Получения списка шаблонов договоров
  • Приглашения / Сценарии
    • Получение списка приглашений агента
    • Получение уведомления о прохождении сценария
  • Самозанятые
    • Получение актуальных самозанятых
    • Добавление самозанятого в компанию c помощью API
    • Добавление нескольких самозанятых в компанию
    • Перевод самозанятого в архив
    • Перевод списка самозанятых в архив
    • Вывод самозанятого из архива
    • Получение согласия на сотрудничество
    • Подтверждение пин кода из смс при подтверждении самозанятого
    • Проверка регистрации исполнителя в сервисе
    • Проверка регистрации исполнителя в ФНС
    • Получение результата проверки статуса самозанятого в налоговой
    • Получение списка самозанятых по ФИО
    • Получение списка самозанятых по id
    • Получение списка самозанятых по ИНН
    • Получение списка договоров самозанятого
    • Обновление информации о самозанятом
  • Работа с реестрами
    • Создание реестра выплат
    • Проверка реестра
    • Асинхронная проверка реестра
    • Удаление реестра
    • Оплата реестра
    • Получение информации по реестру
    • Получение информации об операциях самозанятых
    • Получение информации по всем реестрам за определённый период
    • Запрос чеков реестров
    • Повтор выплаты реестра
    • Обновление реестра
  • Статистика по самозанятым
    • Получение статистики "Дни"
    • Получение статистики "Группы самозанятых"
    • Получение статистики "Месяцы"
    • Получение статистики "Самозанятые"
  • Налоги
    • Получение списка налогов
    • Получение списка налогов по ФИО
    • Получение списка неоплаченных налогов
    • Отправка налога на карту самозанятого
  • HTTP-коды ответов
  • Интеграция с 1С
    • Установка модуля
    • Интеграция с Самозанятые.РФ
    • Функции расширения
    • История версий
      • СамозанятыеРФ071
      • СамозанятыеРФ072
  • Хеширование пароля в формате MD5
Powered by GitBook
On this page
  • Подготовка
  • Шаг 1. Предоставление доступа к API
  • Шаг 2. Создание реестра/проверка
  • Шаг 3. Оплата реестра

Быстрый старт

Быстрый старт API Сам.Бизнес. Эта статья поможет вам произвести первую выплату, не углубляясь в детальную информацию по использованию API. Более подробную информацию о работе методов API, вы сможете

PreviousГлавнаяNextОсновы работы с API

Last updated 1 year ago

Подготовка

Чтобы начать работать с API Сам.Бизнес , вам нужно и получить доступ к личному кабинету.

Для в API вам потребуется передавать в Header запроса X-Login и X-Password. Логин - необходимо запросить у администратора; пароль - пароль захешированный в MD5 (его нужно сгенерировать).

Шаг 1. Предоставление доступа к API

Сервис Сам.Бизнес позволяет настраивать условия доступа к функциям, создавая профили пользователей.

Чтобы отобразить список существующих пользователей, следует выбрать Бизнес — Пользователи — Пользователи. Для использования API, необходимо выбрать соответствующую роль.

Для создания профиля нового пользователя необходимо:

В области “Фильтр” над таблицей нажать “Создать.” В появившемся окне ввести все необходимые данные:

  • ФИО пользователя;

  • номер телефона

  • логин для входа в личный кабинет

  • первоначальный пароль (будет изменен пользователем при первом входе)

  • график работы

Добавлять новых пользователей имеет возможность только пользователь с правами Администратор. Другие категории пользователей такой возможности не имеют. Администратором может быть только один пользователь.

Шаг 2. Создание реестра/проверка

Создание реестра

При создании реестра на выплату нужно указать сумму выплаты в копейках (sum) - обязательно только для добавления/редактирования, список объектов выплат , идентификатор самозанятого в системе (idIndividual).

В запросе передается основание выплаты (comment) и массив "payouts" с обьектом, содержащим информацию о реестре.

curl --location --request PUT 'https://business.selfwork.ru/selfemployed/business/v1/payouts/add' \
--header 'X-Login: example' \
--header 'X-Password: 591c0bcd4a41137fe9fce94dfba74e24' \
--header 'Content-Type: application/json' \
--data-raw ' {
  "payouts": [
    {
      "state": 0,
      "idIndividual": 1234,
      "sum": 10000,
      "comment": "test"
    }
  ]
}'
var axios = require('axios');
var data = JSON.stringify({
  "payouts": [
    {
      "state": 0,
      "idIndividual": 9286,
      "sum": 10000,
      "comment": "test"
    }
  ]
});

var config = {
  method: 'put',
  url: 'https://business.selfwork.ru/selfemployed/business/v1/payouts/add',
  headers: { 
    'X-Login': 'example', 
    'X-Password': '591c0bcd4a41137fe9fce94dfba74e24', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Проверка реестра

Проверка реестра необходима для проверки статуса самозанятого на момент выплаты денежных средств, а так же соответствие информации по выплатам. Чтобы проверить реестр, используйте id, который возвращается в методе создания реестра.

В тело запроса передается массив с идентификаторами проверяемых реестров.

curl --location --request POST 'https://business.selfwork.ru/selfemployed/business/v1/payouts/check' \
--header 'X-Login: example' \
--header 'X-Password: 591c0bcd4a41137fe9fce94dfba74e24' \
--header 'Content-Type: application/json' \
--data-raw '[
    1234
]'
var axios = require('axios');
var data = JSON.stringify([
  1234
]);

var config = {
  method: 'post',
  url: 'https://business.selfwork.ru/selfemployed/business/v1/payouts/check',
  headers: { 
    'X-Login': 'example', 
    'X-Password': '591c0bcd4a41137fe9fce94dfba74e24', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Шаг 3. Оплата реестра

Оплата

После проверки реестра, в случае успеха, можно производить оплату реестра.

curl --location --request POST 'https://business.selfwork.ru/selfemployed/business/v1/payouts/registry-payment' \
--header 'X-Login: example' \
--header 'X-Password: 591c0bcd4a41137fe9fce94dfba74e24' \
--header 'Content-Type: application/json' \
--data-raw '[1234]'
var axios = require('axios');
var data = JSON.stringify([
  1234
]);

var config = {
  method: 'post',
  url: 'https://business.selfwork.ru/selfemployed/business/v1/payouts/registry-payment',
  headers: { 
    'X-Login': 'example', 
    'X-Password': '591c0bcd4a41137fe9fce94dfba74e24', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

аутентификации запросов
зарегистрироваться