В Новой почте есть старая и новая адресная система.
На сайтах часто для доставки на отделение используется старая адресная система, а для доставки в адрес – новая адресная система.
Ниже приведены примеры, как можно передать тот же населенный пункт в SalesDrive при создании заявок по API:
№ | Пример данных | Комментарий |
---|---|---|
1 |
"novaposhta": { "ServiceType": "Warehouse", "WarehouseNumber": "44099676-de89-11e9-b48a-005056b24375" } |
Если novaposhta[WarehouseNumber] передается в формате Ref, город в поле novaposhta[city] можно не передавать. |
2 |
"novaposhta": { "ServiceType": "Warehouse", "city": "ef0279ea-b7bd-11e9-8c22-005056b24375", "WarehouseNumber": "1" } |
Ref города (старая адресная система) |
3 |
"novaposhta": { "ServiceType": "Warehouse", "city": "0e440bbc-4b3a-11e4-ab6d-005056801329", "WarehouseNumber": "1" } |
Ref населенного пункта (новая адресная система) |
4 |
"novaposhta": { "ServiceType": "Warehouse", "cityNameFormat": "full", "city": "Вишневе (Полтавська обл.)", "WarehouseNumber": "1" } |
В novaposhta[city] передается название города, как он называется в старой адресной системе Новой Почты |
5 |
"novaposhta": { "ServiceType": "Warehouse", "cityNameFormat": "short", "area": "Полтавська", "region": "Оржицький", "city": "Вишневе", "WarehouseNumber": "1" } |
В novaposhta[city] передается только название города (без района и области). Область и район передаются отдельными полями |
6 |
"novaposhta": { "ServiceType": "Warehouse", "cityNameFormat": "full", "city": "Вишневе (Полтавська обл.)", "WarehouseNumber": "Пункт приймання-видачі (до 30 кг): вул. Марченка, 3" } |
В novaposhta[WarehouseNumber] можно передавать Ref или номер или название отделения |
В старой адресной системе названия городов не повторяются и имеют такой формат:
- то есть несмотря на то, что это одно и то же название населенного пункта "Вишневе" - все равно названия разные.
В режиме cityNameFormat="full" – не нужно передавать область и район (так как название населенного пункта однозначно идентифицирует населенный пункт).
В режиме cityNameFormat="short" ожидается, что данные по API будут передаваться следующим образом:
- здесь название города однозначно не идентифицирует населенный пункт (в Украине есть 57 населенных пунктов "Вишневое"), поэтому нужно указывать область и район.
Если указать только область (а район не указать), то в большинстве случаев – город заполнится в SalesDrive. Но если в указанной области найдется несколько населенных пунктов с данным названием, то город не заполнится в SalesDrive.