CRM для інтернет-магазину
У Новій Пошті є стара і нова адресна система.
На сайтах часто для доставки на відділення використовується стара адресна система, а для доставки на адресу - нова адресна система.
Нижче наведено приклади, як можна передати той самий населений пункт в SalesDrive:
| № | Приклад даних | Коментар |
|---|---|---|
| 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.
