В Новой почте есть старая и новая адресная система.
На сайтах часто для доставки на отделение – используется старая адресная система, а для доставки на адрес – новая адресная система.
Как передавать данные Новой почты при создании заявок по API, чтобы автоматически заполнились город и улица доставки в блоке Новой Почты в SalesDrive?
В старой адресной системе – названия городов не повторяются и имеют такой формат:
- то есть несмотря на то, что это одно и то же название населенного пункта "Запорожье" - все равно названия разные.
В режиме cityNameFormat="full" – можно передавать Ref города в системе Новой почты:
Если с сайта не удается получить ref города, можно передавать название города текстом:
В режиме cityNameFormat="full" – не нужно передавать область и район (так как название населенного пункта – однозначно идентифицирует населенный пункт).
Названия городов можно передавать на украинском или русском языке.
В режиме cityNameFormat="short" - ожидается, что данные по API будут передаваться следующим образом:
- здесь название города однозначно не идентифицирует населенный пункт (так как в Украине есть 14 населенных пунктов "Запорожье"), поэтому нужно указывать область и район.
Если указать только область (а район не указать), то в большинстве случаев – город заполнится в SalesDrive (так как обычно в одной области нет двух населенных пунктов с одинаковым названием). Если в указанной области найдется несколько населенных пунктов с указанным названием, то город не заполнится в SalesDrive.
Если не указать область (novaposhta[area]) и район (novaposhta[region]), и будет найдено несколько населенных пунктов с указанным названием, то город не заполнится в SalesDrive.
Названия городов, областей, районов можно передавать на украинском или русском языке.
При создании в SalesDrive заявки по API – то чтобы указать, что это новая адресная система – нужно указать:
В режиме cityNameFormat="settlement" – можно передавать Ref города в новой адресной системе Новой почты (Ref города в новой адресной системе – отличается от Ref города в старой адресной системе):
Если с сайта не удается получить Ref города, можно передавать название города текстом:
Названия городов, областей, районов можно передавать на украинском или русском языке..
В старой адресной системе (cityNameFormat="full" или cityNameFormat="short") – улицы можно передавать так:
Названия улиц можно передавать только на украинском языке (так как в старой адресной системе – названия улиц есть только на украинском языке).
Улица заполнится в SalesDrive только в случае, если точно совпадет название и тип улицы.
В новой адресной системе (cityNameFormat="settlement") – улицу нужно передавать текстом:
Здесь не требуется точного соответствия с названием улицы в системе Новой Почты..
Ref улицы нельзя передавать в новой адресной системе.