company logo
mail Написать нам phone Заказать звонок
Мессенджеры и почта
Описание веб сервисов Trinity-parts
Точка подключения : https://trinity-parts.ru/httpws/hs/
Общая информация:

Отправка и получение данных в формате JSON

Для удобства использования предлагается написанный класс для работы с сервисами на php.
Подробное описание методов и аргументов в стиле PHPDoc
Скачать
Создание экземпляра класса:
require_once ('TrinityPartsWS.php');
$ws = new \TrinityPartsWS('Ваш код доступа');
В случае ошибки обращения к сервису ошибка будет записана в свойство error
print_r($ws->error);
У каждой функции есть необязательный аргумент asArray (всегда последний), который отвечает за формат ответа, в ввиде массива или объекта.

Список брендов

https://trinity-parts.ru/httpws/hs/search/byCode

{
"clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
"searchCode":"OC90",
"online":"allow"
}
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$brands = $ws->searchBrands('OC90');
  • clientCode - Код пользователя
  • searchCode - Артикул
  • online - Использовать данные олнайн поставщика

Пример ответа:

{
  "count": 2,
  "data": [
    {
        "article": "OC90",
        "producer": "MAHLE/KNECHT",
        "ident": "Фильтр масляный"
     },
     {
        "article": "OC90",
        "producer": "AUTOCOMPONENT",
        "ident": "Фильтр масляный"
     }
  ]
}
  • count - количество элементов в ответе
  • data - массив данных
  • article - артикул детали
  • ident - наименование детали
  • producer - бренд/производитель детали
Поиск предложений

https://trinity-parts.ru/httpws/hs/search/byCodeBrand

{
   "clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
   "searchCode": {
       "sm101": "SCT GERMANY"
   },
   "onlyStock": "0",
   "crosses": "allow",
   "online": "allow"
}
Если crosses - allow, то аналоги будут только по складам Trinity-Parts.
Существует посуточный лимит на количество вызовов, счетчик сбрасывается при размещении заказа
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$items = $ws->searchItems('333310', 'SUBARU', 'full', true);
  • clientCode - Код пользователя
  • onlyStock - поиск товара только на своих складах
  • online - Использовать данные онлайн поставщика(allow - да, disallow - нет)
  • crosses - Поиск с аналогами(allow - да, disallow - нет)
  • searchCode - Элемент поиска в формате "Артикул:Бренд" поисковой детали

Для получения полного списка аналогов, в запрос требуется добавить параметр includeStocks со значением "1".
Данные параметр имеет двойное назначение:
1) Если = "1" - будет осуществлен поиск по складам Trinity Parts, если = "0", соответственно без вышеупомянутых складов.
2) В списке предложений добавяться элементы подобные: 

                                                    {
"bid": "",
"bra_id": "",
"caption": "crosses",
"code": "KUM114",
"currency": "",
"dataprice": "",
"deliverydays": "",
"infokey": "",
"minOrderCount": "",
"n_file": "",
"ordered": "",
"outputTime": "",
"prc_fail_total": "",
"prc_ok_total": "",
"price": "326.37",
"producer": "KUJIWA",
"product_code": "",
"quickDelivery": "",
"rest": "13",
"safety_code": "",
"safety_desc": "",
"safety_img": "",
"source": "",
"stock": "",
"store": "",
"supplier_comment": "",
"supplier_id": "",
"Бренд": "",
"Код": "",
"ПредставлениеСтатуса": "",
"ЦветНаСайте": ""
}

Значимые поля для таких элементов:

  • code - артикул
  • producer - бренд
  • price - минимальная цена по артикулу бренду

В случае если необходимо дополнить выдачу по основному запросу, следует отправить подобный запрос: 
{
    "clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
    "searchCode": {
        "KUM114": "KUJIWA"
    },
    "onlyStock": "0",
    "includeStocks": "0",
    "crosses": "disallow",
    "online": "allow"
}
То есть, запрашиваем по артикулу бренду, без кроссов и без поиска на складах Trinity Parts. Полученные результат можно интегрировать в список товаров основного запроса.

Пример ответа:

