Импорт и экспорт данных

Унифицированная конфигурация форматов импорта/экспорта

Унифицированный механизм настройки импорта/экспорта предоставляет возможность обмена данными с другими программами посредством файлов, представленных в различных формах. Этот механизм реализован для части объектов данных, используемых системой. Сюда входят:

Товарные документы

Платежные поручения (при импорте - выписка банка)

Прайс-лист

Строки инвентаризации (только импорт)

DBF

Текстовый (предусмотрен целый ряд опций, позволяющих настроить систему на подавляющее большинство вариантов текстовых представлений данных)

XML

Общие принципы работы и структура унифицированных конфигураций импорта/экспорта

Конфигурация импорта/экспорта хранится в текстовом файле bin/impexp.ini. Структура конфигурации содержит следующие атрибуты:

Наименование

Направление передачи данных (импорт или экспорт)

Путь к файлу импорта/экспорта

Тип формата файла

Параметры формата

Список соответствия полей

Дополнительный опции, определяемые конкретной областью использования конфигурации

Ид документа

Номер документа

Дата

ИНН контрагента

Имя контрагента

Код контрагента

и т.д.

Возможности обмена данными через текстовые файлы

Настройка конфигурации импорта/экспорта

Общий список конфигураций импорта/экспорта

Доступ к большей части конфигураций импорта/экспорта объединен общим диалогом, показанном на рис. link. Здесь сгруппированы следующие наборы конфигураций:

Товаров

Заголовков и строк документов

Инвентаризации

Прайс-листов

Заголовочный диалог конфигурации

В заголовочном диалоге необходимо указать основные параметры импорта/экспорта. Вид этого диалога показан на рис. link. Далее в таблице перечисляются управляющие элементы этого диалога.Обратите внимание, что в некоторых случаях, заголовочный диалог может отличаться от представленного на рисунке дополнительными полями, специфичными для конкретной области применения.

Наименование

Наименование конфигурации.

Формат внешних данных

Формат, в котором представлены входящие (исходящие) файлы. Доступны следующие варианты:

Текстовый

Данные представлены в виде текста. При этом детальные опции формата устанавливаются в дополнительном диалоге “Параметры текстового файла”.

DBF

Широко распространенный формат представления данных, используемый популярными системами семейства xBase (dBase, FoxPro, Clipper и др.)

XML

Текстовый файл в формате XML. На текущий момент поля могут быть определены только в виде тегов XML-файла, но не как атрибуты тегов.

Excel

Данные представлены в виде файла в формате Microsoft Excel^™.

Работа с такими файлами реализуется средствами COM-интерфейсов программы Microsoft Excel^™. Это означает, что она должна быть установлена на том компьютера, на котором запускается сеанс, выполняющий функции импорта/экспорта.

Диалог параметров текстового файла

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

Вид диалога редактирования этих параметров приведен на рис. link.

Имя файла данных

Это поле дублирует аналогичное поле в диалоге заголовка конфигурации. При открытии диалога, значение поле “Имя файла” и заголовочного диалога копируется в этот диалог. При подтверждении изменений в диалоге параметров текстового файла это имя будет скопировано в диалог заголовка.

Ориентация записей

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

Строка-разделитель полей

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

При вертикальной ориентации записей в этом поле устанавливается специальная строка, отделяющая одну запись от другой. Если вы хотите, чтобы при вертикальной ориентации записи разделялись пустой строкой, то в качестве разделителя следует указать специальную строку n. Еще один специальный случай - неявное разделение записей в вертикальной раскладке по числу строк. То есть, каждые N строк входного файла составляют отдельную запись, при этом явной строки-разделителя нет. В этом случае в рассматриваемом поле следует ввести строку следующего вида :N: (например, :4:).

✓Первая запись - наименование полей

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

✓Поля фиксированной длины

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

✓Формат поля: имя=значение

Этот флаг применяется только при вертикальной ориентации записей. Если он установлен, то программа предполагает, что поля в файле заданы строками вида: имя поля=значение поля (имена полей не должны содержать символов '=').

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

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

✓Текст имеет OEM - кодировку

Если этот флаг установлен, то система предполагает, что строки во внешнем файле имеют национальную OEM-кодировку (для русского языка это - CP-866). Если флаг не установлен, то система считает, что текстовые строки в файле представлены в Windows-кодировке (для русского языка это - Windows-1251).

✓Текстовые поля обрамлены кавычками

Если этот флаг установлен, то система предполагает, что все поля, имеющие тип “Строка”, обрамлены двойными кавычками.

Количество незначащих строк в начале файла

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

Завершающая строка файла

Этот параметр применим только для конфигурации с вертикальной раскладкой полей. Если здесь указан какой-либо текст, то при экспорте программа выведет его последней строкой файла.

