Портал для розробників-Address-getWarehouses

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

Метод «getWarehouses», работает в модели «Address», этот метод загружает справочник отделений «Новая почта» в рамках населенных пунктов Украины.

Есть возможность отфильтровать нужные отделения по следующим признакам:

1) TypeOfWarehouseRef - тип отделения

2) PostFinance - наличика кассы NovaPay

3) BicycleParking - наличие парковки

4) POSTerminal - наличие пос терминала

5) CityName - по названию населенного пункта

6) CityRef - по рефке населенного пункта

7) Используя пару паметров CityName и FindByString можно найти определенное отделени в населенном пункте или указав идентификатор отеделения Ref

8) "WarehouseId": "номер отделения 151" - поиск отделения по номеру

9) Для получения отделений в конкретном населенном пункте можно использовать SettlementRef, брать его из ответа метода getSettlements

Пример использования вышеперечисленных параметров в запросе:

"methodProperties": {

"BicycleParking": "1",

"TypeOfWarehouseRef":"9a68df70-0267-42a8-bb5c-37f427e36ee4",

"PostFinance": "1",

"CityName":"Київ",

"CityRef": "20982d74-9b6c-11e2-a57a-d4ae527baec3",

"WarehouseId": "151",

"FindByString": "Відділення №8",

"Ref": "47402ec5-e1c2-11e3-8c4a-0050568002cf" //РЕФ отделения из справочника отделений,

"SettlementRef": "e71629ab-4b33-11e4-ab6d-005056801329" //РЕФ города из справочника населенных пунктов Украины

}

Копию справочника необходимо сохранять и поддерживать в актуальном состоянии путем обновления раз в сутки.

Текст запроса

Параметр	Тип	Описание
CityName	string[36]	Дополнительный фильтр по имени города
CityRef	string[36]	Дополнительный фильтр по идентификатору города
Page	string[36]	Страница, максимум 500 записей на странице. Работает в связке с параметром Limit
Limit	string[36]	Количество записей на странице. Работает в связке с параметром Page
Language	string[2]	Вывод описания на Украинском или русском языках - ru. По умолчанию всегда выводиться на Украинском языке.
TypeOfWarehouseRef	string[36]	Тип отделения
WarehouseId	string[36]	Поиск отделения по его номеру

* Обозначение обязательного параметра

                        
 
{
   "apiKey": "[ВАШ КЛЮЧ]",
   "modelName": "Address",
   "calledMethod": "getWarehouses",
   "methodProperties": {"CityName" : "Київ","CityRef" : "00000000-0000-0000-0000-000000000000","Page" : "1","Limit" : "50","Language" : "UA","TypeOfWarehouseRef" : "00000000-0000-0000-0000-000000000000","WarehouseId" : "151"   }
}

                                  

    <?xml version="1.0" encoding="UTF-8"?>
            <file>
                <apiKey>[ВАШ КЛЮЧ]</apiKey>
                <modelName>Address</modelName>
                <calledMethod>getWarehouses</calledMethod>
                <methodProperties>
                    <CityName>"Київ"</CityName>
                    <CityRef>"00000000-0000-0000-0000-000000000000"</CityRef>
                    <Page>"1"</Page>
                    <Limit>"50"</Limit>
                    <Language>"UA"</Language>
                    <TypeOfWarehouseRef>"00000000-0000-0000-0000-000000000000"</TypeOfWarehouseRef>
                    <WarehouseId>"151"</WarehouseId>
                </methodProperties>
            </file>

Ответ 200
Всегда возвращает код 200 даже при логических ошибках.

Тело ответа на запрос

