Page tree
Skip to end of metadata
Go to start of metadata

MySQL база данных шлюза предназначена для обмена данными между торговой системой B2B и внешними системами (ERP, CMS и другими приложениями-коннекторами).

У запроса mysql есть ограничения. Максимальный размер пакета принимаемых данных сервером mysql - 64МБ

  1. Список таблиц
  2. Структура БД
  3. Описание таблиц
  4. Часто задаваемые вопросы
  5. Ссылки

Список таблиц

Нужны для старта прохождения заказов

Название таблицыОписание

Обязательность заполнения

ИтерацияНа чьей стороне
merchantПродавцы (может быть несколько)Обязательно!Передать нам в виде списка
regionРегионыОбязательно!Передать нам в виде списка
catalog_sectionДерево разделов каталога (Adjacency List)Обязательно!Передаются из 1С в ШТ
brandБрендыОбязательно!Передаются из 1С в ШТ
productТоварыОбязательно!Передаются из 1С в ШТ
price_typeТипы цен (названия) с указанием с НДС или безОбязательно!Передаются из 1С в ШТ
priceЦены товаровОбязательно!Передаются из 1С в ШТ
storeСкладыОбязательно!Передаются из 1С в ШТ
remainsОстатки на складахОбязательно!Передаются из 1С в ШТ
featureСвойства товара. Показаны в карточке товараЖелательно
Передаются из 1С в ШТ
galleryИзображения товаров для галереиЖелательноПередаются из 1С в ШТ
companyКомпанииОбязательно!Передаются из 1С в ШТ
legal_entityЮридические лица компаний (у каждой компании может быть несколько)Обязательно!Передаются из 1С в ШТ
addressСписок адресов, принадлежащих компании (у каждой компании может быть несколько)Обязательно!Передаются из 1С в ШТ
orderЗаказыОбязательно!Передаются из B2B в ШТ
order_itemТовары в заказахОбязательно!Передаются из B2B в ШТ
order_statusСтатусы заказовЖелательноПередаются из 1С в ШТ


Опционально

Название таблицыОписание
certificateСертификаты для товаров
company_additional_fieldДополнительные поля для компаний
company_manager_relationСвязь менеджера с компанией покупателем
contract_priceИндивидуальные скидки для компаний в процентном отношении к цене
documentДокументы
document_additional_fieldДополнительные поля для документов
document_itemТовары в документах
document_statusСтатусы документов (предустановлены)
document_typeТипы документов (предустановлены)
external_link_typeТипы внешних ссылок для product_external_link
legal_entityЮридические лица компаний. У компании может быть несколько юр. лиц
managerМенеджеры. Связь с компанией через company_manager_relation*
payment_companyГрафик платежей для компаний (документ - срок оплаты)
product_additional_fieldДополнительные поля для товаров. Настраиваются индивидуально для каждого контрагента.
product_contract_priceИндивидуальные скидки для компаний в рублях для конкретного товара
product_customПроизвольные товары
product_external_linkВнешние ссылки для товаров
product_identifiersИдентификаторы для товаров. Настраиваются индивидуально для каждого контрагента.
product_relatedСвязанные товары
regionРегионы
remains_manufacturerОстатки на складах поставщика
residue_packingОстатки в упаковке
delivery_pointАдреса доставки заказа
userПользователи



*В шт manager попадает пользователь, когда ему назначают роль Менеджер, кроме того, у этого пользователя обязательно должен быть номер телефона.

Если пользователю сменили роль с клиента на менеджер, то он попадает в шт manager ( и соответственно, его уже можно привязывать к компании как менеджера через шт company_manager_relation)


Структура БД

Скачать в PDF

Описание таблиц


address - адреса компаний

NameTypeNullDefaultDescription
company_id‭int(11)‬NoNoneID компании => company.id
address‭text‬NoNoneАдрес с индексом
address_hash‭varchar(32)‬NoNoneХеш адреса для быстрого поиска. Можно использовать MD5(company_id + address)

brand - бренды

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
external_id‭varchar(120)‬YesNULLВнешний ID продавца (идентификатор из 1С)
name‭varchar(255)‬NoNoneНазвание бренда
synonyms‭text‬YesNULL

Список синонимов через запятую. Используется только для поиска, на внешней части не отображается. Регистр не имеет значения, обычно используют нижний.

Например: "legrand, legrand, легранд, легрант"

