| Программа для склада, для магазина, для производства |
Vvs "Офис-Склад-Магазин"Техническая поддержка |
| Поддержка | Вопросы пользователей | Изменения в программе | Новые печатные формы | Обмен опытом |
Формат для обмена "Vvs обмен данными".
В программе Vvs “Офис — Склад — Магазин” используются несколько форматов для обмена данными. Обмен возможен через текстовые или XML файлы. Описание всех форматов имеются во встроенной помощи. В данной части рассматривается вариант обмена данными через текстовый файл в формате "Vvs обмен данными".
Для обмена с другими нашими программами, а также для выгрузки документов в 1С Бухгалтерию используются текстовые файлы в формате, который мы назвали "Vvs обмен данными". Этот формат поддерживается нашей программой Vvs "Офис – Склад - Магазин" начиная с версии 6.2.3. Также есть поддержка формата в нашей мобильной программе Vvs “Мобильная Торговля” для Android и программе в Vvs “Торговля” для Windows и Linux.
В этом формате возможен обмен данными о товарах, клиентах и заказах.
В файле могут передаваться изображения товара в кодировке Base64. Текстовый формат позволяет обрабатывать файл построчно не загружая его целиком в память. Это может быть важно при передаче больших объемов данных, особенно вместе с изображениями товаров.
Получение файлов для экспорта
Для выгрузки данных поставляются формы отчетов и документов. В Vvs “Офис — Склад — Магазин” эти формы называются “Экспорт в формат "Vvs обмен данными". Их можно найти в следующих местах программы:
Отчеты по товарам для выгрузки названий товаров
Отчеты по клиентам для выгрузки реквизитов клиентов
Печатаная форма заказа на приход или расход
Отчет по заказам на приход или расход
Печатаная форма накладной в заказе на приход или расход
Отчет по накладным на приход или расход
Отчет по товарам в розничной торговле
Загрузка данных
Для загрузки данных в этом формате используйте пункт меню “Сервис” - “Импорт данных из текста в формате Vvs Обмен Данными”.
Кроме этого, можно использовать параметры командной строки при запуске программы (исполняемый файл OWS6.EXE).
Параметры командной строки
--base=Путь_к_базе_данных
--user=Имя_пользователя
--pass=Пароль_пользователя
--import=Имя_текстового_файла_для_импорта
--duplicate
Если указаны имя и пароль, то программа не запрашивает их при запуске.
Если указан файл для импорта данных, то после их обработки программа прекращает работу.
Если задан параметр --duplicate, то заказы с существующими номерами будут добавляться повторно.
Описание формата.
Каждая единица информации размещается на отдельной строке.
Первой в файле должна находиться служебная строка, для распознавания формата и определения кодировки:
Vvs data for exchange
По умолчанию кодировка текста – Utf-8. Для Windows кодировки используйте следующую строку:
Vvs data for
exchange,cp1251
Далее каждая строка может содержать команды с началом и концом блока информации или значением одного из полей в базе данных. Вложенности информации не предусмотрено. Все данные размещаются с первого символа в строке, лидирующие пробелы не допускаются. Команды или блоки информации начинаются с символов ##. Между началом и окончанием информационных блоков находятся строки со значениями. Значения для данных записывается в отдельных строках в формате Имя_поля:Значение. Идентификация существующих записей контрагентов и товаров происходит по коду. Например:
##partner
name:ООО
“Треугольник”
code:1001
address:125252, Москва,
ул. Зорге, 10
##endpartner
Вложенности блоков информации нет, но порядок их следования имеет значение. Например, перед описанием параметров заказа должно следовать описание клиента по этому заказу. Перед описанием пункта заказа с количеством и ценой может следовать описание товара.
Для полей используются зарезервированные названия, такие как name, code, address. Можно также использовать названия полей из таблиц в базе данных, но их название зависит от специфики конкретного приложения. Не все поля могут обрабатываться при загрузке данных в конкретное приложение. Если в приложении какие-то поля отсутствуют, то они пропускаются при загрузке данных.
Для передачи многострочных данных, таких как описание товара,и комментарии к клиенту или заказу, используется следующий формат:
--- begin ---
СТРОКИ
ОПИСАНИЯ …
--- end ---
Далее рассмотрим основные блоки информации.
Данные о покупателе, поставщике
Информационный блок начинается со строки ##partner, а заканчивается ##endpartner Можно использовать следующие стандартные поля для клиента:
name - наименование
code - код
is_supplier =1 если это поставщик
fullname – полное наименование
address - адрес
address_legal – юридический адрес
address_actual – фактический адрес
note – примечание (в одну строку)
inn - ИНН
kpp - КПП
okpo – код ОКПО
phone - телефон
fax - факс
www
ogrn
bank
bankcity
bik
accnum – номер расчетного счета
corrnum – корр.счет
swift
iban
person
person1
person2
discount - скидка клиента в %
param1, param2, ... - дополнительные параметры
country - страна
region - область
city - город
postcode - почтовый индекс
phone2 - 2-й телефон
phone3 - 3-й телефон
Данные о заказе
Информационный блок начинается со строки
##order,
а заканчивается ##endorder.
Кроме этого имеется отдельная команда ##closeorder,
которую можно передавать после окончания загрузки товаров в заказ для
пересчета суммы заказа и других действий. Для заказа используется
контрагент из предыдущего блока информации ##partner
- ##endpartner Можно использовать
следующие стандартные поля для параметров заказа:
type - тип заказа, 0-приход товаров, 1 – продажа товаров
number – номер заказа, если не задан, то используется текущий номер
date – дата заказа, если не задана, то используется текущая дата
shipdate – дата отгрузки
discount - скидка в %
note - примечание (1 строка)
status - статус заказа
Данные о товаре
Информационный блок начинается со строки
##goods,
а заканчивается ##endgoods.
Можно использовать следующие поля для товара:
name – наименование товара
code – код
group – группа товаров. Если программа поддерживает вложенные группы в виде дерева, то можно указывать полный путь группы с разделителем и 3 символов: " \ "
is_service = 1, если это услуга
vat – ставка НДС
price – розничная отпускная цена товара
unit – единица измерения
country – страна
vendor – производитель товара
article – артикул товара
barcode – штрих код товара, могут быть несколько строк со штрих кодами для одного товара
barcode_pack – штрих код товара упаковки товара
note – примечание однострочное
vendor_code – код производителя
gtd – номер ГТД
weight – вес товара
in_pack – количество единиц в упаковке
expiry - срок годности, дата в формате YMD
param1, param2, ... - дополнительные параметры
image - изображение товара в виде строки в кодировке Base64
stock - остаток на складе
Пункт заказа
Информационный блок начинается со строки
##item,
а заканчивается ##enditem.
Пункты заказа должны идти после блока ##order
с параметрами заказа. Если перед блоком #item
было описание товара, то в заказ будет вставлен
этот товар. Можно использовать следующие поля для пункта заказа:
code – код товара. По этому полю происходит поиск товара. Если это поле отсутствует, то будет использоваться товар из предыдущей секции ##goods.
qty – количество
price – цена с НДС
Поля ниже пока не используются в программе Vvs "Офис – Склад - Магазин":
total - сумма с НДС
total_no_vat – сумма без НДС
price_no_vat – цена без НДС
vat – ставка НДС