|
Обязательные переменные запроса
Эти переменные обязательно должны присутствовать в запросе. Если их нет, либо они не проходят проверку - возвращается глобальная ошибка. Переменные 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 в данный момент, можно:
Пробелы в запросах можно заменить на подчеркивание: Сергиев_Посад,_50.
Обновление баз данных происходит один раз в месяц.
|
|
To
|
t
|
3 варианта (распознаются автоматически):
1. 6-значный индекс отправителя.
Исчерпывающий список почтовых индексов, используемых Postcalc.RU в данный момент, можно:
2. Ключ населенного пункта отправителя на русском или английском языке. Кодировка - cp1251 или utf8, регистр букв значения не имеет, однако должны присутствовать все пробелы, скобки и дефисы.
Исчерпывающий список ключей населенных пунктов, используемых Postcalc.RU в данный момент, можно:
Пробелы в запросах можно заменить на подчеркивание: Сергиев_Посад,_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= в явном виде.
|
|
