Для CISLink¶

Компания CISLink занимается верификацией данных о товародвижении аптек по заданию отдельных производителей ("Пфайзер" на сегодняшний день).

В штатном режиме файлы, созданные по спецификации CISLink, создаются и отправляются автоматически ежесуточно на FTP (b2b.cislink.com), в каталог Pfizer/in/.

Файлы содержат информацию о движении товаров с группировкой Пфайзер Рх 2019 (см. справочник "Номенклатуры") за последние 45 дней.

Для изменения списка товаров надо отредактировать признак Группировка у номенклатур.

Перечень и описание полей в файлах¶

В качестве разделителя для полей используется символ точка с запятой ";"

pcatal.txt - Справочник товарной номенклатуры.

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

Порядковый номер поля	Заголовок поля	Тип данных	Описание
1.	code	Строковое, не пустое	Код товара
2.	art	Строковое	Артикул товара
3.	barcode	Строковое	Штриховой код товара
4.	name	Строковое, не пустое	Полное наименование товара
5.	pack	Строковое	Количество штук в упаковке
6.	price	Числовое (12,2)	Цена последнего прихода за одну штуку, с НДС
7.	manfid	Числовое, не пустое	444

Внимание

Поле code является первичным ключом, по нему группируются все остальные поля. Если на одном коде хранится несколько различных товаров, необходимо внести изменения в кодировку товаров для достижения уникальности.

Если артикулы товаров не хранятся в системе учёта, то это никак не помешает проверке данных – высылайте файлы на проверку с пустующим полем art. Сами коды можно будет внести в процессе работы над файлами или в ближайшее время после завершения подключения к системе сбора данных.

pclient.txt - Справочник клиентов и поставщиков дистрибьютора.

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

Порядковый номер поля	Заголовок поля	Тип данных	Описание
1.	clientcode	Строковое, не пустое	Код контрагента
2.	clientname	Строковое, не пустое	Наименование контрагента
3.	address_ur	Строковое	Юридический адрес контрагента
4.	address	Строковое	Фактический адрес контрагента
5.	inn	Строковое	ИНН
6.	kpp	Строковое	КПП
7.	spocode	Строковое	Код торговой точки
8.	sponame	Строковое	Наименование торговой точки
9.	spoaddress	Строковое	Фактический адрес торговой точки
10.	fdistrict	Строковое	Субъект РФ для spoaddress
11.	city	Строковое	Населенный пункт для spoaddress
12.	kladrcode	Строковое	Код города или насел. пункта по КЛАДР для spoaddress
13.	zip_code	Строковое	Почтовый индекс контрагента
14.	mccode	Строковое	Код канала рынка
15.	mcname	Строковое	Наименование канала рынка
16.	manfid	Числовое, не пустое	444

Внимание

Поля clientcode и spocode не должны содержать символов разделения на разряды (т.н. триады; номер символа 160). Если в кодах есть эти символы, от них необходимо избавиться.

Поля clientcode и clientname связаны между собой: строки с одним и тем же clientcode должны содержать один и тот же clientname.

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

Если в системе учёта допустимо хранение документов реализации и документов возвратов без указания действительного клиента, то в файл pclient, кроме действительных клиентов, необходимо выгрузить фиктивную строку, где все обязательные поля должны быть заполнены строковым значением «Клиент не определён» (без кавычек), а значение поля manfid – 444. Остальные поля оставляйте пустыми.

pwh.txt - Справочник филиалов.

Файл содержит список территориально разделённых филиалов (и виртуальных складов с тендерными товарами), их наименования и адреса. Если дистрибьютор является аптечной сетью или имеет собственную аптечную сеть, то в качестве филиалов необходимо выгружать магазины этой сети.

Порядковый номер поля	Заголовок поля	Тип данных	Описание
1.	whcode	Строковое, не пустое	Код филиала
2.	whname	Строковое, не пустое	Наименование филиала
3.	whaddress	Числовое, не пустое	Адрес филиала
4.	whtype	Числовое, не пустое	Тип филиала
5.	manfid	Числовое, не пустое	444

