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-04-04

Для разработчиков: переход на версию API 2.0 с 01 июня 2020 года

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

С 01 июня 2020 года Postcalc.RU переходит на новую "большую версию" API - версию 2.0. 

С октября 2019 года в API проекта был внесен ряд изменений. Основная цель - максимально приблизить расчеты на Postcalc.RU к расчетам на официальных тарификаторах Почты России.

В настоящее время активная работа завершена, нынешнее API 1.2 полностью совпадает с API 2.0, за исключением установок по умолчанию для переменных p (Parcels) и ib (InsuranceBase). То есть вы можете прямо сейчас внести изменения в ваш плагин, проверить его и быть уверенными, что с 01 июня 2020 года плагин будет работать корректно.

Ниже список переменных, затронутых изменениями.

Мнемо-ника Перемен-ная По умолчанию Описание
Key key нет Ключ доступа. С 19 октября 2019 года. Ключ необходимо получить в Личном кабинете. Возможно использование тестового ключа key=test (не более 50 запросов в сутки с одного IP).
Parcels p Для бесплатного доступа -
bv,pv,b1v,p1,ems,
is,isa,ip,ipa,iem
Для платного доступа - все возможные отправления
Список кодов отправлений через запятую. С 16 марта 2020 года. Для бесплатного доступа - не более 5 внутренних отправлений и не более 5 международных. Коды для международных отправлений начинаются с i. По умолчанию в ответе будут: для расчетов внутренних отправлений - ценная бандероль, посылка, ценная бандероль 1 класса, посылка 1 класса, EMS; для международных - мелкий пакет, мелкий пакет авиа, посылка, авиапосылка, EMS с товарным вложением. Коды отправлений см. в документации ниже.
Опциональное поле с 16 марта 2020 года, с 01 июня 2020 года - обязательное.
Corp co 1 Если 1, расчет идет по тарифам для клиентов, имеющих договор с Почтой России ("корпоративные клиенты"), если 0 - расчет по тарифам для "обычных" клиентов: физических лиц и индивидуальных предпринимателей без договора. С 25 октября 2019 года.
С 23 марта 2020 года по умолчанию - 1, до этого - 0.
По состоянию на март 2020 года касается: 1. расчета ценных посылок. 2. расчета "EMS Оптимальное". 3. Некоторых дополнительных услуг. Для "корпоративных клиентов" тарифы несколько ниже.
Box bo s Тип коробки, определяет т.н. объемный вес. Если объемный вес больше реального, то при расчете тарифа применяется именно он. С 14 марта 2020 года.
По состоянию на март 2020 года касается только расчета "ЕКОМ".
Значения: s (коробка "S", 260*170*80 мм), m (коробка "M", 300*200*150 мм), l (коробка "L", 400*270*180 мм), xl (коробка "XL", 530*360*220 мм), ng (негабаритная коробка, сумма сторон не более 1400 мм, одна сторона не более 600 мм).
Services sv пустая строка Опции отправки и дополнительные услуги . Список кодов через запятую, например: sv=sm,ko,cod.
Следует учитывать, что не все виды отправлений имеют все виды услуг и опций.
Код Услуга
fr Хрупкая (только для посылок)
ng Негабаритная (только для посылок)
op Проверка соответствия вложения описи
ko Проверка комплектности
pp Предпочтовая подготовка
sm SMS получателю
sm2 SMS отправителю
cod Оплата в момент доставки (COD)
uv Простое уведомление о вручении
uvr Заказное уведомление о вручении
uve Электронное уведомление о вручении
iuv Международное уведомление о вручении
Partible pa 0 Отправление является делимым (можно распределить на несколько). С 30 марта 2020 года.
Если 0 (по умолчанию), используется логика официальных калькуляторов Почты России: отправление может быть только одно, при превышении допустимого веса и/или ценности расчет не производится.
Если 1, используется логика Postcalc.RU: отправление делится на несколько, контроль ценности не производится.
Например, для веса 20 кг при pa=0 расчет бандероли не производится, при pa=1 возвращается расчет для 4-х бандеролей весом по 5 кг каждая.
Внимание! Для внутренних писем ограничение по весу действует в любом случае (так было в расчетах Postcalc.RU с самого начала): простое, заказное, ценное письмо рассчитываются при весе не более 100 г, заказное и ценное письмо 1 класса - не более 500 г.
IBase ib f, с 01 июня 2020 года - p. База для расчета страховки (только при оценке товарного вложения больше 0!).

Если IBase=p или Partial, то страхуется только товарное вложение. Например, посылка с оценкой 1000 рублей будет застрахована на 1000 * 4% = 40 рублей независимо от стоимости доставки.
В случае пропажи отправления почта возместит только стоимость товара, а расходы на доставку и страховку придется списать в убыток.
Кроме того, при отправке наложенным платежом возникает проблема расчета суммы, которую адресат должен выплатить при получении отправления: ведь эта сумма больше оценки товара и должна покрывать расходы интернет-магазина на доставку и страховку

