Уважаемые коллеги!
С 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. Следует учитывать, что не все виды отправлений имеют все виды услуг и опций.
|
||||||||||||||||||||||||||
| 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 года.