Интеграция 1С с Битрикс 24. Полная интеграция с необходимость изменения Битрикс 24
(0)
16 000 грн.
Купить
Полное описание

Обмен данными между 1С и Битрикс24

(с использованием HTTP-Сервиса)

 

В данной реализации инициатором обмена всегда является Битрикс24!

HTTP-сервис 1С принимает команды от Битриккс24 и выдает ответ в формате JSON.

Рассмотрим подробнее все команды:

Существует две ветки пути

http://hostname/{Имя публикации}/hs/exch/IN (POST) - Загрузка (+изменение/пометка на удаление) данных в 1С

http://hostname /{Имя публикации}/hs/exch/OUT (GET, POST) – Выгрузка данных из 1С (получение данных)

IN – только POST

JSON, формат : {"ENTITY":"XXX"; "XXX":"ADD"; "1С_ID":"XXXХХ"; "BX24_ID":"XXXХХ"; ... другие данные}

1. При добавлении: в запрос попадают все данные, необходимые для синхронизации (см. перевязочные таблицы ниже);

{"ENTITY":"XXX"; "ACTION":"ADD"; "1С_ID":"XXXХХ"; "BX24_ID":"XXXХХ"; ... другие данные}

При добавлении ID 1С будет равен пустоте.

2. При редактировании: в запрос попадают все данные, необходимые для синхронизации (см. перевязочные таблицы ниже);

{"ENTITY":"XXX"; "ACTION":"UPDATE"; "1С_ID":"XXXХХ"; "BX24_ID":"XXXХХ"; ... другие данные}

3. При удалении (в 1С пометка на удаление): запрос имеет следующий вид:

{"ENTITY":"XXX"; "ACTION":"DELETE"; "1С_ID":"XXXХХ"; "BX24_ID":"XXXХХ";}

OUT – GET (получение списка измененных объектов)

JSON, пример:

Запрос:

GET http://HostName/{Имя публикации}/hs/exch/OUT

ответ (все измененные/добавленные объекты):

{

    "result": [

        {

            "ENTITY": "INVOICE",

            "_1C_ID": "1381668b-e798-11e5-a58e-00266cf15e2d",

            "BX24_ID": "",

            "DESC": "Заказ покупателя PL000000001 от 11.03.2016 16:55:33"

        },

        {

            "ENTITY": "COMPANY",

            "_1C_ID": "9f349220-cefb-11df-9990-0013726517ec",

            "BX24_ID": "112233",

            "DESC": "Наименование контрагента 1"

        },

        {

            "ENTITY": "COMPANY",

            "_1C_ID": "ca816ade-f4a6-11e0-9e00-0013726517ec",

            "BX24_ID": "",

            "DESC": " Наименование контрагента 2"

        }

    ],

    "CODE": "200",

    "DESC": "Данные успешно получены."

}

 

Где

Для элементов массива:

ENTITY – Сущность Битрикс24 (ID Сущности)

                Предусмотрен обмен для следующих сущностей:

Integration-of-1C-with-Bitrix-24 10

_1C_ID – Уникальный идентификатор объекта 1С

BX24_ID – ID объкта Битрикс24

DESC – Описание объекта

Элементы за пределами массива:

CODE, DESC – Код результата запроса и его описание.

a.        при успешном обновлении данных:

Отправляется ответ со следующим содержимым:

{…"CODE":"200";"DESC":"Данные успешно обновлены."}

 

b.        при возникновении ошибки:

Отправляется ответ со следующим содержимым:

{…"CODE":"400";"DESC":"Ошибка! Данные не были обновлены."}

 

 

OUT – POST (получение данных объекта)

JSON, пример:

Запрос:

       {

            "ENTITY": "COMPANY",

            "_1C_ID": "9f349220-cefb-11df-9990-0013726517ec"

        }

ответ:

