====Формат загрузки истории продаж====
===Общие требования===
Сsv файл кодировки UTF-8

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

Разделители разрядов отсутствуют. Верно 6000. 6 000 – неверно.
Строки разделяются между собой переносом строки.

Код товара, артикул, название не должны содержать символа “;”. Необходимо заменять все символы “;” на любой допустимый, например пробел.

Если код товара, артикул или название – пустая строка, то выгружать один пробел.

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

===Структура файла===
В файле есть заголовок, задающий порядок и содержимое столбцов, а также непосредственно информация о продажах и остатках товара 

**Вид заголовка:**

<code>
1.Код товара;2.артикул;3.название товара;4.склад;5.дата;6.кол-во продажи;7.прочий расход;8.кол-во поступления;9.в резерве;10.заказано;11.цена продажи;12.выручка;13.цена закупа;14.себестоимость;15.остаток;16. Упущенный спрос 17.клиент 18.невыполненный заказ 19.прибыль 20.учётная цена 21.товар в пути
</code>

Текст в столбцах заголовка и порядок столбцов в csv файле не фиксирован, может быть любой. Количество столбцов в заголовке должно совпадать с количеством столбцов в данных.

Далее в файле идут строки с информацией о продажах и остатках.

Строка выгружается в следующих случаях:
  - Была продажа
  - Был прочий расход
  - Было поступление
  - Изменился остаток (перемещение, продажа и пр.), кол-во товара в пути (проведение документа, отмена проведения, приход товара и пр.), кол-во товара в заказе (размещение-закрытие заказа), кол-во товара в резерве (снятие резерва, открытие резерва), 

Также выгружаются все строки на день – начало периода выгрузки и все строки на день – конец периода выгрузки вне зависимости от наличия продажи или изменения остатка.

===Формат строки файла===

**< Код товара - уникальный идентификатор>**;< артикул товара>;<название товара>;<название склада или код склада>;**<дата продажи или изменения остатка в формате "гггг-мм-дд">**;**< кол-во единиц продажи суммированное за весь день>**;//< кол-во единиц прочего расхода (перемещения, списания, корректировки и пр.) за весь день>//;//< кол-во единиц поступления за весь день>//;< количество товара в резерве на конец дня >;< количество товара в размещенных заказах поставщику на конец дня>;__< цена продажи>__;<сумма продажи= кол-во единиц продажи*цена продажи>;__<цена закупочная>__;<сумма закупочная=кол-во единиц продажи*цена закупочная>;**<остаток товара на конец дня>**;<упущенный спрос (в случае поклиентской детализации для каждого клиента грузится отдельно)>;<клиент, которому произошла продаж>;<невыполненный заказ>;<прибыль=Кол-во проданного * (Цена реализации - Закупочная цена)>;<учётная цена>;<товар в пути>

**Жирным** выделен минимальный набор необходимых данных при первоначальной загрузке.

__Подчеркнутым__ дополнительно выделен желательный набор данных для работы различных анализов и оптимизации уровня сервиса, а также для проведения предварительного (предпроектного) исследования.

//Курсивом// обозначены поля, которые в настоящий момент не используются в системе. Поля зарезервированы для будущих версий и предназначены для контроля стокового уравнения (корректности выгрузки данных).

