Kazpost™ Developers / API сервиса генерации трэк номера

Сервис генерации трэк номера модуля доставки - Для Клиентов

Предоставляет сгенерированный трэк номер для адресного ярлыка, формируемого на стороне Клиента.

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

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

Справочники параметров

Справочники по коду продукта и отметок

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pos="http://webservices.kazpost.kz/postratesws">
<soapenv:Header/>
<soapenv:Body>
	<pos:GetParcelBarcodeRequest>
		<pos:Key></pos:Key>
		<pos:AddrInfo>
			<!--Optional:-->
			<pos:RcpnIIN></pos:RcpnIIN>
			<!--Optional:-->
			<pos:RcpnName></pos:RcpnName>
			<pos:RcpnPhone></pos:RcpnPhone>
			<!--Optional:-->
			<pos:RcpnEmail></pos:RcpnEmail>
			<!--Optional:-->
			<pos:RcpnCountry></pos:RcpnCountry>
			<pos:RcpnIndex></pos:RcpnIndex>
			<!--Optional:-->
			<pos:RcpnCity></pos:RcpnCity>
			<!--Optional:-->
			<pos:RcpnDistrict></pos:RcpnDistrict>
			<!--Optional:-->
			<pos:RcpnStreet></pos:RcpnStreet>
			<!--Optional:-->
			<pos:RcpnHouse></pos:RcpnHouse>
			<!--Optional:-->
			<pos:SndrBIN></pos:SndrBIN>
			<!--Optional:-->
			<pos:SndrName></pos:SndrName>
			<!--Optional:-->
			<pos:SndrPhone></pos:SndrPhone>
			<!--Optional:-->
			<pos:SndrEmail></pos:SndrEmail>
			<!--Optional:-->
			<pos:SndrCountry></pos:SndrCountry>
			<pos:SndrIndex></pos:SndrIndex>
			<!--Optional:-->
			<pos:SndrCity></pos:SndrCity>
			<!--Optional:-->
			<pos:SndrDistrict></pos:SndrDistrict>
			<!--Optional:-->
			<pos:SndrStreet></pos:SndrStreet>
			<!--Optional:-->
			<pos:SndrHouse></pos:SndrHouse>
			<!--Optional:-->
			<pos:Weight></pos:Weight>
			<!--Optional:-->
			<pos:DeclaredValue></pos:DeclaredValue>
			<!--Optional:-->
			<pos:CashOnDelivery></pos:CashOnDelivery>
			<!--Optional:-->
			<pos:DeliverySum></pos:DeliverySum>
			<pos:ProductCode></pos:ProductCode>
			<!--Optional:-->
			<pos:Marks>
				<pos:Mark></pos:Mark>
			</pos:Marks>
			<!--Optional:-->
			<pos:PartNum></pos:PartNum>
			<!--Optional:-->
			<pos:EnvelopeSize></pos:EnvelopeSize>
			<pos:SendMethod></pos:SendMethod>
			<pos:MailCtg></pos:MailCtg>
			<!--Optional:-->
			<pos:F1></pos:F1>
			|
			<pos:F15></pos:F15>
		</pos:AddrInfo>
	</pos:GetParcelBarcodeRequest>
</soapenv:Body>
</soapenv:Envelope>

