Задание: Python. интеграция СДЭК с amoCRM (Дистанционная работа)
ТЗ: интеграция СДЭК с amoCRM Необходимо разработать интеграцию СДЭК → amoCRM для создания и автоматического отслеживания нескольких последовательных отправлений документов в рамках одной сделки. 1. Общая логика В одной сделке может быть несколько отправлений СДЭК. Каждое отправление сотрудник создаёт вручную через виджет в карточке сделки amoCRM. После создания отправления интеграция получает номер отправления СДЭК и сохраняет его в соответствующее поле сделки. Далее интеграция отслеживает статус каждого отправления и при изменении статуса автоматически переводит сделку на соответствующий этап воронки. 2. Воронка «Возврат страховки досудебный» Последовательность отправлений: Документы: СДЭК «Отправлено» → этап «документы направлены» СДЭК «Доставлено» → этап «документы получены» Заявление в банк: «Отправлено» → «заявление в банк направлено» «Доставлено» → «заявление получено» Претензия в банк: «Отправлено» → «претензия в банк направлена» «Доставлено» → «претензия получена» Обращение к ФУ: «Отправлено» → «обращение к фу направлено» «Доставлено» → «обращение к фу получено» 3. Воронка «Возврат партнеры» Заявление в банк: «Отправлено» → «заявление в банк направлено» «Доставлено» → «заявление получено» Претензия в банк: «Отправлено» → «претензия в банк направлена» «Доставлено» → «претензия получена» Обращение к ФУ: «Отправлено» → «обращение к фу направлено» «Доставлено» → «обращение к фу получено» Логика должна работать в рамках одной и той же сделки, при этом одновременно может существовать несколько отправлений. 4. Поля для номеров СДЭК В amoCRM необходимо создать отдельные поля: Возврат страховки досудебный: Номер СДЭК — документы Номер СДЭК — заявление в банк Номер СДЭК — претензия в банк Номер СДЭК — обращение к ФУ Возврат партнеры: Номер СДЭК — заявление в банк Номер СДЭК — претензия в банк Номер СДЭК — обращение к ФУ Желательно также хранить текущий статус каждого отправления. 5. Виджет СДЭК в карточке сделки Сотрудник должен самостоятельно создавать отправление через виджет. Виджет должен позволять выбрать тип отправления и ввести данные отправителя/получателя. Данные отправителя и получателя разные для каждой сделки, поэтому они вводятся непосредственно в виджете. Необходимые данные, как минимум: ФИО отправителя; телефон; данные получателя; телефон; город; адрес или ПВЗ СДЭК; параметры отправления документов. Точный набор полей определить по API СДЭК и существующим решениям СДЭК в amoCRM. После нажатия «Создать отправление» виджет создаёт отправление через API СДЭК и записывает полученный номер в соответствующее поле сделки. Для каждой воронки должны отображаться только доступные типы отправлений. 6. Отслеживание СДЭК Интеграция должна получать актуальные статусы созданных отправлений через API/Webhook СДЭК. Необходимо однозначно связывать номер отправления с его типом. Например: Номер СДЭК — заявление в банк + «Доставлено» → этап «заявление получено». Статус одного отправления не должен менять сделку на этап другого отправления. Необходимо предусмотреть корректное соответствие реальных статусов API СДЭК статусам «Отправлено» и «Доставлено», включая возможные промежуточные статусы. 7. Защита от дублей и ошибок Предусмотреть: запрет случайного создания второго отправления одного типа; повторные webhook от СДЭК; повторное получение одного статуса; ошибки API; временную недоступность СДЭК; некорректные данные; уже существующее отправление. Повторное событие не должно создавать дубли или повторно переводить сделку. 8. Технические требования Использовать: API СДЭК; API amoCRM; Webhook/механизм отслеживания статусов СДЭК; виджет amoCRM. Архитектура должна позволять в дальнейшем добавлять новые типы отправлений, воронки и этапы без полной переработки системы. 9. Что передать заказчику полностью рабочую интеграцию; исходный код; виджет amoCRM; серверную часть; настройку API; инструкцию по установке и обслуживанию; инструкцию по изменению соответствий статусов; логирование ошибок; тестирование всех описанных сценариев. 10. В отклике указать Опыт разработки интеграций с amoCRM. Опыт разработки виджетов amoCRM. Опыт работы с API СДЭК. Опыт Webhook и отслеживания статусов доставки. Как будет реализовано хранение нескольких отправлений в одной сделке. Как будет обеспечена защита от дублей. Стоимость и срок. Какие доступы понадобятся. Примеры аналогичных проектов. Исходный код и все разработанные компоненты передаются заказчику.