{
  "count": 1,
  "data": [
    {
        "caption": "SCT SM 101 Масляный фильтр SM101",
        "code": "SM101",
        "currency": "руб.",
        "dataprice": "online",
        "product_code": "00000094095",
        "price": "221.42",
        "producer": "SCT GERMANY",
        "bra_id": "000002263",
        "rest": "1",
        "minOrderCount": "1",
        "deliverydays": "0/1",
        "stock": "Trinity-Parts 31",
        "source": "9",
        "Номенклатура": "SCT SM 101 Масляный фильтр SM101",
        "АртикулПараметров": "",
        "store": "9",
        "quickDelivery": "Yes",
        "safety_code": "0",
        "safety_desc": "",
        "safety_img": "",
        "prc_ok_total": "100",
        "prc_fail_total": "0",
        "supplier_id": "",
        "supplier_comment": "",
        "bid": "",
        "n_file": "",
        "outputTime": "28.08.2024 17:49",
        "ЦветНаСайте": "",
        "Код": "",
        "ПредставлениеСтатуса": ""
    },
    "message": ""
  ]
}
  • caption - Наименование детали
  • code - Артикул детали
  • currency - Валюта цены
  • producer - Бренд/производитель детали
  • stock - Представление склада
  • supplier_id - Код поставщика
  • deliverydays - Расчетное время доставки заказа с момента его отправки поставщику
  • rest - Доступный остаток
  • price - Цена в валюте цены
  • minOrderCount - Кратность упаковки, минимальный заказ
  • quickDelivery - Признак, что поставщик выполняет быструю поставку товара
  • bid - Ключ строки, служебное поле, обязательное для отправки корзины (Для складов Trinity-Parts отправлять пустое)
  • bra_id - Код бренда
  • source - Служебное поле, обязательное для отправки корзины
  • product_code - Служебное поле, обязательное для отправки корзины (Только для складов Trinity-Parts, иначе пустое)
  • supplier_comment - Описание поставщика
  • dataprice - Дата обновления прайс-листа
  • outputTime - Ближайшая дата вывода заказов поставщику
  • safety_code - Поставщик является центральным складом или официальным дилером(Если не является - то приходит значение 0)
  • ordered - Приходит только по складам Bella, кол-во зарезервированных позиций
  • infokey - Информационный ключ, требуется при добавлении товаров в корзину и получения статистики по поставщику(Bella)
  • prc_ok_total - Процент выполненных заказов
  • prc_fail_total - Процент невыполненных заказов
  • ПредставлениеСтатуса - Описание возвратности склада, возможные варианты: 1) Возврат без удержаний 2) Возвратный с удержанием 3) Возврат невозможен.

    Склады Trinity-Parts все возвратные без удержания

message - Используется при превышении лимита запросов.
Пример сообщения: Превышен лимит запросов без размещения. Ваш лимит: 50
Пакетный поиск предложений

https://trinity-parts.ru/httpws/hs/search/byCodeBrandBatch

{
"clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
"onlyStock":"0",
"searchCode": {"PMC":"P1GC016", "Honda":"15400PLMA02"}
}
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$search = array( 'Honda'=>'15400PLMA02', 'PMC'=>'P1GC016', );
$items = $ws->searchItems($search); //Везде
$items = $ws->searchItems($search, '1'); //Только на складе
  • clientCode - Код пользователя
  • onlyStock - поиск товара только на своих складах
  • searchCode - Массив элементов поиска в формате "Бренд:Артикул" поисковых деталей

Пример ответа:

