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

Метод «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"   }
}

                                
                                  




                                

Ответ 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": []
}