интеграция Почты России с amoCRM

ТЗ: интеграция Почты России с amoCRM
1. Общая логика

Необходимо разработать интеграцию Почты России с amoCRM.

Сотрудник вручную создаёт отправление из карточки сделки через виджет amoCRM. После создания отправления интеграция получает трек-номер, сохраняет его в соответствующее поле сделки и отслеживает статус отправления.

При изменении статуса отправления сделка автоматически переводится на соответствующий этап воронки.

В одной сделке может быть несколько последовательных отправлений. Каждое отправление должно быть связано с конкретным типом документов, чтобы статус одного отправления не влиял на этап другого.

2. Воронка «Возврат страховки досудебный»

Типы отправлений:

Документы
отправлено → этап «документы направлены»
доставлено → «документы получены»
Заявление в банк
отправлено → «заявление в банк направлено»
доставлено → «заявление получено»
Претензия в банк
отправлено → «претензия в банк направлена»
доставлено → «претензия получена»
Обращение к ФУ
отправлено → «обращение к фу направлено»
доставлено → «обращение к фу получено»
3. Воронка «Возврат партнеры»

Отправление «Документы» не используется.

Типы отправлений:

Заявление в банк
отправлено → «заявление в банк направлено»
доставлено → «заявление получено»
Претензия в банк
отправлено → «претензия в банк направлена»
доставлено → «претензия получена»
Обращение к ФУ
отправлено → «обращение к фу направлено»
доставлено → «обращение к фу получено»
4. Виджет в amoCRM

В карточке сделки необходимо сделать виджет, через который сотрудник:

выбирает тип отправления;
указывает данные отправителя;
указывает данные получателя;
указывает необходимые параметры отправления;
создаёт отправление в системе Почты России.

После успешного создания отправления:

получить трек-номер;
записать его в соответствующее поле сделки;
сохранить связь «трек-номер → тип отправления»;
начать отслеживание отправления.

Данные отправителя и получателя индивидуальны для каждой сделки и должны вводиться сотрудником через виджет.

5. Поля в amoCRM

Для воронки «Возврат страховки досудебный»:

Трек-номер: Документы
Трек-номер: Заявление в банк
Трек-номер: Претензия в банк
Трек-номер: Обращение к ФУ

Для воронки «Возврат партнеры»:

Трек-номер: Заявление в банк
Трек-номер: Претензия в банк
Трек-номер: Обращение к ФУ

При необходимости можно добавить отдельные поля для текущего статуса и даты доставки.

6. Отслеживание отправлений

Интеграция должна получать актуальный статус отправления через API/доступные механизмы Почты России.

Необходимо корректно сопоставить статусы Почты России с логикой amoCRM:

отправление принято/отправлено → этап «... направлено»;
отправление доставлено получателю → этап «... получено».

Промежуточные статусы Почты России необходимо обработать так, чтобы они не вызывали ошибочного перевода сделки.

7. Несколько отправлений в одной сделке

Одна сделка может последовательно иметь несколько отправлений.

Например:

Документы → Заявление в банк → Претензия → Обращение к ФУ.

При этом у каждого отправления свой трек-номер и свой тип.

Статус отправления должен изменять только соответствующий этап сделки согласно настроенной логике.

Необходимо предусмотреть защиту от повторной обработки одного и того же статуса/уведомления.

8. Технические требования

Использовать:

API Почты России;
API amoCRM;
виджет amoCRM;
серверную часть интеграции;
механизм получения/проверки статусов отправлений.

Предусмотреть:

обработку ошибок API;
повторные запросы при временных ошибках;
защиту от дублей;
логирование операций;
безопасное хранение ключей/API-доступов;
корректную работу с несколькими отправлениями в одной сделке.

Перед разработкой изучить существующие интеграции Почты России с amoCRM и виджеты в Marketplace amoCRM и использовать их как ориентир по интерфейсу и принципу работы.

9. Результат

На выходе нужна полностью рабочая интеграция:

виджет в карточке сделки;
создание отправлений через Почту России;
получение и сохранение трек-номеров;
отслеживание статусов;
автоматическое изменение этапов сделок;
работа с несколькими отправлениями в одной сделке;
серверная часть;
исходный код;
документация по установке и настройке;
тестирование всех сценариев.

В отклике указать: опыт разработки виджетов/API для amoCRM, опыт интеграции с Почтой России, стоимость, сроки, необходимые доступы и примеры аналогичных работ.