Данные

class pochta.api.nogroup.NoGroup(client)

Bases: object

Методы API Данных.

Используется через объект Delivery или вручную.

Инициализация API Данных.

Parameters

client (Delivery) – API клиент Доставки

address_normalization(addresses)

Нормализация адреса.

Разделяет и помещает сущности переданных адресов (город, улица) в соответствующие поля возвращаемого объекта. Параметр id (идентификатор записи) используется для установления соответствия переданных и полученных записей, так как порядок сортировки возвращаемых записей не гарантируется. Метод автоматически ищет и возвращает индекс близлежащего ОПС по указанному адресу.

https://otpravka.pochta.ru/specification#/nogroup-normalization_adress

Parameters

addresses (List[Address]) – Список адрессов

Return type

dict

Returns

Результат нормализации

calc_delivery_rate(completeness_checking=None, courier=None, declared_value=None, height=None, length=None, width=None, entries_type=None, fragile=None, index_from=None, index_to=None, mail_category=<MailCategory.SIMPLE: 'SIMPLE'>, mail_direct=None, mail_type=<MailType.POSTAL_PARCEL: 'POSTAL_PARCEL'>, mass=100, notice_payment_method=None, payment_method=None, sms_notice_recipient=None, transport_type=None, with_order_of_notice=False, with_simple_notice=False)

Калькулятор стоимости доставки.

Рассчитывает стоимость пересылки в зависимости от указанных входных данных. Индекс ОПС точки отправления берется из профиля клиента. Возвращаемые значения указываются в копейках.

https://otpravka.pochta.ru/specification#/nogroup-rate_calculate

Parameters

• completeness_checking (Optional[bool]) – Признак услуги проверки комплектности

• courier (Optional[bool]) – Отметка “Курьер”

• declared_value (Optional[int]) – Объявленная ценность

• height (Optional[int]) – Линейная высота (сантиметры)

• length (Optional[int]) – Линейная длина (сантиметры)

• width (Optional[int]) – Линейная ширина (сантиметры)

• entries_type (Optional[EntryType]) – Категория вложения.

• fragile (Optional[bool]) – Отметка “Осторожно/Хрупко”

• index_from (Optional[str]) – Почтовый индекс объекта почтовой связи места приема

• index_to (Optional[str]) – Почтовый индекс объекта почтовой связи места назначения

• mail_category (MailCategory) – Категория РПО

• mail_direct (Optional[int]) – Код страны назначения.

• mail_type (MailType) – Вид РПО

• mass (int) – Масса отправления в граммах

• notice_payment_method (Optional[PaymentType]) – Способ оплаты уведомеления.

• payment_method (Optional[PaymentType]) – Способ оплаты.

• sms_notice_recipient (Optional[int]) – Признак услуги SMS уведомления

• transport_type (Optional[TransportType]) – Вид транспортировки

• with_order_of_notice (bool) – Отметка ‘С заказным уведомлением’

• with_simple_notice (bool) – Отметка ‘С простым уведомлением’

Return type

dict

Returns

Результат расчета доставки

check_reliability(recipients)

Проверка благонадежности получателя.

Актуально для отправлений с наложенным платежом. Определяет, является ли получатель благонадёжным, есть ли прецеденты невыкупа.

https://otpravka.pochta.ru/specification#/nogroup-unreliable_recipient

Parameters

recipients (List[Recipient]) – Список получателей

Return type

List[dict]

Returns

Результат проверки

counterpart_balance

Отображение баланса.

Отображает баланс расчетного счета. Возвращаемые значения указываются в копейках.

https://otpravka.pochta.ru/specification#/nogroup-counterpart_balance

Return type

dict

Returns

Информация о балансе контрагента

fio_normalization(names)

Нормализация ФИО.

Очищает, разделяет и помещает значения ФИО в соответствующие поля возвращаемого объекта. Параметр id (идентификатор записи) используется для установления соответствия переданных и полученных записей, так как порядок сортировки возвращаемых записей не гарантируется.

https://otpravka.pochta.ru/specification#/nogroup-normalization_fio

Parameters

names (List[Name]) – Список имен

Return type

dict

Returns

Результат нормализации

phone_normalization(phone_numbers)

Нормализация телефона.

Принимает номера телефонов в неотформатированном виде, который может включать пробелы, символы: +-(). Очищает, разделяет и помещает сущности телефона (код города, номер) в соответствующие поля возвращаемого объекта. Если номер телефона 11-ти значный (мобильный), то дополнительные параметры, кроме original-phone и id, указывать не обязательно. Если номер телефона стационарный, то необходимо опционально указать дополнительные параметры для определения кода города. Параметр id (идентификатор записи) используется для установления соответствия переданных и полученных записей, так как порядок сортировки возвращаемых записей не гарантируется.

https://otpravka.pochta.ru/specification#/nogroup-normalization_phone

Parameters

phone_numbers (List[Phone]) – Список номеров

Return type

dict

Returns

Результат нормализации