Неофициальный API клиент lknpd.nalog.ru ("Мой Налог")
Позволяет автоматизировать отправку информации о доходах для самозанятых, получать информацию о созданных чеках и удалять их. Поддерживается аутентификация по ИНН и паролю, а также по номеру телефона.
С помощью composer
$ composer require shoman4eg/moy-nalog
Также Вам понадобится релизация виртуального пакета psr/http-client-implementation
, например (рекомендуется):
Symfony
$ composer require symfony/http-client
Или Guzzle
$ composer require guzzlehttp/guzzle
// Необходимо выставить часовой пояс для корректного формирования дат в чеках
// Можно установить с помощью функции date_default_timezone_set
date_default_timezone_set('Europe/Kaliningrad');
// или через класс DateTimeImmutable, с нужным часовым поясом, перед созданием чека
$operationTime = new \DateTimeImmutable('now', new \DateTimeZone('Europe/Kaliningrad'))
При аутентификации с помощью методов createNewAccessToken
(по ИНН и паролю) или createNewAccessTokenByPhone
(по номеру телефона) , вместе с токеном доступа (accessToken), возвращается также токен обновления (refreshToken) с неограниченным сроком действия. Сохраните оригинальный ответ этих методов и используйте повторно в методе authenticate
.
При повторном использовании методов
createNewAccessToken
иcreateNewAccessTokenByPhone
, предыдущий accessToken становится недействительным.
Если Вам нужно восстановить пароль от сервиса "Мой налог", это возможно сделать только через "Личный кабинет налогоплательщика". Аккаунты на обоих сервисах одинаковые.
use Shoman4eg\Nalog\ApiClient;
$apiClient = ApiClient::create();
try {
// Запрос accessToken
$accessToken = $apiClient->createNewAccessToken($username, $password);
} catch (\Shoman4eg\Nalog\Exception\Domain\UnauthorizedException $e) {
var_dump($e->getMessage());
}
// Аутентификация с помощью accessToken
$apiClient->authenticate($accessToken);
Вариант аутентификации по номеру телефона происходит в 2 шага:
- Запросите SMS с кодом подтверждения на номер телефона и сохраните возвращённый challengeToken;
- Обменяйте номер телефона, challengeToken и код подтверждения на accessToken.
Внимание: запрос нового кода подтверждения возможен только если предыдущий код истёк (2 минуты), или по предыдущему коду произошла успешная аутентификация. Повторная отправка выпущенного кода подтверждения невозможна, только одновременно с созданием нового.
use Shoman4eg\Nalog\ApiClient;
$apiClient = ApiClient::create();
try {
$phoneChallengeResponse = ApiClient::createPhoneChallenge('79500000000');
/**
* $phoneChallengeResponse = [
* 'challengeToken' => '00000000-0000-0000-0000-000000000000',
* 'expireDate' => 2022-11-24T00:20:19.135436Z,
* 'expireIn' => 120,
* ];
*/
} catch (\Shoman4eg\Nalog\Exception\Domain\UnauthorizedException $e) {
var_dump($e->getMessage());
}
// Сохраните $phoneChallengeResponse['challengeToken']. Он потребуется Вам на втором шаге.
use Shoman4eg\Nalog\ApiClient;
$apiClient = ApiClient::create();
try {
// Запрос accessToken
$accessToken = $apiClient->createNewAccessTokenByPhone(
'79500000000', // Номер телефона
'00000000-0000-0000-0000-000000000000', // challengeToken
'123456' // Код из СМС
);
} catch (\Shoman4eg\Nalog\Exception\Domain\UnauthorizedException $e) {
var_dump($e->getMessage());
}
// Аутентификация с помощью accessToken
$apiClient->authenticate($accessToken);
$name = 'Предоставление информационных услуг #970/2495'; // Наименование
$amount = 1800.30; // Стоимость
$quantity = 1; // Количество
$operationTime = new DateTimeImmutable('2020-12-31 12:12:00'); // Дата продажи
// Создание чека
$createdIncome = $apiClient->income()->create(
$name,
$amount,
$quantity,
$operationTime
);
// UUID чека для операций запроса данных чека или его отмены
$receiptUuid = $createdincome->getApprovedReceiptUuid();
$items = [
new \Shoman4eg\Nalog\DTO\IncomeServiceItem(
'Предоставление информационных услуг #970/2495', // Наименование
1800.30, // Стоимость
1 // Количество
),
new \Shoman4eg\Nalog\DTO\IncomeServiceItem(
'Предоставление информационных услуг #971/2495',
900,
2
),
// И так далее...
];
// Дата продажи
$operationTime = new DateTimeImmutable('2020-12-31 12:12:00');
// Создание чека
$createdIncome = $apiClient->income()->createMultipleItems(
$items,
$operationTime
);
// UUID чека для операций запроса данных чека или его отмены
$receiptUuid = $createdincome->getApprovedReceiptUuid();
$name = 'Предоставление информационных услуг #970/2495'; // Наименование
$amount = 1800.30; // Стоимость
$quantity = 1; // Количество
$operationTime = new DateTimeImmutable('2020-12-31 12:12:00'); // Дата продажи
// По умолчанию физ. лицо без указания контактных данных (INDIVIDUAL)
$client = new \Shoman4eg\Nalog\DTO\IncomeClient();
// Или физ. лицо с указанием контактных данных (INDIVIDUAL)
$client = new \Shoman4eg\Nalog\DTO\IncomeClient(
' 79009500000',
'Вася Пупкин',
\Shoman4eg\Nalog\Enum\IncomeType::INDIVIDUAL,
'395000000000' // ИНН физ. лица (12 символов)
);
// Или юр. лицо (ИП, ООО и т.п.) (LEGAL_ENTITY)
$client = new \Shoman4eg\Nalog\DTO\IncomeClient(
null,
'ИП Вася Пупкин Валерьевич',
\Shoman4eg\Nalog\Enum\IncomeType::LEGAL_ENTITY,
'7700000000' // ИНН юр лица (10 символов)
);
// Или иностранная организация (FOREIGN_AGENCY)
$client = new \Shoman4eg\Nalog\DTO\IncomeClient(
null,
'Facebook Inc.',
\Shoman4eg\Nalog\Enum\IncomeType::FOREIGN_AGENCY,
'9909500000' // ИНН иностранной организации (10 символов)
);
// Создание чека
$createdIncome = $apiClient->income()->create(
$name,
$amount,
$quantity,
$operationTime,
$client
);
// UUID чека для операций запроса данных чека или его отмены
$receiptUuid = $createdincome->getApprovedReceiptUuid();
// UUID чека
$receiptUuid = "20hykdxbp8";
// Получить ссылку на чек для печати
$receipt = $apiClient->receipt()->printUrl($receiptUuid);
// Получить данные по чеку в JSON формате
$receipt = $apiClient->receipt()->json($receiptUuid);
// UUID чека
$receiptUuid = "20hykdxbp8";
// Причина отмены: "Чек выдан ошибочно"
$comment = \Shoman4eg\Nalog\Enum\CancelCommentType::CANCEL;
// Причина отмены: "Возврат денежных средств"
$comment = \Shoman4eg\Nalog\Enum\CancelCommentType::REFUND;
// Код партнёра (по умолчанию: null)
$partnerCode = null;
// Дата совершения возврата (по умолчанию: now)
$operationTime = new \DateTimeImmutable('now');
// Дата запроса отмены чека (по умолчанию: now)
$requestTime = new \DateTimeImmutable('now');
// Отмена чека
$incomeInfo = $apiClient->income()->cancel(
$receiptUuid,
$comment,
$operationTime,
$requestTime,
$partnerCode
);
$apiClient->authenticate($accessToken);
$userInfo = $apiClient->user()->get();
$apiClient->authenticate($accessToken);
$userInfo = $apiClient->tax()->get();
$apiClient->authenticate($accessToken);
$userInfo = $apiClient->tax()->payments();
$apiClient->authenticate($accessToken);
$userInfo = $apiClient->tax()->history();
Статья на Habr: Автоматизация для самозанятых: как интегрировать налог с IT проектом
Реализация на JS: alexstep/moy-nalog
Changelog: A complete changelog
Если этот проект поможет Вам сократить время разработки, вы можете угостить меня чашкой кофе :)
The MIT License (MIT). Please see License File for more information.