Параметры запроса:
  • Key - Key - Идентификационный ключ клиента (32 символов) (Необходимо зарегистрироваться в post.kz и зайти в Профиль для регистрации организации)
  • RcpnIIN - ИИН получателя (12 цифр, не обязательный)
  • RcpnName - ФИО получателя (256 символов, не обязательный)
  • RcpnPhone - Номер телефона получателя 7ХХХХХХХХХ (10 цифр)
  • RcpnEmail - Email получателя (при наличии, login@example.com, не обязательный)
  • RcpnCountry - Страна получателя (256 символов, не обязательный)
  • RcpnIndex - Почтовый индекс получателя (6 цифр либо новый индекс, пример: Z01H9M9)
  • RcpnCity - Город получателя (256 символов, не обязательный)
  • RcpnDistrict - Район получателя (256 символов, не обязательный)
  • RcpnStreet - Улица получателя (256 символов, не обязательный)
  • RcpnHouse - Дом/квартира получателя (10 символов, не обязательный)
  • SndrBIN - БИН отправителя (12 цифр, не обязательный, не обязательный)
  • SndrName - Название компании/ ФИО отправителя (256 символов, не обязательный)
  • SndrPhone - Номер телефона отправителя 7ХХХХХХХХХ (10 цифр, не обязательный)
  • SndrEmail - Email отправителя (при наличии, login@example.com, не обязательный)
  • SndrCountry - Страна отправителя (256 символов, не обязательный)
  • SndrIndex - Почтовый индекс отправителя (6 цифр либо новый индекс, пример: Z01H9M9)
  • SndrCity - Город отправителя (256 символов, не обязательный)
  • SndrDistrict - Район отправителя (256 символов, не обязательный)
  • SndrStreet - Улица отправителя (256 символов, не обязательный)
  • SndrHouse - Дом/квартира отправителя (10 символов, не обязательный)
  • Weight - Вес (хх.хх 4 цифры, не обязательный)
  • DeclaredValue - Объявленная ценность (хххххх.хх 8 цифр, не обязательный)
  • CashOnDelivery - Наложенный платеж (хххххх.хх 8 цифр, не обязательный)
  • DeliverySum - Сумма за доставку (хххххх.хх 8 цифр, не обязательный)
  • ProductCode - Код продукта (4 символа, см. справочник)
  • Marks - Отметки (список отметок Mark, см. справочник, не обязательный)
  • PartNum - Номер партии (не обязательный)
  • EnvelopeSize - Размер конверта (2 символа, не обязательный)
  • SendMethod - Способ пересылки (1 символ, обязательный)
  • MailCtg - Категория отправления (1 символ, обязательный)
  • F1-F15 - Доп. параметры (в случае необходимости)
  • Справочники параметров:

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

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pos="http://webservices.kazpost.kz/postratesws">
    <soapenv:Header/>
    <soapenv:Body>
    	<pos:GetParcelBarcodeRequest>
    		<pos:Key>12AA45EW22ZZ1234567890ASDFGHJKLM</pos:Key>
    		<pos:AddrInfo>
    			<!--Optional:-->
    			<pos:RcpnIIN>123456789012</pos:RcpnIIN>
    			<!--Optional:-->
    			<pos:RcpnName>ФИОполучателя</pos:RcpnName>
    			<pos:RcpnPhone>7012345678</pos:RcpnPhone>
    			<!--Optional:-->
    			<pos:RcpnEmail>test@test.com</pos:RcpnEmail>
    			<!--Optional:-->
    			<pos:RcpnCountry>Страна</pos:RcpnCountry>
    			<pos:RcpnIndex>010000</pos:RcpnIndex>
    			<!--Optional:-->
    			<pos:RcpnCity>Город</pos:RcpnCity>
    			<!--Optional:-->
    			<pos:RcpnDistrict>Район</pos:RcpnDistrict>
    			<!--Optional:-->
    			<pos:RcpnStreet>Улица</pos:RcpnStreet>
    			<!--Optional:-->
    			<pos:RcpnHouse>12</pos:RcpnHouse>
    			<!--Optional:-->
    			<pos:SndrBIN>098765432121</pos:SndrBIN>
    			<!--Optional:-->
    			<pos:SndrName>Компания</pos:SndrName>
    			<!--Optional:-->
    			<pos:SndrPhone>7077654321</pos:SndrPhone>
    			<!--Optional:-->
    			<pos:SndrEmail>company@company.com</pos:SndrEmail>
    			<!--Optional:-->
    			<pos:SndrCountry>Страна</pos:SndrCountry>
    			<pos:SndrIndex>020000</pos:SndrIndex>
    			<!--Optional:-->
    			<pos:SndrCity>Город</pos:SndrCity>
    			<!--Optional:-->
    			<pos:SndrDistrict>Район</pos:SndrDistrict>
    			<!--Optional:-->
    			<pos:SndrStreet>Улица</pos:SndrStreet>
    			<!--Optional:-->
    			<pos:SndrHouse>25</pos:SndrHouse>
    			<!--Optional:-->
    			<pos:Weight>1.55</pos:Weight>
    			<!--Optional:-->
    			<pos:DeclaredValue>100.5</pos:DeclaredValue>
    			<!--Optional:-->
    			<pos:CashOnDelivery>1000.0</pos:CashOnDelivery>
    			<!--Optional:-->
    			<pos:DeliverySum>1000.0</pos:DeliverySum>
    			<pos:ProductCode>P103</pos:ProductCode>
    			<!--Optional:-->
    			<pos:Marks>
    				<pos:Mark>returnAfter</pos:Mark>
    				<pos:Mark>noReturn</pos:Mark>
    				<pos:Mark>payAfter</pos:Mark>
    			</pos:Marks>
    			<!--Optional:-->
    			<pos:PartNum>123456789</pos:PartNum>
    			<!--Optional:-->
    			<pos:EnvelopeSize>С5</pos:EnvelopeSize>
    			<pos:SendMethod>1</pos:SendMethod>
    			<pos:MailCtg>1</pos:MailCtg>
    		</pos:AddrInfo>
    	</pos:GetParcelBarcodeRequest>
    </soapenv:Body>
    </soapenv:Envelope>

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

    <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
       <ns2:GetParcelBarcodeResponse xmlns:ns2="http://webservices.kazpost.kz/postratesws">
          <ns2:Barcode>AP012345678KZ</ns2:Barcode>
          <ns2:ResponseInfo>
             <ns2:ResponseGenTime>2015-08-28T01:22:07.243+06:00</ns2:ResponseGenTime>
             <ns2:ResponseCode>0</ns2:ResponseCode>
             <ns2:ResponseText>Принято успешно!</ns2:ResponseText>
          </ns2:ResponseInfo>
       </ns2:GetParcelBarcodeResponse>
    </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>

    Параметры ответа на запрос:
  • Barcode - Сгенерированный трэк номер для адресного ярлыка
  • ResponseGenTime - Время сформированного ответа
  • ResponseCode - Код ответа
  • ResponseText - Текст ответа (успешно или ошибка)

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