Подключение интеграций и работа с API
Получайте заказы в Eltaman автоматически — из встроенных интеграций с магазинами, которые вы подключаете сами, или напрямую через API.
Встроенные интеграции
Подключите Shopify, WooCommerce, Kaspi, Uzum или Noon самостоятельно в разделе Настройки → Интеграции — у каждой есть собственные элементы подключения/отключения. Заказы из Shopify, WooCommerce, Kaspi и Noon импортируются автоматически; заказы Uzum импортируются, когда вы нажимаете Синхронизировать Uzum на странице заказов. Обновления статуса отправляются обратно в Uzum, Kaspi и WooCommerce, а в Shopify заказ отмечается выполненным после доставки.
Собственные интеграции
Если у вас собственный 3PL или своя платформа, интегрируйтесь напрямую через API (см. ниже). Если нужна помощь с подключением, напишите нам через виджет чата или в Telegram, указав используемую вами платформу.
API-ключи
Для прямой интеграции создайте API-ключ в настройках. Каждый ключ несёт области доступа (scopes), ограничивающие его возможности. Передавайте ключ в заголовке X-API-Key при запросах к партнёрскому API по адресу /api/v1/external/.
Относитесь к API-ключам как к паролям. Храните их безопасно, никогда не добавляйте в систему контроля версий и немедленно меняйте ключ, если он был раскрыт. API-ключи не имеют доступа к путям загрузки файлов.
Вебхуки
Зарегистрируйте URL вебхука, чтобы получать события — например, изменения статуса заказа — в свои системы в момент их возникновения. Eltaman автоматически повторяет неудавшиеся доставки (до 6 попыток в течение примерно 39 часов). Проверить конечную точку можно кнопкой Тест в разделе Настройки → Вебхуки.
Импорт с маркетплейсов дедуплицируется по интеграции и внешнему идентификатору заказа. При работе с внешним API передавайте заголовок Idempotency-Key, чтобы повторный запрос в течение 24 часов никогда не создал второй заказ.