☰

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

Дата рассылки: 2020-03-17

Ключ p (Parcels) - коды отправлений

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

Сейчас в ответ на запрос api.poscalc.ru отдает расчеты по всем возможным видам отправлений. Это до 18 видов внутренних и 16 видов международных отправлений. Понятно, что такое количество отправлений на практике бессмысленно, это лишняя нагрузка на процессор и лишний трафик.

Поэтому с 16 марта 2020 года вводится переменная p=[список кодов отправлений через запятую]. Полный список кодов приведен ниже, а также на странице с описанием API. Если эта переменная указана, то отдаются расчеты только по данным видам отправлений. Это значительно экономит трафик и увеличивает скорость ответа. Если эта переменная не указана, то до 01 июня 2020 года по-прежнему отдаются все возможные виды отправлений, то есть ничего не меняется.

Начиная с 01 июня 2020 года, на бесплатном доступе будут отдаваться расчеты не более чем по четырем внутренним или международным отправлениям.

Пример:
<QUERY_STRING>&p=p1,ems,ip,iem

В ответе будут: для расчетов внутренних отправлений - посылка 1 класса и EMS, для международных - посылка и EMS с товарным вложением.

Если переменная p в запросе отсутствует, то после 01 июня 2020 года ошибки не возникнет, но в ответе будут следующие 4 отправления по умолчанию: для внутренних - ценная бандероль, посылка, посылка 1 класса, EMS; для международных - мелкий пакет, бандероль, посылка, EMS с товарным вложением.

Список кодов отправлений и ключей следующий:

array(
   // Внутренние отправления
   'ls' => 'ПростоеПисьмо',
   'lr' => 'ЗаказноеПисьмо',
   'lv' => 'ЦенноеПисьмо',
   'bs' => 'ПростаяБандероль',
   'br' => 'ЗаказнаяБандероль',
   'b1r' => 'ЗаказнаяБандероль1Класс',
   'bv' => 'ЦеннаяБандероль',
   'pv' => 'ЦеннаяПосылка',
   'b1v' => 'ЦеннаяБандероль1Класс',
   'p1' => 'Посылка1Класс',
   'em' => 'EMS',
   'po' => 'ПосылкаОнлайн',
   'co' => 'КурьерОнлайн',
   'ek' => 'ЕКОМ',
   'emo' => 'EMSОптимальное',
   'emoc'=> 'EMSОптимальноеКурьер',
   'bc' => 'БизнесКурьер',
   'bce' => 'БизнесКурьерЭкспресс',
   // Международные отправления
   'im' => 'МждМешокМ',
   'ima' => 'МждМешокМАвиа',
   'imr' => 'МждМешокМЗаказной',
   'imar' => 'МждМешокМАвиаЗаказной',
   'ib' => 'МждБандероль',
   'iba' => 'МждБандерольАвиа',
   'ibr' => 'МждБандерольЗаказная',
   'ibar' => 'МждБандерольАвиаЗаказная',
   'is' => 'МждМелкийПакет',
   'isa' => 'МждМелкийПакетАвиа',
   'isr' => 'МждМелкийПакетЗаказной',
   'isar' => 'МждМелкийПакетАвиаЗаказной',
   'ied' => 'EMS_МждДокументы',
   'iem' => 'EMS_МждТовары',
   'ip' => 'МждПосылка',
   'ipa' => 'МждПосылкаАвиа',
);

Рекомендую реализовать поддержку переменной p= в ваших плагинах. Обратите, пожалуйста, внимание, что для бесплатного доступа число видов отправлений не должно превышать четырех как для внутренней, так и для международной доставки.

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