Форматы ввода вывода Альта-ГТД: различия между версиями

Материал из Alta-Soft Wikipedia
Перейти к навигации Перейти к поиску
(Выгрузка/Загрузка XML (Альта))
 
Строка 307: Строка 307:
 
Схему XSD для текущего Альта-XML формата можно получить из самой Альта-ГТД при помощи команды меню '''''Настройка|Служебные|Выгрузить XSD-схемы'''''. Это позволяет управлять взаимодействием систем при помощи специальных интеграционных приложений.
 
Схему XSD для текущего Альта-XML формата можно получить из самой Альта-ГТД при помощи команды меню '''''Настройка|Служебные|Выгрузить XSD-схемы'''''. Это позволяет управлять взаимодействием систем при помощи специальных интеграционных приложений.
  
В данный момент файлы в формате Альта-XML, помещенные в подкатлог '''IN\''', будут автоматически загружены Альтой-ГТД.
+
Файлы в формате Альта-XML, помещенные в подкатлог '''IN\''', будут автоматически загружены Альтой-ГТД. Или по кнопке "зелёная стрелка", или полностью автоматически (для этого после сохранения XML надо положить рядом файл IN\eoj.txt).
 +
 
 +
При создании XML-документа можно указать в поле '''DocumentID''' уникальный GUID документа.
 +
Если Опись создаётся вместе с пакетом документов, то можно сделать чтобы они сразу же были привязаны.
 +
Для этого в поле '''ED_ID''' нужно для соответствующей строчки Описи заполнить '''*{00000000-0000-0000-0000-000000000000}\{''' + GUID + '''}.GTD''', а в соседнее поле '''ED_TYP''' - тип документа. Тип документа - это его внутреннее латинское наименование, которое можно посмотреть в меню "Информация о документе...", строчка  '(Тype=...)'.
 +
 
 +
Если Описи нет - те же самые поля '''ED_ID''' и '''ED_TYP''' с привязкой заполняются в дополнении гр.44 ДТ.
  
 
== Выгрузка/Загрузка в DBF-файл ==
 
== Выгрузка/Загрузка в DBF-файл ==

Текущая версия на 16:44, 16 сентября 2015

Форматы файлов ввода/вывода для Альта-ГТД


Выгрузка/Загрузка в АРМ-ТИ (DBF)

Традиционная выгрузка в таможенном формате в виде набора файлов DBF (DBase IV). Применялась в таможне вплоть до 2008 года. Формат задокументирован на сайте ГНИФЦ ФТС РФ http://edpc.customs.ru/edpc/document/

Выгрузка: Каталог|Выгрузка в АРМ nn.nn.nn от nn.nn.nn (DBF)

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

Загрузка: Каталог|Загрузка из АРМ-ТИ|DBF(...)

Выгрузка/Загрузка в АРМ-ТИ (XML)

Выгрузка в таможенном формате в виде XML файла. Применяется с 2008 года. Формат открытый и задокументирован на сайте ГНИФЦ ФТС РФ http://edpc.customs.ru/edpc/document/

Выгрузка: Каталог|Выгрузка в АРМ nn.nn.nn от nn.nn.nn (XML)

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

Загрузка: Каталог|Загрузка из АРМ-ТИ|XML(...)

Печать в офисные приложения

Основная статья: Печать в офис

Программы Альта (ГТД, Такса) поддерживают печать (выгрузку данных) в специально подготовленные шаблоны в форматах TXT, DOC и XLS (Microsoft Office), ODT и ODS (OpenOffice). Печать осуществляется при помощи OLE-серверов внедренных в офисы, т.о. требуется их обязательная установка на компьютер пользователя.

1. Механизм выгрузки данных в офисное приложение
Выгрузка данных в офисное приложение осуществляется при помощи шаблона. Шаблон – это документ офисного приложения, в котором оформляется для печати соответствующий электронный документ программы ГТД-PRO. Причем если неизменяемая часть электронного документа (названия полей, комментарии и т.п.) записывается в шаблон непосредственно, то изменяемая часть – введенные в поля значения – представляется в виде специальных символьных последовательностей – идентификаторов полей. Таким образом, при выполнении выгрузки Альта-программа открывает шаблон в офисном приложении, находит в тексте шаблона идентификаторы полей Альта-Документа и заменяет их соответствующими значениями. Замена идентификаторов на данные из электронного документа производится методами самого офиса (как если бы пользователь вручную вызвал в офисном приложении команду замены одних строк на другие), поэтому при печати полностью сохраняется исходное форматирование шаблона, которое, следовательно, может быть сколь угодно сложным. Полный перечень идентификаторов, предназначенных для использования в шаблонах, содержится в файле alta\data\gtdwin.dcf (файл можно открыть в любом текстовом редакторе). Идентификатор текущего (выделенного в данный момент) поля отображается в статусной строке окна программы (в правом нижнем углу).

2. Правила составления идентификаторов
Отличительная особенность идентификаторов: все они начинаются с двойного знака процента – %%. Идентификаторы могут быть расположены в любом месте документа, но должны отделяться от остального текста пробелами. Идентификаторы могут содержать только латинские буквы в верхнем регистре, цифры, а также знаки: % _ & \ [ ] ( ) @.

Далее приводится синтаксис идентификаторов, используемых в шаблонах:

%%<ИМЯ_ПОЛЯ> - вставка значения указанного поля.

 %%7_1  Вставить значение поля 7_1 (регистрационный номер ГТД)

%%START[<ИМЯ_БЛОКА>] - начало повторяющегося блока;
%%END[<ИМЯ_БЛОКА>] - конец повторяющегося блока
Эти идентификаторы используются для печати информации о товарах или дополнений документов, например

 %%START[BLOCK]%%31.NAME%%END[BLOCK]

позволит вставить в документ список товаров из поля ГТД «31. Грузовые места и описание товаров».
Этот фрагмент шаблона размножается столько раз, сколько записей находится в ИМЯ_БЛОКА. Это или количество товаров или количество строк дополнения. Каждый из размноженных блоков заполняется данными полей соответствующего товара (дополнения). Такой подход позволяет создавать шаблоны печати практически любого вида. %%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара.
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы

%%STARTSUB[<ИМЯ_БЛОКА>] - начало повторяющегося вложенного блока
%%STARTSUB[<ИМЯ_БЛОКА>] - конец повторяющегося вложенного блока

Имя поля в идентификаторах в этом случае предваряется именем основного блока и именем вложенного блока через «\»

 %%START[BLOCK]        Начало основного блока (графа 31 ГТД)
    %%STARTSUB[TXT]    Начало вложенного блока (дополнительное описание товара, текст к гр. 31 ГТД)
      %%BLOCK\TXT\TEXT Собственно, сам текст
    %%ENDSUB[TXT]      Конец вложенного блока
 %%END[BLOCK]          Конец основного блока

Иногда возникает необходимость при печати в шаблоны получать информацию, не доступную в явном виде в документе Альта-ГТД. Например требуется получить наименование страны, зная при этом ее цифровой код. Для этого используется идентификатор %%REF[<СПР>,<ПОЛЕ1>,<ИМЯ_ПОЛЯ>,<ПОЛЕ2>] , где <CПР> - имя файла справочника, <ПОЛЕ1> - название поля в справочнике, по которому ищем информацию, <ИМЯ_ПОЛЯ> - поле документа, откуда извлекается информация, <ПОЛЕ2> - название поля с возвращаемым значением.

 %%REF(COUNTRS,CODE,34_1,NAME17)   Возьмем значение из графы 34 ГТД (код страны происхождения), и используя его найдем наименование страны.

Другие специальные идентификаторы:
%%31.NAMEONLY – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания;
%%31ВСЕГОШТ – извлекает из графы 31 с основного листа ГТД число N из выражения вида «(ВСЕГО N ШТ)»;
%%SUM(<имя_поля>) – вычисляет сумму значений указанного поля. Например, по идентификатору %%SUM(42_1) будет выведена общая стоимость товаров (поле 42_1 – цена товара). Кроме того с помощью идентификатора %%SUM можно извлечь сумму значений поля вложенного блока, например %%SUM(BLOCK\TOVG\KOLVO) извлекает из вложенного блока TOVG общее количество товаров в группах для текущего товара (используется внутри %%START[BLOCK] %%END[BLOCK]);
%%TOVG(<имя_поля>) – извлечет из дополнения «Описание и характеристика товаров» все значения для указанного поля через запятую (используется внутри %%START[BLOCK] %%END[BLOCK]);
%%NEW_PAGE - разрыв страницы;
%%RATE(<код_валюты>) – получает курс валюты по её коду. В качестве передаваемого параметра можно использовать непосредственно код валюты (например USD), а можно использовать ссылку на идентификатор, содержащий этот код, например:

 %%RATE(BLOCK\DOG\PRVAL)

%%BLOCKNUM – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]);
%%BLOCKCOUNT – выводится количество товаров в документе;
%%TNVEDTEXT – выводится описание кода ТНВЭД для текущего выгружаемого товара;
%%PRICESCOLOR – если в документе поле «цены» (PRICES) подсвечено красным цветом, то при выгрузке в Excel ячейка с ценой также будет закрашена красным (используется вместо %%PRICES).

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

 %%INV.42_ZAEDINIC 

выведет значение поля «стоимость за единицу» из связанного с ГТД инвойса.

Еще один тип идентификаторов – предваряемый символами %%@ Они используется для граф 44 и 47 ГТД. Используется для частичной выгрузки поля. Кулуарное название "поля с плюшкой". Синтаксис можно посмотреть в статье GetOldField

Синтаксис следующий:
- %%@47_код вида платежа_номер столбика. Например:

 %%@47_5010_3 – выгрузит ставку НДС,
 %%@47_5010_4 – выгрузит сумму НДС,
 %%@47_5010_4_V выгрузит сумму НДС, но в валюте по курсу из гр.23_1;

- %%@44_код строки.код подстроки_код документа_дополнительные параметры. Примеры использования:

 %%@44_!_6* – выгрузятся все с кодом начинающимся на 6
 %%@44_!_06011 – номер и дату Сертификата с кодом 06011
 %%@44_!_06011_ДО – номер, дату "от" и дату "до" 
 %%@44_!_06011_nodate – выгружает номер без дат
 %%@44_!_06011_date - только дату "от"
 %%@44_!_04021 - номер и дату инвойса
 %%@44_!_04021_date - только дату инвойса

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


To-Do:

про простой TXT про XML(HTML) примеры шаблонов

Выгрузка в SQL при помощи утилиты Docs2SQL

Документы в Альта-ГТД исторически хранятся в файловом внутреннем формате. Из-за этого доступ к данным документов, построения произвольных отчетов, сбор статистики и пр. для пользователя не возможен. Для обеспечения доступа к данным зарегистрированных в Альта-ГТД документов была реализована возможность выгрузки документов в SQL-базу. Для базы данных выбран приемный формат АРМ-ТИ (DBF файлы). Перенос данных в SQL базу осуществляется утилитой Docs2SQL. База данных документов может размещаться либо на сервере Microsoft SQL Server 200x, либо в файле Microsoft Access 2000/XP/2003 (*.mdb).

Принцип работы.

Программа запускается вместе с системой (может работать в виде сервиса Windows NT) или вручную, и затем работает в фоновом режиме, ожидая появления в назначенной ей папке новых документов для выгрузки. Документы в эту папку выгружает "Альта-ГТД" при регистрации документа (меню Список->Регистрация). При обнаружении новых документов происходит выгрузка их в базу данных. При этом, создаются или модифицируются таблицы, необходимые для размещения документов, и если не найдена сама база данных, указанная в Настройках, предпринимается попытка создать ее. При повторной выгрузке документа, т.е. когда в базе обнаруживается документ с таким же номером, он удаляется и выгружается заново. Кроме того, если в Настройках установлена галочка "Удалять разрегистрированные документы", то при разрегистрации документа, т.е. снятии признака "зарегистрирован", он удаляется из базы данных вместе со своими резервными копиями.

Все выполняемые программой действия записываются в Журнал.

В программе предусмотрена функция просмотра накопленной базы документов ГТД и восстановления соответствующих им файлов во внутреннем формате программы "Альта-ГТД".

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

Загрузка файла обмена Заполнителя

Передача данных из заполнителя в программы экспорта производится посредством создания файла обмена в папке \IN\ рабочего каталога экспортной программы. Затем программа экспорта по команде от Заполнителя конвертирует этот файл в документ в своем внутреннем формате. В частности, "Альта-ГТД" создает документы, "Такса" наполняет список и т.д. После обработки файл удаляется. Поименование файлов идет по инкрементному принципу imp000.ini, imp001.ini, imp002.ini, .... При автоматическом вызове программы используется последний файл.

Пользователи программ Альта-Софт могут самостоятельно, при условии владения соответствующими навыками, наладить создание файлов обмена непосредственно из своих корпоративных информационных систем (КИС), таких как "1С", "Парус", "R3" и др. Таким образом, генерируя готовый файл обмена в папке \IN\ програм экспорта (ГТД,Такса) можно избежать использования Заполнителя и значительно ускорить процесс создания таможенных документов.

Файл обмена представляет из себя текстовый файл в кодировке Winows (cp1251, строки разделяются символами #13#10) со структурой INI-файла. Т.е. данные в файле организованы в виде секций, содержащих параметры со значениями:

   [Секция1] 
   Параметр1=Значение1 
   Параметр2=Значение2 
   
   [Секция2] 
   Параметр1=Значение1 
   Параметр2=Значение2 
   ... 


Создание файла обмена для программы Альта ГТД

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

   [Common] 
   IncludedDoc=ИМЯДОКУМЕНТА\ИМЯГЛАВНОГОБЛОКА 

,где

ИМЯДОКУМЕНТА - внутреннее краткое англоязычное наименование импортируемого документа; ИМЯГЛАВНОГОБЛОКА - внутреннее англоязычное название главного блока импортируемого документа.

Названия документов программы Альта ГТД для Windows можно посмотреть в файле \DATA\gtdwin.dcf, расположенном в рабочем каталоге программы Альта-ГТД. Это параметры DocFileExt= и MainBlock= из секций документов. Например, для документа инвойс секция [Common] имеет вид:

   [Common] 
   IncludedDoc=INV\block 

Вторая секция является необязательной и называется [ИМЯДОКУМЕНТА\ИМЯГЛАВНОГОБЛОКА.Header] В ней перечисляются данные для заголовка создаваемого документа, такие как реквизиты отправителя, получателя, номер документа и пр. Данные передаются в формате: ИМЯПОЛЯ=ДАННЫЕ ДЛЯ ПОЛЯ Где: ИМЯПОЛЯ - латинский идентификатор поля документа в программе Альта ГТД. ДАННЫЕ ДЛЯ ПОЛЯ - собственно данные для заполняемой графы.

Узнать идентификатор можно несколькими способами. Например, если в программе Альта ГТД поставить курсор в нужное поле, то его идентификатор отображается в правом нижнем углу статусной строки. Список всех идентификаторов полей хранится в том же файле \DATA\gtdwin.dcf в секции [ИМЯДОКУМЕНТА.Fields] в строках сразу после начала секции. Пример второй секции для документа Инвойс:

   [INV\BLOCK.HEADER] 
   INV_NUM=026/15 
   INV_DATE=13.11.02 

При обработке такого файла в заголовке инвойса заполнятся 2 поля: номер инвойса и дата инвойса. Третья и последующие секции называются [ИМЯДОКУМЕНТА\ИМЯГЛАВНОГОБЛОКА.BlockНОМЕРБЛОКА] ,где НОМЕРБЛОКА - это порядковый номер товара в документе, начиная с 0.

Эти секции содержат данные для полей товара создаваемого документа в формате ИМЯПОЛЯ=ДАННЫЕ ДЛЯ ПОЛЯ. ИМЯПОЛЯ можно найти в файле \DATA\gtdwin.dcf в секции [ИМЯДОКУМЕНТА.Fields] внутри после строки, содержащей ИМЯГЛАВНОГОБЛОКА{&&NUM. Ниже приведен фрагмент \DATA\gtdwin.dcf для документа инвойс:

   [INV.Fields] 
   INV_NUM= 15 |Номер документа
   INV_DATE= 10 |Дата документа 
   .... 
   G44S= 16 |9.2-Nтов.в реестре 
   G44DD= 10 |Дата предст. недост.док. 
   BLOCK{&&NUM 
   7_NUM= 10 |Номер декларации, в которую будет экспортирован товар 
   32_NUM= 10 |Номер товара в создаваемой декларации 
   32_ID= 14 |Идентификационный номер товара 
   31_ARTICUL= 24 |Артикул товара 
   ...... 
   } 
   ... 

Поля, окрашенные красным, относятся к загловку инвойса, синие поля, вложенные в BLOCK{...}, относятся к товару инвойса.


Пример секций товаров для документа инвойс:

   [INV\block.Block0] 
   31_ARTICUL=GHS323 
   
   [INV\block.Block1] 
   31_ARTICUL=AA1555 

При обработке такого файла, в документе инвойс будет создано 2 товара с заполненными полями Артикул. Количество последующих секций, т.е. товаров, не ограничено, но товары с номером большим, чем MaxExtraBlocks= из \DATA\gtdwin.dcf из секции [ИМЯДОКУМЕНТА.Header] не будут обработаны. Для документов программы Альта ГТД помимо заголовка и данных товара, можно передавать данные для оборотных сторон. Синтаксис секций для обороток идентичен секциям, заполняющим данные о товаре. Один файл обмена может содержать несколько оборотных сторон для одного документа.


Пример файла обмена для создания документа ГТД с оборотной стороной Контейнеры и Транспортные средства - файл imp050.ini

   [Common] 
   IncludedDoc=GTD\block,GTD\Block\Kont,GTD\DKD 
   
   [GTD\block.Header] 
   1_1=ИМ 
   1_2=40 
   
   [GTD\block.Block0] 
   31_NAME=ПЫЛЕСОС 
   33_1=8509101000 
   42_1=20 
   38_1=5 
   31=1- ПЫЛЕСОС КИТАЙ 
   
   [GTD\block.Block1] 
   31_NAME=ГВОЗДОДЕР 
   33_1=8205599090 
   42_1=5.5 
   38_1=.25 
   31_COUNTRY=КИТАЙ 
   31=1- ГВОЗДОДЕР КИТАЙ 
   
   [GTD\Block\Kont.Block0] 
   BLOCK=1 
   CONT=КОНТ111 
   
   [GTD\Block\Kont.Block1] 
   BLOCK=2 
   CONT=КОНТ222 
   
   [GTD\DKD.Block0] 
   NGR=18 
   NTRANS=Е247ОН77 
   VIDTRANS=20 
   G212=643 
   
   [GTD\DKD.Block1] 
   NGR=18 
   NTRANS=А456ВА99 
   VIDTRANS=20 
   G212=643 
   

Данные для сложных граф типа 18, 22, 44, имеющие оборотные стороны, целесообразно переносить сначала на оборотные стороны при помощи файла обмена, а затем, используя специальные диалоги программы Альта ГТД, формировать графы на основном листе. В принципе, ничто не мешает создать непосредственно 44 или 18, но использование диалога гарантирует простановку СМ.ДОП., объединение однотипных документов в 44 и пр.

Выгрузка/Загрузка в формате Альта-Windows

В файловом режиме документы Альта-ГТД хранятся в двоичных файлах внутреннего формата. Имя файла совпадает с KeyField документа, описанного в Gtdwin.dcf (фактически - номер документа), расширение файла - внутреннее имя типа документа. Имя, как правило, состоит из трех букв латинского алфавита и созвучно с аббревиатурой документа, например: ГТД - *.gtd, ДТС-1 - *.ds1, Опись - *.opn и т.д.

Расположены файлы документов в подкаталоге \DOCSWIN\ (по умолчанию), который формирует структуру списка документов. Каталог с документами может быть изменен пользователем в меню Настройка|Каталоги|Каталог документов.

Не для клиентов!
Непосредственное редактирование файлов в формате Альта-Windows невозможно, хотя известны отдельные случаи безвозмездного получения
клиентами фрагментов исходного кода для работа с данным форматом и организации интеграции с клиентскими КИС силами собственных IT   
отделов. Однако в виду перманентно меняющего формата этих файлов, данные решения не являются гибкими. Поэтому выгрузка/загрузка в 
формате Альта-Windows в основном используется для передачи документов между рабочими местами.

Выгрузка: Каталог|Выгрузка в формате Альта-Windows При выгрузке будет предложено скопировать и взаимосвязанные документы (при их наличии), т.е. выгрузится несколько файлов. Имена файлов будут одинаковыми (номер ГТД), а расширения соответсвенно их типу (см.выше).

Загрузка: Каталог|Загрузка из формата Альта-Windows При загрузке будет предложено затянуть и взаимосвязанные документы (при их наличии).

По сути "Выгрузка/Загрузка" это простое копирование файлов из \DOCSWIN\ одной программы в \DOCSWIN\ другой, плюс контроль переноса взаимосвязанных документов. Идеальный способ для обмена декларациями и другими документами между рабочими местами.

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

Выгрузка/Загрузка XML (Альта)

На данный момент самый прогрессивный формат обмена данных. Рекомендуется для организации двухстороннего документообмена между корпоративными системами и Альта ГТД. При выгрузке формируется XML файл, несущий в себе все данные внутреннего формата Альта ГТД. Структура XML строится на базе внутреннего DCF-устройства документа, таким образом исключается возможность переформатирования или сокращение данных.

Выгрузка: Каталог|Выгрузка/Загрузка дополнительная|Выгрузка в XML (Альта)

Загрузка: Каталог|Выгрузка/Загрузка дополнительная|Загрузка из XML (Альта)

Схему XSD для текущего Альта-XML формата можно получить из самой Альта-ГТД при помощи команды меню Настройка|Служебные|Выгрузить XSD-схемы. Это позволяет управлять взаимодействием систем при помощи специальных интеграционных приложений.

Файлы в формате Альта-XML, помещенные в подкатлог IN\, будут автоматически загружены Альтой-ГТД. Или по кнопке "зелёная стрелка", или полностью автоматически (для этого после сохранения XML надо положить рядом файл IN\eoj.txt).

При создании XML-документа можно указать в поле DocumentID уникальный GUID документа. Если Опись создаётся вместе с пакетом документов, то можно сделать чтобы они сразу же были привязаны. Для этого в поле ED_ID нужно для соответствующей строчки Описи заполнить *{00000000-0000-0000-0000-000000000000}\{ + GUID + }.GTD, а в соседнее поле ED_TYP - тип документа. Тип документа - это его внутреннее латинское наименование, которое можно посмотреть в меню "Информация о документе...", строчка '(Тype=...)'.

Если Описи нет - те же самые поля ED_ID и ED_TYP с привязкой заполняются в дополнении гр.44 ДТ.

Выгрузка/Загрузка в DBF-файл

В результате выгрузки получается DBF файл ориентировочно формата DBase IV. Выгружаются только данные заголовка документа и его основного блока. Информация с дополнений не переносится! Документ выгруженный и загруженный обратно теряет все кроме заголовка и непосредственно товаров.

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

Получаемый файл может сильно не соответствовать спецификации DBase IV. Впереди идентификаторов полей ставится префикс G_. Длинна названий полей может превышать допустимые 30, т.к. формат DCF допускает более длинные названия. Многострочные поля документа записываются как несколько полей с одинаковыми названиями. Количество полей может превышать 255 (зависит от DCF структуры документа). Из-за этого полученный dbf-файл может не открываться в большинстве редакторов.

Однако для решения простых задач, например получение в 1С платежей из ГТД, этот формат вполне подходит.

Набор выгружаемых полей может быть ограничен при помощи EXP файла DATA\dbf.exp.

Формат EXP следующий:

[GTD]
ExpFields=2,44,7_1,54_20,33_1,31_1,31_2,31_3...
SkipFields=8
[INV]
ExpFields=2_NAME,KONTRAKT,INV_NUM,32_REALNUM,...

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

Выгрузка/Загрузка в TXT

Устаревший формат не рекомендуемый к использованию. Выгружаются только данные заголовка документа и его основного блока. Информация с дополнений не переносится! В результате выгрузки получается файл в DOS-кодировке следующей структуры:

Имя докумета и метка начала

 GTD
 =>

Далее поля заголовка

 &&NUM = 10121080/140808/0000147
 1_1 = ИМ
 1_2 = 4
 2 = "МИЦУБИСИ ИНТЕРНЕШНЛ ГМБХ"\65439 ШИФЕРШТАЙН 11В, ФЛЁРСХАЙМ, ГЕРМАНИЯ, DE
 2_7 = DE
 ...

Метка начала, имя главного блока, его номер. Далее поля главного блока

 =>\BLOCK\1
 31 = 1-АВТОМОБИЛИ МАРКА: ELANTRA 1.6 GLS ...
 31_8 = 1
 32_1 = 1
 33_1 = 8703231910
 ....
 

Метка завершения, блока начала следующего и т.д.

 <=\BLOCK\1
 =>\BLOCK\2
 31 = 1-АВТОМОБИЛИ МАРКА: GETZ GL 1.4 ...
 31_8 = 1

После N-го товара, идут остальные поля шапки и метка завершения

 <=\BLOCK\N
 42_2 = 21310.29
 54_1 = 713-87-81
 54_20 = 14.08.2008
 ...
 <=

Выгрузка/Загрузка Инвойс/ДО из Альта-СВХ

Перенос данных из MDB базы Альта-СВХ в Альта-ГТД производится специальным приложением INVSVH.EXE. Помощь к этой утилите сообщает: Утилита предназначена для выгрузки документов из программы "Склад временного хранения" ("Альта-СВХ") в программу "Грузовая таможенная декларация" (ГТД).

Вероятно приложение извлекает из MDB информацию о документах и в формате Заполнителя передает их в Альта ГТД.

Вызов Выгрузка: Каталог|Выгрузка/Загрузка дополнительная|Выгрузка в XML (Альта)

Загрузка из SCP/SCW (ИКЕА)

Формат загрузки из текстовых файлов-скриптов. Является первым вариантом организации автоматизированного получения информации из внешней программы. На смену скриптам пришел INI формат, получаемый из заполнителя.

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


В данный момент загрузка реализована только для заголовков и товаров документов ГТД и ДТС. Пример скрипта:

19.08.08 13:39:17 [SK930AI/SK421YB; FCA Верона]
Picture КВЕЛЛЕ.GTD
{
18=SK930AI/SK421YB
21=SK930AI
20_20=FCA
20_21=Верона
22_1=978
23_1=23.2322
54_20=19.08.08
}
{
34_1=IT
33_1=8302100009
43_1=1
43_2=0
45_2=1
35_1=1938
38_1=1837
42_1=339897.60
45_1=789711
46_1=29114
31=1-Шарниры мебельные из недрагоценных металлов: АРТ. ....
31_8=4480
41_2=
41_1=
44=2-2015 SK2253763#2.2-2024 JX56346073....
}
Revise 33_1
NewBlock
{
34_1=IT
33_1=9403609009
43_1=1
....

Создание ДТС в этом же файле

NEWDTS
{
S_3_1=FCA Верона
S_4=CH783390 от 09.01.08, CH783395 от 10.01.08
}
{
S_NTOV=1
S_KTOV=8302100009
S_11A_1=0
...
}
NewBlock
{
S_NTOV=2
S_KTOV=9403609009
S_11A_1=0
...
}
NewBlock
{
S_NTOV=3
...
}
Block 0
{
S_10A_1=0
}

Несмотря на более широкие возможности скрипта, предпочтительней использовать файл INI от Заполнителя, как более задокументированный.

Выгрузка платежей из Инвойса в DBF

Как правило, платежи реальной ГТД распределенные по инвойсу интересуют пользователей с целью их автоматической загрузки в бухгалтерские программы. Для этого существует возможность выгрузки инвойса в файл формата DBF. Файл должен содержать поля с именами совпадающими с идентификаторами полей Инвойса, т.е. помимо платежей можно выгрузить любую информацию необходимую для ее идентификации в бухгалтерской системе. Образец такого файла можно посмотреть фирменном диске с дистрибутивами в архиве articul.cab, файл GtdOut.dbf.

При регистрации ГТД (кнопка с синей печатью в списке ГТД), если она была получена из Инвойса, происходит попытка выгрузки платежей ГТД в родительский инвойс. Соответствие товара ГТД к группе позиций Инвойса происходит по полям "Код ТНВЭД" (33_1) и "Номер товара в создаваемой ГТД" (PARENT_POS в ГТД и 32_NUM в инвойсе), т.о. для корректного переноса платежей необходимо:

  1. Количество товаров и позиций в документах не менялось
  2. Инвойс не перегруппировывался
  3. Не менялись коды ТНВЭД

Распределение платежей товара ГТД по отдельным позициям происходит пропорционально стоимости позиций. Помимо переноса платежей происходит копирование некоторых полей (номер ГТД, курсы и пр.) определенных в WInvInfo.dat

[GetFromGTDHeadToINVBlock]
GTD_5=5_1
32_REALNUM=7_1
GTD_REGDT=REG_DATE
GTD_KURS=23_1
GTD_22_1=22_1 
[GetFromGTDBlockToINVBlock]
32_TOVNUM=32_1

Когда платежи для всех позиций получены, из Инвойса можно выгрузить DBF файл (DBase IV) с нужными полями. Расположение, набор выгружаемых полей, автоматическое создание файла и пр. параметры задаются в Настройка|Документы|Инвойс на закладке Платежи. Создаваемый DBF может использоваться для импорта платежей в бухгалтерские или корпоративные системы. В частности посредствам его ПК Артикуд забирает платежи из Альта-ГТД.

Выгрузка осуществляется командой Инвойс|Платежи|Выгрузить платежи в файл или автоматически, как только Инвойс получил данных из реальных ГТД для всех своих позиций. Автоматическая выгрузка включается в окне настроек Инвойса на закладке «Платежи»|группа «Выгрузка платежей». Там же можно настроить запуск какой-нибудь внешней программы пользователя, обрабатывающей выгруженный файл.

Отчет о группировке инвойса

Инвойс может формировать XLS или HTML отчет о группировке позиций. Позиции согласно меткам в полях 7_NUM и 32_NUM выводятся в файл. В настройках отчета можно указать интересующие поля и задать вывод подсумм по группе. Отчет изначально ориентирован на декларантов, только осваивающих Инвойс и по началу не доверяющим автоматической группировке. После сличения нескольких инвойсов сгруппированных вручную и отчетов об автоматической группировке, как правило, декларанты перестают заниматься ерундой и пользуются автоматической группировкой.

Создать отчет: Инвойс|Отчет о группировке товаров

Папка автозагрузки

Часто оказывается удобно не выбирать каждый раз файлы с документами для загрузки из внешних программ, а выделить на локальном или сетевом диске папку обмена "входящие". Имя этой папки прописывается в "Настройка|Внешние программы" на специальной закладке "Автозагрузка". По умолчанию предлагается использовать папку C:\ALTA\IN\.

Gtdin.png

После включения данной настройки программа будет раз в несколько секунд опрашивать данную папку и при наличии в ней файлов отображать на панели инструментов значок "зеленая стрелка". Нажатием на эту кнопку производится загрузка всех документов в текущий каталог рабочей БД.

На данный момент программа умеет автоматически принимать из папки обмена файлы

  • *.XML таможенного формата
  • *.XML внутреннего формата
  • *.GTD двоичного внутреннего формата
  • *.TXT внутреннего формата
  • *.DBF внутреннего формата
  • *.INI в формате заполнителя
  • *.SCW текстовые скрипты, содержащие помимо данных список полей для немедленного по ним пересчета.

Для полностью автоматической загрузки документов без "зеленой кнопки" надо по окончании формирования пакета документов создать в папке автозагрузки файл eoj.txt пустой или с произвольным содержимым.

Для более продвинутой интеграции с КИС вместо папки обмена можно использовать SQL-таблицу ExtDocs

См. также

Интеграция с КИС