[Поля заголовка...]

Кнопка применима только при экспорте и при вертикальной раскладке полей.

При нажатии на кнопку открывается диалог выбора полей заголовка. Это диалог аналогичен диалогу списка соответствия полей. Если для данной конфигурации специфицированы какие-либо поля заголовка, то начало экспортируемого файла будет формироваться в следующем порядке:

Заданные параметром 'Количество незначащих строк в начале файла' пустые строки.

Если установлен флаг ✓Первая запись - наименование полей, то перечисляются наименования полей.

Выводятся поля заголовка.

Диалог параметров XML-файла

Параметры XML-файла предназначены для определения особенностей структуры импортируемого или экспортируемого файла. Внешний вид диалога параметров XML-файла показан на рис. link.Далее перечислены управляющие элементы диалога и их назначение.

Корневой тег

Тег записи

Тег заголовка

✓Использовать DTD

✓Использовать кодировку UTF8

✓Имеет вложенную запись

[Поля заголовка...]

Диалог списка соответствия полей

В диалоге соответствия полей импорта/экспорта представлен упорядоченный список, состоящий из следующих колонок:

Наименование внутреннего поля

Наименование внешнего поля

Тип данных внешнего поля

Длина внешнего поля

Автоматически вычисляемая величина смещение поля относительно начала записи в символах (эта колонка служит хорошим подспорьем в случае настройки обмена данными через текстовый файл с фиксированной шириной полей).

Кроме описанного списка, диалог содержит несколько типовых кнопок:

[Редактировать]

[Добавить]

[Удалить]

[Вверх] и [Вниз]

Диалог элемента списка соответствия полей

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

Внутреннее представление

Здесь необходимо выбрать одно из полей, предоставляемых системой. Список внутренних полей определяется спецификой конкретной области использования конфигурации импорта/экспорта. Далее в этом разделе будут перечислены все внутренние поля для каждой области использования конфигурации.

Формула

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

Внешнее наименование поля

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

Тип поля

Тип данных содержащихся в данном поле. Система предоставляет выбор одного из следующих типов данных:

Строка - произвольная строка символов

Целое число - целочисленная величина

Число - число с плавающей точкой

Дата

Время

Определение формул в соответствиях полей

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

Текстовая формула

“Сегодня @curdate”Эта формула будет преобразована к виду “Сегодня 1/09/2008” (если текущая дата - первое сентября 2008 года).

Вот немногочисленный список пвседопеременных, которые можно использовать в формулах:

@empty

Специальная переменная, не заменяемая ни чем. Используется для представления пустых полей.

Это может понадобиться при экспорте, если какое-то поле должно присутствовать в файле, но его нет необходимости наполнять содержанием. При импорте необходимость в пустом поле может быть обусловлена тем, что входящий файл данных содержит поле, которое не может быть интерпретировано системой.

@recno

Номер текущей записи.

@curdate

Текущая системная дата.

@curyear

Числовое представление текущего года.

@curmonth

Числовое представление текущего месяца (1 - январь).

@curday

Числовое представление текущего календарного дня.

@curtime

Текущее системное время.

Функции

Система предусматирвает несколько специализированных функция для использования в выражениях экспорта:

@personregnum

Возвращает строку номера регистра персоналии. Аргументы:

regtypesymb

Символ типа регистрационного документа.

personid

Значение идентификатора персоналии.

Арифметическая формула

Специальные возможности

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

Интерфейс с системами клиент-банк

Конфигурация форматов клиент-банк

[Редактировать]

[Добавить]

[Удалить]

[События]

[Ассоциации]

[Закрыт]

Диалог редактирования формата клиент-банк

Вот их описание:

Код банка

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

Соответствие кодов платежей

Формат описания этих соответствий следующий: PM1,BM1;PM2,BM2;..;PMN,BMN

Здесь: PM1 (а так же PM2 и далее) - номер метода платежа, определенный в системе Papyrus BM1 (а так же BM2 и далее) - номер метода платежа, определенный в системе клиент-банк. В системе Papyrus используются следующие коды платежей

0

неопределенный

1

почтой

2

телеграфом

3

электронно

4

срочно

✓Определять плательщика по знаку суммы

Альтернативная категория форматов представлена парой групп полей: для плательщика и для получателя. В этом случае Papyrus определяет кто есть кто, сравнивая ИНН и того и другого с ИНН главной организации, определенной в текущем состоянии базы данных.

Список полей представленных в окне “Соответствие полей импорта/экспорта”

Empty

Строка(16)
Поле, не заполняемое системой, но требуемое модулем клиент-банк.

BillID

Число(9)
ИД платежного документа.

Code

