API для покупателей
Для покупателей
Адрес WEB-service - http://ws1.avdmotors.ru/AvdUserService.svc?wsdl
Для доступа к веб-сервису необходимо отправить запрос на добавление IP-адресов, через личный кабинет.
Методы веб-сервиса:
1. Получение каталогов (GetCatalogsList)
Метод возвращает возможные каталоги по введённому номеру
Входные параметры
- login - Логин
- password - Пароль
- number - Номер
Возвращаемые значения:
- CatalogName - Каталог
2. Получение данных по оригиналу (GetOriginalPrice)
Метод возвращает предложения и информацию по поставщикам для оригинального искомого номера если по этому номеру несколько разных каталогов, то все предложения по этим каталогам. Если указать catalog, то предложения и информацию по поставщикам для оригинального искомого номера и искомого каталога. Если указать поставщика, то предложения и информацию по поставщикам для оригинального искомого номера искомого каталога и искомому поставщику.
Входные параметры:
- login - Логин
- password - Пароль
- number - Номер
- catalog - Каталог не обязательный
- supplier - Поставщик AVDmotors не обязательный
Возвращаемые значения
- CatalogName - Каталог
- DatePrice - Дата обновления прайс листа
- DealerStore - Склад дилера
- Hash - Hash для метода InsertToBasket вставки в корзину
- IsOriginal - Упразднён
- ItemName - Название детали
- ItemNumber - Номер детали
- Multiply - Кратность
- Price - Цена
- PriceAverage - Статистическое время доставки до склада AVDmotors
- PriceStatistic - Процент выполнения заказов поставщиком
- Quantity - Количество деталей на складе поставщика AVDmotors
- SupplierCastrol - Официальный дилер Castrol
- SupplierInfo - Информация о поставщике
- SupplierName - Название поставщика в AVDmotors
- SupplierOfficial - Официальный дилер
- SupplierPeriod - Время поставки до склада AVDmotors
- SupplierPrepay - Предоплата по поставщику
- SupplierRecommended - Рекомендуемый AVDmotors поставщик
- SupplierRegion - Регион поставщика
- SupplierRestrictions - Ограничения по поставщику AVDmotors
- SupplierReturn - Возможность возврата
- SupplierReturn_description - Описание условий возврата
- SupplierSendGraf1 - Расписание отправки заказов поставщику AVDmotors, если на этот день расписание пустое значит отправка будет на следующий в расписании не пустой день
- SupplierSendGraf2 - Расписание отправки заказов поставщику AVDmotors
- SupplierSendGraf3 - Расписание отправки заказов поставщику AVDmotors
- SupplierSendGraf4 - Расписание отправки заказов поставщику AVDmotors
- SupplierSendGraf5 - Расписание отправки заказов поставщику AVDmotors
- SupplierSendGraf6 - Расписание отправки заказов поставщику AVDmotors
- SupplierSendGraf7 - Расписание отправки заказов поставщику AVDmotors
- SupplierSpecification - Спецификация поставщика
- SupplierStock - Вид склада 1 склады AVDmotors все остальные значения склады дилеров AVDmotors
3.Получение кроссов с минимальной ценой (GetFastCrossesPrice)
Метод возвращает предложения и информацию по поставщикам со всеми возможными заменами и поставщикам с минимальной ценой для связки номер детали каталог . Для получения всех предложение по номерам из замен использовать метод GetOriginalPrice указав номер детали и каталог.
- Входные параметры:
- login - Логин
- password - Пароль
- number - Номер
- catalog - Каталог обязательный
- supplier - Поставщик AVDmotors не обязательный
- Возвращаемые значения
- CatalogName - Каталог
- DatePrice - Дата обновления прайс листа
- DealerStore - Склад дилера
- Hash Hash - для метода
- InsertToBasket вставки в корзину
- IsOriginal - Упразднён
- ItemName - Название детали
- ItemNumber - Номер детали
- Multiply - Кратность
- Price - Цена
- PriceAverage - Статистическое время доставки до склада AVDmotors
- PriceStatistic - Процент выполнения заказов поставщиком
- Quantity Количество деталей на складе поставщика AVDmotors
- SupplierCastrol - Официальный дилер Castrol
- SupplierFake - Недобросовестный поставщик (Аналог красной звезды)
- SupplierInfo - Информация о поставщике
- SupplierName - Название поставщика в AVDmotors
- SupplierOfficial - Официальный дилер
- SupplierPeriod - Время поставки до склада AVDmotors
- SupplierPrepay - Предоплата по поставщику
- SupplierRecommended - Рекомендуемый AVDmotors поставщик (Аналог жёлтой звезды)
- SupplierRegion - Регион поставщика
- SupplierRestrictions - Ограничения по поставщику AVDmotors
- SupplierReturn - Возможность возврата
- SupplierReturn_description - Описание условий возврата
- SupplierSendGraf1 - Расписание отправки заказов поставщику AVDmotors если на этот день расписание пустое значит отправка будет на следующий в расписании не пустой день (пн.)
- SupplierSendGraf2 - Расписание отправки заказов поставщику AVDmotors (вт.)
- SupplierSendGraf3 - Расписание отправки заказов поставщику AVDmotors (ср.)
- SupplierSendGraf4 - Расписание отправки заказов поставщику AVDmotors (чт.)
- SupplierSendGraf5 - Расписание отправки заказов поставщику AVDmotors (пт.)
- SupplierSendGraf6 - Расписание отправки заказов поставщику AVDmotors (сб.)
- SupplierSendGraf7 - Расписание отправки заказов поставщику AVDmotors (вс.)
- SupplierSpecification - Спецификация поставщика
- SupplierStock - Вид склада 1 склады AVDmotors все остальные значения склады дилеров AVDmotors
- Supplier_star_g - Зелёная звезда
- Supplier_star_r - Красная звезда
- Supplier_star_y - Жёлтая звезда
4.Положить в корзину (InsertToBasket)
InsertToBasket(string login, string password, string hash, int quantity, string comment, bool OnlyThis );
Входящие параметры:
login - Ваш логин на сайте (string).
password - Ваш пароль на сайте (string).
hash - Строка из результатов поиска идентифицирующая деталь среди наших предложений (string).
quantity - Количество деталей которое необходимо положить в корзину (int).
comment - Комментарий к детали (string).
OnlyThis - Параметр "Без замен" (bool).
Возвращаемые параметры:
Идентификатор добавленной записи. Если запись не была добавлена в корзину будет возвращен один из следующих кодов ошибок.
Список ошибок при добавлении записи:
0 : ошибка выполнения команды INSERT INTO fw_basket
1 : ошибка в верификации ID пользователя
2 : не зарегистрирован IP адрес для клиента
3 : ошибка верификации пользователя
4 : ошибка в HASH строке
5 : ошибка подключения к базе данных
6 : ошибка кратности
7 : ошибка количество деталей меньше чем у поставщика
5.Получение корзины (GetBasketItem)
GetBasketItem(string login, string password);
Входящие параметры:
login - Ваш логин на сайте (string).
password - Ваш пароль на сайте (string).
Возвращаемые параметры:
- BasketItem - объект содержащий информацию о содержимом корзины.
6.Редактирование детали в корзине (EditItemInBasket)
EditItemInBasket(string login, string password, long idBasketItem, int quantity, string comment, bool OnlyThis);
Входящие параметры:
login - Ваш логин на сайте (string).
password - Ваш пароль на сайте (string).
idBasketItem - Идентификатор детали в корзине (long).
quantity - Количество которое необходимо установить для данной детали в корзине (int).
comment - Комментарий который необходимо установить для данной детали в корзине (string).
OnlyThis - Параметр "Без замен" (bool).
Возвращаемые параметры:
- Возвращается количество измененных записей. Если ни одна запись не была обновлена возвращается "0".
7.Удаление детали из корзины (DeleteItemInBasket)
DeleteItemInBasket(string login, string password, long idBasketItem);
Входящие параметры:
login - Ваш логин на сайте (string).
password - Ваш пароль на сайте (string).
idBasketItem - Идентификатор детали в корзине (long).
Возвращаемые параметры:
- Возвращается количество удаленных записей. Если ни одна запись не была удалена возвращается "0".
8.Создание заказа (CreateOrder)
CreateOrder(string login, string password, string comment);
Входящие параметры:
login - Ваш логин на сайте (string).
password - Ваш пароль на сайте (string).
comment - Комментарий к заказу (string).
Возвращаемые параметры:
- Возвращает идентификатор созданного заказа. В случае если заказ не был создан будет возвращен "0".
9.CreateOrderSByIdBasket(string login, string password, string comment, basketIds arr[int]);
Входящие параметры:
login - Ваш логин на сайте (string).
password - Ваш пароль на сайте (string).
comment - Комментарий к заказу (string).
basketIds arr[int]
Возвращаемые параметры:
- Возвращает идентификатор созданного заказа. В случае если заказ не был создан будет возвращен "0".
10.Получение списка заказов (GetOrders)
GetOrders(string login, string password, string dateBegin, string dateEnd, int status, string number);
Входящие параметры:
login - Ваш логин на сайте (string).
password - Ваш пароль на сайте (string).
dateBegin - Начальная дата периода (string в формате YYYY-MM-DD, можно передавать данный параметр пустым. В этом случае начало периода будет установлено автоматически на максимально ранний срок.)
dateEnd - Конечная дата периода (string в формате YYYY-MM-DD, можно передавать данный параметр пустым. В этом случае начало периода будет установлено автоматически на время создания запроса.)
status - Параметр для поиска по статусу (int).
Допустимые значения:
( 0 ) Все
( 1 ) В работе (Включает в себя статусы: "В работе", "На складе в Москве", "Заказано", "Отгрузка", "Контейнер", "Закуплено", "Отгружено", "Упаковано", "Поступило", "Отправлено дилеру", "Комплектуется отправка дилеру", "На складе дилера", "Готов к выдаче")
( 3 ) Закуплено
( 4 ) Отгрузили
( 5 ) Поступило, На складе в Москве
( 6 ) Готов к выдаче
( 7 ) Нет в наличии, Отказ
( 8 ) Товар выдан
Number - Параметр для поиска по номеру или части номера (string).
OrderComment - Параметр для поиска по комментарию к заказу или части комментария (string).
OrderItemComment - Параметр для поиска по комментарию кзапчасти в заказе или его части (string).
Archive - Пустое значение все заказы 0 актуальные заказы 1 заказы в архиве
Возвращаемые значения:
Archive Находиться заказ в архиве или нет
CatalogName Каталог
Comment Коментарий
DealerPrice Цена
Id Id записи
ItemName Название детали
ItemNumber Номер детали
OrderDate Дата заказа
OrderId Id заказа
OrderInfo Коментарий к заказу
OrderNumber Номер заказа
Period Срок
Price Цена
Quantity Количество
QuantityBuyin Количество закуплено
QuantityCome Количество пришло на склад в Москве
QuantityDeny Количество отказ
QuantityDone Количество выполненое
SchetNumber
Send Отправлено
Status Статус коментарий
StatusDate Дата Статуса
Status_id Id Статуса
SupplierName Название поставщика
User Код клиента
Значения Status_id отвечает за правильность статусов:
( 1 ) В обработке
( 2 ) В работе
( 3 ) Заказано
( 4 ) Закуплено
( 5 ) На складе в Москве
( 6 ) Готов к выдаче
( 7 ) Выдан
( 8 ) Отправленно дилеру
( 9 ) В резерве
( 10 ) На складе дилера
( 11 ) Отказ
( 12 ) Заказ не принят
( 13 ) Возврат получен
( 14 ) Возврат проведен
( 15 ) Возврат просрочен
11.Получение карточки клиента (GetBalance)
GetBalance(string login, string password);
Входящие параметры:
login - Ваш логин на сайте (string).
password - Ваш пароль на сайте (string).
Возвращаемые параметры:
- BalanceItem - Объект с данными из карточки клиента.
12.Отправка заказов в архив (SendOrdersArchive) SendOrdersArchive(string login, string password, arr:int[])
Входящие параметры:
login - Ваш логин на сайте (string).
password - Ваш пароль на сайте (string).
id arr[int].
Возвращаемые параметры:
- SendOrdersArchiveResult