Функции get_price_info и get_price. Узнать цену запчасти.

Описание функции:

Сервис "узнать цену запчасти" работает в два этапа:

  1. Функция (get_price_info) определяет возможность проведения операции и есть ли данные по запрашиваемым параметрам.
  2. Функция (get_price) списывает деньги за услугу и выдает подробную информацию о ценах.

Первый этап. Функция get_price_info

Название параметра Значение Описание
s_sn набор символов длиной не более 255 символов. код программы
action get_price_info действие выполняемое с данными
marka строка опционально, марка машины
model строка опционально, модель машины
modelN строка опционально, номер оптики
kuzovN строка опционально, номер кузова
engineN строка опционально, номер двигателя
producer_code строка опционально, код производителя
producer строка опционально, производитель
F_R R,F опционально, перед/зад
U_D U,D опционально, верх/низ
R_L L,R опционально, лев/прав
N_O O,N опционально, новая, б/у
name строка опционально, название запчасти
oem строка опционально, ОЕМ код запчасти
place код города из справчника parts_place опционально, идентификатор города

Вид POST запроса:

s_sn=3274171001&action=get_price_info&name=efi&marka=toyota&model=ipsum

Ответ: (пример приведен для программ 1С, для программ JcTrade ответ будет таки же, за исключением тега techinfo. Информация в нем будет представлена в формате JSON)

<?xml version="1.0" encoding="windows-1251"?>
<jcanswer>
<message>
    <result >SUCCESS</result>
    <code >N0407_BILLING_SUCCESS</code>
    <action >detail</action>
    <group id="billing" area="none"><![CDATA[Обработка данных биллинга]]></group>
    <datetime >2013-07-11 06:38:13</datetime>
    <text ><![CDATA[Данные о возможности проведения операции получены]]></text>
    <techinfo >
        <summary>
            <get_price_info>
                <free>
                    <count>0</count>
                    <atom_cost>0</atom_cost>
                    <cost>0</cost>
                </free>
                <poket>
                    <count>0</count>
                    <atom_cost>0</atom_cost>
                    <cost>0</cost>
                </poket>
                <cash>
                    <count>1</count>
                    <atom_cost>1</atom_cost>
                    <cost>1</cost>
                </cash>
                <active>1</active>
            </get_price_info>
        </summary>
        <result>1</result>
        <posible>yes</posible>
        <cost>1</cost>
        <currency_id>4</currency_id>
    </techinfo>
</message>
<message>
    <result >SUCCESS</result>
    <code >N0407_BILLING_SUCCESS</code>
    <action >account</action>
    <group id="billing" area="none"><![CDATA[Обработка данных биллинга]]></group>
    <datetime >2013-07-11 06:38:13</datetime>
    <text ><![CDATA[Данные о лицевом счете и добавленных объявлениях]]></text>
    <techinfo>
        <money>395143</money>
        <currency_id>4</currency_id>
        <added_count>0</added_count>
    </techinfo>
</message>
<message>
    <result >SUCCESS</result>
    <code >N0080_SERVICE_SUCCESS</code>
    <action >get_price_info</action>
    <group id="main" area="parts"><![CDATA[Система обработки данных]]></group>
    <datetime >2013-07-11 06:38:14</datetime>
    <text ><![CDATA[Запрос на среднюю цену успешно обработан]]></text>
    <techinfo>
        <has_value>1</has_value>
        <request_id>41</request_id>
        <notice_count>119</notice_count>
    </techinfo>
    <debuginfo></debuginfo>
</message>
</jcanswer>

Результат функции:
в первом теге message содержится информация о стоимости услуги, возможности ее проведения, во втором теге message указывается информация о состоянии счета программы, в третьем теге message результат запроса функции get_price_info. В теге techinfo приходят следующие параметры:

Название параметра Значение Описание
has_value 0,1 флаг показывающий есть ли результат
request_id Целое число идентификатор, по которому можнообратится для получения данных методом get_price
notice_count Целое число количество объявлений участвовавших в формировании цены

Второй этап. Функция get_price Получение результата.

Название параметра Значение Описание
s_sn набор символов длиной не более 255 символов. код программы
action get_price действие выполняемое с данными
request_id Целое число Значение, полученное на первом этапе функцией get_price_info

Вид POST запроса:

s_sn=45234523453&action=get_price&request_id=1565

Ответ: (пример приведен для программ 1С, для программ JcTrade ответ будет таки же, за исключением тега details. Информация в нем будет представлена в формате JSON)

<?xml version="1.0" encoding="windows-1251"?>
<jcanswer>
    <message>
        <result >SUCCESS</result>
        <code >N0081_SERVICE_SUCCESS</code>
        <action >get_price</action>
        <group id="main" area="parts"><![CDATA[Система обработки данных]]></group>
        <datetime >2013-07-11 06:40:54</datetime>
        <text ><![CDATA[Средняя цена получена]]></text>
        <techinfo >
            <notice_count>28</notice_count>
            <price_min>100</price_min>
            <price_max>5670</price_max>
            <price_average>3293</price_average>
            <details>
                <item num="0">14</item>
                <item num="100">1</item>
                <item num="1500">1</item>
                <item num="1600">1</item>
                <item num="2000">2</item>
                <item num="3000">3</item>
                <item num="3200">1</item>
                <item num="4846">1</item>
                <item num="4850">1</item>
                <item num="5670">3</item>
            </details>
        </techinfo>
        <debuginfo ><![CDATA[]]></debuginfo>
    </message>
</jcanswer>

В результате поле techinfo содержит следующие параметры:

Название параметра Значение Описание
notice_count набор символов длиной не более 255 символов. количество объявлений принимавших участие в построении цены
price_min Целое число минимальная цена
price_max Целое число максимальная цена
price_average Целое число средняя цена
details атрибут num - цена, значение в теге item - количество запчастей с указаной ценой. массив полученных цен, сгруппированных по цене, массив отсортирован по возрастанию. Ограничение на количество элементов в массиве: 200 (если различных цен больше то в результат не войдут маленькие цены)

results matching ""

    No results matching ""