Maillist archive

2019-12-19 Личный кабинет и обязательная регистрация
2020-01-01 Новые тарифы 01 января 2020 года
2020-02-24 Тарифы ЕКОМ
2020-02-29 Тарифы "EMS Оптимальное"
2020-02-29 Расчеты услуги "Бизнес-Курьер"
2020-03-03 Расчеты услуги "Бизнес-Курьер экспресс"
2020-03-14 Добавлены 2031 ПВЗ и АПС партнеров Почты России, введен ключ bo (Box)
2020-03-14 Ключ bo (Box) в API, обновление PostcalcLight (базы данных и версия программы)
2020-03-17 Ключ p (Parcels) - коды отправлений
2020-03-17 Ключи fr (Fragile) и ng (Negabarit) для ценных посылок
2020-03-22 Почтовые отправления для интернет-магазинов
2020-03-23 Ключ ЕКОМПартнер, обновление ОПС городов по умолчанию, таблицы для разработчика
2020-03-24 Опции и дополнительные услуги Почты России
2020-03-24 Ключ sv (Services), расчет для корпоративных клиентов по умолчанию
2020-03-30 Новые тарифы и список ОПС для Посылки Онлайн, пункт "Количество отправлений"
2020-03-30 Ключ pa (Partible), обновление PostcalcLight
2020-04-04 Переход на версию API 2.0 с 01 июня 2020 года
2020-04-04 Для разработчиков: переход на версию API 2.0 с 01 июня 2020 года
2020-04-13 Вывод ошибок тарификации в лог и личный кабинет разработчика
2020-04-17 Тарифы на письменные отправления с 18 апреля 2020 года
2020-04-18 Переменная cod (ставка наложенного платежа для корп. клиентов)
2020-05-09 Расчет сроков доставки
2020-05-13 Сроки доставки международных отправлений и обновление тарифов
2020-06-30 Тарифы на письменные отправления 1-го класса и международные с 01 июля 2020 года
2020-07-04 Тарифы на Посылку Онлайн
2020-07-06 Тарифы на Курьер Онлайн
2020-07-11 Тарифы на ЕКОМ/ЕКОМ Партнер, автоматическое обновление ПВЗ
2020-07-15 Список ОПС для приема отправлений от корпоративных клиентов
2020-07-24 ЕКОМ: доставка в 208 населенных пунктов, максимальный вес 20 кг
2020-12-09 ОПС с ограничениями по доставке: изменение алгоритмов
2020-12-12 Доставка EMS в города с выделенной тарификацией
2020-12-22 Новые тарифы с 01 января 2021 года на письменные отправления - 1-го класса и международные
2020-12-25 Прекращение поддержки EKOM в ПВЗ/АПС партнеров
2020-12-31 Переход на версию API 2.1 с 01 февраля 2021 года
2020-12-31 Новая версия сайта с поддержкой мобильных устройств
2021-01-13 Переход на новую версию сайта
2021-01-15 Повышение тарифов на посылки с 15 января 2021 года

Дата рассылки: 2020-12-31

Переход на версию API 2.1 с 01 февраля 2021 года

Уважаемые коллеги!

С наступающим новым 2021 годом, благополучия и здоровья, пусть новый год окажется счастливее, чем уходящий!

С 01 февраля 2021 года Postcalc.RU переходит на новую версию 2.1, в которой код переписан на 100%. Она максимально совместима с текущей версией 2.0. Подробное описание - по ссылке.

Версия 2.1 доступна по ссылке:
http://api2.postcalc.ru

