SALOUTS – это общая информация о документах фактических продаж.
Для обмена данными об объемах продаж в учетной системе Дистрибьютора должен вестись учет реализации товара Торговым точкам.
Для этих целей можно использовать движение по регистрам накопления ОСТАТКИ или ОБОРОТЫ и по их соответствующим записям – документам, таким как:
o Реализация товаров и услуг
o Расходная накладная
o Возвратная накладная
В системе SalesWorks существует возможность перезаписи существующих документов после их модификации в учетной системе, но в пределах параметра «открытого периода», который устанавливается в головном управляющем офисе компании Заказчика.
Обязательно использование поля Doc_Type для идентификации типа движения продукции в виде сквозной нумерации.
Тип документа |
Описание |
Значение |
Продажа в ТТ - «2» |
фактическая отгрузка продукции от ДС к ТТ |
Положительное (+) |
Возврат из ТТ - «3» |
поступление продукции от ТТ на склад ДС |
Отрицательное (-). При этом обязательно указывается причина возврата одна из (поле «LOT_ID»): · Брак · Документы · Закрытая ТТ · Логистика/транспорт · Недогруз · Несоответствие заказа · Нет денег · Низкий срок годности · Ошибка заказа · Ошибка цен · Прочее |
Корректировка отгрузки -«4» |
Документ, который корректирует существующий документ Продажи в ТТ |
Положительное (+) – в случае, если отгрузка корректируется в сторону увеличения объема отгрузки (соответственно, уменьшения количества продукции на остатках) Отрицательное (-) – в случае, если отгрузка корректируется в сторону уменьшения объема отгрузки (соответственно, увеличения количества продукции на остатках) |
Списание - «5» |
снятие с остатков продукции на складе. |
Положительное (+) |
Инвентаризация – «8» |
Документ, с помощью которого приводятся в соответствие остатки в системе и фактические остатки на складе. |
Положительное (+) – в случае, если уменьшаются остатки на складе Отрицательное (-) – в случае, если увеличиваются остатки на складе |
Перемещение между складами – «6» |
отгрузка из одного склада дистрибьютора на другой склад. |
Положительное (+) – для склада, с которого отгружен товар Отрицательное (-) – для склада, на который получен товар |
Дегустация – «11» |
отгрузка продукции от ДС в ТТ с целью проведения оценки вкусовых качеств продукта конечными потребителями в ТТ |
Положительное (+) |
Ключ |
Атрибут |
Тип данных XML |
Тип данных SQL |
Описание |
Поле обязательное |
<SalOut> тег содержит информацию о конкретном документе фактических продаж продукции из учетной системы. |
|||||
PK |
INVOICE_NO |
string |
VARCHAR(58) |
идентификатор инвойса. Необходимо добавить признак года. Пример накл1234_2018 |
Да |
PK, FK |
OL_CODE |
string |
NVARCHAR(25) |
внешний код торговой точки |
Нет |
PK, FK |
MERCH_ID |
int |
INT |
идентификатор торгового представителя. Заполнять значением «0» |
Да |
|
MERCH_CODE |
string |
VARCHAR(50) |
Внешний код торгового представителя |
Нет
|
PK |
DATE |
dateTime |
DATE |
дата заказа |
Да |
PK, FK |
ORDER_NO |
string |
VARCHAR(100) |
идентификатор заказа из SWE, 0 – если отсутствует. |
Да |
|
DATETO |
dateTime |
DATE |
дата отгрузки товара |
Да |
|
PARAM1 |
int |
INT |
количество ТТ по типам Заполнять значением «1» |
Да |
|
PRINTORDER |
boolean |
BOOL |
признак печати чека на ЭККА Заполнять значением «0» |
Да |
|
PRINTCHECK |
boolean |
BOOL |
признак печати бланков документов (товарная накладная, налоговая накладная) Заполнять значением «0» |
Да |
|
PRNCHKONLY |
boolean |
BOOL |
оплата только через ЭККА Заполнять значением «0» |
Да |
FK |
DOC_TYPE |
unsignedByte |
TINYINT |
идентификатор типа движения документов |
Да |
FK |
WAREH_CODE |
string |
VARCHAR(20) |
внешний код склада. Обязательно к заполнению. |
Да |
|
VATCALCMOD |
int |
INT |
тип начисления НДС Режим расчета цен (с НДС / без НДС)
0 – цены без НДС 1 – цены с НДС 2 – цены с НДС = 0 |
Да |
|
STATUS |
unsignedByte |
TINYINT |
Статус документа (2-"получено,9-"удален") |
Да |
|
DTLM |
string |
VARCHAR(14), дата в формате yyyymmdd hh:mm |
дата последней модификации записи в БД SWE |
Да |
<SalOutLocalDetail> тег содержит информацию о продукции в документе фактических продаж продукции из учетной системы (локальная кодировка продукции). |
|||||
PK, FK |
LOCALCODE |
string |
VARCHAR(20) |
локальный код продукции |
Да |
PK |
LOT_ID |
string |
VARCHAR(20) |
Причина возврата • Брак • Документы • Закрытая ТТ • Логистика/транспорт • Недогруз • Несоответствие заказа • Нет денег • Низкий срок годности • Ошибка заказа • Ошибка цен • Прочее Поле обязательно для заполнения при возврате |
Да |
PK |
PRICE |
decimal |
NUMERIC(15,8) |
цена продукции |
Да |
PK, FK |
ORDER_NO |
string |
VARCHAR(20) |
идентификатор заказа |
Да |
|
QTY |
decimal |
NUMERIC(14,3) |
количество продукции |
Да |
|
VAT |
decimal |
NUMERIC(5,2) |
НДС, % |
Да |
|
ACCPRICE |
decimal |
NUMERIC(15,8) |
учетная цена товара |
(необязательное, значение по умолчанию “0”) |
|
STATUS |
unsignedByte |
TINYINT |
Статус (2-активный, 9-неактивный) |
Да |
|
DTLM |
string |
VARCHAR(14), дата в формате yyyymmdd hh:mm |
дата последней модификации записи в БД SWE |
Да |
Пример структуры файла:
<?xml version="1.0" encoding="utf-8"?>
<ROOT>
<SalOuts>
<SalOut INVOICE_NO="INVOICE_NO_01" OL_CODE="OL_CODE" MERCH_ID="1" DATE="2014-08-27T11:06:08.847" ORDER_NO="ORDER_NO" STATUS="2" DATETO="2014-08-27T11:06:08.847" PARAM1="1" DTLM="20140826 11:00" VATCALCMOD="1" PRINTORDER="0" PRINTCHECK="1" PRNCHKONLY="0" DOC_TYPE="7" WAREH_CODE="WAREH_CODE">
<SalOutDetails>
<SalOutDetail CODE="CODE1" LOT_ID="1" PRICE="10.12345678" ORDER_NO="ORDER_NO" QTY="12.123" DTLM="20140826 11:00" STATUS="2" VAT="10.23" ACCPRICE="10.12345678" />
<SalOutDetail CODE="CODE2" LOT_ID="1" PRICE="10.12345678" ORDER_NO="ORDER_NO" QTY="12.123" DTLM="20140826 11:00" STATUS="2" VAT="10.23" ACCPRICE="10.12345678" />
<SalOutDetail CODE="CODE3" LOT_ID="1" PRICE="10.12345678" ORDER_NO="ORDER_NO" QTY="12.123" DTLM="20140826 11:00" STATUS="2" VAT="10.23" ACCPRICE="10.12345678" />
<SalOutDetail CODE="CODE4" LOT_ID="1" PRICE="10.12345678" ORDER_NO="ORDER_NO" QTY="12.123" DTLM="20140826 11:00" STATUS="2" VAT="10.23" ACCPRICE="10.12345678" />
<SalOutDetail CODE="CODE5" LOT_ID="1" PRICE="10.12345678" ORDER_NO="ORDER_NO" QTY="12.123" DTLM="20140826 11:00" STATUS="2" VAT="10.23" ACCPRICE="10.12345678" />
</SalOutDetails>
</SalOut>
</SalOuts>
</ROOT>
<SalOuts> тег содержит информацию о документах фактических продаж продукции из учетной системы.
<SalOut> тег содержит информацию о конкретном документе фактических продаж продукции из учетной системы.
<SalOutLocalDetails>
<SalOutLocalDetail LOCALCODE="LOCALCODE1" LOT_ID="LOT_ID" PRICE="10.12345678" ORDER_NO="ORDER_NO" QTY="12.123" DTLM="20140826 11:00" STATUS="2" VAT="10.23" ACCPRICE="10.12345678" />
<SalOutLocalDetail LOCALCODE="LOCALCODE2" LOT_ID="LOT_ID" PRICE="10.12345678" ORDER_NO="ORDER_NO" QTY="12.123" DTLM="20140826 11:00" STATUS="2" VAT="10.23" ACCPRICE="10.12345678" />
<SalOutLocalDetail LOCALCODE="LOCALCODE3" LOT_ID="LOT_ID" PRICE="10.12345678" ORDER_NO="ORDER_NO" QTY="12.123" DTLM="20140826 11:00" STATUS="2" VAT="10.23" ACCPRICE="10.12345678" />
<SalOutLocalDetail LOCALCODE="LOCALCODE4" LOT_ID="LOT_ID" PRICE="10.12345678" ORDER_NO="ORDER_NO" QTY="12.123" DTLM="20140826 11:00" STATUS="2" VAT="10.23" ACCPRICE="10.12345678" />
</SalOutLocalDetails>