Внимание

Файл предназначен не для внутренних виртуальных складов, а для территориально разделённых филиалов или магазинов сети (при наличии). Если система позволяет выделить отдельно тендерный товар или товар «в пути» (транзит), то необходимо отразить это посредством добавления виртуальных складов, в наименовании которых будет содержаться наименование физического склада или магазина плюс комментарий «тендер» или «транзит».

Список филиалов оптимально согласовать с техподдержкой CISLink, контактная информация указана на первом листе.

pseria.txt - Справочник сроков годности.

Файл содержит перечень серий товаров и сроков годности.

Порядковый номер поля	Заголовок поля	Тип данных	Описание
1.	serial_no	Строковое, не пустое	Номер серии производителя
2.	code	Строковое, не пустое	Код товара
3.	is_date	Числовое	Дата производства
4.	sl_date	Числовое	Дата истечения срока годности
5.	manfid	Числовое, не пустое	444

Внимание

В файл pseria необходимо выгружать весь список товаров, имеющихся на складе за выгружаемый период, с указанием срока годности и даты производства. Если в системе отсутствует учет по сериям товара, но есть учет по датам производства и срокам годности, то в поле serial_no нужно выгрузить любой другой внутренний идентификатор (возможно, внутренний номер партии), который обеспечит уникальность по составному ключу: serial_no, code.

pdoc.txt - Файл с документами об операциях с товаром.

Файл содержит документы: реализация (продажа), возврат от клиента (агента), приход на склад, заказ от клиента, перемещения между территориально разделёнными филиалами, с указанием клиента, торгового представителя и партии, за последние 45 календарных дней.

Порядковый номер поля	Заголовок поля	Тип данных	Описание
1.	doc_number	Строковое, не пустое	Номер документа
2.	whcode	Строковое, не пустое	Код филиала
3.	oper_type	Числовое, не пустое	Тип операции с товаром
4.	doc_date	Числовое, не пустое	Дата актуальности документа
5.	doc_parent	Строковое	Номер документа-основания
6.	doc_ttn	Строковое	Номер ТТН поставщика
7.	doc_inv	Строковое	Номер счёта-фактуры поставщика
8.	order_date	Числовое	Дата заказа товара
9.	deliv_date	Числовое	Дата доставки товара
10.	order_stat	Числовое, не пустое	Статус заказа
11.	clientcode	Строковое, не пустое	Код клиента
12.	spocode	Строковое	Код торговой точки
13.	gw_code	Строковое	Код госзаказчика
14.	tenderno	Строковое	Реестровый номер аукциона за средства госбюджетов
15.	location	Строковое	Адрес госзаказчика
16.	manfid	Числовое, не пустое	444

Внимание

Чтобы избежать возможных дублей в файле, строки необходимо группировать. Поля, входящие в составной ключ: doc_number; whcode; oper_type; doc_date. То есть сочетание этих полей должно содержать уникальное в пределах файла значение. Остальные поля не должны влиять на уникальность составного ключа.

Если в системе учёта нередки случаи, когда все накладные переносятся с одного дня на другой (например, с выходного на будний день), то необходимо обнулять такие даты. В файл pdoc требуется выгрузить виртуальный (фиктивный) номер документа, в котором дата равна обнуляемой, а коды филиала, клиента и торговой точки могут быть любыми, но обязательно действительными (присутствующими в файлах-справочниках: pwh и pclient). Возможен вариант введения для подобных записей виртуальных кодов, которые не отображают действительных филиалов, клиентов и торговых точек, но выгружены в справочники. Фиктивный документ должен отвечать требованиям уникальности. Или, как вариант достижения уникальности, должен быть выгружен в объединении с обнуляемой датой. Объединять необходимо через нижнее подчеркивание.

pfact.txt - Файл с детализацией операций с товаром.