Имеется возможность редактирования из административного интерфейса. При синхронизации, изменения, внесенные из административного интерфейса, заменяются(!) данными из шлюзовых таблиц. 

catalog_section - разделы каталога

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
external_id‭varchar(120)‬YesNULLВнешний ID раздела каталога(идентификатор из 1С)
name‭varchar(255)‬NoNoneНазвание раздела
synonyms‭text‬YesNULL

Список синонимов через запятую. Используется только для поиска, на внешней части не отображается. Регистр не имеет значения, обычно используют нижний.

Например: "рамка, красная, valena, валена"

int(11) Yes  NULLСсылка на родительский раздел catalog_section.id. NULL - для разделов верхнего уровня.
sortint(11)Yes1Порядковый номер сортировки

certificate - сертификаты

NameTypeNullDefaultDescription
idint(11)NoNoneAUTO_INCREMENT
product_idint(11)NoNoneИдентификатор продукта => product.id
namevarchar(255)YesNULLНазвание типа сертификата
urlvarchar(255)NoNoneСсылка на файл сертификата
validity_fromdateYesNULLДата начала действия сертификата
validity_todateYesNULLДата окончания действия сертификата

company - компании

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
external_id‭varchar(60)‬NoNoneВнешний ID компании (контрагента) продавца (идентификатор из 1С)
merchant_idint(11)YesNULLID продавца => merchant.id
is_individual‭tinyint(1)‬No0Признак физического лица
name‭varchar(255)‬NoNone Название компании
alt_name‭varchar(255)‬No
 Альтернативное название компании
description‭text‬YesNULL Описание
price_type_id‭int(11)‬NoNone Тип цен, назначенный для компании => pryce_type.id
bonusint(8)

Yes

0Бонусы.
balance‭decimal(11,2)‬Yes0Баланс
deferral_daysint(6)Yes0Количество дней отсрочки
credit_sum‭decimal(11,2)‬No0Сумма кредитного лимита
receivables‭decimal(11,2)‬No0Дебиторская задолженность
overdue_receivables‭decimal(11,2)‬No0Просроченная дебиторская задолженность
overdue_duration‭int(10)‬No0Срок просрочки дебиторской задолженности
note‭text‬YesNULL Примечание для менеджера (видно в панели управления)

company_additional_field - дополнительные поля для компаний

NameTypeNullDefaultDescription
company_idint(11)NoNoneID компании => company.id
typeenum('string','number','boolean','object','array')NostringТип переменной
namevarchar(255)NoNoneНазвание доп. поля
valuemediumtextYesNoneЗначение (для типов array и object это строка в формате JSON)

company_manager_relation - связь компания-менеджер

NameTypeNullDefaultDescription
company_idint(11)NoNoneID компании => company.id
manager_idint(11)NoNoneID менеджера => manager.id

company_segment_relation - связь компания-сегмент

NameTypeNullDefaultDescription
company_idint(11)NoNoneID компании => company.id
segment_idint(11)NoNoneID сегмента=> segment.id

contract_price - цены по контракту (скидки для компаний)

NameTypeNullDefaultDescription
idint(11)NoNoneAUTO_INCREMENT
company_idint(11)NoNoneID компании => company.id
price_type_idint(11)NoNoneID типа цены => price_type.id
discountdecimal(7,4)NoNoneРазмер скидки в процентах
brand_idint(11)YesNULLID бренда, для которого предоставляется скидка => brand.id
category_idstextYesNULLСписок ID категорий через запятую, для которых предоставляется скидка
price_group_idstextYesNULLСписок ID ценовых групп

Если brand_id, category_ids и price_group_ids оставить NULL, то скидка будет распространяться на ВСЕ товары.

ПО УМОЛЧАНИЮ. Если на один товар задано несколько скидок, то клиент увидит цену с наибольшей скидкой, самую выгодную для него.

Алгоритм ценообразования может быть изменен.

currency - валюты

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
abbreviation‭varchar(60)‬NoNoneаббревиатура валюты. Например RUR, USD
signvarchar(10)NoNoneОтображаемый знак валюты. Например руб. или $

