API для Партнеров

Для Вашего удобства мы разработали API (программный интерфейс приложения), чтобы Вы могли настроить бесперебойный автоматический обмен информацией между нашей и вашей системами.

Вы можете получить информацию об артикулах, технических характеристиках, сертификатах, фото- и видеоматериалах и остатках товара.

Авторизация выполняется по ключу доступа (API-KEY), который выдается отдельно каждому пользователю (только юридическому лицу) по запросу.

Оформите запрос через вашего личного менеджера!

 

Описание web-сервисов:

Технология веб-сервиса: SOAP1.2

Кодировка: UTF-8

Пространство имен: http://ws.e-s-t.ru/

 

Подключение:

Web-сервисы доступны по адресу: https://ws.e-s-t.ru:8443/est/ws/est.1cws

Имя пользователя: customer

Пароль: customer!1107

 

Описание сервисов:

Использование полей:

MA – обязательный атрибут (Mandatory Attribute)

NA – необязательный атрибут (Non-Mandatory Attribute)

ME – обязательный элемент (Mandatory Element)

NE – необязательный элемент (Non-Mandatory Element)

* - признак возможной множественности элемента

Типы значений:

STR(N) – строка длиной не более N символов

CHR(N) – строка фиксированной длины N символов

INT – целое число (int)

DEC – число с десятичной частью (decimal)

DATE – дата/время (dateTime)

BOOL – булево (Boolean)

 

getStock

Позволяет получить остатки товаров, доступные для резервирования, цены товаров, минимально-рекомендуемые цены, рекомендуемые розничные цены, минимальное количество товара для заказа.

Имя

Тип

Комментарий

Входящие параметры

Request

getStockRequest

 

Возвращаемое значение

Response

getStockResponse

 
 

getGoods

Позволяет получить характеристики товаров включая упаковки. Возможен запрос только тех товаров, которые были изменены (операции «запись» для товара и его единиц измерения в базе данных) с предыдущего запроса характеристик товаров. Запрос по списку товаров не сбрасывает признак изменения товаров.

Имя

Тип

Комментарий

Входящие параметры

Request

getGoodsRequest

 

Возвращаемое значение

Response

getGoodsResponse

 

 

Типы и состав данных

getStockRequest

Поле

Исп.

Тип значения

Описание

Комментарий

KeyID

MA

STR

Идентификационный код контрагента

 

Goods

NE*

GoodCode

Список товаров, по которым необходимо передать данные

Необязателен. При отсутствии будут переданы все доступные товары. При запросе по списку товаров дата запроса характеристик не запоминается для корректной передачи в будущем данных по измененным товарам.

OnlyChanged

NA

BOOL

Признак запроса товаров, измененных с момента последнего запроса характеристик товаров

Необязателен. Если имеет значение «Истина», то поле Goods игнорируется и будут переданы только измененные с момента предыдущего запроса характеристик товары.

TextFeatures

NA

BOOL

Признак запроса характеристик товаров в тестовом виде (расшифровка кодов ETIM)

Необязателен. Если имеет значение «Истина», то в Good добавляется поле «PRODUCT_FEATURES_TEXT» с текстовыми расшифровками характеристик и значений ETIM на русском языке.

 

getStockResponse

Наследует тип BaseGood

Поле

Исп.

Тип значения

Описание

Комментарий

Stocks

NE*

Stock

Результаты запроса

 

getGoodsRequest

Поле

Исп.

Тип значения

Описание

Комментарий

KeyID

MA

STR

Идентификационный код контрагента

 

Goods

NE*

GoodeCode

Список товаров, по которым необходимо передать данные

Необязателен. При отсутствии будут переданы все доступные товары

getGoodsResponse

Наследует тип BaseGood

Поле

Исп.

Тип значения

Описание

Комментарий

Groups

NE

Groups

Результаты запроса (группы товаров)

 

Goods

NE

Goods

Результаты запроса (товары)

 

BaseGood

Поле

Исп.

Тип значения

Описание

Комментарий

SupplierCode

МА

STR

Код товара ЭСТ

 

BuyerCode

STR

Код товара покупателя

 

Description

МА

STR

Наименование товара

 

Article

NA

STR

Артикул товара

 

ETIM

Поле

Исп.

Тип значения

Описание

Комментарий

REFERENCE_FEATURE_SYSTEM_NAME

ME

STR

Версия базы ETIM

ETIM-7.0

REFERENCE_FEATURE_GROUP_ID

ME

STR

Код класса товара по ETIM

 

FEATURE

NE*

ETIMFeature

Характеристики

 
 

ETIMFeature

Поле

Исп.

Тип значения

Описание

Комментарий

FNAME

ME

STR

Код характеристики товара по ETIM

 

FVALUE

ME*

STR

Значение характеристики товара по ETIM

 

FVALUE_DETAILS

NE

STR

   

ETIMText

Поле

Исп.

Тип значения

Описание

Комментарий

Group

ME

STR

Описание группы товар по ETIM

 

Class

ME

STR

Описание класса товара по ETIM

 

FEATURE

NE*

ETIMFeatureText

Текстовое описание характеристик

 

ETIMFeatureText

Поле

Исп.

Тип значения

Описание

Комментарий

NAME

ME

STR

Характеристика товара по ETIM

 

VALUE

