Kazpost™ Developers / API сервиса расчета тарифов доставки (версия 1)

Сервис расчета тарифов доставки (версия 1) - Для Клиентов

Предоставляет информацию о тарифах доставки.

WSDL боевого сервиса

http://rates.kazpost.kz/postratesprod/postratesws.wsdl
Для получения тарифов доставки необходимо отправить запрос на операцию GetPostRate указанный в WSDL модуля доставки.

Тело запроса операции GetPostRate:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pos="http://webservices.kazpost.kz/postratesws">
<soapenv:Header/>
<soapenv:Body>
	<pos:GetPostRateRequest>
		<pos:MailInfo>
			<pos:Product></pos:Product>
			<pos:MailCat></pos:MailCat>
			<pos:SendMethod></pos:SendMethod>
			<pos:Weight></pos:Weight>
			<!--Optional:-->
			<pos:From></pos:From>
			<pos:To></pos:To>
			<!--Optional:-->
			<pos:SpecMarks/>
			<!--Optional:-->
			<pos:InCity/>
			<!--Optional:-->
			<pos:ExpressDlv/>
			<!--Optional:-->
			<pos:Size/>
			<!--Optional:-->
			<pos:DeclaredValue/>
			<!--Optional:-->
			<pos:Client/>
		</pos:MailInfo>
	</pos:GetPostRateRequest>
</soapenv:Body>
</soapenv:Envelope>

Параметры запроса:
  • Product - Продукт (см. справочник, отправляется значение ID)
  • MailCat - Категория регистрируемого почтового отправления (РПО) (см. справочник, отправляется значение ID)
  • SendMethod - Способ пересылки РПО (см. справочник, отправляется значение ID)
  • Weight - Вес РПО (в граммах, например 1 кг. - 1000 )
  • From - Откуда (см. справочник, отправляется значение ID областного филиала) Если международное отправление, то не обязательный параметр
  • To - Куда ((см. справочник, отправляется значение ID областного филиала или ID страны)
  • SpecMarks - Доп. услуги (см. справочник, не обязателный параметр, отправляется значение ID, если несколько значений - отправляется с разделителем | , например, 1|2|3 )
  • InCity - Признак «Доставка внутри города». Если да, то отправляется "1", иначе пусто или "0" (не обязательный параметр)
  • ExpressDlv - Признак «Доставка курьером» (для продукта EMS). Если да, то отправляется "1", иначе пусто или "0" (не обязательный параметр)
  • Size - Размер посылки (для посылки на постамат, не обязательный параметр)
  • DeclaredValue - Сумма объявленной ценности (не обязательный параметр)
  • CLient - Идентификатор клиента сервиса (не обязательный параметр)
  • Справочники параметров:
    • Для получения актуальных справочников по видам продуктов и видам особых отметок необходимо отправить запрос с параметром "PRODUCT" или "SPECMARKS" на операцию GetHelper в WSDL модуля доставки. По остальным параметрам справочники находятся здесь:
    • Справочники

    Пример запроса:

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pos="http://webservices.kazpost.kz/postratesws">
    <soapenv:Header/>
    <soapenv:Body>
    	<pos:GetPostRateRequest>
    		<pos:MailInfo>
    			<pos:Product>1</pos:Product>
    			<pos:MailCat>1</pos:MailCat>
    			<pos:SendMethod>1</pos:SendMethod>
    			<pos:Weight>100</pos:Weight>
    			<pos:From>2</pos:From>
    			<pos:To>2</pos:To>
    			<pos:SpecMarks/>
    			<pos:InCity/>
    			<pos:ExpressDlv/>
    			<pos:Size/>
    			<pos:DeclaredValue/>
    			<pos:Client/>
    		</pos:MailInfo>
    	</pos:GetPostRateRequest>
    </soapenv:Body>
    </soapenv:Envelope>

    Ответ на запрос:

    <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
       <ns2:GetPostRateResponse xmlns:ns2="http://webservices.kazpost.kz/postratesws">
          <ns2:PostRate>480</ns2:PostRate>
          <ns2:ResponseInfo>
             <ns2:ResponseGenTime>2015-06-24T11:17:43.275+06:00</ns2:ResponseGenTime>
             <ns2:ResponseText>Принято успешно!</ns2:ResponseText>
          </ns2:ResponseInfo>
       </ns2:GetPostRateResponse>
    </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    Параметры ответа на запрос:
  • PostRate - Тариф (в тг)
  • ResponseGenTime - Время сформированного ответа
  • ResponseText - Текст ответа (успешно или ошибка)

  • Примечание* - Данный материал находится на стадии разработки