Обзор файла обмена в формате XML таблицы SalOuts

Обратите внимание, данный файл используется для обмена по схеме DMS lite.

 

 

Таблица SalOuts.xml

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>

 


Перейти к странице описания проекта