====== Предварительные операции (получение токенов) ======


Для работы ПО необходимо получить токены:
  - Токен Яндекс.Доставки
  - Токен Яндекс.Геокодера (платное использование!)
  - Токен (API-ключ) DADATA (есть бесплатное использование, подходящее для задач данного модуля)

Токен Яндекс.Доставки нужен всегда.
Для работы с картами можно использовать два сервиса на выбор - **либо Яндекс.Геокодер, либо DADATA.**
На территории России доступны оба, на территории Казахстана DADATA не работает.
Использование Яндекс.Геокодера - не бесплатно. Для базового случая настройки интеграции используйте сервис DADATA.

===== Получение токена Яндекс.Доставки =====
Чтобы получить токен Яндекс.Доставка необходимо пройти [[https://dostavka.yandex.ru/business/self-registration?ya_source=businessdelivery&ya_medium=module&ya_campaign=rkeeper#form|процесс регистрации]]. 
Пример процесса регистрации по шагам:
{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-085633.png}}
{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-085706.png}}
{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-085820.png}}
{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-085838.png}}

Данный токен потребуется при настройке модуля. Сохраните его.

Убедитесь, что в личном кабинете сделано всё чтобы иметь возможность оплачивать работу курьеров. В частности, если личный кабинет сделан на "самозанятого" - нужно привязать банковскую карту.

===== Получение токена Яндекс.Геокодера =====

Использование Яндекс.Геокодера - не бесплатно.
Выдержка из условий - "Бесплатная версия API предназначена только для сайтов или приложений, доступ к которым может получить любой пользователь интернета."

Чтобы получить токен геокодирования в системе Яндекс [[https://developer.tech.yandex.ru/|необходимо зарегистрироваться здесь]]. 
Пример получения токена по шагам:
{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-090808.png}}
Заполняем данные формы, нажимаем "продолжить". На этапе заполнения формы осознаём, что воспользоваться данным сервисом бесплатно не получится.
{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-091154.png}}
{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-091540.png}}
{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-091625.png}}

Важно! Может потребоваться заполнение дополнительных данных.
На июнь 2023 Яндекс требует: "Для корректной работы JavaScript API необходимо указать параметр HTTP Referer для ключей: Key #4, Key #3, Key #2, Key #1."

Требования могут меняться.

===== Получение токена (API-ключа) DADATA =====

Не работает на территории Казахстана. Если настраиваете для Казахстана - используйте Яндекс.Геокодер
Для получения токена нужно пройти регистрацию на сайте https://dadata.ru/
Процесс регистрации по шагам:
{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-092227.png}}
{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-092239.png}}
{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-092318.png}}
Обязательно подтвердить регистрацию по ссылке в письме.
После этого: 
{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-092425.png}}
{{:external:r_keeper_и_яндекс.доставка:pasted:20230602-092528.png}}