Строка(24)
Номер платежного документа.

Date

Дата(8)
Дата платежного документа.

PayerBankAcc

Строка(32)
Банковский счет плательщика.

PayerID

Число(10)
ИД персоналии плательщика.

PayerINN

Строка(24)
ИНН плательщика.

PayerName

Строка(128)
Наименование плательщика.

PayerBankCode

Строка(24)
БИК банка плательщика.

PayerBankCorr

Строка(32)
Корр счет банка плательщика.

PayerBankName

Строка(128)
Наименование банка плательщика.

ReceiverID

Число(10)
ИД персоналии получателя.

ReceiverBankAcc

Строка(32)
Банковский счет получателя.

ReceiverINN

Строка(24)
ИНН получателя.

ReceiverName

Строка(128)
Наименование получателя.

ReceiverBankCode

Строка(24)
БИК банка получателя.

ReceiverBankCorr

Строка(32)
Корр счет банка получателя.

ReceiverBankName

Строка(128)
Наименования банка получателя.

Amount

Число(10,2)
Сумма платежа.

Purpose

Строка(160)
Назначение платежа.

Sequence

Число(4)
Очередность платежа.

TaxPayerKPP

Строка(24)
КПП плательщика бюджетного платежа.

TaxReceiverKPP

Строка(24)
КПП получателя бюджетного платежа.

TaxPayerStatus

Строка(4)
Статус плательщика бюджетного платежа.

TaxClass

Строка(24)
Код бюджетной классификации.

OKATO

Строка(16)
Код по ОКАТО бюджетной организации.

TaxReason

Строка(8)
Код причина бюджетного платежа.

TaxPeriod

Строка(16)
Налоговый период.

TaxDocNumber

Строка(16)
Номер документа, согласно которому идет уплата.

TaxDocDate

Строка(16)
Дата документа, согласно которому идет уплата.

TaxPaymType

Строка(8)
Тип бюджетного платежа.

VatSum

Число(8,2)
Сумма НДС.

PurposePlusVat

Строка(250)
Поле примечание с присоединенным к нему текстом по НДС.

CorrName

Строка(16)
Не используется.

CorrBIC

Строка(16)
Не используется.

CorrINN

Строка(16)
Не используется.

CorrPerson

Строка(16)
Не используется.

PaymMethod

Число(4)
Вид платежа.

AddedAssocTag

Число (Только импорт)
Дополнительный признак ассоциации вида операции. Это поле позволяет уточнить вид операции импортируемого документа выписки. Если в принимаемом файле определено это поле, то при идентификации вида операции, которой должен принадлежать создаваемый документ, система обращает внимание на поле “Дополнительный признак ассоциации” в элементах списка ассоциаций импорта клиент-банк.

AgentINN

Строка(24)
ИНН агента по документу. Если это поле определено, то при импорте выписки, в создаваемый документ будет устанавливаться агент по документу (если система сумеет идентифицировать агента по значению кода ИНН в этом поле входящего файла).

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

AgentName

Строка(48)
Наименование агента по документу. Это поле помогает разрешать проблемы с идентификацией агента по импортируемому документу.

LocSymb

Строка(12)
Символ склада. При импорте, если в этом поле указано допустимый символ склада, то создаваемый документ будет принадлежать соответствующему складу.

При экспорте в это поле заносится символ склад, которому принадлежит экспортируемый документ.

DebtBillID

Число (Только импорт)
ИД долгового документа (для зачета).

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

Дата и номер долгового документа

Эти два поля имеют тоже назначение, что и DebtBillID. Только идентификация долгового документа для зачета в этом случае будет осуществляться // по номеру и дате документа.

Для того, чтобы такая идентификация работала необходимо, чтобы были определены оба эти поля и во входном файле их значения должны быть не пустыми. Так как поле DebtBillID и пара полей DebtBillDate/DebtBillCode являются дублирующими, то при наличии всех трех полей приоритет использования принадлежит DebtBillID.

DebtBillDate

Дата (Только импорт)
Дата долгового документа (для зачета).

DebtBillCode

Строка(24) (Только импорт)
Номер долгового документа (для зачета).

Экспорт платежных поручений

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

Импорт банковской выписки

Импорт и экспорт документов

Настройка импорта и экспорта документов

Описание полей заголовка документа

ID

zstring(32) Идентификатор документа. По этому полю система сопоставляет данную запись с записями строк документа.

Code

zstring(24) Номер документа.

Date

date Дата документа.

OpID

long Только для экспорта.

Идентификатор вида операции, которой принадлежит документ.

OpSymb

zstring(20)

Только для экспорта. Символ вида операции, которой принадлежит документ.

InvoiceCode

