ALL4CAR.RU - краткое описание веб сервиса

Описание методов вэбсервиса получения данных ALL4CAR.RU

адрес: http://pri.all4car.ru/partnersWS_35/service.asmx
WSDL: http://pri.all4car.ru/partnersWS_35/service.asmx?wsdl

GetActualRatesUSD — данные по актуальным курсам валют, тип результата: XML-документ
GetActualRatesByLogin — данные по актуальным курсам валютв соответствии с вашим логином, тип результата: XML-документ
GetSuppliersList — список поставщиков, тип результата: XML-документ

SearchResult — поиск запчасти по OEM коду, результат в валюте прайслиста поставщика, тип результата: строка, содержащая XML-документ
SearchResultOneCurrency — поиск запчасти по OEM коду, цены приведены к одной валюте, тип результата: строка, содержащая XML-документ
SearchResultOneCurrencyXml — поиск запчасти по OEM коду, цены приведены к одной валюте, тип результата: XML-документ
SearchResultXml — поиск запчасти по OEM коду, результат в валюте прайслиста поставщика, тип результата: XML-документ

Важно! Обращение на проценку от каждого логина не чаще чем 1 раз в 0.5 секунды!, если чаще - выдается ошибка "Maximum requests per second exeeded"

SearchOrdersByState — поиск краткой информации о клиентских заказах по их состояниям, тип результата: XML-документ
SearchOrdersByRef — поиск краткой информации о клиентских заказах по клиентским номерам, тип результата: XML-документ
getVersionDate — данные о версии сервиса

Сервис по работе с корзиной пользователя: all4car.ru/ws

GetActualRatesUSD()

результат (xml):

<result>
	<rate 
		dt="2011-04-05" 
		usd="29" 
		dtBN="2011-04-05" 
		usdBN="30" 
		dtUsdEur="2011-04-05" 
		UsdEur="1.41" 
	/> 
</result>

где:

dt — дата курса USD
usd — текущий курс USD
dtBN — дата внутреннего безнального курса USD
usdBN — внутренний безнальный курс USD
dtUsdEur — дата кросс-курса USD/EUR
UsdEur — внутренний кросс-курс USD/EUR

GetActualRatesByLogin(sAuthCode)

параметры:

sAuthCode — ваш код доступа к сервисам ALL4CAR

результат (xml):

<result>
	<rate 
		dt="2011-04-05" 
		usd="29" 
		dtBN="2011-04-05" 
		usdBN="30" 
		dtUsdEur="2011-04-05" 
		UsdEur="1.41" 
	/> 
</result>

где:

GetSuppliersList()

результат (xml):

<result>
	<suppl id="211" region="Москва" title="211">
		<dlv>Msc</dlv> 
	</suppl>
	...
	<suppl id="3089" region="ОАЭ" title="ОАЭ TAIHO">
		<dlv>Avia</dlv> 
		<dlv>Cargo</dlv> 
		<dlv>Cont</dlv> 
	</suppl>
</result>

SearchResultOneCurrencyXml(sPartCode,sAuthCode,iReplaces)

параметры:

sPartCode — ОЕМ-код запчасти
sAuthCode — ваш код доступа к сервисам ALL4CAR
iReplaces — поиск с учетом "замен" (по кроссам ALL4CAR): 0 — нет, 1 — да

результат (xml):

Тег supplier — информация о поставщике:

k — коэф. к цене по данному поставщику, в соотв. с вашей группой скидок

sId — код поставщика в ALL4CAR

make — код производителя

supplDays100 — статистика для срока поставки за последние 100 дней

supplDays30 — статистика для срока поставки за последние 30 дней

supplDate30 — предпологаемая дата поставки в соответствии со статистикой последних 30 дней

rgb — код цвета для отображения на сайте ALL4CAR

Delivery — код доставки

RusName — показывает необходимость "русского" наименования при формировании заказа для данного поставщика

