Integration > API 2.1 > Обязательные перемен...

Обязательные переменные запроса

Запрос
Ответ
Реализация

Обязательные переменные запроса

Эти переменные обязательно должны присутствовать в запросе. Если их нет, либо они не проходят проверку - возвращается глобальная ошибка. Переменные v= и p= по состоянию на декабрь 2020 года имеют умолчания для упрощения перехода с предыдущих версий API, однако в течение 2021 года они также станут строго обязательными.
Мнемоника
(упрощает запоминание)
Переменная Описание
Key key Ключ доступа. Ключ необходимо получить в Личном кабинете. Возможно использование тестового ключа key=test (не более 50 запросов в сутки по московскому времени с одного IP).
Обязательное поле с 25 декабря 2019 года.
From f 2 варианта (распознаются автоматически):
1. 6-значный индекс отправителя.
Исчерпывающий список почтовых индексов, используемых Postcalc.RU в данный момент, можно: 2. Ключ населенного пункта отправителя на русском или английском языке. Кодировка - cp1251 или utf8, регистр букв значения не имеет, однако должны присутствовать все пробелы, скобки и дефисы.
Исчерпывающий список ключей населенных пунктов, используемых Postcalc.RU в данный момент, можно:
  • Посмотреть онлайн.
  • Скачать в формате дампа таблицы MySQL.
  • Скачать упрощенную версию в "старом" формате (вместо номера региона указано название) в виде текста или дампа MySQL для Postcalc Light (таблица postcalc_light_cities). "Старый" формат будет поддерживаться в течение 2021 года, далее поддержка не гарантируется.
Пробелы в запросах можно заменить на подчеркивание: Сергиев_Посад,_50.

Обновление баз данных происходит один раз в месяц.
To t 3 варианта (распознаются автоматически):
1. 6-значный индекс отправителя.
Исчерпывающий список почтовых индексов, используемых Postcalc.RU в данный момент, можно: 2. Ключ населенного пункта отправителя на русском или английском языке. Кодировка - cp1251 или utf8, регистр букв значения не имеет, однако должны присутствовать все пробелы, скобки и дефисы.
Исчерпывающий список ключей населенных пунктов, используемых Postcalc.RU в данный момент, можно:
  • Посмотреть онлайн.
  • Скачать в формате дампа таблицы MySQL.
  • Скачать упрощенную версию в "старом" формате (вместо номера региона указано название) в виде текста или дампа MySQL для Postcalc Light (таблица postcalc_light_cities). "Старый" формат будет поддерживаться в течение 2021 года, далее поддержка не гарантируется.
Пробелы в запросах можно заменить на подчеркивание: Сергиев_Посад,_50.

3. Код из 2 букв или название страны на русском или английском языке.
Список стран и кодов можно: Примечание. В предыдущих версиях API название страны задавалось в отдельной переменной c= в виде кода страны из 2 букв. Совместимость будет поддерживаться в течение 2021 года.

Обновление баз данных происходит один раз в месяц.
Weight w Вес отправления - число полных и неполных граммов (неполный грамм округляется в верхнюю сторону). Число от 1 до 31500. Рекомендуется проверять выход за допустимые пределы по таблице отправлений.
Valuation v Ценность отправления в рублях. Число от 0 до 100 000 для физических лиц и до 3 000 000 для корпоративных клиентов. Рекомендуется проверять выход за допустимые пределы по таблице отправлений.
Parcels p Список кодов отправлений через запятую. Для бесплатного доступа - не более 5 внутренних отправлений и не более 5 международных, для платного не более 8 внутренних и 8 международных. Коды международных отправлений начинаются с i.

Опциональное поле с 16 марта 2020 года, с 01 июня 2020 года - обязательное.

Полный список кодов можно: Внимание! Если переменная p= не задана, то в настоящее время это не вызовет ошибки, а по умолчанию в ответе будут:
  • Для расчетов внутренних отправлений - ценная бандероль, посылка, ценная бандероль 1 класса, посылка 1 класса, EMS (bv,pv,b1v,p1,em);
  • Для международных - мелкий пакет заказной авиа/наземный, посылка, авиапосылка, EMS с товарным вложением (isr,isar,ip,ipa,iem).
Это временная мера для облегчения перехода с предыдущих версий API; настоятельно рекомендуется задавать p= в явном виде.