Kazpost™ Developers / API сервиса получения адресного ярлыка

Сервис получения адресного ярлыка - Для Клиентов

Предоставляет base64 закодированный адресный ярлык и сгенерированный трэк номер.

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

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

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

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

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pos="http://webservices.kazpost.kz/postratesws">
<soapenv:Header/>
<soapenv:Body>
	<pos:GetAddrLetterRequest>
		<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:GetAddrLetterRequest>
</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 цифр)
  • RcpnCity - Город получателя (256 символов, не обязательный)
  • RcpnDistrict - Район получателя (256 символов, не обязательный)
  • RcpnStreet - Улица получателя (256 символов, не обязательный)
  • RcpnHouse - Дом/квартира получателя (10 символов, не обязательный)
  • SndrBIN - БИН отправителя (12 цифр, не обязательный, не обязательный)
  • SndrName - Название компании/ ФИО отправителя (256 символов, не обязательный)
  • SndrPhone - Номер телефона отправителя 7ХХХХХХХХХ (10 цифр, не обязательный)
  • SndrEmail - Email отправителя (при наличии, login@example.com, не обязательный)
  • SndrCountry - Страна отправителя (256 символов, не обязательный)
  • SndrIndex - Почтовый индекс отправителя (6 цифр)
  • 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:GetAddrLetterRequest>
		<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:GetAddrLetterRequest>
</soapenv:Body>
</soapenv:Envelope>

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

    <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
   <ns2:GetAddrLetterResponse xmlns:ns2="http://webservices.kazpost.kz/postratesws">
      <ns2:AddrLetPdf>base64PDF</ns2:AddrLetPdf>
      <ns2:Barcode>AP000000001KZ</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:GetAddrLetterResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

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




    © 2015 Copyright. АО Казпочта. Департамент Информационных технологий. Email: api@kazpost.kz