Інтеграція 1С з Бітрікс 24. Повна інтеграція з необхідність зміни Бітрікс 24
(0)
16 000.00
Купити
Повний опис

Обмін даними між 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. Це зроблено для тих випадкiв, коли строкове представлення значень довідника (перерахування) ні (завжди) відповідає своєму аналогу в Бітрікс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
Завантаження коментаріїв...