{
  "count": 2,
  "data": [
    {
	"caption": "Прокладка крышки клапанной P1G-C016",
	"code": "P1GC016",
	"Бренд": "",
	"currency": "руб.",
	"producer": "PMC",
	"stock": "Trinity-Parts 77_2",
	"supplier_id": "",
	"deliverydays": "0/1",
	"rest": "198",
	"price": "158.72",
	"minOrderCount": "1",
	"quickDelivery": "Yes",
	"bid": "",
	"bra_id": "000000024",
	"source": "60",
	"product_code": "00000097104",
	"supplier_comment": "",
	"ЦветНаСайте": "",
	"Код": "",
	"ПредставлениеСтатуса": "",
	"safety_code": "0",
	"ordered": "",
	"safety_img": "",
	"safety_desc": "",
	"infokey": "",
	"prc_ok_total": "100",
	"prc_fail_total": "0",
	"dataprice": "online",
	"store": "60",
	"n_file": "",
	"outputTime": "28.08.2024 18:23"
    },
    {
	"caption": "Фильтр масляный",
	"code": "15400PLMA02",
	"Бренд": "HONDA",
	"currency": "руб.",
	"producer": "HONDA",
	"stock": "Bella5657",
	"supplier_id": "УТ0012615",
	"deliverydays": "0/1",
	"rest": "10",
	"price": "586.61",
	"minOrderCount": "1",
	"quickDelivery": "Yes",
	"bid": "УТ001261500000008915415400PLMA0201823/159480107",
	"bra_id": "000000089",
	"source": "1",
	"product_code": "n/a",
	"supplier_comment": "ВОЗВРАТ только по БРАКУ и ПЕРЕСОРТУ! Возврат возможен только после согласования с поставщиком. Срок возврата с момента прихода детали на склад Trinity-parts: скрытый брак, пересорт - 10 дней; явный брак - выявляется на месте, при водителе. Заявки на возврат принимаем через сайт с ОБЯЗАТЕЛЬНЫМ ВЛОЖЕНИЕМ ФОТО (самой детали, упаковки и всех стикеров).",
	"ЦветНаСайте": "#fd7a68",
	"Код": "000000001",
	"ПредставлениеСтатуса": "Возврат невозможен",
	"safety_code": "000000001",
	"ordered": "0",
	"safety_img": "",
	"safety_desc": "",
	"infokey": "F-0016-01",
	"prc_ok_total": "92",
	"prc_fail_total": "8",
	"dataprice": "28.08 14:17",
	"store": "",
	"n_file": "",
	"outputTime": "29.08.2024 09:20"
    }
  ]
}

Значения полей аналогичны сервису Поиск предложений

Список товаров в корзине

https://trinity-parts.ru/httpws/hs/cart/getCartGoods

{
"clientCode": "4A7D1ED414474E4033AC29CCB8653D9B"
}
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$items = $ws->getCart();

Пример ответа:

{
  "count": 1,
  "data": [
    {
      "comment": "Комментарий",
      "createDT": "11/26/2017 3:58:29 PM",
      "stock": "Bella57",
      "quantity": "1",
      "id": "91648004",
      "error_message": "",
      "caption": "Фильтр масляный Nexia/Lanos/Senz/Chance ",
      "code": "W71222",
      "impossible_offer": "",
      "price": "235",
      "deliverydays": "0-1",
      "bid": "УТ0000057000000097W71222120545725432866701911",
      "minOrderCount": "1",
      "producer": "MANN-FILTER",
      "saled_total": "222",
      "saled_price": "222",
      "allowable_percent": "0",
      "error_code": "",
      "positional_total": "235",
      "source": "1",
      "product_code": "n/a"
    }
  ]
}
  • id - ид товара в корзине покупателя
  • error_message - Может иметь значения если были ошибки при размещении корзины
  • impossible_offer - Если значение Истина данная строка размещена не будет
  • saled_total - Сумма по ценам продажи
  • positional_total - Сумма по ценам закупки
Неописаные поля описаны в разделе "Сохранить товары"
Добавить

https://trinity-parts.ru/httpws/hs/cart/saveGoods?v=2

{
"clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
"parts": [
{
"source": "1",
"product_code": "",
"allowable_percent": "5",
"bid": "УТ0002790000000095OP570T1184646550131544687",
"code": "OP570T",
"producer": "FILTRON",
"caption": "Фильтр масляный",
"supplier_id": "УТ0002790",
"stock": "Bella2790",
"price": "73",
"saled_price": 80,
"quantity": 1,
"comment": "",
"deliverydays": "0/2",
"minOrderCount": "1",
"infokey": "U-0358-01"
}
]
}
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$item1 = new stdClass();
$item1->source = '1';
$item1->product_code = '';
$item1->allowable_percent = '5';
$item1->bid = 'УТ0002790000000095OP570T1184646550131544687';
$item1->code = 'OP570T';
$item1->producer = 'FILTRON';
$item1->caption = 'Фильтр масляный';
$item1->supplier_id = 'УТ0002790';
$item1->stock = 'Bella2790';
$item1->price = '73';
$item1->saled_price = '80';
$item1->quantity = '1';
$item1->comment = '';
$item1->deliverydays = '0/2';
$item1->minOrderCount = '1';
$item1->infokey = 'U-0358-01';