deleted_product - удаленные товары

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
external_id‭varchar(120)‬NoNoneВнешний ID продавца (идентификатор из 1С)
article‭varchar(60)‬NoNoneАртикул (код 1С)
manufacturer_code‭varchar(80)‬YesNULLКод производителя
alt_manufacturer_code‭varchar(80)‬YesNULLАльтернативный код производителя
manufacturer‭varchar(255)‬YesNULLПроизводитель, название
name‭text‬YesNULLНазвание товара (из 1С)
name_of_manufacturer‭text‬YesNULLНазвание от производителя
alt_name_of_manufacturer‭text‬YesNULLАльтернативное название от производителя
unit_name‭varchar(30)‬YesNULLНазвание единицы измерения (шт, м)
multiplicity‭decimal (8,4) int(7)No1Кратность для заказа.
image_url‭varchar(255)‬YesNULLАбсолютная ссылка на изображение товара
country_code_a3‭varchar(255)‬YesNULLТрехбуквенный код страны производителя (RUS - Россия)
brand_id‭int(11)‬YesNULLID бренда => brand.id
catalog_section_id‭int(11)‬YesNULLID раздела каталога => catalog_section.id
processedtinyint(1)No0

Таблица заполняется автоматически при удалении строк из таблицы product.

delivery_period - информация о сроках поставки товаров в регионы

NameTypeNullDefaultDescription
product_id‭int(11)‬NoNoneID товара ожидаемого в поставке product_id = product.id
region_idint(11)NoNoneID региона в который ожидается поставка region_id = region.id
days‭int(8)‬YesNULLКоличество дней - срок поставки
quantity
decimal(11,4)‬YesNULLОжидаемое количество товара в поставке

delivery_point - адреса доставки

NameTypeNullDefaultDescription
idint(11)NoNoneAUTO_INCREMENT
external_idvarchar(120)YesNULLВнешний идентификатор (из 1С)
company_id‭int(11)‬YesNULLID компании company.id
addresstextNoNoneАдрес доставки

Список адресов доставки доступных для компании. Адреса доставки могут создаваться и удаляться(опционально) непосредственно пользователями системы.

delivery_schedule - график доставки

NameTypeNullDefaultDescription
company_idint(11)NoNoneID компании company_id=company.id
delivery_point_idint(11)NoNoneID адреса доставки delivery_point_id=delivery_point.id
montinyint(1)No0Флаг доставки в определенный день недели
tuetinyint(1)No0
wedtinyint(1)No0
thutinyint(1)No0
fritinyint(1)No0
sattinyint(1)No0
suntinyint(1)No0

document - документы

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
external_id‭varchar(60)‬YesNULLВнешний ID документа продавца (идентификатор из 1С)
b2b_id‭int(11)‬YesNULLID документа в B2B, проставляется после синхронизации
type_id‭int(11)‬YesNULLID типа документа => document_type.id
status_id‭int(11)‬YesNULLID статуса документа document_status.id
order_id‭int(11)‬YesNULLID заказа, если документ прикреплен к заказу => order.id
parent_document_id‭int(11)‬YesNULLID родительского документа
number‭varchar(120)‬YesNULLНомер документа
total_amount‭decimal(18,2)‬YesNULLСумма
doc_date‭date‬YesNULLДата документа 
valid_until_date‭date‬YesNULLДата - документ действителен до 
external_linkvarchar(255)YesNULLВнешняя ссылка на готовый документ в формате PDF
status‭int(1)‬No0Статус: 0-новый 1-импортирован 2-ошибка 3-необходимо перезагрузить. Новые документы из 1С должны иметь статус = 0
incoming‭tinyint(1)‬NoNoneФлаг, указывающий, что документ входящий (1)

document_additional_field - дополнительные поля для документов

NameTypeNullDefaultDescription
document_id‭int(11)‬YesNULLID документа => document.id
typeenum('string','number','boolean','object','array')NostringТип переменной
namevarchar(255)NoNoneНазвание доп. поля
valuemediumtextYesNoneЗначение (для типов array и object это строка в формате JSON)

document_item - товары в документе

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
document_id‭int(11)‬YesNULLID документа => document.id. Принадлежность к документу
product_id‭int(11)‬YesNULLID товара => product.id
price‭decimal(11,2)‬YesNULLЦена
price_type_id‭int(11)‬YesNULLID типа цены => price_type.id
quantity‭decimal(11,4)‬YesNULLКоличество
amount‭decimal(11,2)‬YesNULLСумма = price*quantity
unit_name‭varchar(30)‬NoштНазвание единицы измерения
extra_datamediumtextYesNULLДополнительные данные к позиции. Массив "key": "value" в формате json