ME

STR

Значение характеристики товара по ETIM

 

Good

Наследует тип BaseGood

Поле

Исп.

Тип значения

Описание

Комментарий

GroupID

MA

STR

Код группы

 

ShortDescription

NE

ShortDescription

Краткое наименование

Краткое наименование как в таможенных документах

Brand

NA

STR

Торговая марка

 

OriginCountry

NA

OriginCountry

Страна происхождения

 

Weight

MA

DEC

Вес брутто (кг)

Вес брутто за базовую единицу, рассчитанный из веса максимальной упаковки

Capacity

MA

DEC

Объем (м3)

Объем за базовую единицу, рассчитанный из объема максимальной упаковки

TNVED

NA

STR

Код ТН ВЭД

 

PackingUnits

ME

PackingUnits

Варианты упаковок товара

 

Images

ME

Images

Ссылки на изображения товара

 

PRODUCT_FEATURES

NE

ETIM

Характеристики по ETIM

 

DescriptionFull

NA

STR

Описание товара

 

PRODUCT_FEATURES_TEXT

NE

ETIMText

Характеристики по ETIM в текстовом виде

 

New

NA

BOOL

Признак нового товара

Принимает значение «Истина» если продажи товара начались не ранее 90 дней от текущей даты

GoodeCode

Поле

Исп.

Тип значения

Описание

Комментарий

SupplierCode

NE

STR

Код товара ЭСТ

 

BuyerCode

NE

STR

Код товара покупателя

 

Goods

Поле

Исп.

Тип значения

Описание

Комментарий

Good

NE*

Good

Единицы измерения товара

 

Group

Поле

Исп.

Тип значения

Описание

Комментарий

ID

MA

STR

Код группы товаров

 

ParentID

MA

STR

Код родительской группы товаров

Если родительской группы нет, то пустая строка

Description

MA

STR

Наименование группы товаров

 

Groups

Поле

Исп.

Тип значения

Описание

Комментарий

Group

NE*

Group

Группы товаров

 

Images

Поле

Исп.

Тип значения

Описание

Комментарий

Thumbnail

NA

STR

Уменьшенное изображение

 

Image

NE*

STR

Ссылки на изображения товара

 

OriginCountry

Поле

Исп.

Тип значения

Описание

Комментарий

OriginCountryName

MA

STR

Наименование страны происхождения

 

OriginCountryCode

MA

STR

Код (числовой) страны происхождения

 
 

PackingUnit

Поле

Исп.

Тип значения

Описание

Комментарий

PackingUnitType

MA

INT

Тип единицы измерения

1 – базовая единица измерения, 2 – прочие единицы измерения

OKEI

NA

STR

Международное наименование единицы измерения

     
   

Краткое

Полное

Международное

бл

Блистер

PK

кг

Килограмм

KGM

кор

Коробка

CT

п

Пакет

BG

пал

Паллет

PAL

уп

Упаковка

NMP

шт

Штука

PCE

ящ

Ящик

CR

       

Description

MA

STR

Краткое наименование

Coefficient

MA

INT

Коэффициент пересчета из базовой единицы измерения

 

Barcode

NA

STR

Штрихкод

Может быть пустая строка если не существует

MinimumIndivisibleUnit

MA

BOOL

Признак минимальной неделимой упаковки

 

Height

MA

DEC

Высота (м)

 

Width

MA

DEC

Ширина (м)

 

Length

MA

DEC

Длина (м)

 

Weight

MA

DEC

Вес (кг)

 

Capacity

MA

DEC

Объем (м3)

 

PackingUnits

Поле

Исп.

Тип значения

Описание

Комментарий

PackingUnit

NE*

PackingUnit

Единицы измерения товара

 

Response

Поле

Исп.

Тип значения

Описание

Комментарий

Status

ME

INT

Статус результата запроса

100 – запрос успешный
101 – неправильный идентификационный код контрагента

 

ShortDescription

Поле

Исп.

Тип значения

Описание

Комментарий

Russian

NA

STR

Краткое наименование в таможенных документах на русском

 

English

NA

STR

Краткое наименование в таможенных документах на английском

 

Stock

Наследует тип BaseGood

Поле

Исп.

Тип значения

Описание

Комментарий

Quantity

NA

INT

Остаток товара в базовых единицах измерения

Передается по согласованию

Price

NA

DEC

Цена товара

Передается по согласованию

PriceMR

NA

DEC

Минимальная рекомендуемая цена товара

Передается по согласованию

PriceRR

NA

DEC

Рекомендуемая розничная цена товара

Передается по согласованию

MinimumQuantity

NA

INT

Минимальное количество для заказа (в базовых единицах измерения)

Передается по согласованию

PricePackingUnitDescription

NA

STR

Наименование единицы измерения товара, для которой опубликованы цены

Является минимальной неделимой единицей измерения товара. Передается при передаче цен

PricePackingUnitCoefficient

NA

INT

Коэффициент единицы измерения товара, для которой опубликованы цены по отношению к базовой

Передается при передаче цен

PricePackingUnitOKEI

NA

STR

Международное наименование единицы измерения товара, для которой опубликованы цены

Передается при передаче цен

Barcode

NA

STR

Штрихкод единицы измерения товара, для которой опубликованы цены

Может быть пустая строка если не существует