интеграция СДЭК с 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 и отслеживания статусов доставки.
Как будет реализовано хранение нескольких отправлений в одной сделке.
Как будет обеспечена защита от дублей.
Стоимость и срок.
Какие доступы понадобятся.
Примеры аналогичных проектов.

Исходный код и все разработанные компоненты передаются заказчику.