Модуль доставки® API

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>
			<pos:RcpnStreet></pos:RcpnStreet>
			<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:AddInfo>
               <!--Zero or more repetitions:-->
               <pos:Field>?</pos:Field>
            </pos:AddInfo>
			<!--Optional:-->
			<pos:PartNum></pos:PartNum>
			<!--Optional:-->
			<pos:EnvelopeSize></pos:EnvelopeSize>
			<pos:SendMethod></pos:SendMethod>
			<pos:MailCtg></pos:MailCtg>
			<!--Optional:-->
            <pos:Barcode>?</pos:Barcode>
            <!--Optional:-->
            <pos:OrderNum>?</pos:OrderNum>
            <!--Optional:-->
            <pos:MailCount>?</pos:MailCount>
            <!--Optional:-->
            <pos:Pickup>?</pos:Pickup>
            <!--Optional:-->
            <pos:NPI>?</pos:NPI>
			<!--Optional:-->
            <pos:DEA_NUMBER>?</pos:DEA_NUMBER>
            <!--Optional:-->
            <pos:DEA_DEPCODE>?</pos:DEA_DEPCODE>
			<!--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, см. справочник, не обязательный)

AddInfo - Дополнительные поля для добавления в Адресный ярлык (не обязательный)

PartNum - Номер партии (не обязательный)

EnvelopeSize - Размер конверта (2 символа, не обязательный)

SendMethod - Способ пересылки (1 символ, обязательный)

MailCtg - Категория отправления (1 символ, обязательный)

Barcode - Трэк номер (не обязательный)

OrderNum - Номер заказа интернет магазина(не обязательный)

MailCount - Количество генерируемых ШПИ (не обязательный)

Pickup - Плановая дата забора заказа. (не обязательный)

NIP - Новый почтовый индекс. (не обязательный)

DEA_NUMBER - Номер договора (255 символов, не обязательный)

DEA_DEPCODE - Номер подразделения договора (подразделение где создан договор) (255 символов, не обязательный)

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>EMKWG7x5dSrCowxnKd1adBItLi0lcwkR</pos:Key>
		<pos:AddrInfo>
			<pos:RcpnIIN>123456789012</pos:RcpnIIN>
			<pos:RcpnName>ФИОполучателя</pos:RcpnName>
			<pos:RcpnPhone>77010000000</pos:RcpnPhone>
			<pos:RcpnEmail>test@test.com</pos:RcpnEmail>
			<pos:RcpnCountry> Казахстан </pos:RcpnCountry>
			<pos:RcpnIndex>010000</pos:RcpnIndex>
			<pos:RcpnCity>Город</pos:RcpnCity>
			<pos:RcpnDistrict>Район</pos:RcpnDistrict>
			<pos:RcpnStreet>Улица</pos:RcpnStreet>
			<pos:RcpnHouse>12</pos:RcpnHouse>
			<pos:SndrBIN>098765432121</pos:SndrBIN>
			<pos:SndrName>Компания</pos:SndrName>
			<pos:SndrPhone>77010000000</pos:SndrPhone>
			<pos:SndrEmail>company@company.com</pos:SndrEmail>
			<pos:SndrCountry>Казахстан</pos:SndrCountry>
			<pos:SndrIndex>050000</pos:SndrIndex>
			<pos:SndrCity>Город</pos:SndrCity>
			<pos:SndrDistrict>Район</pos:SndrDistrict>
			<pos:SndrStreet>Улица</pos:SndrStreet>
			<pos:SndrHouse>25</pos:SndrHouse>
			<pos:Weight>1.55</pos:Weight>
			<pos:DeclaredValue>15000</pos:DeclaredValue>
			<pos:CashOnDelivery>15000</pos:CashOnDelivery>
			<pos:ProductCode>P104</pos:ProductCode>
			<pos:Marks>
				<pos:Mark>returnAfter</pos:Mark>
			</pos:Marks>
			<pos:SendMethod>2</pos:SendMethod>
			<pos:MailCtg>4</pos:MailCtg>
                        <pos:OrderNum>123456789</pos:OrderNum>
                        <pos:MailCount>1</pos:MailCount>
                        <pos:DEA_NUMBER>537868654454000542</pos:DEA_NUMBER>
                        <pos:DEA_DEPCODE>279900</pos:DEA_DEPCODE>
		</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 - Текст ответа (успешно или ошибка)

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