document_custom_item - товары от покупателя в документе

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
document_id‭int(11)‬YesNULLID документа => document.id. Принадлежность к документу
product_custom_id‭int(11)‬YesNULLID товара => product_custom.id
price‭decimal(11,2)‬YesNULLЦена
quantity‭decimal(11,4)‬YesNULLКоличество
amount‭decimal(11,2)‬YesNULLСумма = price*quantity
unit_name‭varchar(30)‬NoштНазвание единицы измерения
extra_datamediumtextYesNULLДополнительные данные к позиции. Массив "key": "value" в формате json

document_status - предустановленные статусы документов

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
document_type_id‭‭int(11)‬NoNoneПривязка статуса к типу документа => document_type.id
name‭varchar(255)‬NoNoneНазвание статуса

document_type - типы документов

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
name‭varchar(255)‬NoNoneНазвание
name_short‭varchar(255)‬NoNoneНазвание краткое
file_generation‭tinyint(1)‬No11 - формировать файл (pdf, xlsx), 0 - нет
NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
name‭varchar(64)‬NoNoneНазвание статуса
is_video‭tinyint(1)Yes0Флаг для видео ссылки

feature - свойства товаров

NameTypeNullDefaultDescription
product_id‭int(11)‬NoNoneID товара => product.id
name‭varchar(255)‬NoNoneНазвание свойства
value‭varchar(255)‬NoNoneЗначение свойства
unit‭varchar(30)‬YesNULLЕдиница измерения
sort‭int(6)‬No0Сортировка в карточке товара
NameTypeNullDefaultDescription
product_idint(11)NoNoneID товара => product.id
image_urlvarchar(255)NoNoneАбсолютная ссылка на изображение товара
NameTypeNullDefaultDescription
company_id‭int(11)‬NoNoneID компании => company.id
external_id‭varchar(60)‬YesNullВнешний идентификатор (из 1С)
name‭varchar(255)‬NoNoneНазвание юр. лица
short_name‭varchar(255)‬NoNoneКраткое название
inn‭varchar(12)‬NoNone ИНН
kpp‭varchar(9)‬NoNone КПП
visibletinyint(1)NoВидимость юридического лица на front-end 

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

manager - менеджеры

NameTypeNullDefaultDescription
idint(11)NoNoneAUTO_INCREMENT
external_idvarchar(120)YesNULLВнешний идентификатор (из 1С)
phonevarchar(16)NoNoneНомер телефона в формате +79991234567
emailvarchar(120)NoNoneАдрес электронной почты
identityvarchar(255)NoNoneИмя Фамилия менеджера

Хранится информация о менеджерах компании продавца.

Обращаем внимание на необходимость правильного заполнения поля phone, так как номер телефона имеет строковый формат и используется для поиска соответствующего пользователя системы.

merchant - продавцы

NameTypeNullDefaultDescription
idint(11)NoNoneAUTO_INCREMENT
external_idvarchar(60)YesNULLВнешний идентификатор (из 1С)
namevarchar(255)NoNoneНазвание компании продавца
addresstextYesNULLАдрес
phonevarchar(255)YesNULLТелефон
phone_hotlinevarchar(255)YesNULLТелефон горячей линии
inn‭varchar(12)‬YesNULLИНН
kpp‭varchar(9)‬YesNULL КПП
emailvarchar(255)YesNULLАдрес электронной почты
sitevarchar(255)YesNULLАдрес сайта в сети Интернет
bank_namevarchar(255)YesNULLНазвание банка
bank_accountvarchar(255)YesNULLНомер счета
bank_cor_accountvarchar(255)YesNULLНомер кор. счета
bank_bikvarchar(255)YesNULLБИК
directorvarchar(255)YesNULLФИО директора
accountantvarchar(255)YesNULL
consignorvarchar(255)YesNULLРеквизиты грузоотправителя
gave_out_productvarchar(255)YesNULLФИО производящего отгрузку (для документов)
offer_for_legal_entitiestextYesNULLОферта для юридических лиц
offer_for_individualstextYesNULLОферта для физических лиц
is_defaulttinyint(1)YesNULLФлаг: использовать по умолчанию

Для записи информации о компаниях (филиалах) продавцах продукции.

В административном интерфейсе есть возможность создания и редактирования. При синхронизации со шлюзовыми таблицами ведется поиск по полю id.