$result = $ws->addToCart(array( $item1 )); - вызов без обработки Вашего ID
$result = $ws->addToCart(array( $item1 ), true); - Расширенная версия
  • saled_price - Цена продажи
  • quantity - Количество к заказу
  • comment - Комментарий к заказу
  • allowable_percent - Допустимый процент увеличения цены (Актуально только для Bella)
  • infokey - infokey из поиска по артикулу и бренду
Неописаные поля описаны в разделе "Поиск по артикулу и бренду"
Для корректного сохранения, все поля кроме comment обязательны к заполнению

Пример ответа:

{
  "count": 1,
  "data": {
    "str_1": "Ok"
  }
}
{
   "data":    [
      {"251256": "76882223"},
   ],
   "desc": "OK",
   "count": 1
}
Проверить товары

https://trinity-parts.ru/httpws/hs/cart/checkBasketGoods

{
"clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
"IDs": [
"76882195"
]
}
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$result = $ws->checkCart(array('76882195'));
  • IDs - массив кодов которые необходимо разместить. Если требуется разместить сразу несколько ID запрос должен иметь вид
    {
"clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
"IDs": [
"76882195",
"76882194",
]
}
$result = $ws->checkCart(array('76882195', '76882194'));

Пример ответа:

{
"count": 1,
"data": {
"76882194": {
"Доступность": true,
"Цены": {
"ВЗаказе": 276,
"ВозможноеЗначение": 276
},
"Остатки": {
"ВЗаказе": 2,
"ВозможноеЗначение": 4
},
"НормаУпаковки": {
"ВЗаказе": 1,
"ВозможноеЗначение": 1
}
},
"76882195": {
"Доступность": true,
"Цены": {
"ВЗаказе": 876,
"ВозможноеЗначение": 876
},
"Остатки": {
"ВЗаказе": 4,
"ВозможноеЗначение": 10
},
"НормаУпаковки": {
"ВЗаказе": 2,
"ВозможноеЗначение": 2
}
}
},
"desc": "OK"
}

Цены - результат проверки по цене
Остатки - результат проверки по наличию
НормаУпаковки - результат проверки по минимальному кол-ву для заказа(кратность)

Заказать товар

https://trinity-parts.ru/httpws/hs/cart/confirm

{
"clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
"IDs": [
"91648004"
]
}
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$result = $ws->sendToOrder(array('91648004'));
  • IDs - массив кодов которые необходимо разместить. Если требуется разместить сразу несколько ID запрос должен иметь вид
    {
"clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
"IDs": [
"91648004",
"91648005",
"91648008"
]
}
$result = $ws->sendToOrder(array('91648004', '91648005', '91648008'), false);
Неописаные поля описаны в разделе "Сохранить товары"

Пример ответа:

{
"checkRes": {
"НЕ_ДоступныеПредложения": {},
"ДоступныеПредложения": {
"78573653": "OK"
}
},
"count": 1,
"desc": "OK",
"OrderNumber": "00000040373",
"OrderDate": "2019-01-16"
}
    

{
"checkRes": {
"НЕ_ДоступныеПредложения": {
"78553456": "Предложение более неактуально!"
},
"ДоступныеПредложения": {}
},
"count": 1,
"data": "Нет доступных товаров для обработки",
"desc": "ERROR"
}
    

{
"checkRes": {
"НЕ_ДоступныеПредложения": {
"76882193": "Предложение более неактуально!"
},
"ДоступныеПредложения": {
"76882195": "OK",
"76882194": "OK"
}
},
"count": 3,
"desc": "OK",
"OrderNumber": "00000000018",
"OrderDate": "2019-01-16"
}
Удаление товара

https://trinity-parts.ru/httpws/hs/cart/delGoods