zstring(24) Номер счет-фактуры. При экспорте, если номер счет-фактуры явно не задан, то это поле равно номеру документа.

При импорте, это поле устанавливается в создаваемом документе если оно не пустое и отличается от номера документа.

InvoiceDate

date

Дата счет-фактуры. При экспорте, если дата счет-фактуры явно не задана, то это поле равно дате документа. При импорте, это поле устанавливается в создаваемом документе если оно не пустое и отличается от даты документа.

INN

zstring(32) ИНН контрагента.

При импорте по этому поле система идентифицирует контрагента. Идентификация осуществляется следующим образом:

Из базы данных извлекается список персоналий, у которых регистрационный номер зарезервированного типа ИНН равен значению этого поля.

Найденный список персоналий проецируется на таблицу статей, заданную в виде операции, которой принадлежит импортируемый документ, как основная таблица объектов.

Если результирующий список статей не пустой, то берется первая статья из этого списка и она считается контрагентом по документу.

Указанному методу идентификации контрагента предшествуют попытки идентификации по CntragID и по RegistryCode (см. ниже). Если эти две попытки не дали результата, то только в этом случае применяется описанный метод.

Если все описанные шаги привели к успешному поиску аналитической статьи, то она становится контрагентом по документу, в противном случае применяется поиск по ИНН.

Применение формул при экспорте документов

В дополнение к штатному механизму определения формул в конфигурации экспорта заголовков документов можно применять символы, используемые для формирования сумм шаблонов проводок (см. стр. link).Благодаря этому вы, например, можете экспортировать документы со значениями их дополнительных сумм.

Обратим внимание на то, что символы, относящиеся к контексту документа можно вписывать в формулу как с префиксом @, так и без него. Например, выражения {@addamt * 1.8} и {addamt * 1.8} эквивалентны.

Описание полей строк документа

BillID

zstring(32) Идентификатор документа. По этому полю система сопоставляет данную запись с записью в таблице документов.

LineNo

long Только для экспорта.

Номер строки (первая строка нумеруется единицей).

GoodsID

long

Идентификатор товара.

LotID

long

Только для экспорта. Идентификатор лота, к которому привязана строка документа.

GoodsName

zstring(128) Наименование товара.

Barcode

zstring(24) Штрихкод товара.

ArCode

zstring(24) Кода товара, сопоставленный со статьей контрагента по документу.

ArCodeOwn

zstring(24) Только для экспорта.

Собственный код товара (артикул, сопоставленный с пустой аналитической статьей).

UnitName

zstring(48)

Только для экспорта. Наименование торговой единицы измерения товара.

UnitCode

zstring(20) Только для экспорта.

Код торговой единицы измерения товара.

PhUnitName

zstring(48)

Только для экспорта. Наименование физической единицы измерения товара.

Quantity

double format(10.3) Количество торговых единиц товара.

PhQtty

double format(10.3) Только для экспорта.

Количество физических единиц. Если по товару в строке ведется независимый учет физических единиц, то данное поле отражает соответствующее значение из строки документа. В противном случае, величина, выводимая в этом поле равна произведению количества на соотношение физических единиц к торговым, заданное для товара. Для переоценки это поле не инициализируется.

UnitPerPack

double format(10.3) Емкость упаковки.

PckgQtty

double format(10.3) При экспорте это поле заполняется количеством целых упаковок, содержащемся строке документа. Емкостью упаковки при этом берется из лота, к которому привязана данная строка. Если в лоте емкость упаковки не определена, то система пытается извлечь значение емкости упаковки поставки из записи товара. Если и эта величина не определена, то значение данного поля нулевое.

При импорте поле PckgQtty используется только в случае, если величина в поле Quantity не определена либо меньше или равна нулю. При этом емкость упаковки определяется в следующем порядке:

Значение, заданное в поле UnitPerPack обрабатываемой записи (см. выше).

Значение емкости упаковки поставки, заданное в карточке товара.

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

Применение формул при импорте документов

В конфигурации импорта строк документа можно использовать специализированные формулы (так называемые, динамические импортируемые поля).Общий формат такой формулы следующий: prefix . content. Здесь prefix - зарезервированное ключевое слово, обозначающее механизм обработки, . (точка) - просто разделитель префикса и содержания формулы, content - содержание формулы.

На данный момент доступны следующие поля:

lottag

Формулы для динамической привязки тегов лотов. Для этого в содержании формулы необходимо указать символ тега с префиксом lottag. Например, формула lottag.manufprice означает, что из заданного внешнего поля будет извлечено значение, которое будет присвоено тегу лота с символом manufprice.

priceformula

