Feedback > Maillist archive

Архив рассылок

Дата рассылки: 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

Для бесплатного доступа -
bv,pv,b1v,p1,ems,
is,isa,ip,ipa,iem
Для платного доступа - все возможные отправления

Список кодов отправлений через запятую. С 16 марта 2020 года. Для бесплатного доступа - не более 5 внутренних отправлений и не более 5 международных. Коды для международных отправлений начинаются с i. По умолчанию в ответе будут: для расчетов внутренних отправлений - ценная бандероль, посылка, ценная бандероль 1 класса, посылка 1 класса, EMS; для международных - мелкий пакет, мелкий пакет авиа, посылка, авиапосылка, EMS с товарным вложением. Коды отправлений см. в документации ниже.
Опциональное поле с 16 марта 2020 года, с 01 июня 2020 года - обязательное.

Corp

Если 1, расчет идет по тарифам для клиентов, имеющих договор с Почтой России ("корпоративные клиенты"), если 0 - расчет по тарифам для "обычных" клиентов: физических лиц и индивидуальных предпринимателей без договора. С 25 октября 2019 года.
С 23 марта 2020 года по умолчанию - 1, до этого - 0.
По состоянию на март 2020 года касается: 1. расчета ценных посылок. 2. расчета "EMS Оптимальное". 3. Некоторых дополнительных услуг. Для "корпоративных клиентов" тарифы несколько ниже.

Box

Тип коробки, определяет т.н. объемный вес. Если объемный вес больше реального, то при расчете тарифа применяется именно он. С 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=sm,ko,cod.
Следует учитывать, что не все виды отправлений имеют все виды услуг и опций.

Код	Услуга
fr	Хрупкая (только для посылок)
ng	Негабаритная (только для посылок)
op	Проверка соответствия вложения описи
ko	Проверка комплектности
pp	Предпочтовая подготовка
sm	SMS получателю
sm2	SMS отправителю
cod	Оплата в момент доставки (COD)
uv	Простое уведомление о вручении
uvr	Заказное уведомление о вручении
uve	Электронное уведомление о вручении
iuv	Международное уведомление о вручении

Partible

Отправление является делимым (можно распределить на несколько). С 30 марта 2020 года.
Если 0 (по умолчанию), используется логика официальных калькуляторов Почты России: отправление может быть только одно, при превышении допустимого веса и/или ценности расчет не производится.
Если 1, используется логика Postcalc.RU: отправление делится на несколько, контроль ценности не производится.
Например, для веса 20 кг при pa=0 расчет бандероли не производится, при pa=1 возвращается расчет для 4-х бандеролей весом по 5 кг каждая.
Внимание! Для внутренних писем ограничение по весу действует в любом случае (так было в расчетах Postcalc.RU с самого начала): простое, заказное, ценное письмо рассчитываются при весе не более 100 г, заказное и ценное письмо 1 класса - не более 500 г.

IBase

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 года.