===Описание и обязательность полей===
^Поле^Описание^Обязательность^
|Код товара|Уникальный идентификатор товара, обычно код в учетной системе|Обязательно|
|Артикул товара|Дополнительный идентификатор товара (обычно тот, который привычен пользователям|Рекомендуется|
|Название товара|Название товара|Рекомендуется|
|Код склада|Уникальный идентификатор склада (обычно uid код в учетной системе|Обязательно|
|Дата продажи или изменения остатка|Дата продажи или изменения остатка в формате гггг-мм-дд или дд.мм.гггг|Обязательно|
|Количество|Количество продажи или списания в производство по калькуляции. Считается суммарно за день по складу-товару -клиенту (в случае поклиентской детализации|Обязательно|
|Клиент|Клиент, которому произошла продажа|выгружается только в том случае, если предполагается использование модуля маркетинговых акций в разрезе по клиентам (акция действует на конкретного клиента). В других случаях выгрузка этого поля нецелесообразна|
|Прочий расход|Выбытие товара, списание и пр|Не обязательно, на текущий момент программа использует поле|
|Прочее поступление|Приход товара|Не обязательно, на текущий момент программа использует поле|
|Количество товара в резерве на конец дня|количество товара в резерве под исключительный спрос на конец дня|Не обязательно, рекомендуется при наличии резервирования|
|Количество товара в размещенных заказах поставщику на конец дня|количество товара в размещенных заказах, но еще не отправленных поставщиком на конец дня|Обязательно при наличии такой информации в учетной системе и если не выгружается отдельным файлом с датами поступлений|
|Товар в пути|Число товара, находящееся в пути от поставщика|Обязательно при наличии такой информации в учетной системе и если не выгружается отдельным файлом с датами поступлений|
|Цена продажи|Цена реализации, при наличии отгрузок в день по разным ценам использовать средневзвешенную. Выгружается только в случае, если кол-во продажи больше нуля|Обязательно|
|Цена закупки|Последняя известная цена закупки товара. Выгружается в случае, если была реализация и равна последней цене закупки. Также  выгружается в случае, если было поступление и равна цене закупки в этом заказе.|Обязательно|
|Учетная цена|Цена, по которой учитывается товар, себестоимость|Не обязательно|
|Сумма продажи|кол-во единиц продажи*цена продажи|Рекомендуется|
|Сумма закупочная|кол-во единиц продажи * ценазакупочная|Рекомендуется|
|Остаток товара на конец дня|Фактический остаток товара на конец дня|Обязательно|
|Упущенный спрос|Известный упущенный спрос|Необязательно|
|Прибыль|Кол-во проданного*реализации - Закупочная цена (или себестоимость)|Необязательно|
|Невыполненный заказ|Известный упущенный спрос|Необязательно|

По умолчанию, остатки(фактический остаток, остаток в резерве, товар в заказах и в пути) загружаются на конец дня. Соответственно, при расчётах учитывается, что загружена полная информация по каждой дате. \\
Если же нужно, загружать и учитывать остатки за текущую дату, при этом, информация загружается не на конец дня, то для этого нужно воспользоваться флагом ''--day-completion-part'' при загрузке через [[консоль#опции|консольную утилиту]].

<note tip>
В случае загрузки поклиентской истории продаж поля прибыль и себестоимость будут суммироваться по всем клиентам, но в качестве цен закупки и реализации на конкретную дату  будут использованы цены из первой строчки в файлке по этому товару-складу-дате.  
Рекомендуем загружать по товару для каждого клиента одинаковую цену за один день  (среднюю/средневзвешенную).
</note>

<note important>Одному товару в один день для одного склада (и клиента, если таковой задан) соответствует только одна строка.</note>


===Пример файла===

<code>
Код товара;артикул;название товара;склад;дата;кол-во продажи;заказано;цена продажи;выручка;цена закупа;себестоимость;остаток;резерв
31051;AR132;Масло бочковое;Склад1;2020-08-01;4;4;100;400;3;300;10;0
31051;AR132;Масло бочковое;Склад1;2020-08-02;0;0;0;0;3;0;14;0
31051;AR132;Масло бочковое;Склад1;2020-08-03;0;0;0;0;3;0;14;4
</code>
В первой строчке была продажа, 02.08.2020 пришел заказ (изменился остаток и заказано), 03.08.2020 был открыт резерв

==== Сопоставление полей ====

Сопоставление полей при загрузке в программу следующее (слева название в описании, справа при выборе полей в указании формата в графическом интерфейсе Forecast NOW!):
  - уникальный идентификатор товара – Артикул
  - артикул товара  – Артикул (доп) (или Артикул, если первое - Пусто)
  - название товара – Название
  - название склада – Склад
  - дата продажи или изменения остатка – Дата
  - кол-во единиц продажи – Кол-во
  - кол-во единиц прочего расхода – Пусто (зарезервировано для будущих версий)
  - кол-во единиц поступления – Пусто(зарезервировано для будущих версий)
  - количество товара в резерве – В резерве, ед.
  - количество товара в размещенных заказах – Размещенный заказ, ед.
  - цена продажи – Цена реализации
  - сумма продажи – Выручка
  - цена закупочная – Цена закупки
  - сумма закупочная – Себестоимость
  - остаток товара - Остаток
  - упущенный спрос - Упущенный спрос
  - клиент - Клиент
  - невыполненный заказ - Невыполненный заказ
  - прибыль - Прибыль
  - учётная цена - Учётная цена
  - товар в пути - Товар в пути