Параметр	Тип	Описание
SiteKey	string[10]	Код отделения
Description	string[99]	Название отделения на украинском языке
DescriptionRu	string[99]	Название отделения на русском языке
ShortAddress	string[36]	Короткий адрес отделения на украинском языке
ShortAddressRu	string[36]	Короткий адрес на русском языке
Phone	string[36]	Телефон
TypeOfWarehouse	string[36]	Тип отделения
Ref	string[36]	Идентификато отделения
Number	string[36]	Номер отделения
CityRef	string[36]	Идентификатор населенного пункта
CityDescription	string[50]	Название населенного пункта на украинском языке
CityDescriptionRu	string[50]	Название населенного пункта на русском языке
SettlementRef	string[36]	Реф населенного пункта
SettlementDescription	string[36]	Описание населенного пункта
SettlementAreaDescription	string[36]	Описание области
SettlementRegionsDescription	string[36]	Описание района
SettlementTypeDescription	string[36]	Тип населенного пункта на украинском языке
SettlementTypeDescriptionRu	string[36]	Тип населенного пункта на русском языке
Longitude	float	Долгота
Latitude	float	Широта
PostFinance	string[36]	Наличие кассы NovaPay (1/0)
BicycleParking	string[1]	Наличие паровки возле отделении (1/0)
PaymentAccess	string[1]	Доступность оплаты в отделении (1/0)
POSTerminal	string[36]	Наличие пос-терминала на отделении (1/0)
InternationalShipping	string[36]	Возможность оформления Международного оформления (1/0)
SelfServiceWorkplacesCount	string[1]	Наличие рабочего места самообслуживания (1/0)
TotalMaxWeightAllowed	string[36]	Максимальный вес отправления
PlaceMaxWeightAllowed	string[36]	Максимальный вес одного места отправления
SendingLimitationsOnDimensions	object	Максимальные габариты отправления для отправки
ReceivingLimitationsOnDimensions	object	Максимальные габариты отправления для получения
Reception	object	График приема отправлений
Delivery	object	График отправки день в день
Schedule	object	График работы
DistrictCode	string[36]	Код района
WarehouseStatus	string[36]	Статус отделения
WarehouseStatusDate	string[36]	Дата статуса отделения
CategoryOfWarehouse	string[36]	Категория склада
RegionCity	string[36]	Область/город
WarehouseForAgent	string[36]	Принадлежность отделения к франчайзинговой сети (1/0)
MaxDeclaredCost	string[10]	Максимально допустимая оценочная стоимость отправления
DenyToSelect	string[36]	Запрет выбора склада в ИД. Допустимые значения 0\1. Если установлено 1, то с/на данный склад нельзя создать документ
PostMachineType	string[36]	Тип почтомата. Допустимые значения: None - не указан тип почтомата, FullDayService - почтомат доступен 24/7, PartTime - почтомат с ограниченным графиком работы (установлен в ТЦ, магазине) и не миеет круклосуточного доступа, ForResidentOfEntrance - для жильцов подъезда Private - личный, LimitedAccess - с ограниченным доступом, установлен в организациях за пределеми досегаемости сторонних лиц
PostalCodeUA	string[36]	Почтовый индекс адреса отделения (склада) Новой Почты
OnlyReceivingParcel	string[36]	Признак, что отделение работает только на выдачу, если значение 1, если 0 то отделение работает и на выдачу и на прием
WarehouseIndex	string[36]	Индекс НП, где данные до слеша - это индекс населенного пунка, а после номер отделения/почтомата

                                  
{
  "success": true,
  "data": [{"SiteKey" : "10119","Description" : "Відділення №1: вул. М. Грушевського, 3","DescriptionRu" : "Отделение №1: ул. М. Грушевского, 3","ShortAddress" : "Заболотів, М. Грушевського, 3","ShortAddressRu" : "Заболотов, Грушевского, 3","Phone" : "380800500609","TypeOfWarehouse" : "00000000-0000-0000-0000-000000000000","Ref" : "00000000-0000-0000-0000-000000000000","Number" : "1","CityRef" : "00000000-0000-0000-0000-000000000000","CityDescription" : "Заболотів (Снятинський р-н)","CityDescriptionRu" : "Заболотов (Снятинский р-н)","SettlementRef" : "00000000-0000-0000-0000-000000000000","SettlementDescription" : "Заболотів","SettlementAreaDescription" : "Івано-Франківська область","SettlementRegionsDescription" : "Снятинський р-н","SettlementTypeDescription" : "селище міського типу","SettlementTypeDescriptionRu" : "поселок городского типа","Longitude" : "25.284086000000000","Latitude" : "48.467503000000000","PostFinance" : "1","BicycleParking" : "0","PaymentAccess" : "1","POSTerminal" : "1","InternationalShipping" : "1","SelfServiceWorkplacesCount" : "0","TotalMaxWeightAllowed" : "0","PlaceMaxWeightAllowed" : "1000","SendingLimitationsOnDimensions" : {"Width":170","Height":170","Length":300},"ReceivingLimitationsOnDimensions" : {"Width":170","Height":170","Length":300},"Reception" : {"Monday":"16:45-18:00","Tuesday":"16:45-18:00","Wednesday":"16:45-18:00","Thursday":"16:45-18:00","Friday":"16:45-18:00","Saturday":"16:30-17:00","Sunday":"10:00-15:00"},"Delivery" : {"Monday":"08:00-12:00","Tuesday":"08:00-12:00","Wednesday":"08:00-12:00","Thursday":"08:00-12:00","Friday":"08:00-12:00","Saturday":"09:00-12:00","Sunday":"09:00-14:30"},"Schedule" : {"Monday":"09:00-19:00","Tuesday":"09:00-19:00","Wednesday":"09:00-19:00","Thursday":"09:00-19:00","Friday":"09:00-19:00","Saturday":"09:00-18:00","Sunday":"10:00-18:00"},"DistrictCode" : "Ск За","WarehouseStatus" : "Working","WarehouseStatusDate" : "4/2/21 0:00","CategoryOfWarehouse" : "Branch","RegionCity" : "ЧЕРНІВЦІ","WarehouseForAgent" : "1","MaxDeclaredCost" : "0","DenyToSelect" : "1","PostMachineType" : "","PostalCodeUA" : "15001","OnlyReceivingParcel" : "0","WarehouseIndex" : "000/00000"  }],
  "errors": [],
  "warnings": [],
  "info": [],
  "messageCodes": [],
  "errorCodes": [],
  "warningCodes": [],
  "infoCodes": []
}

                                   
<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>true</success>
    <data>
        <SiteKey>"10119"</SiteKey>
        <Description>"Відділення №1: вул. М. Грушевського, 3"</Description>
        <DescriptionRu>"Отделение №1: ул. М. Грушевского, 3"</DescriptionRu>
        <ShortAddress>"Заболотів, М. Грушевського, 3"</ShortAddress>
        <ShortAddressRu>"Заболотов, Грушевского, 3"</ShortAddressRu>
        <Phone>"380800500609"</Phone>
        <TypeOfWarehouse>"00000000-0000-0000-0000-000000000000"</TypeOfWarehouse>
        <Ref>"00000000-0000-0000-0000-000000000000"</Ref>
        <Number>"1"</Number>
        <CityRef>"00000000-0000-0000-0000-000000000000"</CityRef>
        <CityDescription>"Заболотів (Снятинський р-н)"</CityDescription>
        <CityDescriptionRu>"Заболотов (Снятинский р-н)"</CityDescriptionRu>
        <SettlementRef>"00000000-0000-0000-0000-000000000000"</SettlementRef>
        <SettlementDescription>"Заболотів"</SettlementDescription>
        <SettlementAreaDescription>"Івано-Франківська область"</SettlementAreaDescription>
        <SettlementRegionsDescription>"Снятинський р-н"</SettlementRegionsDescription>
        <SettlementTypeDescription>"селище міського типу"</SettlementTypeDescription>
        <SettlementTypeDescriptionRu>"поселок городского типа"</SettlementTypeDescriptionRu>
        <Longitude>"25.284086000000000"</Longitude>
        <Latitude>"48.467503000000000"</Latitude>
        <PostFinance>"1"</PostFinance>
        <BicycleParking>"0"</BicycleParking>
        <PaymentAccess>"1"</PaymentAccess>
        <POSTerminal>"1"</POSTerminal>
        <InternationalShipping>"1"</InternationalShipping>
        <SelfServiceWorkplacesCount>"0"</SelfServiceWorkplacesCount>
        <TotalMaxWeightAllowed>"0"</TotalMaxWeightAllowed>
        <PlaceMaxWeightAllowed>"1000"</PlaceMaxWeightAllowed>
        <SendingLimitationsOnDimensions>
             <Width>170</Width>
             <Height>170</Height>
             <Length>300</Length>
        </SendingLimitationsOnDimensions>
        <ReceivingLimitationsOnDimensions>
             <Width>170</Width>
             <Height>170</Height>
             <Length>300</Length>
        </ReceivingLimitationsOnDimensions>
        <Reception>
             <Monday>16:45-18:00</Monday>
             <Tuesday>16:45-18:00</Tuesday>
             <Wednesday>16:45-18:00</Wednesday>
             <Thursday>16:45-18:00</Thursday>
             <Friday>16:45-18:00</Friday>
             <Saturday>16:30-17:00</Saturday>
             <Sunday>10:00-15:00</Sunday>
        </Reception>
        <Delivery>
             <Monday>08:00-12:00</Monday>
             <Tuesday>08:00-12:00</Tuesday>
             <Wednesday>08:00-12:00</Wednesday>
             <Thursday>08:00-12:00</Thursday>
             <Friday>08:00-12:00</Friday>
             <Saturday>09:00-12:00</Saturday>
             <Sunday>09:00-14:30</Sunday>
        </Delivery>
        <Schedule>
             <Monday>09:00-19:00</Monday>
             <Tuesday>09:00-19:00</Tuesday>
             <Wednesday>09:00-19:00</Wednesday>
             <Thursday>09:00-19:00</Thursday>
             <Friday>09:00-19:00</Friday>
             <Saturday>09:00-18:00</Saturday>
             <Sunday>10:00-18:00</Sunday>
        </Schedule>
        <DistrictCode>"Ск За"</DistrictCode>
        <WarehouseStatus>"Working"</WarehouseStatus>
        <WarehouseStatusDate>"4\/2\/21 0:00"</WarehouseStatusDate>
        <CategoryOfWarehouse>"Branch"</CategoryOfWarehouse>
        <RegionCity>"ЧЕРНІВЦІ"</RegionCity>
        <WarehouseForAgent>"1"</WarehouseForAgent>
        <MaxDeclaredCost>"0"</MaxDeclaredCost>
        <DenyToSelect>"1"</DenyToSelect>
        <PostMachineType>""</PostMachineType>
        <PostalCodeUA>"15001"</PostalCodeUA>
        <OnlyReceivingParcel>"0"</OnlyReceivingParcel>
        <WarehouseIndex>"000\/00000"</WarehouseIndex>
    </data>
    <errors/>
    <warnings/>
    <info/>
    <messageCodes/>
    <errorCodes/>
    <warningCodes/>
    <infoCodes/>
</root>

Попробовать API

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

Дополнительные параметры

                                   
    <?xml version="1.0" encoding="UTF-8"?>
            <file>
                <apiKey>[ВАШ КЛЮЧ]</apiKey>
                <modelName>Address</modelName>
                <calledMethod>getWarehouses</calledMethod>
                <methodProperties>
                    
                </methodProperties>
            </file>