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

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