{
"clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
"IDs": [
"91648005"
]
}
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$result = $ws->deleteFromCart(array('91648005'));
Неописаные поля описаны в разделе "Запрос на размещение"

Пример ответа:

{
"count": 1,
"data": {
"_91648005": true
},
"desc": "OK"
}
Сведения о поставщике

https://trinity-parts.ru/httpws/hs/getInfo/getDeliveryInfo

{
  "clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
  "supplier_id": "УТ0000057"
}
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$info = $ws->getSupplierInfo('УТ0000057');

Пример ответа:

{
  "text":
  "Заказы оформленные до 14.30, на следующий рабочий день на складе Trinity-Parts.
  Поступление товара ВТ, СР, ЧТ, ПТ, СБ.
  ВОЗВРАТ только по БРАКУ и ПЕРЕСОРТУ!
  Возврат возможен  в течение 14 дней
  с момента прихода детали на склад Trinity-parts,
  только при подтверждении поставщиком!
  Заявки на возврат принимаем на почту vozvrat@trinity-parts.ru.",
  "delivery": "УТ0000527"
}
Статистика

https://trinity-parts.ru/httpws/hs/getInfo/showStatistics

    //Bella
{
  "clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
  "supplier_id": "УТ0000905",
   "infokey" : "Ф-0947-01"
}
    //Cella
{
  "clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
  "supplier_id": "48749",
  "n_file" : "1"
}
  • clientCode - Ваш код для доступа к апи
  • supplier_id - код/имя поставщика из поиска по артикулу и бренду
  • infokey - infokey из поиска по артикулу и бренду(Актуально только для товаров с source = 1 или более 100)
  • n_file - n_file из поиска по артикулу и бренду(Актуально только для товаров с source = 2)
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
//Bella
$statistics = $ws->getSupplierStatistics('УТ0000905', 'Ф-0947-0');
//Cella
$statistics = $ws->getSupplierStatistics('48749','1');

Пример ответа:

    {
"СтатПоставщика": {
"prc_fail_0": "77",
"prc_fail_1": "6",
"prc_fail_2": "2",
"prc_ok_0": "5",
"prc_fail_3": "7",
"prc_ok_1": "67",
"prc_fail_4": "8",
"prc_ok_2": "24",
"prc_fail_5": "0",
"prc_ok_3": "3",
"prc_fail_6": "0",
"prc_ok_4": "0",
"prc_fail_7": "0",
"prc_ok_5": "0",
"prc_ok_6": "0",
"prc_ok_7": "0",
"PercentRefuse": "15"
},
"РаспОтпЗакПоставщику": [
{
"WeekDay": "1",
"Time": "08:00"
},
{
"WeekDay": "1",
"Time": "13:55"
},
{
"WeekDay": "2",
"Time": "08:00"
},
{
"WeekDay": "2",
"Time": "13:55"
},
{
"WeekDay": "3",
"Time": "08:00"
},
{
"WeekDay": "3",
"Time": "13:55"
},
{
"WeekDay": "4",
"Time": "08:00"
},
{
"WeekDay": "4",
"Time": "13:55"
},
{
"WeekDay": "5",
"Time": "08:00"
},
{
"WeekDay": "5",
"Time": "13:55"
}
],
"ДатаЗагрузкиПрайслиста": "26 Дек 16:03",
"ОписаниеПоставщика": "Используется только для Bella"
}
Документы

https://trinity-parts.ru/httpws/hs/balance/getPayments

{
    "clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
    "filters": {
        "dateFrom": "20240128",
        "dateTo": "20240728"
    },
    "showNumber": 200,
    "showOff": "1"
}
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$documents = $ws->getDocuments('2017-09-01'); //формат даты: год - месяц - число

Пример ответа:

[
  {
    "ИтоговыеДанныеСписка": {
      "TotalNumber": 1036,
      "SummaryIncom": 1004614.09,
      "TotalDebt": 1017697,
      "SummaryExpenditure": 831445.27
    }
  },
  {
    "СписокДокументов": [
      {
        "DocumentName": "Приходный кассовый ордер 00000044425 от 06.05.2017 15:09:05",
        "Comments": "",
        "Expenditure": "25000.00",
        "DocumentType": "ПриходныйКассовыйОрдер",
        "Date": "06.05.2017",
        "DocumentID": "cc18fca1-3254-11e7-8102-00155d0a0b00",
        "Income": ""
      },
      {
        "DocumentName": "Реализация товаров и услуг 00000058129 от 06.05.2017 14:41:10",
        "Comments": "",
        "Expenditure": "",
        "DocumentType": "РеализацияТоваровУслуг",
        "Date": "06.05.2017",
        "DocumentID": "e5d1a124-3250-11e7-8102-00155d0a0b00",
        "Income": "207.58"
      },
      {
        "DocumentName": "Реализация товаров и услуг 00000058013 от 06.05.2017 13:24:21",
        "Comments": "",
        "Expenditure": "",
        "DocumentType": "РеализацияТоваровУслуг",
        "Date": "06.05.2017",
        "DocumentID": "262517d7-3246-11e7-8102-00155d0a0b00",
        "Income": "54504.86"
      },
      {
        "DocumentName": "Возврат товаров от покупателя 00000003677 от 06.05.2017 09:14:26",
        "Comments": "",
        "Expenditure": "",
        "DocumentType": "ВозвратТоваровОтПокупателя",
        "Date": "06.05.2017",
        "DocumentID": "414122f6-3223-11e7-8102-00155d0a0b00",
        "Income": "-1425.30"
      }
    ]
  }
]
Состав документа

https://trinity-parts.ru/httpws/hs/balance/getDocument

{
"clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
"documentType": "РеализацияТоваровУслуг",
"documentId": "bf410f82-b655-11e7-810c-00155d0a0b01"
}

Значения documentType и documentId из сервиса получения документов

Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$document = $ws->getDocument('bf410f82-b655-11e7-810c-00155d0a0b01', 'РеализацияТоваровУслуг')

Пример ответа:

[
  {
    "РеквизитыДокумента": {
      "СуммаДокумента": "253.50",
      "ДатаДок": "22.04.2017 15:13:07",
      "ВидДок": "РеализацияТоваровУслуг",
      "НомерДок": "00000050826"
    },
    "ТоварыДокумента": [
      {
        "Price": "253.50",
        "Qty": 1,
        "Product_Name": "масл фильтр",
        "Sum": "253.50",
        "ID": "74153535",
        "Articul": "HU7197X",
        "BarCode": "7024000668322",
        "Comment": "наличие",
        "Brand": "MANN-FILTER",
        "Delivery": 0,
        "Total": "253.50"
      }
    ]
  }
]
Список заказов

https://trinity-parts.ru/httpws/hs/balance/orderList

{
"clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
"filters": {
"dateFrom": "2017-10-01T00:00:00",
"dateTo": "2017-10-31T00:00:00",
"CodeOfStatus" : "000000001",
"Qty_Returned": "<9"
},
"showNumber": "1000"
}
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$list = $ws->getOrdersList('2017-10-01', '2017-10-31', '000000001', '<9', 1000); //формат даты: год - месяц - число

Пример ответа:

