# Интеграция MACRO и 1С Ниже приводятся типовые сценарии обмена данными и требования к наличию доступов к ресурсам. ## CRM: синхронизация договоров (ДДУ/ДКП/ДУСТ и т.д.) **Синхронизация (из 1С в CRM) договоров покупателей** Договоры необходимо синхронизироваться для последующей синхронизации платежей из 1С, которые обязательно должны быть разнесены в 1С на корректный договор с покупателем. Один договор в MacroCRM можете быть сопоставлен с несколькими договорами в 1С, по которым необходимо забирать данные об оплатах. **Особенности реализации** * Сверка с договорами в системе идет по номеру и дате договора в 1С, в ином случае (например, пустой даты, либо не обнаруженном по номеру договору) поиск идет по найденной в описании договора строчке вида “№0-9ХХХХ от дд.мм.гггг”. * Если по основному номеру договора ничего не найдено, то будет попытка найти по номеру договора основания в договорах уступки. * Во время синхронизации из номера договора из 1С удаляются строки “ДДУ”, “ДКП”, “№”, “УПТ” и пробелы. Затем поиск идет с учетом того что в 1С русские буквы могут быть написаны латиницей и наоборот. * Из 1С для синхронизации забираются только договоры с не пустым номеромне равным “б/н”. **Отчеты в CRM:** “Не сопоставленные договора из 1С”, “Статус синхронизации договоров CRM c 1C” **Ресурсы в 1С к которым требуется доступ:** Catalog\_Контрагенты, Catalog\_ДоговорыКонтрагентов, Catalog\_Пользователи, Catalog\_Организации ## CRM: синхронизация поступлений платежей по графику договора Синхронизируются поступления прежде всего на расчетный счет. Также могут быть синхронизированы поступления на эскроу счета, если компания ведет учет поступлений по эскроу счетам с помощью бухгалтерских операций на хозрасчетных счетах. Операции зачета платежей при переуступке по эскроу счетам игнорируются, чтобы не дублировать поступления по графику. **Особенности реализации** * **Учитываются только поступления, имеющие договор, синхронизированный с CRM.** * Может быть настроен учет поступлений только определенных статей движения денежных средств из 1С. * Должны быть сопоставлены банковские счета в настройках интеграции 1С. * Если сопоставленная в CRM фин.операция помечена как удаленная либо у нее изменилась сумма в 1C, то сопоставление удаляется, фин.операция возвращается в статус “К оплате” чтобы быть корректно обработанной при следующей синхронизации. * Синхронизация очередной операции из 1С с графиком платежей по договору проходит по сценарию (проверка идет до первого успешного действия): * Поиск в графике первой не сопоставленной операции, подходящей по сумме платежке в 1С. * Формирование из графика платежей набора операций с одинаковым банковским счетом, сумма которых полностью совпадает с суммой платежа из 1С. Если набор сформирован, то в первой из набора операции изменяется сумма на сумму платежа в 1С и операция проводится. Остальные операции из набора удаляются. * Проверяем есть ли в графике проведенные операции, не сопоставленные с 1С. Если есть - прекращаем попытку синхронизации этого платежа. * Если сумма платежа в 1С меньше чем первая не проведенная операция в графике, то разбиваем эту операцию на две операции, первую закрываем пришедшей суммой, вторую оставляем к оплате. * Если сумма платежа в 1С больше чем первая не проведенная операция в графике, увеличиваем сумму в операции до суммы в платежке. Корректируем последующие операции (удаляем либо корректируем сумму и проводим). Если существующих платежей недостаточно для проведения всей суммы то создается и проводится дополнительная операция в графике. **Отчеты в CRM:** Не сопоставленные 1С-платежи по договорам **Ресурсы в 1С к которым требуется доступ:** Catalog\_БанковскиеСчета, Catalog\_СтатьиДвиженияДенежныхСредств, Document\_ПоступлениеНаРасчетныйСчет. (При необходимости: Document\_ПлатежноеПоручениеВходящее, Document\_ПриходныйКассовыйОрдер, Document\_КорректировкаДолга, Document\_ПлатежныйОрдерПоступлениеДенежныхСредств, Document\_ПриходныйКассовыйОрдер, Catalog\_Валюты, AccountingRegister\_Хозрасчетный, Document\_ОперацияБух, ChartOfAccounts\_Хозрасчетный) ## ERP: Синхронизация компаний, контрагентов и физ.лиц. Поддержание идентичности справочников между системами. Данный сценарий требуется для всех последующих сценариев обмена данными с 1С. **Особенности реализации** * Поиск контакта в ERP идет по ИНН контрагента (для юр.лиц) либо по телефону (для физ.лиц). * В зависимости от настройки “Игнорировать КПП при слиянии контактов” при поиске учитывается КПП. * Поиск в организациях идет с параметром (allowedOnly=true) **Ресурсы в 1С к которым требуется доступ:** Catalog\_Контрагенты, Catalog\_Организации,Catalog\_ФизическиеЛица ## ERP: Синхронизация номенклатуры Поддержание идентичности справочников номенклатуры, с учетом расположения в иерархическом дереве категорий номенклатуры. Сопоставления записей, полученные в ходе данной синхронизации, используются для большинства последующих сценариев обмена данными с 1С. **Особенности реализации** * Сопоставление идет по строке “Наименование+Код” **Ресурсы в 1С к которым требуется доступ:** Catalog\_КлассификаторЕдиницИзмерения, Catalog\_Номенклатура ## ERP: Сопоставление складов Сопоставление складов выполняется в ручном режиме в интерфейсе модуля интеграции с 1С и используется для всех сценариев обмена данными движения ресурсов. **Ресурсы в 1С к которым требуется доступ:** Catalog\_Склады ## ERP: Сопоставление счетов Сопоставление счетов выполняется в ручном режиме в интерфейсе модуля интеграции с 1С и используется для всех сценариев обмена данными движения денег. **Ресурсы в 1С к которым требуется доступ:** Catalog\_БанковскиеСчета, Catalog\_Организации ## ERP: Синхронизация УПД Создает в 1С соответствующие первичные документы. Бухгалтеру требуется только проверить корректность и провести документ. **Особенности обратной синхронизации (из ERP в 1С)** * Синхронизация идет ежечасно, выбирая УПД, отмеченные как готовые к загрузке в 1С. * В 1С создаются документы: ПоступлениеТоваровУслуг * Перед созданием в 1С документов идет попытка найти в 1С подходящих под параметры выбранных УПД записей и их сопоставление, вместо создания. * Если в момент создания документа нет сопоставления контрагента, то в 1С предварительно будет сопоставлен, либо создан новый контрагент. * Если в момент создания документа нет сопоставления номенклатуры, то в 1С предварительно будет сопоставлена, либо создана новая номенклатура. * Если в момент создания в 1С нет нужной размерности, она будет создана. * Требуются сопоставленные склады в настройках синхронизации с 1С. У данных складов должна быть определена организация в настройках складов. **Ресурсы в 1С к которым требуется доступ:** Document\_ПоступлениеТоваровУслуг, Catalog\_Склады, Catalog\_Номенклатура, Catalog\_Контрагенты, Catalog\_Организации, Catalog\_КлассификаторЕдиницИзмерения,Catalog\_Валюты ## ERP: Синхронизация М29 Создает в 1С соответствующие первичные документы. Бухгалтеру требуется только проверить корректность и провести документ. **Особенности обратной синхронизации (из ERP в 1С)** * Синхронизация идет ежечасно, выбирая несопоставленные списания по согласованным КС. * В 1С создаются документы: Document\_ПоступлениеИзПереработки * Если в момент создания документа нет сопоставления контрагента, то в 1С предварительно будет сопоставлен, либо создан новый контрагент. * Если в момент создания документа нет сопоставления номенклатуры, то в 1С предварительно будет сопоставлена, либо создана новая номенклатура. * Если в момент создания в 1С нет нужной размерности, она будет создана. * Требуются сопоставленные склады в настройках синхронизации с 1С. У данных складов должна быть определена организация в настройках складов. **Ресурсы в 1С к которым требуется доступ:** Document\_ПоступлениеИзПереработки, Catalog\_Склады, Catalog\_Номенклатура, Catalog\_Контрагенты, Catalog\_Организации, Catalog\_КлассификаторЕдиницИзмерения,Catalog\_Валюты ## ERP: Синхронизация М4 Создает в 1С соответствующие первичные документы. Бухгалтеру требуется только проверить корректность и провести документ. **Особенности обратной синхронизации (из ERP в 1С)** * Синхронизация идет ежечасно, выбирая несопоставленные списания по согласованным КС. * В 1С создаются документы: Document\_ПоступлениеИзПереработки * Если в момент создания документа нет сопоставления контрагента, то в 1С предварительно будет сопоставлен, либо создан новый контрагент. * Если в момент создания документа нет сопоставления номенклатуры, то в 1С предварительно будет сопоставлена, либо создана новая номенклатура. * Если в момент создания в 1С нет нужной размерности, она будет создана. * Требуются сопоставленные склады в настройках синхронизации с 1С. У данных складов должна быть определена организация в настройках складов. **Ресурсы в 1С к которым требуется доступ:** Document\_ПоступлениеИзПереработки, Catalog\_Склады, Catalog\_Номенклатура, Catalog\_Контрагенты, Catalog\_Организации, Catalog\_КлассификаторЕдиницИзмерения,Catalog\_Валюты ## ERP: Синхронизация М15 Создает в 1С соответствующие первичные документы. Бухгалтеру требуется только проверить корректность и провести документ. **Особенности обратной синхронизации (из ERP в 1С)** * Синхронизация идет ежечасно, выбирая несопоставленные списания по согласованным КС. * В 1С создаются документы: Document\_ПередачаТоваров * Если в момент создания документа нет сопоставления контрагента, то в 1С предварительно будет сопоставлен, либо создан новый контрагент. * Если в момент создания документа нет сопоставления номенклатуры, то в 1С предварительно будет сопоставлена, либо создана новая номенклатура. * Если в момент создания в 1С нет нужной размерности, она будет создана. * Требуются сопоставленные склады в настройках синхронизации с 1С. У данных складов должна быть определена организация в настройках складов. **Ресурсы в 1С к которым требуется доступ:** Document\_ПередачаТоваров, Catalog\_Склады, Catalog\_Номенклатура, Catalog\_Контрагенты, Catalog\_Организации, Catalog\_КлассификаторЕдиницИзмерения,Catalog\_Валюты ## ERP: Синхронизация перемещения ТМЦ между складами Создает в 1С соответствующие первичные документы. Бухгалтеру требуется только проверить корректность и провести документ. **Особенности обратной синхронизации (из ERP в 1С)** * Синхронизация идет ежечасно, выбирая несопоставленные списания по согласованным КС. * В 1С создаются документы: Document\_ПеремещениеТоваров * Если в момент создания документа нет сопоставления номенклатуры, то в 1С предварительно будет сопоставлена, либо создана новая номенклатура. * Если в момент создания в 1С нет нужной размерности, она будет создана. * Требуются сопоставленные склады в настройках синхронизации с 1С. У данных складов должна быть определена организация в настройках складов. **Ресурсы в 1С к которым требуется доступ:** Document\_ПередачаТоваров, Catalog\_Склады, Catalog\_Номенклатура, Catalog\_Контрагенты, Catalog\_Организации, Catalog\_КлассификаторЕдиницИзмерения,Catalog\_Валюты ## ERP: Синхронизация расходных финансовых платежей из 1С в ERP Мониторит Document\_ПлатежноеПоручение (либо указанный список других ресурсов) на предмет появления новых проведенных платежей и либо ищет в ERP подходящую финансовую операцию и проводит ее, либо создает новую. Система умеет корректно распознавать переводы между внутренними счетами. Система умеет корректно распознавать и пропускать операции зачета, проведенные на хозрасчетных счетах. **Особенности реализации** * Требуются сопоставленные банковские счета по которым будет синхронизироваться движение ДС. * Требуются синхронизированные контрагенты и организации * Требуются сопоставленные пользователи * Синхронизируются только сопоставленные в настройках интеграции с 1С типы (статьи расходов) * В настройках интеграции с 1С может быть настроен специальный учет для отражения платежей определенным контрагентам как перевод ДС между своими счетами. * Синхронизация идет каждые 10 минут/час/сутки/неделю, выбирая из 1С несопоставленные платежи за определенный период. * Найденные платежи проходят по следующему сценарию. * В ERP ищутся все подходящие по сумме и получателю финансовые операции в пределах того же месяца, либо если задано в настройках синхронизации с 1С в периоде +-Х дней. * Первая из найденных операций проводится. В ней проверяется и корректируется счет с которого произведен платеж. * Если не найдены по сумме и получателю платежи и в настройках интеграции разрешено создавать фин.операции по данной статье расходов, то в ERP создается и проводится соответствующая финансовая операция. **Отчеты:** Не сопоставленные финансовые операций из 1C **Ресурсы в 1С к которым требуется доступ:** Document\_ПлатежноеПоручениеВходящее, Document\_ЗаявкаНаРасходованиеСредств, Catalog\_БанковскиеСчета, Catalog\_ФизическиеЛица, Catalog\_СтатьиДвиженияДенежныхСредств, Catalog\_Контрагенты, Catalog\_Проекты, Catalog\_ДоговорыКонтрагентов, Catalog\_Пользователи, Catalog\_Организации, Catalog\_Валюты ## ERP: Создание в 1С платежных поручений/заявок на расходование средств Создает в 1С соответствующие документы на основании акцептованных финансовых операции с переводом счет → контрагент. **Особенности реализации** * Какой именно вид документа будет создаваться регулируется настройкой в синхронизации с 1С * Требуются синхронизированные контрагенты и организации * Требуются сопоставленные пользователи * Если в момент создания документа нет сопоставления контрагента, то в 1С предварительно будет сопоставлен, либо создан новый контрагент. **Ресурсы в 1С к которым требуется доступ:** Document\_ПлатежноеПоручение, Document\_ЗаявкаНаРасходованиеСредств, Catalog\_БанковскиеСчета, Catalog\_ФизическиеЛица, Catalog\_СтатьиДвиженияДенежныхСредств, Catalog\_Контрагенты, Catalog\_Пользователи, Catalog\_Организации, Catalog\_Валюты ## ERP: Корректный учет платежей по проводимым корректировкам долга Поиск в документе Document\_КорректировкаДолга операций корректировки, последующий поиск ранее проведенных и сопоставленных с 1С финансовых операций (ФО) и замена в них текущего получателя на Фактического получателя, а текущего получателя на контрагента из контракта, также отнесение этого платежа на конкретный контракт, проект, группу работ. **Особенности реализации** * Поиск идет только для корректировок где записи в параметре ДебиторскаяЗадолженность содержат параметр Сделка\_Type равный StandardODATA.Document\_СписаниеСРасчетногоСчета * Корректировка не производится если: * в найденной ФО уже есть фактический получатель * в найденной ФО уже есть привязка к договору * в контракте по которому производится корректировка нет привязки к проекту/работе * сумма найденной ФО не совпадает с суммой корректировки * дебитор корректировки не совпадает с текущим получателем найденной ФО * кредитор корректировки не совпадает с контрагентом контракта **Ресурсы в 1С к которым требуется доступ:** Document\_КорректировкаДолга ## Технические параметры интеграции Для интеграции MACRO и 1С необходимо со стороны 1С предпринять следующие действия: 1. Настроить и опубликовать REST интерфейс OData в 1С (ссылка вида [https://ip:port/servername/odata/standard.odata/](about:blank)) 2. Добавить в OData специального пользователя, с нужными правами на чтение и запись. 3. Предоставить технической поддержке MACRO ссылку и логин/пароль специального пользователя. 4. При необходимости прописать в разрешениях интерфейса доступ только с IP адресов MACRO (запросить у технической поддержки) В интерфейсе ODATA должен быть открыт доступ к ресурсам, требуемым для необходимых сценариев обмена данными.