—крыть меню * ¬ерси€ дл€ печати

API почтового калькул€тора Postcalc.RU

1. «апрос

»меет 2 формы - краткую и полную. ¬ы можете щелкнуть по ссылкам и посмотреть ответ сервера в читабельном виде.

ѕример полной формы запроса:
http://postcalc.ru/get.php?From=101000&Country=RU&To=190000&Weight=1000&Valuation=1000&Step=0&Date=10.02.2011

“от же запрос в краткой форме:
http://postcalc.ru/get.php?f=101000&c=RU&t=190000&w=1000&v=1000&s=0&d=10.02.2011

«апрос в краткой форме с опущенными параметрами по умолчанию (вес - 1000 г, оценка - 0 рублей, расчет на насто€щий момент):
http://postcalc.ru/get.php?f=101000&t=190000

Ёто то же самое, что и следующий запрос (отделение 101000 €вл€етс€ ќѕ— по умолчанию дл€ ћосквы, а 190000 - дл€ —анкт-ѕетербурга):
http://postcalc.ru/get.php?f=ћосква&t=—анкт-ѕетербург

ќписание полей запроса
ѕолна€ форма  ратка€ форма ѕо умолчанию ќписание
From f ћосква
=или=
101000

2 варианта (распознаютс€ автоматически).

1. Ќазвание пункта отправлени€, как это определено в списке местоположений EMS. Ёто может быть город ('ћосква', 'ќрел', '¬ладивосток' и т.п.) или регион ('ћосковска€ область', '—еверна€ ќсети€-јлани€ республика' и т.п.) .  одировка - cp1251 или utf8, разпознаетс€ автоматически, регистр букв значени€ не имеет, однако должны присутствовать все пробелы и дефисы. »ндекс предпри€ти€ св€зи беретс€ по умолчанию - это первое по номеру отделение св€зи, принимающее почту дл€ населени€. 

2. 6-значный индекс отправител€.

To t —анкт-ѕетербург
=или=
190000

2 варианта (распознаютс€ автоматически).

1. Ќазвание пункта назначени€, как это определено в списке местоположений EMS. Ёто может быть город ('ћосква', 'ќрел', '¬ладивосток' и т.п.) или регион ('ћосковска€ область', '—еверна€ ќсети€-јлани€ республика' и т.п.) .  одировка - cp1251 или utf8, разпознаетс€ автоматически, регистр букв значени€ не имеет, однако должны присутствовать все пробелы и дефисы. »ндекс предпри€ти€ св€зи беретс€ по умолчанию - это первое по номеру отделение св€зи, принимающее почту дл€ населени€. 

2. 6-значный индекс адресата.

Weight w 1000 ¬ес отправлени€ в граммах. Ќе более 100 кг.
Valuation v 0 ќценка товарного вложени€ в рубл€х. Ќе более 100 тыс. рублей. 
Date d now ƒата, на которую нужно рассчитать отправку, в любом формате, который распознаетс€ функцией PHP strtotime(). ¬ частности, распознаютс€ такие варианты: 30.01.2011, 30-01-2011, 2011-01-30, now, +10days. ѕо умолчанию - текущий момент времени (now).
Step s 0 ≈сли 0, выводитс€ подробный расчет дл€ данного отправлени€, с учетом веса и оценки. ≈сли равно 100, 500 или 1000, выдаетс€ таблица тарифов дл€ отправлений разного веса с шагом 100, 500 или 1000 граммов соответственно. “аблица содержит 20 строк.
Country c RU ƒвузначный код страны (дл€ международных доставок) из списка. ћожно также использовать трехбуквенный код или название страны по-русски либо по-английски.
Output o html