Формула для расчета цены реализации импортируемой строки документа. После точки должна следовать собственно формула расчета. Обратим внимание на то, что эта формула может оперировать только псевдопеременными, ссылающимися на поля импортируемой структуры, но не на документ (строку документа). Например: priceformula.@cost*1.2 присвоит цене реализации значение, равное цене поступления, умноженное на 1.2.

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

costformula

То же, что и priceformula, но для расчета цены поступления.

formulainner-field-name

Сложная конструкция, реализующая вычисление значения числового поля по формуле.

token
inner-field-name

Сложная конструкция, реализующая извлечение значения из внешнего текстового поля. Здесь inner-field-name - символьное обозначение внутреннего поля, значение которого необходимо определить. После точки следуют 3 аргумента разделенные пробелами: ppyrsrv{outer-field-name} ppyrsrv{divider} ppyrsrv{token-no}

ppyrsrv{outer-field-name}

Символьное обозначение внешнего поля, из которого необходимо извлечь подстроку.

ppyrsrv{divider}

Допустимые разделители, отделяющие подстроки исходного текста. Здесь могут следующие варианты: один из символов _ , ; . - : % ^ $ @ # или специальные строки: space (пробел), tab (табуляция).

ppyrsrv{token-no}

Номер подстроки, которую необходимо извлечь. Первая подстрока имеет номер 1.

Например: в исходных данных содержится текстовое поле с символом CODEANDDATE вида номердокумента-датадокумента Для извлечения номера документа из этого поле применим формулу

token

Экспорт документов

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

Наконец, в таблице документов выберите команду “Экспорт документов” (<Ctrl-R> ).Кроме этого, функция экспорта документов присутствует в отчете по фрахтам.

Импорт документов

Для импорта документов следует выбрать пункт меню Справочники→ Админ→ Импорт→ Импорт документов.

Разрешение неопределенных товаров при импорте документов

В этой ситуации система придерживается двух принципов:

Документ, у которого есть строки с неразрешенными товарами, не может быть сохранен в базе данных.

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

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

Создать новый товар для каждой из неизвестных позиций в отдельности.

Массовое создание новых товаров для всех неизвестных позиций сразу. Эта функция занимает меньше сил, но и снижает возможности контроля над формированием новых номенклатурных позиций.

Заменить неизвестную системе позицию на существующую по выбору пользователя.

Найти аналог неизвестного товара по наименованию.

Импорт инвентаризации

Система предоставляет унифицированный сервис для импорта строк инвентаризации. Настройка форматов импорта инвентаризации доступна через пункт меню Админ→ Конфигурации импорта/экспорта→ Конфигурация импорта инвентаризации.

Поля, используемые при импорте инвентаризации

GoodsID

long Идентификатор товара.

Barcode

zstring(24) Штрихкод товара.

GoodsName

zstring(64) Наименование товара.

Serial

zstring(24) Серийный номер.

Quantity

double format(12.5) Фактическое количество. Допустимое значение должно лежать в пределах от 0 до 1000000 (включительно). Если значение выходит за указанные границы, то строка не будет принята (система проинформирует об этом пользователя).

Cost

double format(12.5) Цена поступления.

Price

double format(12.5) Цена реализации.

Идентификация товаров при импорте инвентаризации

Схема порядка идентификации товара приведена на рис.link. Далее следует описание порядка идентификации:

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

В противном случае, если во входном файле определен штрихкод товара, то товар ищется по этому штрихкоду со следующими особенностями:

Если в записи входного файла задан серийный номер, то ищется подходящий лот с этим серийным номером и из него извлекается товар.

При этом строка инвентаризации получает принадлежность серийного номера.

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

Упомянутый вес используется как фактическое количество только в том случае, если поле Quantity записи во входном файле имеет недопустимое значение или ноль.

Если штрихкод имеет весовой префикс и в конфигурации товаров установлен флаг ✓На весы вместо штрихкода загружать ИД товара, то пять цифр после весового префикса трактуются как идентификатор товара.

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

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

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

Результат идентификации товара выводится в журнал, отображаемый на экране в процессе работы процедуры.

Правило определения цен при импорте строк инвентаризации

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

Система применяет следующий порядок вовлечения значений из этих полей в формирование цен строк инвентаризации:

Если вид операции документа предусматривает учет строк в ценах реализации, то цена извлекается из поля Price (но только если значение этого поля больше нуля).

Если вид операции предусматривает учет строк в ценах поступления и значение поля Cost во входном файле больше нуля, то применяется это значение.

Если предыдущие два случая дали нулевой результат, и существует учетный остаток товара на дату инвентаризации, то используется средняя цена поступления или реализации (в зависимости от флага ✓В ценах поступления опций вида операции).

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

Импорт и экспорт товаров

Наименование конфигурации

▼Группа по умолчанию

▼Операция прихода

▼Таблица аналитических статей