{

    "ENTITY": "COMPANY",

    "_1C_ID": "9f349220-cefb-11df-9990-0013726517ec",

    "BX24_ID": "112233",

    "CODE": "200",

    "DESC": "Данные успешно получены.",

    "COMPANY_SHORT_NAME": "Наименование компании",

    "ASSIGNED_USER": "Имя Ответственного Пользователя",

    "COMPANY_TYPE": "",

    "ACTIVITIES": "Строительная организация",

    "COMMENTS": "",

    "FULL_NAME": " Полное Наименование компании",

    "ACCESS_GROUP": "Киев",

    "DATE_FIRST_IMPLEMENTATION": "0001-01-01T00:00:00Z",

    "LOST_CUSTOMER": false,

    "CREDIT_LIMIT": false,

    "CONDITION_CREDIT_LIMIT": "",

    "CREDIT_LIMIT_USD": 0,

    "TERM_DAYS": 0,

    "OPERATING_MODE": "",

    "FULL_NAME_COMPANY": "Полное Наименование компании",

    "INN": "",

    "CERTIFICATE_NUMBER": "",

    "EDRPOU": "",

    "CONNECTED_WEB": true,

    "EMAIL": "test@test.com",

    "PHONE": "+380 (050) 123-45-67",

    "ACTUAL_ADDRESS": "12345",

    "INDEX_ACTUAL": "12345",

    "FILE_NAME": "Описание бонусной системы.txt",

    "FILE_TYPE": "Прочее",

    "FILE_VALIDITY": "0001-01-01T00:00:00Z",

    "FILE_REGISTRATION": "2017-05-28T00:00:00Z"

}


 Настройка обмена на стороне 1С

 

Для настройки обмена используются следующие объекты метаданных:

Рис.1. Планы видов характеристик

Рис.1. Данные для настройки обмена.

«Справочники Битрикс24» (+ Справочник «Значения справочников Битрикс24»). Предусмотрена настройка соответствия значений справочного типа (справочник, перечисление, …) к значениям в Битрикс24. Это сделано для тех случаев, когда строковое представление значений справочника (перечисления) не (всегда) соответствует своему аналогу в Битрикс24.

Пример:

Рис.2. Настройка соответствия значений справочного типа (справочник, перечисление, …) к значениям в Битрикс 24

Рис.2. Настройка соответствия значений справочного типа (справочник, перечисление, …) к значениям в Битрикс 24.

Структура метаданных – Представление метаданных, участвующих в обмене с Битрикс24, в виде справочника.

Пример:

Рис.3. Структура метаданных – Представление метаданных, участвующих в обмене с Битрикс24, в виде справочника.

Рис.3. Структура метаданных.

Сущности обмена с 1С – Сущности Битрикс24, и настройка соответствия им в 1С.

Пример:

Integration-of-1C-with-Bitrix-24 4

Рис.4. Сущности метаданных.

Предусмотрена связь не только реквизита метаданных с соответствующим полем сущности Битрикс24, но также и категорий, и связанного справочника и регистра сведений с возможностью установки отбора.

Пример:

Integration-of-1C-with-Bitrix-24 5

Рис.5. Связь метаданных с категорией, связанного справочника и регистра сведений с возможностью установки отбора.


Регистры сведений.

ID Битрикс24 – Хранение идентификатора объекта Битрикс24 в 1С.

Integration-of-1C-with-Bitrix-24 6

Рис. 6. Хранение идентификатора объекта.

Протокол выгрузки в Битрикс24 – Фиксация ошибок обмена. При необходимости можно фиксировать в том числе и успешные операции.

Пример:

Рис.7. Фиксация ошибок обмена.

Рис.7. Фиксация ошибок обмена.

Соответствие значений справочников Битрикс24 - Настройка соответствия справочных значений значениям в Битрикс24.

Пример:

Рис.8. Настройка соответствия справочных значений значениям в Битрикс24

Рис.8. Настройка соответствия справочных значений значениям в Битрикс24.





Стоимость работы: от 16000 грн.


Разработчик: Компания «NCT»

www.nct.ua
office@nct.ua



  • Комментарии
  • Facebook
Загрузка комментариев...