info — доп. информация о поставщике (напр. "возврата нет" или "не заказывать габарит" и т.п.)

successProc — процент "успешных" доставок

новое flgRep - показывает возможность заказа с признаком "без замен (БЗ)"

новое flgQty - показывает возможность заказа с признаком "только это количество (ТЭК)"

новое flgReO - показывает возможность заказа с признаком "автоматический перезаказ (АПЗ)"

Тег srok — срок поставки в днях объявленный поставщиком.

<searchResult>
	<main>
		<part id="444159851">
			<from partId="444159851">main</from> 
			<code weightKg="0.300" volWeightKg="0.300">CLT4</code> 
			<price curr="USD" plPrice="10.18" plCurr="USD">10.18</price> 
			<descr>STABILIZER LINK FRT</descr> 
			<supplier k="0.830" sId="53" make="CTR" supplDays100="13" supplDays30="12" supplDate30="2011-04-17" rgb="FFFF00" Delivery="avia" RusName="false" info="" successProc="88.877">ОАЭ DUBL</supplier> 
			<supplierInfo /> 
			<probability>93%</probability> 
			<version>27.03.2011</version> 
			<message>Всего (заказов/штук): 28/130|Из них получено и выдано (заказов/штук): 26/125|Дата последнего заказа: 04.03.2008|Дата последнего получения: 13.03.2008|Средний срок поставки(дн): 8|Вероятность доставки: 93%|</message> 
			<srok>12</srok> 
			<region>ОАЭ</region> 
			<amount /> 
		</part>
		...
		<part id="445008206">
			<from partId="445008206">main</from> 
			<code weightKg="0.300" volWeightKg="0.300">CLT4</code> 
			<price curr="USD" plPrice="377.65" plCurr="RUR">13.02</price> 
			<descr>Стойка стабилизатора</descr> 
			<supplier k="0.830" sId="3211" make="CTR" supplDays100="3" supplDays30="2" supplDate30="2011-04-07" rgb="" Delivery="msc" RusName="false" info="" successProc="71.894">RUMSUP3211</supplier> 
			<supplierInfo /> 
			<probability>-</probability> 
			<version>28.03.2011</version> 
			<message /> 
			<srok>3</srok> 
			<region>Москва</region> 
			<amount>6</amount> 
		</part>
	</main>
	<replaces>
		<r>CLT4</r> 
		<r>1T1816</r> 
		<r>5981002_</r> 
		<r>CLT9</r> 
		<r>CLT2</r> 
		<r>4883020010</r> 
		<r>4883032010</r> 
		<r>4882033010</r> 
		<r>J62005JC</r> 
	</replaces>
	<weightKg byCodeKg="0.3">0.312</weightKg> 
	<searchRequest execMillisec="3117.1783">
		<code>CLT4</code> 
	</searchRequest>
</searchResult>

Список состояний для найденных позиций:

Новый заказ — начальное состояние строки заказа до отправки в работу (код: 0)
Заказано — заказа отправлен поставщику (код: 1)
Куплено — заказ подтвержден поставщиком (код: 2)
Обработано складом — заказ получен нашим складом (код: 3)
Готово к выдаче — заказ готов к выдаче клиенту (код: 4)
Выдано — заказ выдан клиенту, финальное (код: 5)
Нет в наличии — заказ снят поставщиком, финальное (код: 6)
Снято — заказ снят по иным причинам, финальное (например, превышение цены или по запросу клиента) (код: 7)
СКЛАД — позиция есть на складе ALL4CAR (код: 8)
request — запрос (код: 9)
request sent — запрос отправлен поставщику (код: 10)
есть (request) — ответ поставщика на запрос: есть в наличии, финальное (код: 11)
нет (request) — ответ поставщика на запрос: нет в наличии, финальное (код: 12)
Не найдено — позиция утрачена, финальное (код: 13)
Предзаказ — аналогично Новый заказ, но позиция не отправляется в работу автоматически (код: 14)
Резерв — позиция в резерве (код: 15)
Возврат Кл. — возврат клиентом (код: 16)
Возврат Пост. — возврат поставщику (код: 17)
Возврат — возвращено клиентом (код: 18)
Упаковано — заказ укомплектован и ждет выдачу (код: 19)
Брак — товар уценен (код: 20)
Запрос на Снятие — запрос на снятие клиентом (код: 21)