▼Поставщик

▼Склад

Признак необходимости добавления товара в матрицу

SubCode (offs,len)

▼Торговая единица по умолчанию

▼Физ ед измерения

Формат внешних данных

○Текстовый

○DBF

○Xml

○Excel

Поля, используемые при импорте и экспорте товаров

Code

zstring(32) Штрихкод.

CodeCD

zstring(32) Штрихкод с форсированной контрольной цифрой // @v6.2.4

AddedCode

zstring(32) Дополнительный штрихкод.

AddedCodeQtty

double format(10.4) Количество для дополнительного штрихкода.

GrpID

zstring(32) Только для экспорта.

Идентификатор родительской группы товара.

GrpCode

zstring(32)

Код группы родительской группы товара.

GrpName

zstring(128)

Наименование группы.

FolderGrpName

zstring(128)

Наименование группы верхнего уровня.

Name

zstring(128)

Наименование.

Abbr

zstring(128)

Сокращенное наименование. // @v6.2.4

UnitName

zstring(48)

Наименование единицы измерения.

UnitCode

zstring(20)

Только для экспорта. Код единицы измерения.

PhUnitName

zstring(48) Наименование физической единицы измерения.

PhUPerU

zstring(48) Соотношение физических единиц к торговым.

ClsCode

zstring(20) Символ класса товара.

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

DimX

double

Числовой классификатор X.

DimY

double

Числовой классификатор Y.

DimZ

double

Числовой классификатор Z.

DimW

double

Числовой классификатор W.

PropKindName

zstring(48)

Наименование классификатора товара Kind. При импорте, если элемент классификатора с таким именем не существует, система создает новый элемент с этим именем.

PropGradeName

zstring(48)

Наименование классификатора товара Grade. При импорте, если элемент классификатора с таким именем не существует, система создает новый элемент с этим именем.

PropAddName

zstring(48)

Наименование классификатора товара Add. При импорте, если элемент классификатора с таким именем не существует, система создает новый элемент с этим именем.

PropAdd2Name

zstring(48)

Наименование классификатора товара Add2. При импорте, если элемент классификатора с таким именем не существует, система создает новый элемент с этим именем.

UnitsPerPack

double format(10.6)

Емкость упаковки лота.

Cost

double format(10.2)

Цена поступления.

Price

double format(10.2)

Цена реализации.

Rest

double format(10.4)

Остаток.

QCNumber

zstring(32)

Сертификат качества: номер сертификата.

QCBlank

zstring(16)

Сертификат качества: код бланка.

QCDate

date

Сертификат качества: дата выдачи.

QCExpiry

date

Сертификат качества: срок годности.

QCManuf

zstring(128)

Сертификат качества: изготовитель.

QCOrg

zstring(128)

Сертификат качества: регистрирующий орган.

QCManufDate

zstring(20)

Сертификат качества: дата производства.

QCEtc

zstring(32)

Сертификат качества: прочая информация.

QCInnerCode

zstring(16)

Сертификат качества: внутренний код.

SalesTax

double format(10.2)

Ставка налога с продаж.

Vat

double format(10.2)

Ставка НДС.

Country

zstring(48)

Страна изготовитель.

CountryCode

zstring(48)

Код страны изготовителя.

Clb

zstring(32)

Грузовая таможенная декларация.

Serial

zstring(32)

Серийный номер.

Expiry

date

Срок годности.

ExpiryPeriod

long

Срок годности дней.

PckgQtty

double

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

PckgBrutto

long

Масса брутто упаковки поставки, г.

PckgLength

long

Длина упаковки поставки, мм.

PckgWidth

long

Ширина упаковки поставки, мм.

PckgHeight

long

Высота упаковки поставки, мм.

ManufID

long

Только для экспорта. Ид производителя товара.

ManufName

zstring(128) Наименование производителя товара.

Brand

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

ExtA

zstring(255) Дополнительное текстовое поле товара 1.

ExtB

zstring(255) Дополнительное текстовое поле товара 2.

ExtC

zstring(255) Дополнительное текстовое поле товара 3.

ExtD

zstring(255) Дополнительное текстовое поле товара 4.

ExtE

zstring(255) Дополнительное текстовое поле товара 5.

ArCode

zstring(32) Только для импорта.

Код по статье. Код присваивается товару и соответствует поставщику, выбранному следующим образом:

Если поле BillSupplID содержит идентификатор существующей статьи аналитического учета, то код будет соответствовать этой статье.

Если предыдущий вариант не привел к выбору статьи, и поле BillSupplCode содержит действительный поисковый код персоналии, соответствующей какому-либо поставщику, то ArCode будет сопоставлен этому поставщику.