Если IBase=f или Full, базой страховки будет Оценка Товара + Тариф + Страховка, и в случае пропажи отправления почта полностью возместит ущерб. Это самый оптимальный вариант для отправки наложенным платежом, а конечная сумма, которую должен заплатить адресат - это столбец "Ценность" на веб-странице или поле ОценкаПолная в ответе по API.
Ценность вычисляется по формуле: Ценность = Тариф + Оценка вложения + Страховка
Размер страхового сбора вычисляется по формуле: Страховка = ( Тариф + Оценка ) * СтавкаСбора / (1 - СтавкаСбора)


Обратите внимание, что в API 2.0 использовать мнемонику вместо переменной не допускается (например, нельзя From вместо f).

Ключи переменной p (Parcels) для внутренних отправлений.

Параметр переменной p Английский ключ ответа Русский ключ ответа Описание
ls LetterSimple ПростоеПисьмо Простое письмо
lr LetterReg ЗаказноеПисьмо Заказное письмо
lv LetterValued ЦенноеПисьмо Ценное письмо
l1r Letter1ClassReg ЗаказноеПисьмо1Класс Заказное письмо 1 класса
l1v Letter1ClassValued ЦенноеПисьмо1Класс Ценное письмо 1 класса
bs BookpostSimple ПростаяБандероль Простая бандероль
br BookpostReg ЗаказнаяБандероль

Заказная бандероль

b1r Bookpost1ClassReg ЗаказнаяБандероль1Класс Заказная бандероль 1 класс
bv BookpostValued ЦеннаяБандероль Ценная бандероль
pv ParcelValued ЦеннаяПосылка Ценная посылка
b1v Bookpost1ClassValued ЦеннаяБандероль1Класс Ценная бандероль 1 класс
p1 Parcel1Class Посылка1Класс Посылка 1 класса
em EMS EMS Курьерская доставка EMS
po ParcelOnline ПосылкаОнлайн Услуга "Посылка Онлайн" для корпоративных клиентов
co CourierOnline КурьерОнлайн Услуга "Курьер Онлайн" для корпоративных клиентов
ek EKOM ЕКОМ Услуга "ЕКОМ" для корпоративных клиентов (ключ пишется кириллицей!) с доставкой в ПВЗ/АПС Почты России.
ekp EKOMPartner ЕКОМПартнер Услуга "ЕКОМ" для корпоративных клиентов (ключ пишется кириллицей!) с доставкой в ПВЗ/АПС партнеров Почты России.
emo EMSOptimal EMSОптимальное Услуга "EMS Оптимальное" с доставкой до ЦВПП. В ключе EMS пишется латиницей, "Оптимальное" - кириллицей.
emoc EMSOptimalCourier EMSОптимальноеКурьер Услуга "EMS Оптимальное" с доставкой клиенту курьером. В ключе EMS пишется латиницей, "Оптимальное" - кириллицей.
bc BusinessCourier БизнесКурьер Услуга "Бизнес-Курьер" для корпоративных клиентов Почты России.
bce BusinessCourierExpress БизнесКурьерЭкспресс Услуга "Бизнес-Курьер экспресс" для корпоративных клиентов Почты России.

Ключи переменной p (Parcels) для международных отправлений.

Параметр переменной p Английский ключ ответа Ключ ответа Описание
im IntParcelM МждМешокМ Международный мешок М
ima IntParcelMAvia МждМешокМАвиа

Международный мешок М авиа

imr IntParcelMReg МждМешокМЗаказной Международный мешок М заказной
imar IntParcelMAviaReg МждМешокМАвиаЗаказной Международный мешок М авиа заказной
ib IntBookpost МждБандероль Международная бандероль
iba IntBookpostAvia МждБандерольАвиа Международная авиабандероль
ibr IntBookpostReg МждБандерольЗаказная Международная бандероль заказная
ibar IntBookpostAviaReg МждБандерольАвиаЗаказная Международная авиабандероль заказная
is IntSmallPacket МждМелкийПакет Международный мелкий пакет
isa IntSmallPacketAvia МждМелкийПакетАвиа Международный мелкий пакет авиа
isr IntSmallPacketReg МждМелкийПакетЗаказной Международный мелкий пакет заказной
isar IntSmallPacketAviaReg МждМелкийПакетАвиаЗаказной Международный мелкий пакет авиа заказной
ied IntEMSDocs EMS_МждДокументы ЕMS международное - документы
iem IntEMSMerchandise EMS_МждТовары ЕMS международное - товары
ip IntParcel МждПосылка Международная посылка *
ipa IntParcelAvia МждПосылкаАвиа Международная авиапосылка *

Все эти изменения также опубликованы на страницах:

http://www.postcalc.ru/api.html

http://www.postcalc.ru/api20_transition.html

По любым вопросам пишите в техподдержку на postcalc@mail.ru.

С уважением -
Алексей Руденко-Десняк,
автор проекта Postcalc.RU,
04 апреля 2020 года.