Файл содержит детализацию по товарам в документах реализации (продажи), возвратов от клиентов (агентов), приходов, заказов от клиентов, перемещений между территориально разделёнными филиалами с указанием клиента, торгового представителя и партии, за последние 45 календарных дней.

Порядковый номер поля	Заголовок поля	Тип данных	Описание
1.	code	Строковое, не пустое	Код товара
2.	serial_no	Строковое	Номер серии производителя
3.	parcel_no	Строковое	Номер партии дистрибьютора
4.	scd_number	Строковое	Номер ГТД
5.	doc_number	Строковое, не пустое	Номер документа
6.	whcode	Строковое, не пустое	Код филиала
7.	oper_type	Числовое, не пустое	Тип операции с товаром
8.	doc_date	Числовое, не пустое	Дата актуальности документа
9.	ru	Числовое, не пустое	Тип хранения товара
10.	quantity	Числовое, целое, не пустое	Количество
11.	manf_price	Числовое (12,2)	Фактическая отпускная цена, установленная Производителем, без НДС
12.	price	Числовое (12,2)	Цена прихода (закупки) за одну штуку, с НДС
13.	amount	Числовое (12,2), не пустое	Отгрузочная стоимость товара
14.	discount	Числовое (12,2)	Сумма скидки клиенту
15.	vat	Числовое (12,2)	Сумма НДС
16.	manfid	Числовое, не пустое	444

Внимание

Чтобы избежать возможных дублей в файле, строки необходимо группировать. Поля, входящие в составной ключ: code; serial_no; parcel_no; scd_number; doc_number; whcode; oper_type; doc_date. То есть сочетание этих полей должно содержать уникальное в пределах файла значение. Остальные поля не должны влиять на уникальность составного ключа. Если на уникальность составного ключа влияют поля: quantity; amount; discount; vat, то их необходимо суммировать.

prest.txt - Файл состояния склада.

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

Порядковый номер поля	Заголовок поля	Тип данных	Описание
1.	whcode	Строковое, не пустое	Код филиала
2.	code	Строковое, не пустое	Код товара
3.	serial_no	Строковое	Номер серии производителя
4.	parcel_no	Строковое	Номер партии дистрибьютора
5.	scd_number	Строковое	Номер ГТД
6.	curr_date	Числовое, не пустое	Дата актуальности документа
7.	inv_type	Числовое, не пустое	Характеристика брака
8.	ru	Числовое, не пустое	Тип хранения товара
9.	beg_rest	Числовое, целое, не пустое	Остаток товара на начало дня
10.	in_qty	Числовое, целое, не пустое	Количество по всем приходным операциям
11.	out_qty	Числовое, целое, не пустое	Количество по всем расходным операциям
12.	end_rest	Числовое, целое, не пустое	Остаток товара на конец дня
13.	price	Числовое (12,2)	Цена прихода (закупки) за одну штуку, с НДС
14.	transit	Числовое, целое	Входящий транзит
15.	manfid	Числовое, не пустое	444

Внимание

Чтобы избежать возможных дублей в файле, строки необходимо группировать. Поля, входящие в составной ключ: whcode; code; serial_no; parcel_no; scd_number; curr_date; inv_type. То есть сочетание этих полей должно содержать уникальное в пределах файла значение. Остальные поля не должны влиять на уникальность составного ключа. Если на уникальность составного ключа влияют поля: beg_rest; in_qty; out_qty; end_rest, то их необходимо суммировать.

В каждой строке файла должно выполняться равенство:

НачОстаток(beg_rest) + Приход(in_qty) – Расход(out_qty) = КонОстаток(end_rest)

Данные в файле pfact не должны противоречить данным в файле prest. Проверочные нестрогие неравенства, которым должно удовлетворять содержание файлов в сумме по товару и дате (поля code и curr_date):

(файл pfact, поле quantity, oper_type=0,4,7) <= (файл prest, поле out_qty)
(файл pfact, поле quantity, oper_type=1,2,5) <= (файл prest, поле in_qty)