Отличия от API 2.0:

  1. В одном запросе возвращается расчет не более, чем по 5 отправлениям при бесплатном доступе, и 8 отправлениям при платном. В версии 2.0 на платном доступе возвращались расчеты по всем доступным отправлениям.
  2. Если переменной p= в запросе нет, то при запросе на внутренние отправления возвращаются расчеты по ценной бандероли, бандероли 1-го класса, посылке ценной, посылке 1 класса, EMS, при запросе на международные отправления - мелкий пакет заказной наземный/авиа, посылка наземная/авиа, EMS с товарами. В версии 2.0 при отсутствии переменной p= на платном доступе возвращались все возможные отправления.
  3. Для международных расчетов код страны теперь задается в переменной t= (To). Переменная c= (Country) поддерживается в течение 2021 года.
  4. Данная версия не ведет локальные расчеты - она опрашивает в асинхронном режиме официальный тарификатор Почты России и Postcalc.RU версии 2.0. В массив с расчетами для каждого отправления введен ключ Source, который принимает значение api.postcalc.ru или tariff.pochta.ru. Среднее время расчета - порядка 100-200 мс.
  5. Переменная ib (IBase) игнорируется, поскольку режим расчета страховки ib=f на Почте России не применяется. Страховка всегда рассчитывается, как если бы переменная ib имела значения p (Partial).
  6. Переменная НаложенныйПлатеж удалена из ответа, так как не имеет аналогов в расчетах Почты России. Если она кому-то нужна - пишите, обсудим.
  7. Если при расчете произошли фатальные ошибки, устанавливается массив Response->Errors. Если возможны потенциальные проблемы со отправкой/получением, устанавливается массив Response->Warnings. См. Глобальные ошибки и предупреждения.
  8. Если при расчете конкретного отправления произошли ошибки, устанавливается массив Response->Отправления->КлючОтправления->Errors. Если возникли предупреждения - массив Response->Отправления->КлючОтправления->Warnings. См. Ошибки и предупреждения при расчете отправления. Переменная НетРасчета удалена из ответа, поскольку в ней нет необходимости.
  9. Полностью заменена таблица городов - старая нотация (город, регион, район) заменена на ключи населенных пунктов.
    • Для центров регионов ключи состоят из названия населенного пункта: Москва, Самара, Благовещенск.
    • Для прочих населенных пунктов состоят из его названия и номера региона через запятую: Сергиев Посад, 50; Благовещенск, 2 (город в Башкортостане), Самара, 38 (село в Иркутской области); Самара, 79 (село в Еврейской АО).
    • Если в пределах одного региона находятся несколько населенных пунктов с одним названием, то через запятую добавляется район: Михайловка, 2, Абзелиловский; Михайловка, 2, Архангельский; Михайловка, 2, Бакалинский.
    В ключе населенного пункта вместо номера региона можно указать его название (совместимый формат запроса), например: Сургут, Ханты-Мансийский-Югра автономный округ; Сергиев Посад, Московская область. Однако так делать не рекомендуется, так как это ухудшает читаемость и удлиняет строку запроса, кроме того, у регионов имеются альтернативные названия и они могут меняться.
  10. Введена переменная la (Language). Если la=en, то ответ, насколько возможно, выдается на английском языке.
  11. Введена переменная cu (Currency). Если cu!=rub, то рубли в ответе переводятся в соответствующую валюту по курсу Центробанка РФ.

Вам необходимо обновить запросы с версии 2.0, если:
1. Запрашивается более 8 отправлений на платном доступе. Необходимо оставить не более 8 кодов отправлений для внутренних и не более 8 кодов для международных отправлений. Количество отправлений для бесплатного доступа не изменилось (не более 5).
2. Вы используете в запросах названия населенных пунктов. Полный список ключей населенных пунктов находится в таблице postcalc_mini_cities. Если вы используете библиотеку Postcalc Light, обновите таблицу postcalc_light_cities. Однако в Postcalc Light населенные пункты находятся в совместимом формате запроса.

В качестве сервера API можно:
1. Указать api.postcalc.ru. Это сервер API 2.0 с дополнительными патчами, которые корректно обрабатывают ключи населенных пунктов и двухбуквенный код страны в переменной t=. 01 февраля 2021 года он будет заменен на сервер API 2.1.
2. Указать api2.postcalc.ru. Это функционирующий сервер API 2.1.
Ключи доступа (key=) и лимиты - общие, то есть можно сделать в сутки суммарно 50 запросов с ключом test и 500 бесплатных запросов с зарегистрированным ключом к обоим серверам.

Еще раз с наступающим Новым Годом, если какие вопросы - пишите на postcalc@mail.ru! 

С наилучшими пожеланиями -

Алексей Руденко-Десняк,
автор проекта Postcalc.RU