Загрузка контрагентов и карт — различия между версиями

Материал из Wiki
Перейти к: навигация, поиск
 
Строка 15: Строка 15:
 
|<syntaxhighlight lang="xml">
 
|<syntaxhighlight lang="xml">
 
<?xml version="1.0" encoding="utf-8"?>
 
<?xml version="1.0" encoding="utf-8"?>
//Заголовок файла обмена
+
<!--
 +
    Заголовок файла обмена
 +
-->
 
<back_to_ef org_name="Организация" dateuploading="yyyy-mm-dd hh:MM:ss">
 
<back_to_ef org_name="Организация" dateuploading="yyyy-mm-dd hh:MM:ss">
// Обязательные group fio.
+
<!--
// Если при формировании файла будет bind_type = «card» то есть по картам, тогда атрибут code тоже будет обязательным и атрибуты, следующие за ним могут быть, могут не быть. В противном случае атрибуты  
+
    Обязательные group fio.
// group – наименование группы контрагентов
+
    Если при формировании файла будет bind_type = «card» то есть по картам, тогда атрибут code тоже будет обязательным и атрибуты, следующие за ним могут быть, могут не быть. В противном случае атрибуты  
// fio – ФИО контрагента или наименование
+
    group – наименование группы контрагентов
// address – адрес контрагента
+
    fio – ФИО контрагента или наименование
// phone – телефоны контрагента
+
    address – адрес контрагента
// birth_day – день рождения контрагента
+
    phone – телефоны контрагента
// balance – баланс клубной карты контрагента (при загрузке используется для начальной установки)
+
    birth_day – день рождения контрагента
// accumulation – накопления контрагента (при загрузке используется для начальной установки)
+
    balance – баланс клубной карты контрагента (при загрузке используется для начальной установки)
// credit_level – уровень кредита контрагента
+
    accumulation – накопления контрагента (при загрузке используется для начальной установки)
// credit_level_type – периодичность кредита контрагента. «0» - никакого, «1» - понедельный, «2» - помесячный
+
    credit_level – уровень кредита контрагента
// bind_type – вариант синхронизации контрагентов при загрузке. {card|name|external_code} - {по картам|по имени контрагента|по внешнему коду}
+
    credit_level_type – периодичность кредита контрагента. «0» - никакого, «1» - понедельный, «2» - помесячный
// code – код карты контрагента, добавляемый сразу
+
    bind_type – вариант синхронизации контрагентов при загрузке. {card|name|external_code} - {по картам|по имени контрагента|по внешнему коду}
// discount_card – признак дисконтной карты у добавляемой по умолчанию
+
    code – код карты контрагента, добавляемый сразу
// external_code – внешний код синхронизации контрагента
+
    discount_card – признак дисконтной карты у добавляемой по умолчанию
// club_card - признак клубной карты у добавляемой по умолчанию
+
    external_code – внешний код синхронизации контрагента
// bonus_card - признак бонусной карты у добавляемой по умолчанию
+
    club_card - признак клубной карты у добавляемой по умолчанию
 +
    bonus_card - признак бонусной карты у добавляемой по умолчанию
 +
-->
 
<customer group="имя группы" code="Код карты" fio="ФИО" address="АдресКонтрагента" phone="Телефон" birth_day="yyyy-mm-dd" balance="" accumulation="0" credit_level="0" credit_level_type="0" discount_card="true" external_code="" club_card="true" bonus_card="true" bind_type = {card|name|external_code}>
 
<customer group="имя группы" code="Код карты" fio="ФИО" address="АдресКонтрагента" phone="Телефон" birth_day="yyyy-mm-dd" balance="" accumulation="0" credit_level="0" credit_level_type="0" discount_card="true" external_code="" club_card="true" bonus_card="true" bind_type = {card|name|external_code}>
// загрузка дополнительных карт поля см. выше
+
<!--
 +
    загрузка дополнительных карт поля см. выше
 +
-->
 
<card code="123123" discount_card="true" club_card="true" bonus_card="true"/>
 
<card code="123123" discount_card="true" club_card="true" bonus_card="true"/>
 
