Программисты — удалённая работа в Москве

Разработка чат-ботов. Задачи чат-бота: Работа с API. Платформа: Telegram. Продукт: Торговля. Техзадание есть. **Техническое задание на разработку Telegram-бота для работы с Ozon Seller API и сервисом «Мой налог»** --- ### **1. Описание проекта** **Цель:** Создать Telegram-бота, который автоматически проверяет статусы заказов на Ozon Seller и формирует чеки в сервисе «Мой налог» при статусе заказа «получен». --- ### **2. Функциональные требования** #### **Основной функционал:** 1. **Интеграция с Ozon Seller API:** - Получение списка заказов с Ozon. - Проверка статуса каждого заказа (особенно статуса `delivered` — «получен»). 2. **Интеграция с API «Мой налог»:** - Автоматическое создание чека при статусе заказа «получен». - Передача в чек данных: - Информация о клиенте (имя, ИНН). - Список товаров (название, цена, количество). - Общая сумма заказа. 3. **Уведомления в Telegram:** - Отправка подтверждения о создании чека. - Оповещения об ошибках (например, недоступность API, некорректные данные). 4. **Периодическая проверка заказов:** - Автоматическая проверка новых заказов каждые **10 минут**. --- ### **3. Технические требования** #### **Стек технологий:** - **Язык программирования:** Python 3.10+. - **Библиотеки:** - `python-telegram-bot` — для работы с Telegram API. - `requests` — для HTTP-запросов к Ozon и «Мой налог». - `apscheduler` — для периодических задач. - `python-dotenv` — для работы с переменными окружения. - **Хранение данных:** Конфигурационные ключи (API-токены) должны храниться в файле `.env`. #### **Безопасность:** - Ключи API (Ozon, «Мой налог», Telegram) не должны быть захардкожены в коде. - Реализовать обработку ошибок при работе с API (повторные запросы, логирование). --- ### **4. Этапы разработки** #### **Этап 1: Настройка окружения** - Создать виртуальное окружение. - Установить зависимости из `requirements.txt`. - Настроить файл `.env` с переменными: ```env TELEGRAM_TOKEN=ваш_токен OZON_CLIENT_ID=ваш_client_id OZON_API_KEY=ваш_api_ключ MOY_NALOG_TOKEN=ваш_токен_мн ``` #### **Этап 2: Реализация базового функционала Telegram-бота** - Реализовать команды: - `/start` — приветственное сообщение. - `/help` — справка по командам. - Настроить логирование действий бота. #### **Этап 3: Интеграция с Ozon Seller API** - Реализовать метод для получения списка заказов через Ozon API. - Добавить фильтр по статусу `delivered`. #### **Этап 4: Интеграция с «Мой налог»** - Реализовать метод для создания чека на основе данных заказа. - Убедиться в корректности формата данных (соответствие ФЗ-54). #### **Этап 5: Планировщик задач** - Настроить периодическую проверку заказов (каждые 10 минут) через `apscheduler`. #### **Этап 6: Тестирование** - Проверить обработку ошибок (например, при недоступности API). - Протестировать создание чеков в тестовом режиме «Мой налог». --- ### **5. Дополнительные требования** - **Документация:** Написать README.md с инструкцией по запуску и настройке. - **Масштабируемость:** Код должен быть модульным для возможного добавления новых функций (например, интеграция с другими маркетплейсами). - **Логирование:** Все критические события (ошибки, создание чеков) должны записываться в файл `bot.log`. --- ### **6. Сроки и бюджет** - **Срок выполнения:** 5–7 рабочих дней. - **Бюджет:** По договоренности (в зависимости от опыта исполнителя). --- ### **7. Примеры запросов к API** #### **Ozon Seller API (получение заказов):** ```python headers = { “Client-Id“: OZON_CLIENT_ID, “Api-Key“: OZON_API_KEY, “Content-Type“: “application/json“ } response = requests.post( “https://api-seller.ozon.ru/v3/posting/fbs/unfulfilled/list“, headers=headers, json={“limit“: 10} ) ``` #### **«Мой налог» (создание чека):** ```python receipt_data = { “client“: {“name“: “Иван Иванов“, “inn“: “1234567890“}, “items“: [{“name“: “Товар 1“, “price“: 1000, “quantity“: 2}], “totalAmount“: 2000, “timestamp“: “2024-07-20T12:00:00Z“ } response = requests.post( “https://lknpd.nalog.ru/api/v1/receipts“, headers={“Authorization“: f“Bearer {MOY_NALOG_TOKEN}“}, json=receipt_data ) ``` --- **Примечание:** Перед началом работы уточните документацию API Ozon и «Мой налог», так как endpoints и параметры могут меняться.