ВНИМАНИЕ данные в административном интерфейсе заменяются данными из ШТ.

order - заказы

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT (он же B2B ID)
external_id‭varchar(60)‬YesNULLВнешний ID заказа, присваивается после обработки 1С
merchant_id‭int(11)‬YesNULLID продавца order.merchant_id => merchant.id
company_id‭int(11)‬YesNULLID компании order.company_id => company.id
delivery_point_id‭int(11)‬YesNULLID адреса доставки order.delivery_point_id => delivery_point.id
pickup_point_idint(11)YesNULLID пункта самовывоза order.pickup_point_id => pickup_point.id
status‭smallint(6)‬YesNULLСтатус заказа order..status => order_status.id
comment‭text‬YesNULLКомментарий
is_standardtinyint(1)YesNULLФлаг. Выставляется на основе комплексной проверки заказа и заказчика на возможность
автоматической обработки заказа на стороне 1С

order_additional_field - дополнительные поля для заказов

NameTypeNullDefaultDescription
order_id‭int(11)‬YesNULLID заказа => order.id
typeenum('string','number','boolean','object','array')NostringТип переменной
namevarchar(255)NoNoneНазвание доп. поля
valuemediumtextYesNoneЗначение (для типов array и object это строка в формате JSON)

order_meta - дополнительная информация к заказу

NameTypeNullDefaultDescription
order_id‭int(11)‬NoNoneID заказа order.id
user_firstname‭varchar(255)‬YesNULLИмя пользователя
user_middlename‭varchar(255)‬YesNULLОтчество пользователя
user_lastname‭varchar(255)‬‬YesNULLФамилия пользователя
user_phone‭varchar(16)‬YesNULLТелефон пользователя
user_email‭varchar(120)‬YesNULLE-mail пользователя
user_ipvarchar(45)YesNULLIP-адрес пользователя
user_rolevarchar(64)YesNULLРоль пользователя
user_region_name‭varchar(120)‬YesNULLРегион пользователя
store_ids‭varchar(255)‬YesNULL
Идентификаторы складов
delivery_type‭varchar(20)‬YesNULLТип доставки
delivery_addresstextYesNULLАдрес доставки

order_item - товары в заказе

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
order_id‭int(11)‬NoNoneID заказа order.id
article‭varchar(60)‬NoNoneАртикул товара
external_id‭varchar(120)‬YesNULLВнешний ID товара (product.external_id)
price‭decimal(11,2)‬YesNULLЦена
current_price‭decimal(11,2)‬YesNULLТекущая цена на момент обновления
user_price‭decimal(18,2)‬YesNULLЦена назначенная пользователем (для произвольных товаров)
price_type_id‭int(11)‬YesNULLТип цены price_type.id
quantity‭decimal(11,2)‬NoNoneКоличество. Возможно дробное значение.
product_custom_idint(11)YesNULLID произвольного товара

order_status - статусы заказов

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
external_id‭varchar(60)‬YesNULLВнешний ID статуса заказа
name‭varchar(255)‬YesNULLНазвание (ожидание, в работе, завершен, отмена, др.)

payment_company - график платежей компаний

NameTypeNullDefaultDescription
idint(11)NoNoneAUTO_INCREMENT
company_idint(11)NoNoneID компании => company.id
doc_namevarchar(255)YesNULLПроизвольное название документа. Например "Расх. накл. РНк-00840541 (12.09.18)"
sum_doc‭decimal(11,2)YesNULLСумма по документу
sum_debt‭decimal(11,2)YesNULLСумма долга
expired_daysint(11)NoNoneПросрочено дней оплаты. Если значение отрицательное, то срок платежа по документу не истек. Если значение равно нулю, то сегодня последний день оплаты.
document_idint(11)YesNULLID документа => document.id. Привязка к документу

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

pickup_point - адреса самовывоза

NameTypeNullDefaultDescription
idint(11)NoNoneAUTO_INCREMENT
external_idvarchar(120)YesNULLВнешний идентификатор (из 1С)
region_idint(11)NoNoneID региона, к которому привязаны пункты самовывоза
addresstextNoNoneАдрес пункта самовывоза

price - цены

NameTypeNullDefaultDescription
product_id‭int(11)‬NoNoneID товара product_id => product.id
type_id‭int(11)‬NoNoneID типа цены type_id => price_type.id
price‭decimal(11,2)‬NoNoneЦена

