Библиотека edupfr.snils_by_data предоставляет средства для запроса СНИЛС через веб-сервис Пенсионного фонда РФ. Метод SnilsByDataRequest веб-сервиса принимает следующие параметры: фамилия, имя, отчество, пол и дату рождения застрахованного (физ. лица). Результатом работы метода SnilsByDataRequest может быть:
код ошибки;
номер СНИЛС (если найден один застрахованный);
список найденных СНИЛС с указанием реквизитов документов, удостоверяющих личность застрахованных.
edupfr.snils_by_data.helpers.get_snils()
Для запроса СНИЛС библиотека предоставляет функцию edupfr.snils_by_data.helpers.get_snils(), которая принимает в качестве аргументов фамилию, имя, отчество, пол и дату рождения застрахованного, а также номер (без серии) и дату выдачи документа, удостоверяющего личность застрахованного, и возвращает (если найден) СНИЛС застрахованного.
Параметры отчество, пол, номер и дата выдачи документа не обязательные.
Если не указывается пол застрахованного, то будет отправлено два запроса с мужским и женским полом.
Номер и дата выдачи документа используются в том случае, если по указанным ФИО и дате рождения найдено несколько застрахованных.
Подробнее об использовании функции написано в ее документации (docstring).
edupfr.snils_by_data.helpers.load_snils_for_objects()
Функция load_snils_for_objects() запрашивает в ПФР СНИЛС для нескольких объектов. Подробнее об использовании функции см. в ее документации (docstring).
Кнопка “Запросить СНИЛС”
Для встраивания в формы в библиотеке реализована кнопка “Запросить СНИЛС” (компонент edupfr.snils_by_data.ui.SnilsRequestButton). Для использования компонента форма должна содержать поля для ввода фамилии, имени и даты рождения (обязательные поля), а также поля для ввода пола застрахованного, отчества номера и даты выдачи документа. Подробнее об использовании компонента написано в его документации (docstring).
Инициализация библиотеки
Для корректной работы библиотеки перед использованием ее необходимо проинициализировать. Для этого следует использовать функцию edupfr.snils_by_data.initialize(). Ее параметры описаны в документации (docstring).
Протоколирование взаимодействия с веб-сервисом
Библиотека edupfr.snils_by_data поддерживает возможность протоколирования (журналирования, логгирования) запросов, отправляемых к веб-сервису, а также получаемых ответов. Протоколирование осуществляется путем вызова функции, указываемой в аргументе log_func функции edupfr.snils_by_data.initialize(). Подробнее см. документацию функции (docstring).
1 maintainer
Metadata
1 maintainer
Release files for edupfr 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| edupfr-0.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Release files / edupfr-0.4.0-py3-none-any.whl
| Download URL | edupfr-0.4.0-py3-none-any.whl |
|---|---|
| Size | 19.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6d63620d6ca32db211ed03782f256f21f31d4c273fd1b470d284780be2b7cb82
|
|
BLAKE2b-256 checksum How to use checksums |
32cd5d6de37b5eee7de208b593d44e7d7a0f036ee447496117fd23b0d44cee90
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.9.23
|