[
  {
    "Price": 3.15,
    "Qty_Returned": 0,
    "Qty_In_Progress": 0,
    "PriceSale": 5,
    "Qty_Packet": 0,
    "Qty": 1,
    "OrdersDate": "23.10.17",
    "Qty_On_Stock": 0,
    "Product_Name": "Клипса обшивки  A115101035  (CHERY)",
    "CreatedBy": null,
    "Product_Id": 91647964,
    "Orders_Comment": "тест",
    "Articul": "A115101035",
    "Order_Id": 275672,
    "Qty_Expected": 0,
    "Qty_Issued": 0,
    "ReturnIcon": 0,
    "Brand": "CHERY",
    "Supplier_Id": "Cella1146/2",
    "Qty_Rejected": 0,
    "Transit": 0
  },
  {
    "Price": 6.36,
    "Qty_Returned": 0,
    "Qty_In_Progress": 2,
    "PriceSale": 10,
    "Qty_Packet": 0,
    "Qty": 2,
    "OrdersDate": "21.10.17",
    "Qty_On_Stock": 0,
    "Product_Name": "КЛИПСА КРЕПЕЖНАЯ",
    "CreatedBy": "",
    "Product_Id": 13402129,
    "Orders_Comment": "ТЕСТОВЫЙ ЗАКАЗ",
    "Articul": "AGA48",
    "Order_Id": 275645,
    "Qty_Expected": 0,
    "Qty_Issued": 0,
    "ReturnIcon": 0,
    "Brand": "AUTO-GUR",
    "Supplier_Id": "Cella268",
    "Qty_Rejected": 0,
    "Transit": 0
  }
]
  • Order_Id - Номер заказа
  • Product_Id - ID товарной позиции
  • Articul - Артикул
  • Brand - Бренд
  • Product_Name - Наименование
  • OrdersDate - Дата заказа
  • Price - Цена
  • PriceSale - Цена продажи(своему клиенту)
  • Supplier_Id - Склад
  • Orders_Comment - Комментарий к заказу
  • Qty - Заказано
  • Qty_In_Progress - В работе
  • Qty_Expected + Transit - Ожидается
  • Qty_On_Stock - На складе
  • Qty_Issued - Отгружено
  • Qty_Rejected - Отказано
  • Qty_Returned - Возвращено
История заказа

https://trinity-parts.ru/httpws/hs/getInfo/orderHistory