price_type - типы цен

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
external_id‭varchar(120)‬YesNULLВнешний ID типа цены продавца (идентификатор из 1С)
currency_idint(11)NoNoneID валюты
name‭text‬NoNoneНазвание
with_vat‭tinyint(1)‬No11 - цена включает НДС, 0 - без НДС
basetinyint(1)No0Признак базового типа цены

product - товары

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
external_id‭varchar(120)‬NoNoneВнешний ID продавца (идентификатор из 1С)
article‭varchar(60)‬NoNoneАртикул (код 1С)
manufacturer_code‭varchar(80)‬YesNULLКод производителя
alt_manufacturer_code‭varchar(80)‬YesNULLАльтернативный код производителя
manufacturer‭varchar(255)‬YesNULLПроизводитель, название
name‭text‬YesNULLНазвание товара (из 1С)
name_of_manufacturer‭text‬YesNULLНазвание от производителя
alt_name_of_manufacturer‭text‬YesNULLАльтернативное название от производителя
unit_name‭varchar(30)‬YesNULLНазвание единицы измерения (шт, м)
multiplicity‭decimal(9,4)‬No1Кратность для заказа.
image_url‭varchar(255)‬YesNULLАбсолютная ссылка на изображение товара
new_image_flagtinyint(1)No0Флаг, показывающий что изменен image_url.
country_code_a3‭varchar(255)‬YesNULLТрехбуквенный код страны производителя (RUS - Россия)
brand_id‭int(11)‬YesNULLБренд (brand.id)
catalog_section_id‭int(11)‬YesNULLРаздел каталога (catalog_section.id)
stock_status‭varchar(1)‬YesNULLСкладской статус товара (D, S, P, другой, принятый в системе продавца)

product_additional_field - дополнительные поля товара

NameTypeNullDefaultDescription
product_id‭int(11)‬NoNoneID товара product_id => product.id
namevarchar(255)NoNoneНазвание дополнительно поля
value‭mediumtextYesNullЗначение дополнительного поля

product_analog - товары аналоги

NameTypeNullDefaultDescription
product_id‭int(11)‬NoNoneID товара product_id => product.id
analog_product_id‭int(11)‬NoNoneID товара аналога analog_product_id => product.id
sort‭smallint(6)‬No0

Порядок сортировки(приоритета)

Большее значение ниже в списке.

product_catalog_section_relation - отношение товаров к разделам каталога

NameTypeNullDefaultDescription
product_id‭int(11)‬NoNoneID товара product_id => product.id
catalog_section_id‭int(11)‬NoNoneID раздела каталога catalog_section_id =>catalog_section.id

product_contract_price - индивидуальные цены компании

NameTypeNullDefaultDescription
product_id‭int(11)‬NoNoneID товара product_id => product.id
segment_id‭int(11)‬YesNull

ID сегмента компании segment_id => segment.id

company_id‭int(11)‬YesNullID компании company_id => company.id
price‭decimal(11,2)‬NoNoneЦена на товар

Если поля company_id и segment_id задать NULL, то цена будет применяться всем компаниям.

product_custom - произвольные товары

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
namemediu‬mtextYesNullНаименование произвольного товара
manufacturer_code‭varchar(80)‬No''

Код производителя

brand_name‭varchar(120)‬No''Наименование бренда
descriptionmediu‬mtextYesNullОписание
unit_namevarchar(30)No''Единица измерения
pricedecimal(18,2)YesNullЦена

product_identifiers - идентификаторы товара

NameTypeNullDefaultDescription
product_id‭int(11)‬NoNoneID товара product_id => product.id
namevarchar(255)NoNoneНазвание идентификатора
value‭textYesNullЗначение идентификатора
NameTypeNullDefaultDescription
product_id‭int(11)‬NoNoneID товара product_id => product.id
related_product_id‭int(11)‬NoNoneID связанного товара related_product_id => product.id
sort‭smallint(6)‬No0

Порядок сортировки(приоритета)

Большее значение ниже в списке.

sourcesmallint(6)No0Источник связи

region - регионы (Заполняется из интерфейса администратора)

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
internal_idint(11)NoNoneИдентификатор региона на внешней части
name‭varchar(255)NoNoneНаименование региона

remains_manufacturer - остатки на складах производителя