SearchOrdersByState(sAuthCode, sStates, dtFrom, dtTo, iPageNo)

возвращает список клиентских заказов для перечисленных "клиентских" номеров

параметры:

sAuthCode — ваш код доступа к сервисам ALL4CAR
sStates — список запрашиваемых состояний (название состояния или код, через ',': 0,1,2,снято,нет в наличии,5)
dtFrom — нижняя граница периода поиска (yyyy-mm-dd). Внимание, учитываются не даты заказов а даты состояний!
dtTo — верхняя граница периода поиска (yyyy-mm-dd). Внимание, учитываются не даты заказов а даты состояний!
iPageNo — номер запрашиваемой страницы результатов (начиная с 1)

результат (xml):

При большом количестве найденных строк — они выдаются постранично, размер страницы: 200 строк, нумерация страниц - с 1.
Общее количество строк и сумма всех найденных заказов при этом выдаются в корневом теге.

Тег ordersResult — результаты поиска в соотв. с фильтром:

@pageSize — размер страницы поиска

@pageNo — номер страницы

@totalSum — сумма по позициям

@totalQty — общее количество позиций

@records — общее количество найденных записей

Тег order — информация о позиции заказа

@rowNo — номер найденной позиции

@posId — id позиции в ALL4CAR

@id — id заказа в ALL4CAR

dt — дата/время заказа

code — номер запчасти

code/@only — флаг "только этот номер"

code/@replace — заменный номер, если была замена

make — производитель

qty — количество

qty/@only — флаг "только это количество"

currency — валюта отображения цены

price — цена

delivery — тип поставки

delivery/@info — доп. инфо к типу поставки

status — текущее состояние позиции

status/@dt — дата/время выставленния текущего состояния

    <ordersResult xmlns="" pageSize="1000" pageNo="2" totalSum="3379930.8302" totalQty="2064" records="1078">
        <order rowNo="1001" posId="3314161" id="757581">
            <dt>2013-05-03T16:43:00</dt>
            <code only="false" replace="">13717801547</code>
            <make>BMW</make>
            <qty only="false">1</qty>
            <currency>USD</currency>
            <price>94.00</price>
            <delivery info="">auto</delivery>
            <status dt="2013-05-31T14:52:00">Выдано</status>
        </order>
        ...
        <order rowNo="1078" posId="1334625" id="306782">
            <dt>2010-05-04T15:24:00</dt>
            <code only="false" replace="">H15025JC</code>
            <make>JC (JAPAN CARS)</make>
            <qty only="false">1</qty>
            <currency>USD</currency>
            <price>44.99</price>
            <delivery info="">msc</delivery>
            <status dt="2010-05-04T15:28:00">Снято</status>
        </order>
        <procTime ms="450">00:00.450</procTime>
    </ordersResult>

SearchOrdersByRef(sAuthCode, sClientRef, dtFrom, dtTo, iPageNo)

возвращает список клиентских заказов для перечисленных "клиентских" номеров
xml - аналогичен результатам работы метода SearchOrdersByState

параметры:

sAuthCode — ваш код доступа к сервисам ALL4CAR
sClientRef — пользовательский код заказа (через ';': 111;222;333)
dtFrom — нижняя граница периода поиска (yyyy-mm-dd). Внимание, учитываются не даты заказов а даты состояний!
dtTo — верхняя граница периода поиска (yyyy-mm-dd). Внимание, учитываются не даты заказов а даты состояний!
iPageNo — номер запрашиваемой страницы результатов (начиная с 1)