{
"clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
"IDs": [
"75843072"
]
}
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$info = $ws->getOrderHistory(array('75843072');

Пример ответа:

[
    {
        "ID": 75843072,
        "data": [
            {
                "Date": "22/01 15:58",
                "dateFull": "22/01/2024",
                "Status": "Сформирован заказ покупателя",
                "Qty": "2",
                "Status_Comment": "Срок 1/2"
            },
            {
                "Date": "23/01 00:17",
                "dateFull": "23/01/2024",
                "Status": "Сформирован заказ поставщику",
                "Qty": "2",
                "Status_Comment": "Срок 1/2"
            },
            {
                "Date": "23/01 10:18",
                "dateFull": "23/01/2024",
                "Status": "Подтверждено поставщиком",
                "Qty": "2",
                "Status_Comment": "на 25.01.24"
            },
            {
                "Date": "24/01 13:21",
                "dateFull": "24/01/2024",
                "Status": "Принят на склад Trinity-Parts",
                "Qty": "1",
                "Status_Comment": "транзит"
            },
            {
                "Date": "24/01 13:21",
                "dateFull": "24/01/2024",
                "Status": "Принят на склад Trinity-Parts",
                "Qty": "1",
                "Status_Comment": "транзит"
            },
            {
                "Date": "25/01 11:39",
                "dateFull": "25/01/2024",
                "Status": "Перемещен в зону отгрузки",
                "Qty": "2",
                "Status_Comment": ""
            },
            {
                "Date": "26/01 10:37",
                "dateFull": "26/01/2024",
                "Status": "Отгружен со склада Trinity-Parts",
                "Qty": "2",
                "Status_Comment": ""
            }
        ]
    }
]
Отмена заказа

https://trinity-parts.ru/httpws/hs/cart/cancelAnOrder

{
"clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
"IDs": [
"75727363"
]
}
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$result = $ws->cancelOrderItem(array('75727363');

Пример ответа:

{
"75727363": "SUCCESS"
}
Расшифровка ответов:
IMPOSSIBLE: Заказ не может быть отменен
IN_PROCESS: Ваш запрос отправлен на обработку
SUCCESS: Отмена заказа успешно выполнена
NOT_SELECT: Не выбран товар
RECALL: Запрос на отмену уже был отправлен
NO_DATA: Нет данных по выбранному товару
Статусы

https://trinity-parts.ru/httpws/hs/siteInfo/getStatusList

{
  "clientCode": "4A7D1ED414474E4033AC29CCB8653D9B"
}
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$statuses = $ws->getOrderStatuses();

Пример ответа:

{
    "count": 6,
    "data": [
        {
            "Code": "000000001",
            "Name": "В работе",
            "Final": false
        },
        {
            "Code": "000000002",
            "Name": "Ожидается",
            "Final": false
        },
        {
            "Code": "000000003",
            "Name": "На складе",
            "Final": false
        },
        {
            "Code": "000000004",
            "Name": "Отгружен",
            "Final": false
        },
        {
            "Code": "000000005",
            "Name": "Отказ",
            "Final": true
        },
        {
            "Code": "000000006",
            "Name": "Возврат",
            "Final": true
        }
    ]
}
  • count - количество элементов в ответе
  • data - массив данных
  • Code - код статуса
  • Name - наименование статуса
  • Final - признак "окончательного" статуса(не может изменится, логическое)
Установить "Просмотрено"

https://trinity-parts.ru/httpws/hs/siteInfo/setWatched

{
  "clientCode": "4A7D1ED414474E4033AC29CCB8653D9B",
  "IDs": [
    "91648005"
  ]
}
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$result = $ws->setWatched(array('91648005'));

Пример ответа:

{
  "count": 1,
  "data": {
    "OK": 91648004
  }
}
Возвраты

https://trinity-parts.ru/httpws/hs/balance/ClaimList

{
"clientCode": 4A7D1ED414474E4033AC29CCB8653D9B",
"dateFrom": "20170127",
"dateTo": "20170808",
"showOff": "1",
"showNumber": "3"
}
Пример использования вызова на php с использованием библиотеки для работы с веб сервисами:
$list = $ws->$ws->getClaimsList('20170101','20170808', 1, 3);

Пример ответа:

{
"count": 3,
"data": [
{
"Claim_Date": "19.08.24",
"Brand": "VAG",
"Reparation_Percent": 0,
"Product_Name": "Манжетное уплотнение",
"Store": "Bella12372",
"possibleReturn": 1,
"Qty_PickUp": 0,
"Product_Id": 103140740,
"Number": "0434681",
"ReturnIsMade": false,
"Articul": "N0138158",
"Qty_Accepted": 1,
"Decision": "Заявка закрыта",
"Price": 58.3,
"Price_Final": 58.3,
"BarCode": "7569000773855",
"Qty_Rejected": 0,
"Qty_Claim": 1,
"Qty_RejectedBySup": 0,
"Qty_ConfirmedBySup": 0,
"Qty_SentToSup": 0,
"Qty_Ready_To_Ship": 0,
"Qty_In_Acceptance": 0,
"Qty_In_Warehouse": 0,
"PrintRefundDocs": 0
},
{
"Claim_Date": "14.08.24",
"Brand": "MILES",
"Reparation_Percent": 0,
"Product_Name": "Упор газовый крышки багажника SKODA OCTAVIA без спойлера 6/04- CB00011",
"Store": "Bella376",
"possibleReturn": 1,
"Qty_PickUp": 0,
"Product_Id": 102987182,
"Number": "0432866",
"ReturnIsMade": false,
"Articul": "CB00011",
"Qty_Accepted": 1,
"Decision": "Заявка закрыта",
"Price": 558.94,
"Price_Final": 558.94,
"BarCode": "7204000559275",
"Qty_Rejected": 0,
"Qty_Claim": 1,
"Qty_RejectedBySup": 0,
"Qty_ConfirmedBySup": 0,
"Qty_SentToSup": 0,
"Qty_Ready_To_Ship": 0,
"Qty_In_Acceptance": 0,
"Qty_In_Warehouse": 0,
"PrintRefundDocs": 0
},
{
"Claim_Date": "14.08.24",
"Brand": "NGK",
"Reparation_Percent": 0,
"Product_Name": "Свеча зажигания",
"Store": "Bella4749",
"possibleReturn": 1,
"Qty_PickUp": 0,
"Product_Id": 102998709,
"Number": "0432865",
"ReturnIsMade": false,
"Articul": "2397",
"Qty_Accepted": 1,
"Decision": "Заявка закрыта",
"Price": 418.75,
"Price_Final": 418.75,
"BarCode": "7204000571437",
"Qty_Rejected": 0,
"Qty_Claim": 1,
"Qty_RejectedBySup": 0,
"Qty_ConfirmedBySup": 0,
"Qty_SentToSup": 0,
"Qty_Ready_To_Ship": 0,
"Qty_In_Acceptance": 0,
"Qty_In_Warehouse": 0,
"PrintRefundDocs": 0
}
]
}