NameTypeNullDefaultDescription
IDint(11)NoNoneAUTO_INCREMENT
product_id‭int(11)‬NoNoneID товара product_id =>product.id
storage_namevarchar(255)NoNoneНаименование склада производителя
quantity‭decimal(11,4)‬YesNULLКоличество товара на складе.
relevance_date‭date‬YesNULLДата актуальности
delivery_daysint(11)YesNULLСрок поставки, дней

remains - остатки на складах

NameTypeNullDefaultDescription
product_id‭int(11)‬NoNoneID товара product_id => product.id
store_id‭int(11)‬NoNoneID склада store_id => store.id
total_item_count‭decimal(11,2)‬YesNULLКоличество товара на складе. Используется целочисленное значение
status‭varchar(1)‬YesNULLСкладской статус остатка (не обязателен)

residue_packing - Куски товаров

NameTypeNullDefaultDescription
IDint(11)NoNoneAUTO_INCREMENT
product_id‭int(11)‬NoNoneID товара product_id => product.id
store_id‭int(11)‬NoNoneID склада store_id => store.id
consignmentvarchar(255)YesNULLПартия товара
residuedecimal(11,4)YesNULLРазмер куска
reservedecimal(11,4)No0.0000Размер резерва

segment - сегменты

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
external_idvarchar(64)YesNoneВнешний ID сегмента (идентификатор 1C)
name‭varchar(255)YesNoneНаименование сегмента
segment_group_idint(11)YesNoneИдентификатор группы сегмента segment.segment_group_id = segment_group.id

segment_group - группы сегментов

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
external_idvarchar(64)YesNoneВнешний ID группы сегментов (идентификатор 1C)
name‭varchar(255)YesNoneНаименование группы сегментов

store - склады

NameTypeNullDefaultDescription
id‭int(11)‬NoNoneAUTO_INCREMENT
external_id‭varchar(120)‬YesNULLВнешний ID склада продавца (идентификатор из 1С)
name‭varchar(255)‬NoNoneНазвание склада
address‭varchar(255)‬YesNULLАдрес склада (пока не используется на внешней части)
description‭text‬YesNULLОписание (пока не используется на внешней части)
phone‭varchar(255)‬YesNULLТелефон (пока не используется на внешней части)
schedule‭text‬YesNULLРасписание работы (пока не используется на внешней части)
sort‭int(11)‬No1Сортировка
delivery_daysint(3)YesNULLСрок поставки с основного склада 
lat‭float(10,7)‬YesNULLКоординаты склада (пока не используется на внешней части)
lng‭float(10,7)‬YesNULLКоординаты склада (пока не используется на внешней части)

user - пользователи

NameTypeNullDefaultDescription
idint(11)NoNoneAUTO_INCREMENT
company_idint(11)YesNULLИдентификатор компании
phonevarchar(20)YesNULLТелефон пользователя
emailvarchar(120)YesNULLE-mail пользователя
email_agreed_for_marketingtinyint(1)Yes1Подписка на рассылки
email_agreed_updated_atdatetimeYesNULLДата обновления состояния подписки
firstnamevarchar(255)YesNULLИмя
middlenamevarchar(255)YesNULLОтчество
lastnamevarchar(255)YesNULLФамилия
groupvarchar(64)YesNULLГруппа

Таблица используется для получения информации о зарегистрированных пользователях.


Часто задаваемые вопросы

Почему изменения в шлюзе не видно на внешней части B2B?

Синхронизация данных настраивается индивидуально для каждого продавца в зависимости от потребностей и количества товаров. Например проверка новых документов может происходить каждую минуту, остатки на складах - раз в 10 мин., а синхронизация цен - раз в сутки.

Как удалять товары?

Достаточно удалить соответствующую запись в таблице product. На стороне B2B удаление товара из базы обычно происходит в течение 10 минут.

Удаление товара должно быть только в случае полного удаления номенклатуры из 1С.

Как обновлять данные по товару?

Нужно просто обновить нужные поля в таблице product, использовав для идентификации id или external_id. Можно выполнять запросы типа insert into product ... on duplicate key update ...

Нельзя использовать запросы типа replace into product ... , так как в таком случае будет зафиксировано удаление записи.

Как изменить данные в уже загруженном документе?

Нужно изменить документ в ШТ и проставить ему document.status = 3 - это означает, что в документ нужно внести изменения. Через 1 мин документ изменится.

Как грузить описание товара?