В случае невозможности определить аналитическую статью по предыдущим двум шагам код товара по статье сопоставляется с поставщиком, заданным в конфигурации импорта.

Если же и это значение пустое, то код станет собственным.

Экспорт лотов

Для лотов предусмотрен только экспорт.Конфигурация экспорта лотов практически аналогична общей конфигурации экспорта/импорта за исключением дополнительного атрибута ▼Аналитическая статья для получения кодов товаров. Этот параметр необходим в том случае, если требуется экспортировать коды товаров по статье.

Вызов функции экспорта лотов осуществляется из таблицы лотов (см. стр. link).

Поля, используемые при экспорте лотов

ID

long Ид. лота.

BillID

long Ид. документа, которым сформирован лот.

LocID

long Ид. склада.

Dt

date Дата поступления лота.

OprNo

long Номер операции за день.

Closed

int16 Признак нулевого текущего остатка по лоту.

GoodsID

long Ид. товара.

QCertID

long Ид. сертификата качества.

UnitPerPack

double format(10.3) Количество единиц в упаковке.

Quantity

double format(10.3) Поступившее количество единиц.

WtQtty

double format(10.3) Поступившее количество в независимых физических единицах.

WtRest

double format(10.3) Остаток после операции в независимых физических единицах.

Cost

double format(10.2) Цена поступления.

ExtCost

double format(10.2) Величина накладных расходов.

Price

double format(10.2) Цена реализации.

Rest

double format(10.3) Текущий остаток. То есть остаток с учетом все операций по лоту.

PrevLotID

long Ид. родительского лота.

SupplID

long Ид. поставщика.

CloseDate

date Дата закрытия лота.

Expiry

date Дата истечения срока годности.

InTaxGrpID

long Ид. налоговой группы прихода.

BegRest

double format(10.3) Остаток на начало операционного периода. Заполняется только если экспорт осуществляется из списка лотов с непустым операционным периодом.

EndRest

double format(10.3) Остаток на конец операционного периода. Заполняется только если экспорт осуществляется из списка лотов с непустым операционным периодом.

QttyPlus

double format(10.3) Приход за операционный период (количество). Заполняется только если экспорт осуществляется из списка лотов с непустым операционным периодом.

QttyMinus

double format(10.3) Расход за операционный период (количество). Заполняется только если экспорт осуществляется из списка лотов с непустым операционным периодом.

OrgLotDt

date Дата поступления оригинального лота.

Serial

zstring(32) Серийный номер лота. Заполняется только если экспорт осуществляется из списка лотов с атрибутом фильтра ✓Показывать серийные номера.

UhttArCode

zstring(32) Приватный UHTT-код товара.

Импорт других объектов данных

Импорт товаров (старая версия)

file=filename

Имя файла, из которого будут импортированы данные.

hierarchy=obj_code,parent_code

Иерархический справочник:

obj_code

код объекта.

parent_code

код родительского объекта.

Импорт товарных групп

Импорт товарных групп возможен из файлов формата DBF.Описание импорта товарных групп заносится в файл bin/import.ini в зону [goodsgroup].

Здесь могут быть следующие параметры:

file

Обязательный параметр.

Имя файла, из которого будут импортированы данные.

name

Обязательный параметр.

Наименование поля, в котором находится имя группы.

code

Наименование поля, в котором содержится код группы.

parentseq

Специализированный параметр, позволяющий импортировать иерархию групп в случае, если все уровни группировки хранятся в одной записи. Значение параметра задается в виде списка элементов, разделенных символом ; (точка с запятой). Каждый элемент представлен одним или двумя наименованиями полей, представляющих соответственно, поле имени группы верхнего уровня и поле кода этой группы.

name=nam
code=cod
parentseq=group;subgroup,sgc
В этом примере предполагается, что входной файл содержит следующие поля:

nam

Наименование товарной группы.

cod

Код товарной группы.

group

Наименование группы самого верхнего уровня.

subgroup

Наименование группы второго уровня.

sgc

Код группы второго уровня.

Обратите внимание, на то, что для группы самого верхнего уровня код опущен.

Импорт персоналий

Описание импорта персоналий заносится в файл bin/import.ini в зону [person] или [suppl] (специализированный импорт поставщиков).

file=filename

Имя файла, из которого будут импортированы данные.

personcodereg=reg_symb

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

code=fld_name

unique code, identified person in enterprise domain Уникальный внутри импортируемого файла код персоналии. В базу данных Papyrus этот код заносится как регистр типа personcodereg. Если personcodereg не определен, то код персоналии не присваивается.

idbias=bias

bias added to key to avoid person id duplicating

kind=person_kind_list

