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

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

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

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

http://rates.kazpost.kz/postratesws/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>
            <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:DeclaredValueText>?</pos:DeclaredValueText>
            <!--Optional:-->
            <pos:CashOnDeliveryText>?</pos:CashOnDeliveryText>
            <!--Optional:-->
            <pos:DeliverySum>?</pos:DeliverySum>
            <pos:ProductCode>?</pos:ProductCode>
            <pos:Marks>
               <!--Zero or more repetitions:-->
               <pos:Mark>?</pos:Mark>
            </pos:Marks>
            <!--Optional:-->
            <pos:AddInfo>
               <!--0 to 5 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:PAY_CODE>?</pos:PAY_CODE>
            <!--Optional:-->
            <pos:Attachments>
               <!--Zero or more repetitions:-->
               <pos:Attachment>
                  <pos:Quantity>?</pos:Quantity>
                  <pos:Detail>?</pos:Detail>
                  <pos:Weight>?</pos:Weight>
                  <pos:Cost>?</pos:Cost>
                  <pos:Curr>?</pos:Curr>
                  <pos:Hs>?</pos:Hs>
                  <pos:Country>?</pos:Country>
               </pos:Attachment>
            </pos:Attachments>
            <!--Optional:-->
            <pos:Details>
               <pos:Rcpn_ref>?</pos:Rcpn_ref>
               <pos:Ml_class>?</pos:Ml_class>
               <pos:Ml_class_add>?</pos:Ml_class_add>
               <!--Optional:-->
               <pos:Post_chrg>?</pos:Post_chrg>
               <pos:Othr_fee>?</pos:Othr_fee>
               <pos:Cmnt>?</pos:Cmnt>
               <pos:Sndr_office>?</pos:Sndr_office>
               <pos:Date_posting>?</pos:Date_posting>
            </pos:Details>
            <!--Optional:-->
            <pos:Status>?</pos:Status>
            <!--Optional:-->
            <pos:Key>?</pos:Key>
            <!--Optional:-->
            <pos:F1>?</pos:F1>
            <!--Optional:-->
            <pos:F2>?</pos:F2>
            <!--Optional:-->
            <pos:F3>?</pos:F3>
            <!--Optional:-->
            <pos:F4>?</pos:F4>
            <!--Optional:-->
            <pos:F5>?</pos:F5>
            <!--Optional:-->
            <pos:F6>?</pos:F6>
            <!--Optional:-->
            <pos:F7>?</pos:F7>
            <!--Optional:-->
            <pos:F8>?</pos:F8>
            <!--Optional:-->
            <pos:F9>?</pos:F9>
            <!--Optional:-->
            <pos:F10>?</pos:F10>
            <!--Optional:-->
            <pos:F11>?</pos:F11>
            <!--Optional:-->
            <pos:F12>?</pos:F12>
            <!--Optional:-->
            <pos:F13>?</pos:F13>
            <!--Optional:-->
            <pos:F14>?</pos:F14>
            <!--Optional:-->
            <pos:F15>?</pos:F15>
         </pos:AddrInfo>
         <!--Optional:-->
         <pos:License>?</pos:License>
         <!--Optional:-->
         <pos:Certif>?</pos:Certif>
         <!--Optional:-->
         <pos:Invoice>?</pos:Invoice>
         <!--Optional:-->
         <pos:Account>?</pos:Account>
         <!--Optional:-->
         <pos:WeightAll>?</pos:WeightAll>
         <!--Optional:-->
         <pos:CostAll>?</pos:CostAll>
      </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 цифр, не обязательный)
  • DeclaredValueText - Объявленная ценность прописью(string, не обязательный)
  • CashOnDeliveryText - Наложенный платеж прописью(string, не обязательный)
  • DeliverySum - Сумма за доставку (хххххх.хх 8 цифр, не обязательный)
  • ProductCode - Код продукта (4 символа, см. справочник)
  • Marks - Отметки (список отметок Mark, см. справочник, не обязательный)
  • AddInfo - Дополнительные поля для добавления в Адресный ярлык (не обязательный)
  • PartNum - Номер партии (не обязательный)
  • EnvelopeSize - Размер конверта (2 символа, не обязательный)
  • SendMethod - Способ пересылки (1 символ, обязательный)
  • MailCtg - Категория отправления (1 символ, обязательный)
  • Barcode - Трэк номер (не обязательный)
  • OrderNum - Номер заказа интернет магазина(не обязательный)
  • MailCount - Количество генерируемых ШПИ (не обязательный)
  • Pickup - Плановая дата забора заказа. (не обязательный)
  • NPI - Новый почтовый индекс. (не обязательный)
  • DEA_NUMBER - Номер договора (255 символов, не обязательный)
  • DEA_DEPCODE - Номер подразделения договора (подразделение где создан договор) (255 символов, не обязательный)
  • PAY_CODE - ???(string, не обязательный)
  • Attachments - Массив(не обязательный)
  • Quantity - Количество(string, не обязательный)
  • Detail - Подробное описание вложения (string, не обязательный)
  • Weight - Вес нетто (string, не обязательный)
  • Cost - Стоимость (string, не обязательный)
  • Curr - Валюто (string, не обязательный)
  • Hs - Код ТНВЭД (string, не обязательный)
  • Country - Страна происхождения товаров (string, не обязательный)
  • Details - Блок(string, не обязательный)
  • Rcpn_ref - Реквизиты импортера(string, не обязательный)
  • Ml_class - Категория отправления (string, не обязательный)
  • Ml_class_add - Пояснение (string, не обязательный)
  • Post_chrg - Почтовые сборы (string, не обязательный)
  • Othr_fee - Расходы (string, не обязательный)
  • Cmnt - Комментарии(string, не обязательный)
  • Sndr_office - Учреждение подачи (string, не обязательный)
  • Date_posting - Дата подачи (string, не обязательный)
  • Status - Статус (string, не обязательный)
  • Key - Идентификационный ключ клиента зарегистрировавшийся в post.kz (string, не обязательный)
  • F1-F15 - Доп. параметры (в случае необходимости)
  • License - № лицензии (string, не обязательный)
  • Certif - № сертификата (string, не обязательный)
  • Invoice - № счета (string, не обязательный)
  • Account - вложении (string, не обязательный)
  • WeightAll - Общий вкс вложении (string, не обязательный)
  • CostAll - Общая сумма вложении (string, не обязательный)
  • Пример запроса:

                <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>123456789012</pos:RcpnIIN>
                <!--Optional:-->
                <pos:RcpnName>ФИОполучателя</pos:RcpnName>
                <pos:RcpnPhone>77010000000</pos:RcpnPhone>
                <!--Optional:-->
                <pos:RcpnEmail>test@test.com</pos:RcpnEmail>
                <!--Optional:-->
                <pos:RcpnCountry>KZ</pos:RcpnCountry>
                <pos:RcpnIndex>010000</pos:RcpnIndex>
                <!--Optional:-->
                <pos:RcpnCity>Город</pos:RcpnCity>
                <!--Optional:-->
                <pos:RcpnDistrict>Район</pos:RcpnDistrict>
                <pos:RcpnStreet>Улица</pos:RcpnStreet>
                <pos:RcpnHouse>12</pos:RcpnHouse>
                <pos:SndrBIN>120840009442</pos:SndrBIN>
                <!--Optional:-->
                <pos:SndrName>Компания</pos:SndrName>
                <!--Optional:-->
                <pos:SndrPhone>77010000000</pos:SndrPhone>
                <!--Optional:-->
                <pos:SndrEmail>company@company.com</pos:SndrEmail>
                <!--Optional:-->
                <pos:SndrCountry>KZ</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>22000</pos:DeclaredValue>
                <!--Optional:-->
                <pos:CashOnDelivery>15000</pos:CashOnDelivery>
                <!--Optional:-->
                <pos:DeliverySum>123</pos:DeliverySum>
                <pos:ProductCode>P204</pos:ProductCode>
                <pos:Marks>
        <!--Zero or more repetitions:-->
                   <pos:Mark>returnAfter</pos:Mark>
                </pos:Marks>
                <!--Optional:-->
                <pos:AddInfo>
                   <!--0 to 5 repetitions:-->
                   <pos:Field>1</pos:Field>
                </pos:AddInfo>
                <!--Optional:-->
                <pos:PartNum>123</pos:PartNum>
                <!--Optional:-->
                <pos:EnvelopeSize>123</pos:EnvelopeSize>
                <pos:SendMethod>1</pos:SendMethod>
                <pos:MailCtg>4</pos:MailCtg>
                <!--Optional:-->
                <pos:OrderNum>443425</pos:OrderNum>
                <!--Optional:-->
                <pos:MailCount>1</pos:MailCount>
                <!--Optional:-->
                <pos:NPI>123</pos:NPI>
                <!--Optional:-->
                <pos:DEA_NUMBER>537868654454000542</pos:DEA_NUMBER>
                <!--Optional:-->
                <pos:DEA_DEPCODE>279900</pos:DEA_DEPCODE>
                <!--Optional:-->
                <pos:PAY_CODE>3</pos:PAY_CODE>
                <!--Optional:-->
                <pos:Attachments>
                   <!--Zero or more repetitions:-->
                   <pos:Attachment>
                      <pos:Quantity>1</pos:Quantity>
                      <pos:Detail>dfssfs</pos:Detail>
                      <pos:Weight>3</pos:Weight>
                      <pos:Cost>4</pos:Cost>
                      <pos:Curr>5</pos:Curr>
                      <pos:Hs>1234567</pos:Hs>
                      <pos:Country>6</pos:Country>
                   </pos:Attachment>
                </pos:Attachments>
                <!--Optional:-->
                <pos:Details>
                   <pos:Rcpn_ref>1</pos:Rcpn_ref>
                   <pos:Ml_class>91</pos:Ml_class>
                   <pos:Ml_class_add>2</pos:Ml_class_add>
                   <pos:Othr_fee>3</pos:Othr_fee>
                   <pos:Cmnt>4</pos:Cmnt>
                   <pos:Sndr_office>6</pos:Sndr_office>
                   <pos:Date_posting>7</pos:Date_posting>
                </pos:Details>
                <!--Optional:-->
                <pos:Status>5</pos:Status>
                <!--Optional:-->
                <pos:Key>5</pos:Key>
             </pos:AddrInfo>
             <!--Optional:-->
             <pos:License>2</pos:License>
             <!--Optional:-->
             <pos:Certif>2</pos:Certif>
             <!--Optional:-->
             <pos:Invoice>4</pos:Invoice>
             <!--Optional:-->
             <pos:Account>3</pos:Account>
             <!--Optional:-->
             <pos:WeightAll>7</pos:WeightAll>
             <!--Optional:-->
             <pos:CostAll>5</pos:CostAll>
          </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 - Текст ответа (успешно или ошибка)

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