Описание товара это дополнительное поле. Чтобы добавить описание надо создать запись в таблице product_additional_field для соответствующего товара
name = "description", value = "Само описание"

Если документы не выгружаются из ШТ в В2В.

Нужно проверить значение поля document.status. Возможно в поле document.status записано 1, что означает что документ уже обработан. Нужно писать 0. Тогда документ будет обработан и статус изменится на 1.

Как сделать товары с шильдиком "Best price" и специальной ценой

1) Чтобы создать шильдик необходимо в таблицу с доп. полями прогрузить специальный флаг для необходимых товаров. Таблица product_additional_field. Для товаров с пометкой Best price надо создать запись name = "badge_best_price", value = 1. Чтобы быстро убрать пометку можно проставить value = 0

При создании товаров "Best price" свяжитесь с нашими программистами для правок зеленого фильтра (добавление чек-бокса).

2) Если на такие товары нужна специальная цена, то можно воспользоваться таблицей product_contract_price, company_id можно не указывать (null), если нужна цена для всех компаний.

Как прогрузить товары "Сделано в России" ?

Чтобы создать шильдик необходимо в таблицу с доп. полями прогрузить специальный флаг для необходимых товаров. Чтобы добавить товару флаг "Сделано в России" достаточно в таблице product в поле country_code_a3 проставить значение RUS для соответствующих товаров.

Как добавить код РАЭК?

Код РАЭК добавляется в product_identifiers

product_id - ссылка товар (product.id)
name - название, для идентификатора РАЭК это "raec_id". Т.е. для всех кодов РАЭК вы записываете "raec_id"
value = значение, собственно код РАЭК

В шлюзовой таблице document_item чем отличаются поля amount и quantity?

quantity = количество
amount = количество * цена

Свойства для карточки товара.

Таблица features (ID товара, название свойства, значение, ед. изм - не обязательно)
При изменении данных в features желательно обновить дату product.updated_at = NEW() для соответствующего товара. Чтобы все изменения быстро попали в b2b.

Инструкция по добавлению картинок:

  1. Если добавили новый товар. Если он с картинкой выставили флаг new_image_flag = 1. Ожидаем синхронизации на добавление новых товаров. По регламенту (обычно каждый час).
  2. Если товар уже есть в системе, то не зависимо от наличия у него изображения, при изменении ссылки на изображение выставляем флаг равным 1. Ожидаем завершения полной синхронизации товаров, запускаемой по регламенту (обычно раз в сутки)

Как прописать статусы заказа:

Статусы надо прописать в ШТ. id - автоинкремент, external_id - идентификатор в 1с, name - наименование статуса. updated_at - дата обновления записи.

таблица order_status

order.status = order_status.id

когда в 1с измениться статус заказа, он должен обновиться в шт

Как убрать цены на портале?

Чтобы убрать цены на портале надо не удалять их из ШТ, а задавать 0.


При передаче сегментов из 1С для таргетирования:

Работы в связке с нашей стороной. Для дальнейшей работы с ними(актуализации) используйте ШТ segment_group и segment. И необходимо согласовать регламент их синхронизации с основной базой данных.
Далее вам необходимо передать привязку компаний к сегментам в ШТ company_segment_relation. Эти привязки будут обновляться при синхронизации компаний.

Как передавать свои документы через ссылку
Для документов можно передавать ссылку на файл в поле external_link. Эта ссылка должна позволять сразу скачать этот файл без авторизации. Ресурс на котором будут располагаться эти файлы, может быть нашим ftp-сервером или вашим (если наш вы сообщаете об этом заранее и мы его готовим).
В этом случае, вы, когда выгружаете документы в ШТ, закачиваете печатные формы на сервер и указываете в поле external_link ссылку на файл с учетом полученного от нас пути на сервере.
Далее при синхронизации документов мы получаем эти файлы и предоставляем покупателям возможность их скачать.

Подробнее:

  1. В случае использования нашего ftp сервера заказчик загружает туда документы и прописывает в ШТ document в поле external_link полное имя загруженного файла(с учетом созданных вами каталогов) на ftp сервере.
    Заказчику передаем реквизиты доступа к серверу (IP, логин, пароль) предварительно получив от них IP адреса серверов, с которых будет осуществляться загрузка документов. Заказчик загружает документы в корневой или созданные им каталоги.

  2. В случае использования сторонних ресурсов заказчик записывает в выше указанное поле URL файла.






Ссылки

‭varchar(80)‬