Список наименований видов персоналий, которым должны принадлежать импортируемые персоналии. Если таких видно несколько, то их наименования должны следовать друг за другом с разделителем ',' (запятая). Если этот параметр отсутствует или не содержит ни одного допустимого значения, то создаваемые персоналии получают принадлежность зарезервированному виду UNKNOWN (Неизвестные).

name=fld_name

person name (imported into PersonTbl::Rec.Name) Обязательное поле. Поле наименования персоналии. Система не принимает персоналию, если в базе данных уже имеется персоналия с таким именем.

extname=fld_name

Расширенное наименование персоналии.

status=fld_name

Символ (не наименование) юридического статуса, которому должна принадлежать импортируемая персоналия. Если это значение пусто, либо не найден статус с таким символом, то персоналия получает статус по следующему правилу:

Если среди списка видов персоналий, заданного параметром kind, есть хоть один, для которого определен юридический статус по умолчанию, то будет применяться этот статус.

В противном случае используется зарезервированные статус Юридическое лицо.

Вызов функции импорта персоналий осуществляется посредством пункта меню Справочники→ Админ→ Импорт персоналий.Для импорта поставщиков (определенном в зоне [suppl] файла bin/import.ini) необходимо воспользоваться пунктом меню Справочники→ Админ→ Импорт поставщиков.

Идентификация дубликатов персоналий при импорте

Если импортируется персоналия с зарезервированным типом регистрационного документа ИНН и этот тип регистра не имеет признака ✓Неуникальный номер, то система ищет в базе данных персоналию с таким ИНН. Если соответствующая персоналия найдена, то данная запись не импортируется.

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

Импорт котировок

file=filename

Имя файла, из которого будут импортированы данные.

quotname=string

QuotKind Name for importing. Сначала программа ищет котировку по символу quotname, а потом, если символ не найден, по наименованию.

goodsid=fld_name

goods id.

goodscode=fld_name

goods code (goodsid | goodscode)

goodsname=fld_name

goods name

price=fld_name

Price

warehouse=warehouse_code

Символ склада для которого устанавливать котировку.

cursymb=fld_name

currency symbol

Импорт персональных карт

file=filename

Имя файла, из которого будут импортированы данные.

personcodereg=reg_symb

Символ вида регистрационного документа, используемого в качестве кода владельца карты.

seriesid=scser_id

Идентификатор серии, к которой должны относится импортируемые карты. Если серия не определена, то система использует серию с именем DEFAULT. Если такая серия не существует, то создает новую серию с этим именем.

code=fld_name

Текстовый код карты.

codenum=fld_name

Числовой код карты поле codenum имеет приоритет перед code. То есть, если значения есть и в поле codenum и в поле code, то система использует поле codenum и преобразует его в текст.

personcode=fld_name

Код владельца карты. Привязка персоналии-владельца карты осуществляется по этому коду, содержащемуся в регистре персоналии с типом personcodereg.

pctdis=fld_name

Процент скидки по карте.

turnover=fld_name

Начальный оборот по карте. Заносится кассовым чеком, привязанным к этой карте по нулевому кассовому узлу за 01/01/2001.

Импорт банков

В интернете по адресу http://cbrates.rbc.ru/bnk/bnk.exe доступен регулярно обновляемый список банков, действующих на территории Российской Федерации.Вы можете загрузить этот список и импортировать его частично или полностью в базу данных Papyrus .

Для этого необходимо выполнить следующие шаги:

1. Загрузить с указанного адреса файл bnk.exe в какой-либо каталог на вашем компьютере (для примера, C:/BNK).
2. Запустить на выполнение указанный файл. В результате будут распакованы два файла: bnkseek.txt и reg.txt.
3. Запустить Papyrus с параметром командной строки /convertrbcbnk:путь для конвертации файлов bnkseek.txt и reg.txt в bnkseek.dbf и reg.dbf соответственно. Для нашего примера командная строка запуска будет выглядеть так:
   ppw.exe /convertrbcbnk:C:/BNK
4. В каталоге Papyrus в файле BIN/IMPORT.INI настроить зону описания импорта банков. Она должна выглядеть так:

   
   		file=c:/bnk/bnkseek.dbf
   		regionfile=c:/bnk/reg.dbf
   		regionid=ID
   		regionname=Name
   		name=Name
   		city=City
   		bic=BIC
   		corracc=CorrAcc
   	

   Обратите внимание на параметры file и regionfile. В них пути должны соответствовать тому каталогу, в котором вы осуществили конвертацию файлов.

5. Открыв сеанс Papyrus выбрать пункт меню Справочники→ Админ→ Импорт→ Импорт банков. Непосредственно перед импортом система предложит вам выбрать город, которому должны соответствовать импортированные банки. Если вы не выберите город, то будут импортированы все банки из справочника (это - довольно много).