<card code="122124"/>
 
<card code="122124"/>
// регистрация операций по внесению списанию средств для контрагента (изменяет баланс клубной карты). Узел подчинен <customer>. С помощью внесения нескольких узлов по контрагенту можно создать историю его изменения счета, в Аппетите каждый узел отражается в виде отдельной транзакции по контрагенту
+
<!--
// type – приход("debit"), расход("credit") средств клубных карт
+
    регистрация операций по внесению списанию средств для контрагента (изменяет баланс клубной карты). Узел подчинен <customer>. С помощью внесения нескольких узлов по контрагенту можно создать историю его изменения счета, в Аппетите каждый узел отражается в виде отдельной транзакции по контрагенту
// value – сумма операции
+
    type – приход("debit"), расход("credit") средств клубных карт
// datetime – дата и время операции
+
    value – сумма операции
 +
    datetime – дата и время операции
 +
-->
 
<operation type="credit" value="10.0" datetime="yyyy-mm-dd hh:MM:ss"/>
 
<operation type="credit" value="10.0" datetime="yyyy-mm-dd hh:MM:ss"/>
 
<operation type="debit" value="10.0" datetime="2011-10-10 00:00:00"/>
 
<operation type="debit" value="10.0" datetime="2011-10-10 00:00:00"/>

Версия 16:17, 1 апреля 2015

API интеграции с учетной системой

Страница
Параметры
Пример запроса
Пример ответа
<?xml version="1.0" encoding="utf-8"?>
<!--
    Заголовок файла обмена
-->
<back_to_ef org_name="Организация" dateuploading="yyyy-mm-dd hh:MM:ss">
<!--
    Обязательные group fio.
    Если при формировании файла будет bind_type = «card» то есть по картам, тогда атрибут code тоже будет обязательным и атрибуты, следующие за ним могут быть, могут не быть. В противном случае атрибуты 
    group – наименование группы контрагентов
    fio – ФИО контрагента или наименование
    address – адрес контрагента
    phone – телефоны контрагента
    birth_day – день рождения контрагента
    balance – баланс клубной карты контрагента (при загрузке используется для начальной установки)
    accumulation – накопления контрагента (при загрузке используется для начальной установки)
    credit_level – уровень кредита контрагента
    credit_level_type – периодичность кредита контрагента. «0» - никакого, «1» - понедельный, «2» - помесячный
    bind_type – вариант синхронизации контрагентов при загрузке. {card|name|external_code} - {по картам|по имени контрагента|по внешнему коду}
    code – код карты контрагента, добавляемый сразу
    discount_card – признак дисконтной карты у добавляемой по умолчанию
    external_code – внешний код синхронизации контрагента
    club_card - признак клубной карты у добавляемой по умолчанию
    bonus_card - признак бонусной карты у добавляемой по умолчанию
-->
<customer group="имя группы" code="Код карты" fio="ФИО" address="АдресКонтрагента" phone="Телефон" birth_day="yyyy-mm-dd" balance="" accumulation="0" credit_level="0" credit_level_type="0" discount_card="true" external_code="" club_card="true" bonus_card="true" bind_type = {card|name|external_code}>
<!--
    загрузка дополнительных карт поля см. выше
-->
<card code="123123" discount_card="true" club_card="true" bonus_card="true"/>
<card code="122124"/>
<!--
    регистрация операций по внесению списанию средств для контрагента (изменяет баланс клубной карты). Узел подчинен <customer>. С помощью внесения нескольких узлов по контрагенту можно создать историю его изменения счета, в Аппетите каждый узел отражается в виде отдельной транзакции по контрагенту
    type – приход("debit"), расход("credit") средств клубных карт
    value – сумма операции
    datetime – дата и время операции
-->
<operation type="credit" value="10.0" datetime="yyyy-mm-dd hh:MM:ss"/>
<operation type="debit" value="10.0" datetime="2011-10-10 00:00:00"/>
<operation type="credit" value="10.0" datetime="2011-10-10 00:00:00"/>
<operation type="debit" value="10.0" datetime="2011-10-10 00:00:00"/>
</customer>
</back_to_ef>