‘ормат выдачи данных. ѕоддерживаютс€ следующие форматы: php, json, xml, html, arr. –егистр букв значени€ не имеет.
1. HTML. —траница html в читабельном виде, кодировка windows-1251, удобно дл€ просмотра ответа сервера пр€мо из браузера.
2. PHP. ћассив PHP, обработанный функцией serialize(). ”добно дл€ использовани€ напр€мую в скриптах PHP, дл€ чего на стороне клиента следует использовать функцию unserialize() - см. пример в конце страницы.  одировка windows-1251.
3. ARR. ћассив PHP, выведенный функцией print_r().  одировка windows-1251, удобно дл€ контрол€ ответов сервера из браузера.
4. XML или WDDX - массив PHP, обработанный функцией wddx_serialize_value().  одировка UTF-8.
5. JSON - массив PHP, обработанный функцией json_encode().  одировка UTF-8 + JavaScript Object Notation (JSON). ”добно дл€ использовани€ в JavaScript.

Extended e 0 ƒетализаци€ ответа. ѕри e=0 выдаютс€ основные данные (тариф, страховка, оценка, наложенный платеж, сроки доставки, адреса и телефоны отделений св€зи), при других значени€х могут выдаватьс€ некоторые недокументированные сведени€. ѕри разработке собственных модулей, обращающихс€ к API PostCalc.RU, насто€тельно рекомендуетс€ ограничиватьс€ только основными данными, так как расширенные данные могут мен€тьс€ без уведомлени€.

 

2. ќтвет

ќтвет - иерархический массив в одном из 5 форматов (см. описание ключа Output в запросе). ќбратите внимание, что большинство ключей написано кириллицей - это, на мой взгл€д, значительно упрощает работу русско€зычных программистов. 

ј. ќбщие ключи - дл€ всех видов отправлений.

 люч «начение
Status ≈сли ошибки нет, возвращает OK, иначе - код ошибки
Message —ообщение об ошибке.  люч устанавливаетс€, только если возникла ошибка (Status!='OK').
_request

Ёхо-массив переменных, полученных сервером от клиента. ћожет быть полезно при отладке.

ƒата ƒата расчета тарифа в формате ƒƒ.ћћ.√√√√
ƒата—верки“арифов ƒата сверки тарифов с сайтами ѕочты –оссии и EMS
¬ес ¬ес отправлени€ в граммах, использовавшийс€ при расчетах.
ќценка ќценка вложени€ в рубл€х, использовавша€с€ при расчетах.
ћеждународное ѕункт международного обмена почтой - ћќ— ¬ј или —јЌ “-ѕ≈“≈–Ѕ”–√.  люч устанавливаетс€ только дл€ доставки за рубеж.

 лючи ќткуда и  уда - устанавливаютс€ дл€ всех отправлений; дл€ международных отправлений значени€  уда следует игнорировать. 

 люч1  люч2 «начение
ќткуда
=или=
 уда
»ндекс 6-значный индекс предпри€ти€ св€зи.
Ќазвание Ќазвание отделени€ св€зи, например, ћќ— ¬ј-523.
јдрес  јдрес отделени€ св€зи.
“елефон “елефоны отделени€ св€зи.
ћестоположениеEMS Ќазвание центра региона или субъекта федерации (см. список ћестоположений EMS).
÷ентр–егиона Ќазвание центра региона.

 люч ќграничени€ устанавливаетс€ только дл€ внутренних отправлений и только если дл€ данного почтового индекса имеютс€ ограничени€ по доставке. 

 люч1  люч2  люч3 «начение
ќграничени€ ќткуда
=или=
 уда
