Формат загрузки истории продаж

Общие требования

Сsv файл кодировки UTF-8

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

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

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

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

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

Структура файла

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

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

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

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

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

Строка выгружается в следующих случаях:

  1. Была продажа
  2. Был прочий расход
  3. Было поступление
  4. Изменился остаток (перемещение, продажа и пр.), кол-во товара в пути (проведение документа, отмена проведения, приход товара и пр.), кол-во товара в заказе (размещение-закрытие заказа), кол-во товара в резерве (снятие резерва, открытие резерва),

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

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

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

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

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

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

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

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

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

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

Пример файла

Код товара;артикул;название товара;склад;дата;кол-во продажи;заказано;цена продажи;выручка;цена закупа;себестоимость;остаток;резерв
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

В первой строчке была продажа, 02.08.2020 пришел заказ (изменился остаток и заказано), 03.08.2020 был открыт резерв

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

Сопоставление полей при загрузке в программу следующее (слева название в описании, справа при выборе полей в указании формата в графическом интерфейсе Forecast NOW!):

  1. уникальный идентификатор товара – Артикул
  2. артикул товара – Артикул (доп) (или Артикул, если первое - Пусто)
  3. название товара – Название
  4. название склада – Склад
  5. дата продажи или изменения остатка – Дата
  6. кол-во единиц продажи – Кол-во
  7. кол-во единиц прочего расхода – Пусто (зарезервировано для будущих версий)
  8. кол-во единиц поступления – Пусто(зарезервировано для будущих версий)
  9. количество товара в резерве – В резерве, ед.
  10. количество товара в размещенных заказах – Размещенный заказ, ед.
  11. цена продажи – Цена реализации
  12. сумма продажи – Выручка
  13. цена закупочная – Цена закупки
  14. сумма закупочная – Себестоимость
  15. остаток товара - Остаток
  16. упущенный спрос - Упущенный спрос
  17. клиент - Клиент
  18. невыполненный заказ - Невыполненный заказ
  19. прибыль - Прибыль
  20. учётная цена - Учётная цена
  21. товар в пути - Товар в пути