“ип Ѕуквенное обозначение типа ограничени€, используетс€ во внутренних процедурах PostCalc.RU. ¬арианты: 
1. «апрет - установлен только период(ы) полного запрета доставки, в остальное врем€ доставка наземна€.
2. јвиа¬есь√од-јвиа - авиадоставка от центра региона круглый год, установлен период(ы), когда возможна только авиадоставка.
3. јвиа¬есь√од-Ќаземный - комбинированна€ доставка от центра региона круглый год; установлен период(ы), когда возможна только комбинированна€ доставка. 
4. јвиа—езонно - установлен период, когда возможна только авиадоставка, в остальное врем€ доставки нет вообще.
5. «апрет* - особа€ ситуаци€, св€занна€ с ошибкой в Ёталонном справочнике ограничений: установлены периоды запрета доставки, однако имеетс€ сноска, что доставка авиа разрешена. ƒл€ этих ќѕ— точный расчет тарифа в периоды закрыти€ дл€ наземной доставки невозможен (в основном якути€).
ƒействует ƒействует ли ограничение на момент расчета. ≈сли действует, принимает значение '«јѕ–≈“' или 'ј¬»ј'.
јвиадоставка ѕериод доставки только авиатранспортом в формате ƒƒ.ћћ-ƒƒ.ћћ;ƒƒ.ћћ-ƒƒ.ћћ...
«апретƒоставки ѕериод полного запрета доставки в формате ƒƒ.ћћ-ƒƒ.ћћ;ƒƒ.ћћ-ƒƒ.ћћ...

 люч ћагистраль - устанавливаетс€ только дл€ внутренних отправлений, и только если имеетс€ доставка по магистрали (между центрами регионов). 

 люч1  люч2 «начение
ћагистраль ќписание ќписание маршрута, например, ћќ— ¬ј=>—јЌ “-ѕ≈“≈–Ѕ”–√
–ассто€ние  “арифицируемое рассто€ние между городами магистрали в км по железной дороге. ƒл€ регионов, куда железнодорожной доставки нет - примерное рассто€ние.
ƒоставка—тандарт  Ќормативный срок доставки посылки наземным (водным) транспортом в сутках, не счита€ дн€ подачи отправлени€.
ƒоставкајвиа Ќормативный срок доставки письменной корреспонденции, он же установлен и дл€ доставки посылок авиатранспортом. 
ƒоставка ласс1 Ќормативный срок доставки 1-м классом.

 

Ѕ.  лючи и значени€ дл€ внутренних отправлений (Country=RU или параметр в запросе опущен):

 люч ќписание
ѕроста€Ѕандероль ѕроста€ бандероль
«аказна€Ѕандероль

«аказна€ бандероль

«аказна€Ѕандероль1 ласс «аказна€ бандероль 1 класс
÷енна€Ѕандероль ÷енна€ бандероль
÷енна€ѕосылка ÷енна€ посылка
÷енна€јвиаЅандероль ÷енна€ авиабандероль
÷енна€јвиаѕосылка ÷енна€ авиапосылка
÷енна€Ѕандероль1 ласс ÷енна€ бандероль 1 класс
EMS  урьерска€ доставка EMS

 лючи и значени€ дл€ внутренних отправлений на примере ценной бандероли:

 люч1  люч2 «начение
÷енна€Ѕандероль
 
Ќазвание Ќазвание почтового отправлени€
 оличество „исло почтовых отправлений с учетом максимального разрешенного веса.
“ариф ѕочтовый тариф в рубл€х (без учета страховки).
—траховка “олько дл€ ценных отправлений с оценкой больше 0: страховка в рубл€х.
ƒоставка ƒл€ ценных отправлений с оценкой больше 0: тариф+страховка в рубл€х. ƒл€ остальных отправлений - то же самое, что тариф.
ѕроверено ≈сли 1, расчет полностью основан на документально подтвержденных тарифах. ≈сли 0, возможны неточности. ¬ частности, при расчете ценных отправлений дл€ большинства городов используютс€ магистральные по€са не из официальных документов ѕочты –оссии, а вычисленные на основе рассто€ний по железной дороге, то же относитс€ к авиатарифам и т.п. ќбычно неточность невелика и находитс€ в пределах нескольких рублей на килограмм веса.
ѕростые и заказные бандероли, а также EMS, всегда имеют в этом поле 1.
ќценкаѕолна€ “олько дл€ ценных отправлений: сумма оценки в рубл€х, которую необходимо дать почтовому отправлению, чтобы получить на расчетный счет сумму, равную оценке товарного вложени€. –авна: ќценка товарного вложени€ + “ариф + —траховка.
Ќаложенныйѕлатеж “олько дл€ ценных отправлений: сумма в рубл€х, которую платит адресат на почте при наложенном платеже.
Ќаложенныйѕлатеж2 “олько дл€ ценных отправлений в “омской и »ркутской област€х,  расно€рском крае, якутии: наложенный платеж в районах, приравненных к  райнему —еверу. ¬ остальных регионах равно 0.
Ќаложенныйѕлатеж3 “олько дл€ ценных отправлений в  расно€рском крае: наложенный платеж в районах  райнего —евера. ¬ остальных регионах равно 0.
Ќет–асчета

 люч устанавливаетс€, если тариф дл€ данного отправлени€ не может быть достоверно рассчитан. —одержит описание причины. —ледующие варианты:
1. јвиабандероль и авиапосылка, если в базе данных нет магистрального авиатарифа (тарифа на перелет между центрами регионов).
2. ѕроста€ и заказна€ бандероль по маршруту, который включает отрезки с авиадоставкой (возможен только расчет ценных отправлений).
3. ќтделение отправител€ или получател€ временно закрыто.
4. ќшибка в Ёталонном справочнике ограничений по доставке.

 

¬.  лючи и значени€ дл€ международных отправлений:

 люч ќписание
ћждћешокћ ћеждународный мешок ћ
ћждћешокћјвиа

ћеждународный мешок ћ авиа

ћждћешокћ«аказной ћеждународный мешок ћ заказной
ћждћешокћјвиа«аказной ћеждународный мешок ћ авиа заказной
ћждЅандероль ћеждународна€ бандероль
ћждЅандерольјвиа ћеждународна€ авиабандероль
ћждЅандероль«аказна€ ћеждународна€ бандероль заказна€
ћждЅандерольјвиа«аказна€ ћеждународна€ авиабандероль заказна€
ћждћелкийѕакет ћеждународный мелкий пакет
ћждћелкийѕакетјвиа ћеждународный мелкий пакет авиа
ћждћелкийѕакет«аказной ћеждународный мелкий пакет заказной
ћждћелкийѕакетјвиа«аказной ћеждународный мелкий пакет авиа заказной
EMS_ћждƒокументы ≈MS международное - документы
EMS_ћжд“овары ≈MS международное - товары

 лючи и значени€ дл€ международных отправлений на примере международного отправлени€ EMS с товарным вложением:

 люч1  люч2 «начение
≈MS международное - товары
 
Ќазвание Ќазвание почтового отправлени€
 оличество „исло почтовых отправлений с учетом максимального разрешенного веса.
“ариф ѕочтовый тариф в рубл€х (без учета страховки).
—траховка “олько дл€ ценных отправлений с оценкой больше 0: страховка в рубл€х.
ƒоставка ƒл€ ценных отправлений с оценкой больше 0: тариф+страховка в рубл€х. ƒл€ остальных отправлений - то же самое, что тариф.
ќценкаѕолна€ “олько дл€ ценных отправлений: сумма оценки в рубл€х, которую необходимо дать почтовому отправлению, чтобы получить на расчетный счет сумму, равную оценке товарного вложени€. –авна: ќценка товарного вложени€ + “ариф + —траховка.

 

3. ѕример запроса на PHP к Postcalc.RU:

<?
header('Content-Type: text/html; charset=windows-1251');
$Request='http://postcalc.ru/get.php?f=ћосква&t=—анкт-ѕетербург&w=1000&v=1000&o=php';
$Response=file_get_contents($Request) or die('Could not connect!');
$arrResponse=unserialize($Response);
echo $arrResponse['ѕроста€Ѕандероль']['“ариф'];
?>

 






(c) PostCalc.RU 2010-17



яндекс.ћетрика

Time elapsed: 0.00262