Alta-Soft Wikipedia - Вклад участника [ru]

Экспорт данных в офисные приложения

2025-06-03T08:33:18Z

Admin: /* Функции */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

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

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

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

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

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

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

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

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

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

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

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

или

'''%%START'''[BLOCK] ''Начало основного блока (товары ДТ)''
'''%%STARTSUB'''[TOVG] ''Начало вложенного блока (Описание и характеристики товара (Графа 31 ДТ))''
'''%%BLOCK\TOVG\G31_1''' ''Описание группы товаров''
'''%%BLOCK\TOVG\G31_14''' ''Марка''
'''%%BLOCK\TOVG\G31_15''' ''Артикул''
'''%%ENDSUB'''[TOVG] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для объединения ячеек в столбцах (ROWSPAN) ====

Если в столбце дописать ключевое слово '''%%JOIN''', то такой ячейки с одинаковыми значениями в столбце будут объединены.
Например, если шаблон вида

{| class="wikitable"
| %%FID1 || %%FID2
|}

формирует таблицу

{| class="wikitable"
| 1111 || aaaaa
|-
| 1111 || ббббб
|-
| 2222 || ввввв
|-
| 2222 || ггггг
|-
| 2222 || ддддд
|}

то шаблон

{| class="wikitable"
| %%FID1 %%JOIN || %%FID2
|}

cформирует

{| class="wikitable"
| rowspan="2"| 1111 || aaaaa
|-
| ббббб
|-
| rowspan="3"| 2222 || ввввв
|-
| ггггг
|-
| ддддд
|}

Применимо для печати в Excel и OpenOffice Calc.

==== Для очистки строки с вложенным блоком вместо её удаления ====

Если в любом месте главного цикла (START_END) вписать идентификатор '''%%CLEARSUBIFEMPTY''', то строка с вложенным циклом (STARTSUB_ENDSUB) не будет удаляться при пустом вложенном блоке,
а просто очистятся ячейки этого блока. Полезно, когда вложенный блок находится в одной строке с главным блоком. Обычно при пустом вложенном удаляется вся строка, вместе с главным блоком.
С таким идентификатором этого удаления можно избежать.

Применимо для печати в Excel и OpenOffice Calc.

==== Для извлечения из справочников ====

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

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

==== Для извлечений из гр.31 ДТ ====

* '''%%31.NAMEONLY''' – в отличие от %%31.NAME, извлекает из графы 31 только наименование товара без описания; 
* '''%%31.NAMETILLCOLON''' – извлекает из графы 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)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

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

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

* '''%%EXECMACROS(''<ИМЯ_МАКРОСА>'')''' - выполнит макрос, прописанный в шаблоне, после окончания выгрузки. Может находиться в любом месте шаблона.

* '''%%31.PALCOUNT''' - количество паллет.

* '''%%31.PAKTYPE''' - тип упаковки.

* '''%%FORMULA([35_1]+[38_1])''' - выполнить операцию над полями (сложение, умножение, контекация строк и т.д.). Названия полей должны быть выделены скобками.

==== Обработка по условию ====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

* '''%%COPY(''<ИМЯ_ПОЛЯ>'', ''X'', ''Y'')''' - копировать часть данных из поля

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

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

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

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

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

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

Примеры использования дополнительных параметров

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_06011_LASTDATE''' - только дата ДО,
'''%%@44_!_06011_CODE''' - только код типа документа,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код
'''%%@44_!_04021_TEXT''' - полный текст документа со всеми ключевыми полями, как на лицевой графе 44, кроме кода. Обычно номер и дата.
'''%%@44_!_04021_SIGN''' - только признак предоставления документа
'''%%@44_!_04021_PRIOR''' - только номер предшествующей ДТ
'''%%@44_!_04021_COUNT''' - количество документов в товаре с данным кодом
'''%%@44_!_04021_FORMULA(G444+G442+"ОТ"+G443)''' - выгрузится согласно формуле

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

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

С 2015 года так же допускается упрощенный синтаксис без _!_ в середине идентификатора.

'''%%@44_04021_TEXT'''
'''%%@44_01402_NODATE'''

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

'''%%@44_014??_NODATE''' - соберет через запятую номера документов с кодами 01401, 01402, 01403 и до 01499

Если при помощи символов ? не удается закодировать маску для документов, то можно использовать символ & и указать несколько кодов документов

'''%%@44_01191&01402_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01402
'''%%@44_01191&0140?_NODATE''' - соберет через запятую номера документов с кодами 01191 и 01401, 01402, 01403 ... до 01409

==== Для графы 47 и B документа ДТ ====

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

'''%%@47_5010_3''' – выгрузит ставку НДС,
'''%%@47_5010_4''' – выгрузит сумму НДС,
'''%%@47_5010U_4''' - выгрузит сумму НДС, включая условно начисленные платежи,
'''%%@47_5010_4_V''' выгрузит сумму НДС, но в валюте по курсу из гр.23_1,
'''%%@47_0_4''' – выгрузит сумму всех платежей,
'''%%@47_0U_4''' – выгрузит сумму всех платежей, включая условно начисленные;

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.
'''%%@B_1010_Doc''' – выгрузится номер и дата платежного документа по коду 1010.
'''%%@B_1010_DocNum''' – выгрузится номер платежного документа по коду 1010.
'''%%@B_0''' – выгрузится сумма всех платежей.
'''%%@B_0_Doc''' – выгрузятся номер и дата платежных документов по всем кодам.
'''%%@B_0_DocNum''' – выгрузятся номера платежных документов по всем кодам.
'''%%@B_0_Text''' – выгрузится вся строка, кроме ИНН\КПП.

==== Для получения информации из SQL таблиц по ДТ и процедуре ====

* '''%%PROCESSID''' - ID ЭД-процедуры.
* '''%%EDSTAT''' - ЭД-статус ДТ в текстовом виде.
* '''%%EDSENDDATE''' - Дата подачи ДТ.
* '''%%EDSENDTIME''' - Время подачи ДТ.
* '''%%EDREGISTERDATE''' - Дата регистрации ДТ.
* '''%%EDREGISTERTIME''' - Время регистрации ДТ.
* '''%%EDLASTDATE''' - Дата выпуска ДТ.
* '''%%EDLASTTIME''' - Время выпуска ДТ.
* '''%%EDDATEBYCMN()''' - Дата произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDDATEBYCMN(CMN.11001) - дата регистрации ДТ
* '''%%EDTIMEBYCMN()''' - Время произвольного ЭД-сообщения по ДТ, по типу этого сообщения. Например %%EDTIMEBYCMN(CMN.11001) - время регистрации ДТ

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

API Слежение (для Груз на СВХ)

2025-03-12T14:35:09Z

Admin:

== О сервисе Слежение ==
Сервис "Слежение" для "Груз на СВХ" <nowiki>https://www.alta.ru/svh-gruz/tracking/</nowiki> позволяет ставить контейнеры и авианакладные на слежение с получением результатов размещения на складе и таможенного оформления грузов в контейнере через личный кабинет.

Отправляет уведомления на почту и URL-адрес по webhook о появлении новой информации по указанным контейнерам. Ставить и снимать контейнеры со слежения можно как через личный кабинет так и по API. Почта, URL-адрес для уведомлений и события для уведомления настраиваются только через личный кабинет.

== API ==
Доступ к API предоставляется по URL <nowiki>https://www.alta.ru/svh-gruz/tracking/api/v1/</nowiki>. Для использования сервиса необходима авторизация с помощью логина и пароля.

Логин и пароль для обращения по API необходимо получить в личном кабинете <nowiki>https://www.alta.ru/user/</nowiki>, заключив договор на использование онлайн-сервисов. В настройках договора будут указаны технический логин и пароль.

Тарификация производится так же как при постановке на слежение через личный кабинет.

API позволяет ставить, снимать со слежения и просматривать списки контейнеров и авианакладных находящихся на слежении. Уведомления об обнаружении новой информации приходят на указанные почтовые ящики в кабинете слежения <nowiki>https://www.alta.ru/svh-gruz/tracking/</nowiki>

=== Формирование URL запроса ===
Запросы направляются на URL <nowiki>https://www.alta.ru/svh-gruz/tracking/api/v1/</nowiki><МЕТОД>/
{| class="wikitable"
|Метод
|Тип запроса
|Описание
|-
|help
|GET
|Вызывает справку - выдает доступные методы API и списки передаваемых параметров
|-
|test
|GET
|Проверка работы API и правильности формирования запроса - выдает результат проверки правильности секрета, правильную строку для расчета секрета и логин (если отправлен верный секрет)
|-
|info
|GET
|Информация об аккаунте и настройках слежения
|-
|set
|POST
|Постановка контейнеров на слежение, POST-параметр data=<номера контейнеров / авианакладных через запятую “,”>
|-
|del
|POST
|Снятие контейнеров со слежения, POST-параметр ids=<id контейнеров / авианакладных через запятую “,”> или data=<имена контейнеров / авианакладных через запятую “,”> (id контейнера приходит при постановке на слежение)
|-
|list
|GET
|Просмотр статуса всех отслеживаемых контейнеров. Через этот метод можно узнать id контейнеров находящихся на слежении. Можно указать нужные контейнеры: ids=<id контейнеров через запятую “,”> или data=<имена контейнеров через запятую “,”>
|}
обязательные GET параметры в URL

# логин ― логин сервис аккаунта в открытом виде
# секрет ― MD5-хеш от сгенерированной строки (все параметры разделены знаком “:” (двоеточие)): параметры_GET + параметры_POST + метод + логин + md5(пароль)

Формирование секрета

secret = md5("{параметры_GET}:{параметры_POST}:{метод}:{логин}:{md5(пароль)}")

параметры_GET ― это значения прочих get параметров помимо логина, секрета и метода, разделенные “:”

параметры_POST ― это значения post параметров для методов set и del, разделенные “:”

Пример расчёта секрета для метода del, логина testlogin и пароля testpassword:

Если дополнительный GET параметр foo = bar , то для расчета секрета надо использовать параметры_GET = “bar”

Для метода del надо указывать id номера контейнеров в POST параметре ids через запятую. Если ids=11,55,33 , то для расчета секрета параметры_POST = “11,55,33”

Итоговая строка секрета = md5("bar:11,55,33:del:testlogin:md5(testpassword)")

Пример запроса списка контейнеров:

Метод list, пользователь с логином testlogin и пароль testpassword

Прочие параметры_GET - отсутствуют, параметры_POST отсутствуют, так как это GET метод

Вычисляем секрет: secret = md5("пусто:пусто:list:testlogin:md5(testpassword)") = md5("::list:testlogin:md5(testpassword)") = 18a3a18768475d5fbaf244f291212e86

Таким образом, итоговый URL, на который совершается GET-запрос: <nowiki>https://www.alta.ru/svh-gruz/tracking/api/v1/list/?login=testlogin&secret=18a3a18768475d5fbaf244f291212e86</nowiki>

=== Ответ ===

<big>Метод</big> '''<big>List</big>'''
Описание полей возвращаемых данных
{| class="wikitable"
|data
|[]
|Корневой элемент, содержит массив записей слежения *
|-
|id
|int
|Идентификатор записи слежения
|-
|created
|str
|Дата постановки на слежение 3
|-
|updated
|str
|Дата последнего обновления информации сервисом
|-
|num
|str
|Номер контейнера или авианакладной
|-
|type
|str
|Тип слежения: К - контейнер, А - авианакладная
|-
|status
|str
|Статус слежения 1
|-
|do1
|int
|Количество записей ДО1 по контейнеру
|-
|cmn13014
|int
|Количество сообщений 13014 по контейнеру
|-
|infoDateMax
|str
|Дата последних полученных данных по контейнеру
|}
<nowiki>*</nowiki> максимальный размер возвращаемых данных 9900 записей

1 Статусы слежения:
{| class="wikitable"
|new
|Новый, запись только что добавлена
|-
|process
|В процессе обработки, проходят проверки
|-
|old
|В процессе обработки, имеется старая информация, старше чем указано в настройках ЛК в параметре Уведомлять о старой информации 2
|-
|busy
|Занят, происходит запись информации
|-
|arh
|Контейнер перенесен в архив (удален), автоматически помещается в архив если статус old более 90 дней
|}

2 Уведомлять о старой информации ― Параметр включает уведомления по событиям слежения с даты ранее даты постановки на слежение created 3

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

<big>Пример ответа:</big>

Код ответа 200:

{

"data": [

{

"id": 12,

"created": "2023-01-19 12:03:45",

"updated": "2023-04-11 18:11:06",

"num": "XXXX1018593",

"status": "process",

"do1": 0,

"cmn13014": 0,

"infoDateMax": null,

},

...

]

}

<big>Метод</big> '''<big>Set</big>'''

POST данные: data=TEST0000001,TEST0000002

Описание полей возвращаемых данных
{| class="wikitable"
|success
|bool
|true ― успешный запрос
|-
|add
|[]
|Массив успешно добавленных контейнеров
|-
|no
|[]
|Массив контейнеров, которые не добавлены. Каждый элемент содержит массив, состоящий из номера контейнера и статуса
|}

<big>Пример ответа:</big>

{

"add": ["TEST0000001"],

"success": true,

"no": [

[ "TEST0000002", "Новый" ]

]

}

<big>Метод</big> '''<big>Del</big>'''
аналогичен методу set

POST данные: data=TEST0000001,TEST0000002

Описание полей возвращаемых данных
{| class="wikitable"
|success
|bool
|true ― успешный запрос
|}

<big>Пример ответа:</big>

{

"success": true

}

<big>Метод</big> '''<big>Info</big>'''
Описание полей возвращаемых данных

{| class="wikitable"
|success
|bol
|true ― успешный запрос
|-
|data
|[]
|Массив, содержащий настройки аккаунта
|-
|notifyEmail
|bool
|1 ― включены уведомления на email
|-
|notifyOneMail
|bool
|1 ― отдельное письмо для каждого результата. Если в течении минуты пришло несколько контейнеров, то при значении "0" они будут объединены в одно письмо
|-
|notifyTG
|bool
|1 ― включены уведомления в телеграмм
|-
|notifyWebhook
|bool
|1 ― включены уведомления webhook
|-
|webhook
|str
|URL-адрес webhook
|-
|tgId
|int
|ID привязанного телеграмм аккаунта
|-
|sa_balance
|float
|Баланс сервис аккаунта
|-
|service_price
|float
|Цена за уведомление
|-
|freezing
|float
|Заморожено средств
|-
|addArh
|bool
|Разрешено добавлять архивные
|-
|sa_login
|str
|Логин выбранного сервис аккаунта
|-
|notifyAddDoc
|bool
|1 ― добавляет номер документа-основания (ДО1 или CMN.13014) в текст уведомления
|-
|notifyOldDay
|int
|Кол-во дней. При постановке задачи на слежение учитывается полученная ранее информация. Если параметр = 3 дня, то будет уведомление об информации не старше 3 дней. Влияет только на начало слежения
|-
|notifyLoginEmail
|bool
|Уведомление на email аккаунта
|-
|notify13014
|bool
|Уведомлять о получении сообщений 13014
|-
|notifyDO1
|bool
|Уведомлять о появлении новых ДО1
|-
|login
|str
|Ваш логин
|-
|emails
|[]
|Массив Ваших дополнительных email адресов для уведомлений. Содержит массив значений ― email адрес (ключевое поле) и состояние - включен (true) или нет (false)
|}

<big>Пример ответа:</big>

{

"data": {

"notifyEmail": 0,

"service_price": 1,

"notifyAddDoc": 1,

"notifyTG": 0,

"freezing": 147,

"notifyWebhook": 0,

"webhook": null,

"addArh": 0,

"sa_login": "сервис аккаунт",

"notifyDO1": 0,

"tgId": 11122233344,

"sa_balance": 500,

"notifyOldDay": 3,

"notifyLoginEmail": 0,

"notify13014": 1,

"notifyOneMail": 0,

"login": "ваш логин",

"emails": {

"первый@": false,

"второй@": true

},

},

"success": true

}

=== Возможные ошибки ===
При возникновении ошибок возвращается код ответа сервера отличный от '''200''', а также описание ошибки в JSON-массиве.

код ответа '''400''':

{"success":false,"info":"Нет авторизации","code":101}

=== Webhook ===

По Webhook на указанный в личном кабинете URL-адрес приходят POST данные в таком формате:
{| class="wikitable"
|test
|int
|1 ― указывает что запрос тестовый, отсутствие параметра ― боевой
|-
|change
|[] json
|Массив изменений в json формате
|-
|Номер контейнера : тип уведомления
|
|Тип уведомления: do1 ― появилась ДО1; 13014 ― появилось сообщение CMN.13014
|}
пример POST запроса:

test=1&change={"TEST0000001":"do1","TEST0000002":"13014"}

'''Работа запросов webhook'''

Как только url ответил с кодом 200, уведомление считается '''доставленным''', но если код ответа отличный от 200, то происходит еще 5 попыток достучаться до указанного url с интервал между попытками примерно 1-2 минуты.

[[Категория:Автоматизация]]
[[Категория:Web-Сервисы]]

API Слежение (для Груз на СВХ)

2025-03-12T13:02:03Z

Admin: Admin переименовал страницу Слежение (для Груз на СВХ) в API Слежение (для Груз на СВХ): Олег так захотел

Слежение (для Груз на СВХ)

2025-03-12T13:02:03Z

Admin: Admin переименовал страницу Слежение (для Груз на СВХ) в API Слежение (для Груз на СВХ): Олег так захотел

#перенаправление [[API Слежение (для Груз на СВХ)]]

API подбор кода ТНВЭД для экспресс-грузов

2024-02-15T08:14:18Z

Admin: Admin переименовал страницу XML-API подбор кода ТНВЭД для экспресс-грузов в API подбор кода ТНВЭД для экспресс-грузов без оставления перена…

==О сервисе==
Сервис предназначен для автоматизированного определения 10-значных кодов ТНВЭД по описаниям товаров

==API==
Доступ к API предоставляется по URL https://www2.alta.ru/tools/autotnved/.

===Отправка исходных данных===
Для отправки списка описаний товаров, для которых необходимо определить коды ТНВЭД, нужно отправить POST-запрос, в который должны быть включены параметр "slogin" со значением, соответствующим логину вашей учетной записи, и "xml", значение которого должно иметь следующий формат:

<pre>
<xml>


...

</xml>
</pre>

Пример: для отправки запроса, содержащего один товар с описанием "брюки женские" нужно сформировать XML следующего вида:

<pre>
<xml>

</xml>
</pre>

Отправить его можно одним из следующих способов:

<pre>
POST /tools/autotnved/ HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Accept-Encoding: gzip, deflate
Host: www2.alta.ru
Content-Length: 198
Connection: Close

slogin=sa00000&xml=%3Cxml%3E%3Ci+id%3D%221%22+descr%3D%22%D0%B1%D1%80%D1%8E%D0%BA%D0%B8+%D0%B6%D0%B5%D0%BD%D1%81%D0%BA%D0%B8%D0%B5%22%2F%3E%3C%2Fxml%3E
</pre>

<pre>
POST /tools/autotnved/ HTTP/1.1
Content-Type: multipart/form-data; boundary=---------------------------7e6ad602d2
Accept-Encoding: gzip, deflate
Host: www2.alta.ru
Content-Length: 860
Connection: Close

-----------------------------7e6ad602d2
Content-Disposition: form-data; name="slogin"

sa00000
-----------------------------7e6ad602d2
Content-Disposition: form-data; name="xml"

<xml></xml>
-----------------------------7e6ad602d2--
</pre>

Если запрос выполнится успешно, ответ сервера будет иметь следующий вид:

<pre>
<result>
<message>Запрос поставлен в очередь</message>
<requestid>7</requestid>
</result>
</pre>

{| class="wikitable" width="50%"
|-
|result||Корневой элемент документа
|-
|message|| Элемент с информацией о статусе запроса
|-
|requestid||Идентификатор запроса, который понадобится в дальнейшем
|-
|}

===Получение списка кодов ТНВЭД===
Для получения списка кодов ТНВЭД по идентификатору запроса (requestid) необходима авторизация с помощью сервисного логина и пароля.
'''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''requestid + логин + md5-хэш от пароля''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword и requestid = 12345: 
вычисляем хеш:
<pre>
hash = md5("12345:testlogin:" + md5("testpassword"));
</pre>
Итоговый URL: https://www2.alta.ru/tools/autotnved/?requestid=12345&slogin=testlogin&hash=2b7283149605bc5ac1c17de3c34fc786

XML-ответ в случае успешного выполнения запроса:
{| class="wikitable" width="50%"
|-
|result||Корневой элемент документа
|-
|handled|| Состояние запроса: обработан или еще нет (стоит в очереди)
|-
|message|| Описание состояния запроса
|-
|response|| Блок, содержащий детальную информацию о всех найденных кодах ТНВЭД
|-
| item || Блок, содержащий информацию о коде ТНВЭД для одного товара
|-
| id || Идентификатор товара (порядковый номер) в соответствии с исходным запросом
|-
| code || Найденный код ТНВЭД
|-
| weight || Вес кода (количество товаров со схожим описанием, задекларированных с найденным кодом)
|-
| p || Уровень доверия к найденному коду (доля найденного кода по отношению ко всем кодам, которые были использованы для декларирования товаров со схожим описанием)
|-
|}

==Ошибки==
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.

<pre>
<Error>
<ErrorCode>201</ErrorCode>
<ErrorDescr>Запрос #12345 не найден</ErrorDescr>
</Error>
</pre>

При работе с сервисом возможны следующие ошибки:

{| class="wikitable" width="50%"
|+
!Код!!Описание
|-
|100||Пользователь не авторизован
|-
|110||Лимит запросов для данного пользователя исчерпан
|-
|120||Ошибка тарификации
|-
|140||Недостаточно средств для выполнения запроса
|-
|}

[[Категория:Автоматизация]]
[[Категория:Web-Сервисы]]

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

2023-07-20T11:12:07Z

Admin: Новая страница: «Часто у клиентов возникает потребность интеграции своей корпоративной информационной…»

Часто у клиентов возникает потребность интеграции своей корпоративной информационной системы (КИС) с продуктами Альта-Софт.

Возникаемые задачи можно разделить условно на 3 класса:

* Получение в КИС нормативно-справочной информации (НСИ) о товаре по его [[w:ТНВЭД]] коду

* Передача данных о партии товара (Инвойс) в Альту для последующего автоматизированного формирования таможенной декларации на товары ДТ

* Получение обратно в КИС информации для бухгалтерии о таможенных платежах заплаченных при выпуске товара по реальной ДТ

Рассмотрим возможные методы решения этих задач.

== Получение НСИ ==

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

В помощь при классификации товаров можно использовать сервисы

* собственно сам ТНВЭД https://www.alta.ru/tnved/
* "Товары и Коды" https://www.alta.ru/tik/
* "Пояснения" https://www.alta.ru/poyasnenia/
* "Подбор Кода" https://www.alta.ru/codesearch/ - [[API_онлайн-сервиса_Подбор_кода|есть API]]

к некоторые из этих сервисов предлагается платное Web-API, некоторые можно приобрести целиком в виде полной XML выгрузки.

Далее будем исходить из того, что в КИС клиента есть ТНВЭДы, и что он является правильным. Однако надо понимать, во время оформления декларации по требованию Таможни код ТНВЭД может быть изменен на другой или из-за изменения законодательства код в принципе может перестать существовать. Т.е. все что подготавливается в КИС - это прогноз, который может в итоге не совпасть с реальноq ДТ.

=== Виды НСИ ===

Особенности таможенного оформления товара делятся на 2 вида:
* '''Тарифные''' - это сколько денег придется непосредственно заплатить в виде таможенных платежей.
* '''Нетарифные''' - любые прочие меры так или иначе затрудняющие оформление: получение всевозможных документов, ввоз только через определенные погран.переходы, в принципе запрет на ввоз или вывоз и проч.

Тарифные меры можно легко формализовать в виде ставок платежей:
* Пошлина
* Акциз
* НДС
* Антидемпинговая Пошлина

Нетарифные можно попробовать представить в виде списка "особенностей".
* Требуется лицензия
* Запрещен ввоз
* Требуется разрешение от МинГазПромСвязьМониторРесурсХозразвития
* Требуется маркировка
* Требуется выгрузка на складе
* и т.д.

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

=== Получение справки о товаре ===

Спарвку можно получить от сервиса Онлайн-Такса через
[[API_для_получения_справки_о_товаре_(Такса)|XML API]]

или от декстопного приложения через
[[Параметры_командной_строки_(Такса)|вызов макроса]]

=== Получение тарифных особенностей для списка товаров в десктопном приложении "Такса" ===

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

Если список товаров (Инвойс) достаточно велик и имеется в электронном виде, то его можно конвертировать в Таксу при помощи утилиты "Заполнитель".

'''ВАЖНО:''' Существенная проблема заключается в том, что многие коды ТНВЭД для определения ставок платежей могут потребовать от декларанта дополнительных ответов на вопросы о специфике товара, так называемая "детализация":

* Является ли товар детским или предназначен для врозслых (НДС 10% или 18%)
* Является ли товар спиртосодержащим или нет (есть Акциз или не облагается акцизом и т.д.)

т.е. в большом числе случаев НЕВОЗМОЖНО автоматически выдать точные ставки всех платежей. Без уточнения можно говорить только
о неких диапазонах, например, НДС 0%-18%, "Акциз или отсутствует или 15%, но не менее 5евро за литр"

Таким образом мечта "хочу чтобы ваша программа автоматом сказала сколько мне денег платить" на практике не реализуема. Или результат будет в некотором (существенном!!!) диапазоне значений или потребует вмешательства квалифицированного ВЭД персонала.

==== Автоматизация передачи списка в приложение "Такса" ===

Данные из утилиты "Заполнитель" передаются в "Таксу" в виде [[a:Файл_обмена_Заполнителя|текстового ini файла]] заданной структуры.
Вот примерный листинг такого файла на 3 товара.

[Common]
IncludedDoc=INVTAX\block

[INVTAX\block.Block0]
DESCR=ТРУБКИ ПЛАСТИКОВЫЕ БЕЗ ФИТИНГОВ
TNVED=3917329909
QTY=16
NETTO=1.00
BRUTTO=1.00
PRICE=2.94
COUNTRYNAME=ГЕРМАНИЯ

[INVTAX\block.Block1]
DESCR=ЗАГЛУШКА ГОЛОВКИ БЛОКА ЦИЛИНДРОВ
TNVED=3926300009
QTY=560
NETTO=5.00
BRUTTO=5.00
PRICE=61.52
COUNTRYNAME=ГЕРМАНИЯ

[INVTAX\block.Block2]
DESCR=ЗАГЛУШКА ПЛАСТИКОВАЯ
TNVED=3926300009
QTY=38
NETTO=1.00
BRUTTO=1.00
PRICE=12.30
COUNTRYNAME=ЯПОНИЯ

Формат достаточно прост. Полный список полей можно посмотреть в настройке списка программы Такса.
Данный ini файл можно загрузить в список товаров Таксы через команду меню или поместив в подпапку IN\ рабочего каталога Таксы и вызвав taxwin.exe с ключем -Z.

Получить данные обратно можно при помощи [[a:Печать в офис|печати отчетов в Word/Excel]] или txt.
В офисе создается специальный документ-шаблон вида

{| class="standard"
|-
!НАИМЕНОВАНИЕ||АРТИКУЛ||ТНВЭД||НЕТТО||БРУТТО||КОЛ-ВО||СТОИМОСТЬ||Пошлина||Акциз||НДС
|-
|%%Descr||%%ART||%%tnved||%%Netto||%%Brutto||%%Unit2||%%Price||%%ПОШЛИНА||%%АКЦИЗ||%%НДС
|}

при печати которого строка с %% размножается по числу товаров, а вместо %%ключевых слов подставляются данные. Более подробно смотри статью [[Печать в офис]]. В txt файле т.о. можно нарисовать XML файл интересующей структуры.

== Передача данных о товарах в Альта-ГТД ==

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

Одна из ключевых проблем при попытках переноса данных из КИС в Альта-ГТД - это не понимание IT-специалистами специфики российского ВЭД документооборота. Подход "дайте нам формат, мы сформируем ГТД в КИС и передадим Вам файл" обречены на провал по широкому ряду причин. Рассмотрим основные из них:

==== Описание куда-чего заполнять ====

Нередко автоматизацией ВЭД начинают заниматься специалисты IT-отделов вообще не знающие ВЭД-терминологии и ВЭД-законодательства. По большому счету, ничего чрезвычайно сложного в нем нет, но все же при программировании КИС исполнителю придется погрузится в вопрос. Не возможно, например, написать бухгалтерскую программу не зная, что какое "приход\расход". Технические описания форматов - это в лучшем случае названия полей и их размерность.
А вот какие именно данные писать в то или иное поле и в какой комбинации, это уже инструкция по заполнению документов. Инструкция эта достаточно сложна и регулярно меняется в зависимости от законодательства. Чтобы разбираться в ней, надо стать немножко декларантом. Поэтому разработка КИС должна вестись в плотном контакте со ВЭД специалистами предприятия, для которых собственно все и делается. Не существует такого учебника для торопящихся программистов, где бы было расписано, что в такое-то поле в таком-то случае писать вот это, и это это состоит из 10 цифр и означает то-то. Единственный способ научится: изучать уже готовые документы, читать F1-помощь над полями, читать инструкции по заполнению и беседовать с практикующими декларантами.

==== Различие между общечеловеческим понятием "товар" и таможенным "товар ДТ" ====

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

В ВЭД же идентификация товара, как уже упоминалось выше, происходит по коду [[w:ТНВЭД]]. Соответственно при заполнении ГТД в "товаре ГТД" указываются все товары имеющие одинаковый код ТНВЭД. Т.о. возникает существенная разница между Инвойсом и Таможенной Декларацией: группы товаров Инвойса с одинаковым ТНВЭД должны быть объединены в "товары ГТД". Чтобы избежать путаницы в терминологии, записи об отдельных товарах в инвойсе будем называть '''позиции Инвойса''', а товары объединенные группу по критерию одинаковости ТНВЭД – '''товар ГТД'''. Таким образом позиций в Инвойсе, как правило, значительно больше чем товаров в ГТД, изготовленной для растаможки такого инвойса. Процесс такого "сплющивания" Инвйоса называется '''группировкой'''. Пример: "в Инвойсе было 100 '''позиций'''. Cгруппировав их по коду ТНВЭД и стране происхождения, мы получили 5 '''товаров ГТД'''.

Надо отметить, что в реальности все еще хуже: ГТД является чудовищным гибридом транспортного и финансового документа. Позиции инвойса объединяют в "Товары ГТД" не только по ТНВЭД, но и так, чтобы ставки платежей у этих "товаров" были одинаковые. Например, детские товары со сниженных НДС, декларируются в отдельном "товаре" от взрослых. Также на группировку могут влиять и нетарифные ограничения: наличие/отсутствие тех или иных разрешительных документов может вынуждать декларировать позиции порознь (например документ о внесении в '''Р'''еестр '''О'''бъектов '''И'''нтеллектуальной '''С'''обственности). И наконец, есть инструкция с фиксированным списоком кодов ТНВЭД, которые в принципе запрещено объединять. В общем, чрезмерная сложность и, местами, нелогичность законодательства приводит к тому, что без ручной работы ВЭД-специалиста выполнить такую группировку невозможно.

Таким образом одна только группировка инвойсов, которыми оперирует большинство КИС, в документ ГТД является, в общем случае, не банальной и не автоматизируемой задачей.

==== Термины "тип файла", "формат файла", "формат документа" и "таможенный формат" ====

Около термина "формат" существует огромное количество заблуждений.

Самые курьезные возникают, как правило, у руководителей не владеющих ни ВЭД-, ни IT- спецификой, но вынужденных принимать ключевые решения по развитию КИС. Например: "Я слышал, что таможня перешла на XML формат. Также читал, что MicroSoft Office 2007, тоже хранит данные в XML формате. Значит теперь мы можем сразу копировать наши документы в таможню?". Оспаривать подобные тезисы достаточно трудоемко. Да, XML это такой формат хранения данных, но он категорический разный у таможни и у MicroSoft. Это как английский и финский языки, буквы в принципе одинаковые - латинские - но знание алфавита совершенно не достаточно для понимания смысла произведения.

IT-специалисты чаще всего начинают с требования выдать "описание внутреннего формата" или "описание формата базы данных", по которым собираются "сформировать ГТД". К сожалению, такой подход не реализуем.
"Описание внутреннего формата" ни кому не выдается по той простой причине, что его не существует. Документы Альта-ГТД представляют собой древовидные объекты в памяти, со структурой задаваемой DCF-файлом описанием. При сохранении во внутреннем формате получается бинарный файл. Если открыть такой файл текстовым редактором, то в OEM кодировке можно будет даже прочитать содержимое граф, но понять, где какое поле, не представляется возможным. Грубо говоря, для работы с "внутренним форматом" Альта-ГТД необходимы исходные коды Альта-ГТД. На практике бывали случаи, когда для интеграции систем, клиенты получали фрагменты исходников Альта-ГТД в части создания и сохранения документов. Однако использовать готовый Pascal код в КИС не всегда возможно.

Соответственно, единственный метод передать данные в Альта-ГТД - это создать документ в одном из открытых форматов, которые можно штатными средствами загрузить в Альта-ГТД. Исторически таких форматов накопилось много, полный перечень можно увидеть в статье [[Форматы_ввода_вывода_Альта-ГТД]]. Обычное первое что приходит в голову, это '''Таможенный XML формат''', который используется при подаче данных в таможню.

'''Таможенный XML''' разработан [http://edpc.customs.ru/edpc/index.php ГНИВЦ ФТС] и является форматом обмена данных между декларантом и автоматизированной системой таможенного оформления (АИСТ). Поэтому такой XML открывается в любой декларантской программе, в том числе и в Альта-ГТД. Формат является открытым и полная документация по нему доступна на сервере таможни.

Однако, не забываем о необходимости группировки Инвойсов из КИС в товары ГТД. Фактически, чтобы сформировать таможенный XML-файл с ГТД, надо произвести практически всю цепочку работы декларанта: задать вопросы о детализации ТНВЭД, сгруппировать позиции в инвойсе по коду, стране и величине ставок, добавить разрешительные документ и т.д. Если такой механизм удастся создать внутри КИС, то собственно говоря Альта-ГТД уже будет и не нужна.

Следующий подводный камень "таможенного формата" - его перманентная изменчивость. Ориентировочно раз в пол года, ГНИВЦ ФТС перерабатывает формат или инструкцию по заполнению ГТД. Может меняться как сама структура XML, так и принцип заполнения уже существующих граф. Поэтому даже если реализовать систему формирования ГТД в КИС, то она будет требовать регулярного переписывания и поддержки.

В общем, использование непосредственно документа ГТД для автоматизации связи между Альтой и КИС не рационально.
Альта-Софт предлагает готовые решения для автоматизации, когда в качестве аналога КИС используется ПК "Артикул", поэтому все перечисленные проблемы так или иначе уже были решены. Был использован 2-x ступенчатый механизм с использованием промежуточного приложения "Инвойс". Речь о нем пойдет ниже.

==== Документация на формат SQL базы Альта-ГТД ====

С определенного момента программа Альта-ГТД начала хранить базу документов в базе MS SQL Server. Большинство разработчиков КИС владеют языком [[w:T-SQL]] и полагают, что при наличии "описания полей базы" смогут создавать документы в Альта-ГТД обращаясь непосредственно к базе данных посредством SQL-запросов. Это, к сожалению, не возможно. В Альта-ГТД документы обрабатываются в памяти, а хранение происходит во все том же бинарном формате, что и в файловой версии. Просто файл хранится не в папке документов, а в SQL базу в поле типа BLOB. Создание и редактирование таких BLOB полей не возможно без использования проприетарных исходников программы. Поэтому непосредственная работа с SQL базой затруднена.

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

Для получения подробной информации о документах предлагается использовать инструмент [[a:Docs2SQL]]. Оно успешно используется уже много лет. Еще до появления сетевых версий Альта-ГТД в больших компаниях часто возникал вопрос о построении итоговых отчетов. Для этого было создана служба, переносящая документы с разных рабочих мест (в том числе и файловых) в одну SQL базу. После соответствующей настройки при выпуске декларации в Альта-ГТД утилита DOCS2SQL начинает записывать их в отдельную SQL базу в формате схожем с таможенным DBF образца 2007 года. Это формат представляет собой уже более или менее нормализованную реляционную базу, с которой запросами можно получать интересующую информацию о товарах.

=== Роль приложения Инвойс в автоматизации ===

Схема работы ПК "Артикул" + Альта-ГТД показана на рисунке

[[Файл:art1.jpg]]

При самостоятельной автоматизации клиента, вся левая часть включающая Заполнитель и Артикул может быть реализована в КИС клиента. Рассмотрим принцип работы.

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

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

* Коммерческие: артикул, наименование и т.д.
* Физические характеристики: размер, цвет, крепость алкоголя и т.д.
* количественные: количество, вес, количество бутылок\штук в коробке и т.д.
* Таможенные: поля под разрешительные документы, код ТНВЭД, код ОКП и т.д.
* Универсальные: Комментарий, Прочее1-6

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

Дальше в Альта-ГТД из документа Инвойс формируется взаимосвязанный документ ГТД. Этот процесс как раз является ключевым в использовании приложения Инвойс. Заполнение ГТД является сугубо индивидуальным процессом, хотя и регламентируются массой законодательных документов. А может быть, как раз из-за огромной массы различных инструкций, писем, разъяснений и рекомендаций заполнение ГТД и превращается в искусство, требующее определённой квалификации. Содержимое части полей, например, вес нетто или код ТНВЭД, регламентировано достаточно однозначно и разночтений не допускает. А вот содержание описательной части гр.31 про наименование и характеристики представляет собой просто текст, который может существенно отличаться в разных случаях по массе причин:

* настройки приемного АИСТ на конкретной таможне
* неоднозначность трактовки инструкции заполнения
* регулярная модификация правил заполнения
* и т.д. и т.д.

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

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

[[Файл:optinv.png]]

К сожалению, сложность освоения настроек приложения становится платой за его гибкость.
В принципе, набор настроек по умолчанию работает приемлимо в большом количестве случаев, но при возникновении потребности в модификации декларанту придется изучать теоретическую часть. Т.к "метод тыка" широко практикуемый среди отечественных пользователей, при большом объему настроек не всегда дает приемлемый результат: терпение истекает раньше, чем перебор всех комбинаций. Особенно печально, что декларанты практически все рабочее время находятся под стрессом срочного выпуска товаров, и не имеют возможности или желания читать не только руководства пользователя, но даже информационные сообщения программы длиннее 4 строк. Зачастую приходится наблюдать, как декларант месяцами молотит "вручную по-старинке", вместо того, чтобы потратить пару часов на изучение и настройку приложения, так чтобы автоматизировать заполнение полей и исключить ручной ввод.

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

=== Выгрузка данных о товаре в Расширенный Инвойс Альта-ГТД ===

Передача данных осуществляется посредством обмена файлами специального формате.
Файлы формируются в КИС и через [[Форматы_ввода_вывода_Альта-ГТД#.D0.9F.D0.B0.D0.BF.D0.BA.D0.B0_.D0.B0.D0.B2.D1.82.D0.BE.D0.B7.D0.B0.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|папку]] или [[Передача данных через SQL-таблицу ExtDocs|SQL таблицу]] передаются к Альта-ГТД

==== Через [[a:Файл_обмена_Заполнителя|файл обмена заполнителя]] ====
В готовых решениях по автоматизации данные из пользовательских XLS, TXT и пр. файлов переносятся в Альта-ГТД при помощи программы [[Заполнитель]]. Технически это происходит следующим образом

* Данные через буфер обмена переносятся в Заполнитель
* в Заполнителе происходит формализация данных: пользователь отмечает для какого поля Инвойса в каком столбце таблицы находятся данные
* Из Заполнителя в [[Альта-ГТД]] в [[Форматы_ввода_вывода_Альта-ГТД#.D0.9F.D0.B0.D0.BF.D0.BA.D0.B0_.D0.B0.D0.B2.D1.82.D0.BE.D0.B7.D0.B0.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|папку автозагрузки]] выгружается [[a:Файл_обмена_Заполнителя|файл обмена]]
* Заполнитель запускает Альта-ГТД со специальным ключом (-Z) или подает команду уже запущенному экземпляру Альта-ГТД
* Альта-ГТД обрабатывает [[a:Файл_обмена_Заполнителя|файл обмена]] и формирует из него документ заданного типа

Соответственно первый из возможных способов передачи данных из КИС в Альта-ГТД - это создать точно такой же [[a:Файл_обмена_Заполнителя|файл обмена]] в каталоге \IN\. Файл обмена представляет собой ini файл определенной структуры. Примерный вид файла следующий:

[Common]
IncludedDoc=INV\BLOCK

[INV\BLOCK.BLOCK0]
G442_1=8- 3312
G443_1=20.01.11
31_ARTICUL=5871/353
33_1=3926200000
34_TEXT=КИТАЙ
31_DESCRIPT=РЕМЕНЬ ЖЕН.МАТЕР.100% ПОЛИУРЕТАН
31_QUNT=6
42_ZASUM=18
38_1=0.684
ST_NDS=18
31_COMENT=ОДЕЖДА И ЕЕ ПРИНАДЛЕЖНОСТИ (ВКЛЮЧАЯ ПЕРЧАТКИ, РУКАВИЦЫ И МИТЕНКИ) ИЗ ПЛАСТМАСС И ИЗ ПРОЧИХ МАТЕРИАЛОВ ТОВАРНЫХ ПОЗИЦИЙ 3901-3914
31_SIZE=75

[INV\BLOCK.BLOCK1]
G442_1=8- 3312
G443_1=20.01.11
31_ARTICUL=5871/353
33_1=3926200000
34_TEXT=КИТАЙ
31_DESCRIPT=РЕМЕНЬ ЖЕН.МАТЕР.100% ПОЛИУРЕТАН
31_QUNT=2
42_ZASUM=6
38_1=0.228
ST_NDS=18
31_COMENT=ОДЕЖДА И ЕЕ ПРИНАДЛЕЖНОСТИ (ВКЛЮЧАЯ ПЕРЧАТКИ, РУКАВИЦЫ И МИТЕНКИ) ИЗ ПЛАСТМАСС И ИЗ ПРОЧИХ МАТЕРИАЛОВ ТОВАРНЫХ ПОЗИЦИЙ 3901-3914
31_SIZE=85

В первой секции common указывается тип передаваемого документ (INV\BLOCK как раз инвойс), а в последующих секциях передаются данные о товарах. Полный список возможных полей можно посмотреть в файле DATA\inv.dcf

==== В формате XML ====

Второй способ это сформировать инвойс во "внутреннем XML" формате. Т.к. Инвойс является чисто альтовским документом, изобретенным для нужд автоматизации, то для для него нет никакого "таможенного формата" или бланка.

При этом надо уточнить, что в таможенных альбомах есть документ "ЭД2 Инвойс", но этот "таможенный инвойс" содержит минимум полей, поэтому не пригоден для нужд автоматизации. "ЭД2 Инвойс" используется чисто для предоставления данных при электронном декларировании, и такой "ЭД2 инвйос" всегда можно изготовить из Альта-Инвойса как взаимосвязанный.

Несмотря на такую самобытность Альта-Инвойса для него существует внутренний альта-XML формат. Фактически это просто конвертирование внутреннего бинарного формата в текст с XML разметкой. Этот формат также можно использовать для обмена с КИС.

Для загрузки файла необходимо поместить в [[Форматы_ввода_вывода_Альта-ГТД#.D0.9F.D0.B0.D0.BF.D0.BA.D0.B0_.D0.B0.D0.B2.D1.82.D0.BE.D0.B7.D0.B0.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|папку автозагрузки]] выгружается [[a:Файл_обмена_Заполнителя|файл обмена]] и запустить GTDW.EXE

Примерный вид файла:

<source lang=XML>

<?xml version="1.0" encoding="windows-1251"?>
<AltaINV>
<INV_NUM>0054</INV_NUM>
<INV_DATE>21.04.11</INV_DATE>
<BLOCK>
<G_31_ARTICUL>5871/353</G_31_ARTICUL>
<G_31_DESCRIPT>РЕМЕНЬ ЖЕН.МАТЕР.100% ПОЛИУРЕТАН</G_31_DESCRIPT>
<G_31_COMENT>ОДЕЖДА И ЕЕ ПРИНАДЛЕЖНОСТИ (ВКЛЮЧАЯ ПЕРЧАТКИ, РУКАВИЦЫ И МИТЕНКИ) ИЗ ПЛАСТМАСС И ИЗ ПРОЧИХ МАТЕРИАЛОВ ТОВАРНЫХ ПОЗИЦИЙ 3901-3914</G_31_COMENT>
<G_31_SIZE>75</G_31_SIZE>
<G_32_1>1</G_32_1>
<G_33_1>3926200000</G_33_1>
<G_33_5>И</G_33_5>
<G_34_1>156</G_34_1>
<G_34_ALFA>CN</G_34_ALFA>
<G_34_TEXT>КИТАЙ</G_34_TEXT>
<G_38_1>0.684</G_38_1>
<G_38_SHTUKA>0.114</G_38_SHTUKA>
<G_42_ZAEDINIC>3</G_42_ZAEDINIC>
<G_42_ZASUM>18</G_42_ZASUM>
<G_31_QUNT>6</G_31_QUNT>
<G_31_TEXT>ШТ</G_31_TEXT>
<G_31_EDCODE>796</G_31_EDCODE>
<G_31_TARALFA>NE</G_31_TARALFA>
<G_31_TARA>Неупакованный или нерасфасованный</G_31_TARA>
<AD_10_CN>КИТАЙ</AD_10_CN>
<AD_10_COD>CN</AD_10_COD>
<ST_NDS>18</ST_NDS>
<G442_1><NUM>8- 3312</NUM></G442_1>
<G443_1>2011-01-20</G443_1>
</BLOCK>
<BLOCK>
<G_31_ARTICUL>5871/353</G_31_ARTICUL>
<G_31_DESCRIPT>РЕМЕНЬ ЖЕН.МАТЕР.100% ПОЛИУРЕТАН</G_31_DESCRIPT>
<G_31_COMENT>ОДЕЖДА И ЕЕ ПРИНАДЛЕЖНОСТИ (ВКЛЮЧАЯ ПЕРЧАТКИ, РУКАВИЦЫ И МИТЕНКИ) ИЗ ПЛАСТМАСС И ИЗ ПРОЧИХ МАТЕРИАЛОВ ТОВАРНЫХ ПОЗИЦИЙ 3901-3914</G_31_COMENT>
<G_31_SIZE>85</G_31_SIZE>
<G_32_1>2</G_32_1>
<G_33_1>3926200000</G_33_1>
<G_33_5>И</G_33_5>
<G_34_1>156</G_34_1>
<G_34_ALFA>CN</G_34_ALFA>
<G_34_TEXT>КИТАЙ</G_34_TEXT>
<G_38_1>0.228</G_38_1>
<G_38_SHTUKA>0.114</G_38_SHTUKA>
<G_42_ZAEDINIC>3</G_42_ZAEDINIC>
<G_42_ZASUM>6</G_42_ZASUM>
<G_31_QUNT>2</G_31_QUNT>
<G_31_TEXT>ШТ</G_31_TEXT>
<G_31_EDCODE>796</G_31_EDCODE>
<G_31_TARALFA>NE</G_31_TARALFA>
<G_31_TARA>Неупакованный или нерасфасованный</G_31_TARA>
<AD_10_CN>КИТАЙ</AD_10_CN>
<AD_10_COD>CN</AD_10_COD>
<ST_NDS>18</ST_NDS>
<G442_1><NUM>8- 3312</NUM></G442_1>
<G443_1>2011-01-20</G443_1>
</BLOCK>
</AltaINV>
</source>

Как видно примера с теми же данными, идентификаторы идентичны файлу обмена Заполнителя, т.е. берутся из того же DCF-файла.

=== Выгрузка инвойса в ПК Артикул===

Программный комплекс [[Артикул]] это готовое решение для автоматизации, предлагаемое Альта-Софт. В случае когда в КИС клиента отсутствуют какие-то необходимые данные для формирования ГТД, то декларанту приходится вводить их вручную. При постоянно повторяющейся номенклатуре оформляемых товаров возникает вопрос: "а нельзя ли где-то запомнить характеристики товара, если он уже однажды оформлялся". Для этого был разработан Артикул. Декларант единожды вручную обрабатывает конкретный товар, и все его характеристики запоминаются в базе. Если в каком-нибудь из последующих инвойсов попадется точно такая же позиция, то обрабатывать ее уже не придется - все данные о ней будут взяты из базы. Для идентификации отдельных товаров как правило используется их артикул - некий цифро-буквенный код, назначаемый производителем. В современной логистике подобную маркировку имеет практически любой товар.

Поэтому если в КИС клиента нет всех необходимых для декларирования данных (например, кода ТНВЭД), а модификация КИС невозможна по каким-либо причинам, то для автоматизации придется использовать длинную цепочку:

КИС -> ПК "Артикул" -> Документ "Инвойс" в Альта-ГТД-> Документ ГТД в Альта-ГТД

Передачу данных в ПК "Артикул" можно на данный момент организовать в формате файла обмена Заполнителя. По формату это будет аналогичный [[w:ini|ini]] файл, только идентификаторы полей надо смотреть в файле ArtDB.mdb

При необходимости, можно организовать загрузку XML с тегами совпадающими с идентификаторами полей. До сих пор такой необходимости не возникало.

ПК "Артикул" хранит свою базу данных или в файле [[w:Microsoft_Access|MDB]] (локальная версия) или в [[w:Microsoft_SQL_Server|MS SQL]]. У IT-специалистов часто возникает вопрос о возможности КИС писать данные не посредственно в базу артикула. Технически это, естественно, возможно, но с одним нюансом. При загрузке файла из Заполнителя, ПК Артикул производит обработку и дозаполнение данных. Поэтому инвойс созданный непосредственно в базе будет "голый". Его еще будет необходимо обработать в артикуле вручную.

== Загрузка платежей по инвойсу в КИС ==

После оформления ГТД в таможне и выпуска товаров в документах ГТД и, при наличии такового, КТС (корректировка таможенной стоимости) появляются окончательные суммы платежей. Эти цифры, как правило, представляют повышенный интерес как для бухгалтерии компании, так и для руководства.

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

Для извлечения этой информации существует механизм переноса платежей из ГТД в "родительский" Инвойс. При этом суммы платежей распределяются пропорционально стоимостям по каждой позиции. Таким образом, платежи появляются в документе Инвойс. Дальше встает вопрос, как перебросить эти полезные данные обратно в КИС.

В готовом решении ПК "Артикул"+Альта-ГТД платежи возвращаются в [[w:DBF|DBF]] файле. Для взаимодействия с КИС можно использовать
[[a:Печать в офис|печать в шаблон Excel]]. В настройках при получении платежей можно настроить печать Инвойса в заранее подготовленный шаблон

[[Файл:pay2kis.png]]

Там же можно настроить автоматический вызов любого приложения, которое загружало бы полученный XLS в КИС.

Если используется длинная цепочка, то платежи целесообразно получать от ПК Артикул:

КИС -> ПК Артикул-> Альта-ГТД -> Регистрация ГТД в таможне -> Платежи в ПК Артикул -> КИС

Для выгрузки платежей из ПК Артикула применяется механизм схожий с печатью в офис. При помощи него также можно получать и XML, и DBF файл с платежами.

== См. также ==
[[Форматы ввода вывода Альта-ГТД]]

[[Передача данных через SQL-таблицу ExtDocs]]

[[Docs2SQL]]

[[Категория:Альта-ГТД]]
[[Категория:Такса]]
[[Категория:Заполнитель]]
[[Категория:Автоматизация]]

API для сервиса report.alta.ru

2022-08-12T11:32:02Z

Admin: Admin переименовал страницу API для сервиса Мониторинг таможенного оформления в API для сервиса report.alta.ru без оставления перенаправления:…

== Сервис мониторинг таможенного оформления (REPORT.ALTA.RU) ==
Сервис предоставляет разработчикам возможность получения информации из внешних программ и сайтов в JSON-формате. С помощью данного сервиса можно выгружать следующую информацию:

# Список логинов, к пользователю может быть прикреплено много логинов
# Декларанты, таможенные посты
# Получение ДТ
# Получение документов гр.44 (если включено дублирование всех сообщений)
# Получение ЭД сообщений

== Описание параметров ==
Доступ к API предоставляется по URL https://report.alta.ru/api/
Входные параметры передаются с помощью запроса HTTPS GET. Для использования сервиса необходимо получить '''apikey''' и '''secret''' в личном кабинете

Пример адреса запроса с параметрами:
<nowiki>https://report.alta.ru/api/</nowiki>'''function'''/параметр0/?параметр1…2...параметрN&'''apikey'''=XXXX&'''hash'''=YYYYY

любой запрос должен содержать '''обязательные''' параметры, они выделены жирным

{| class="wikitable"
!Параметр || '''Тип''' || Описание || Пример
|-
|colspan="4" | Обязательные, должны быть в любом запросе
|-
|v1 || '''string''' || Версия апи, текущая версия 1 || v1 v2 … v1.1
|-
|function || '''string''' || вызываемая функция апи || docs, decl, logins, tam
|-
|apikey || '''string''' || Ключ авторизации, получить в личном кабинете || 5b145adecf42b8eecd4e6f3dc7134f45
|-
|hash || '''string''' || ХЭШ запроса, рассчитывается для каждого запроса по слову secret || 34563456
|}

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

<code>/api/v1/docs/?apikey=XXX&hash=YYY</code>

Параметр0 указываем для получения конкретного документа, пример:

<code>/api/v1/docs/xxxxx/?apikey=XXX&hash=YYY</code>

'''секрет''' нужен для генерации '''хэша''' (подписи) запроса,
ХЭШ генерируется так:

hash = md5(версия + функция + параметр0(если есть) + ВСЕ_ПАРАМЕТРЫ + md5(apikey) + md5(secret))
ВСЕ_ПАРАМЕТРЫ — это конкатенация всех GET параметров в той последовательности, в которой они идут в параметрах запроса слева направо, параметры: апи ключ, хеш и секрет не участвуют
пример, запрос:

<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?x=1&y=2&z=3&apikey=5555&hash=5b145adecf42b8eecd4e6f3dc7134f45</code>

в данном случае ВСЕ_ПАРАМЕТРЫ это x y z
нам известно, что наш аккаунт имеет следующие данные: apikey = 5555, secret = 7777
тогда вычислим хэш:

hash = md5 ( 1 + docs + (параметр0 не указан, его не берем) + 1 + 2 + 3 + md5(5555) + md5(7777)) =
md5 (1docs1236074c6aa3488f3c2dddff2a7ca821aabd79c8788088c2193f0244d8f1f36d2db ) =
получилось, что hash = '''5b145adecf42b8eecd4e6f3dc7134f45'''

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

<code><nowiki>https://report.alta.ru/api/v1</nowiki>/'''FUNC/param0'''/?apikey=XXX&hash=YYY</code>

=== Получение логинов ===
<code>/logins/</code>

Ответом получаем массив с логинами

=== Получение декларантов ===
<code>/decl/</code>

получаем массив с ИНН и названиями организаций

=== Получение таможенных постов ===
<code>/tam/</code>

Получаем массив таможенных постов

=== Получение документов ===

<code>/docs/</code>

фильтры, передаются как ПАРАМЕТРЫ запроса, пример:

<code><nowiki>https://report.alta.ru/api/v1/docs</nowiki>/?'''regdate[from]=2019-03-01'''&apikey=xxx&hash=xxx&</code>

{| class="wikitable"
!Параметр || '''Тип''' || Описание || Пример
|-
|regdate[from] || '''string''' || дата регистрации от только дата || regdate[from]=2019-03-01
|-
|regdate[to] || '''string''' || дата регистрации до только дата || regdate[to]=2019-03-01
|-
|vypdate[from] || '''string''' || ДатаВремя выпуска от || vypdate[from]=2019-05-08 vypdate[from]=2021-10-10Т10:30:00
|-
|vypdate[to] || '''string''' || ДатаВремя выпуска до || vypdate[to]=2019-05-08 vypdate[to]=2021-10-20Т10:30:00+03:00
|-
|lastmsgdate[from] || '''string''' || последнее сообщение ДатаВремя от || lastmsgdate[from]= 2019-05-08 lastmsgdate[from]=2021-10-10Т10:30:00
|-
|lastmsgdate[to] || '''string''' || последнее сообщение ДатаВремя до || lastmsgdate[to]=2019-03-01 lastmsgdate[to]=2021-10-20Т10:30:00+03:00
|-
|decl || '''array''' || ИНН декларанта, можно несколько || decl[]=555555 decl[]=666666
|-
|tam || '''array''' || Номер таможенного поста, можно несколько || tam[]=555
|-
|login || '''array''' || Логин, можно несколько || login[]=xxx
|-
|pid || '''array''' || процедуры || pid[]=xxx&pid[]=yyy&pid[]=zzz&..
|}

В ответ получаем документы

{| class="wikitable"
|docs || '''array''' || массив документов ||
|}

из выдачи убрали заголовки столбцов, для их получения есть запрос апи <code>/docs/fields/</code>

==== Массив docs ====

Это массив документов, содержит в себе объект doc

==== Объект doc ====

{| class="wikitable"
!messagetype || '''string''' || Тип текущего сообщения с ДТ || CMN.11023
|-
|login || '''string''' || Логин || 123456
|-
|envelopeid || '''string''' || EnvelopeID текущего сообщения с ДТ || BD9D1189-A58E-482B-A108-ADF7D2459BFD
|-
|status || '''string''' || Статус процедуры в числовом виде || 3
|-
|softver || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21
|-
|ProccessID || '''string''' || ID процедуры || 1a2ab345-1a12-1a01-1234-1234a5678bc1
|-
|LastMessageDate || '''string''' || Дата последнего сообщения по процедуре ||
|-
|DeclarantOrganizationName || '''string''' || Наименование организациии || ООО \"Альта-Софт\"
|-
|DeclarantINN || '''string''' || ИНН декларанта || 1234567890
|-
|DeclarantOGRN || '''string''' || ОГРН декларанта ||
|-
|DeclarantFIO || '''string''' || ФИО декларанта из гр.54 ||
|-
|consignorName || '''string''' || Отправитель ||
|-
|consignorAddres || '''string''' || Адрес отправителя ||
|-
|consigneeName || '''string''' || Получатель ||
|-
|consigneeAddres || '''string''' || Адрес получателя ||
|-
|Transp || '''string''' || Номера транспортных средств ||
|-
|TrDoc || '''string''' || Номер транспортных документов ||
|-
|Cont || '''string''' || Номера контейнеров
|-
|NetWeightQuantity || '''string''' || Нетто || 20160.00
|-
|GrossWeightQuantity || '''string''' || Брутто || 20640.00
|-
|CustomsCost || '''string''' || Таможенная стоимость || 1989792.00
|-
|InvoicedCost || '''string''' || Фактурная стоимость || 1989792.00
|-
|ContractCurrencyCode || '''string''' || Валюта контракта || RUB
|-
|REGNUM || '''string''' || Номер ДТ || 10000000/010121/0123456
|-
|PackageNumber || '''string''' || Кол-во мест ||
|-
|GoodsCount || '''string''' || Кол-во товаров || 1
|-
|UD || '''string''' || Код поста гр.30 ||
|-
|CustomsProcedure || '''string''' || Режим || ИМ
|-
|CustomsModeCode || '''string''' || Процедура || 40
|-
|DeclarationKind || '''string''' || Особенности процедуры || ПТД
|}

=== Наименования статусов ===
{| class="wikitable"
|1 || Открытие процедуры
|-
|2 || Присвоен номер
|-
|3 || Идет проверка
|-
|4 || Идет досмотр
|-
|5 || Проверка закончена
|-
|6 || Условно выпущена
|-
|7 || Выпуск разрешен
|-
|10 || Отказано в выпуске
|-
|11 || Товар прибыл (ПТД)
|-
|12 || Выпуск с обеспечением
|-
|13 || Отзыв
|-
|14 || Считается не поданной
|-
|15 || Выпуск приостановлен
|-
|17 || Частично выпущена
|-
|26 || Выпуск под обеспечение
|-
|27 || Идет осмотр
|-
|8192 || Отказано в приеме
|-
|16384 || Переход на "бумагу"
|-
|32768 || Запрошен отзыв
|}

=== Получение, Печать документа, Просмотр документа ===

Теперь, зная список документов, можно получить определенный документ по его ID, вывод данного запроса идет в html виде

<code>/docs/ID/</code>

, где ID = ProccessID_Login, пример: <code>1a2ab345-1a12-1a01-1234-1234a5678bc1_123456</code>

=== Получение полей (заголовки столбцов) ===

<code>/docs/fields/</code>

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

=== Получение вложенных документов из графы 44 ===

<code>/docs44/ID/</code>

, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456

'''также можно передать дополнительные параметры - фильтры'''

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

{| class="wikitable"
!Параметр || '''Тип''' || Описание || Пример
|-
|docCode || '''string''' || Код документа, можно указать часть кода , но только от начала строки || 0234*, 04031
|-
|docNum || '''string''' || Номер документа, можно указать любую часть номера без звездочек VN-RU || VN-RU, 18/04/
|-
|docDate[from] || '''string''' || Дата от || 2018-01-01
|-
|docDate[to] || '''string''' || Дата до || 2019-05-08
|-
|tovNum[] || '''array''' || Номер товара, задается массивом || tovNum[]=1tovNum[]=40
|}

в ответ получаем массив с документами

{| class="wikitable"
|docName || '''string''' || имя документа
|-
|docCode || '''string''' || Код документа
|-
|docDate || '''string''' || Дата документа
|-
|tovNum || '''string''' || Товары, их номера
|-
|elDocId || '''string''' || ID документа в архиве таможни
|-
|docNum || '''string''' || Номер документа
|-
|elArchId || '''string''' || ID архива таможни
|}

=== Получение тела документа 44. Печать в html ===

Запрос похож на предыдущий, добавляем только спереди ID документа в архиве таможни

<code>/docs44/ID/</code>

, где ID = elDocId_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456

=== Получение сообщений ===

<code>/messages/ID/</code>

, где ID = ProccessID_Login, пример: 1a2ab345-1a12-1a01-1234-1234a5678bc1_123456

ProccessID и Login обязательны

дополнительные параметры для запроса:

{| class="wikitable"
!Параметр || '''Тип''' || Описание || Пример
|-
|date[from] || '''string''' || Дата сообщения от || date[from]=2019-03-01
|-
|date[to] || '''string''' || Дата сообщения до || date[to]=2019-03-01
|}

==== Ответные параметры ====

в ответ получаем объект messages, это массив с элементами message - объект с данными сообщения

{| class="wikitable"
|messages || array || массив с сообщениями
|}

сообщение message, элемент этого массива, структура:

{| class="wikitable"
|MessageType || '''string''' || Тип сообщения || CMN.11001
|-
|Priority || '''string''' || Служебное поле в заголовке сообщения || 4
|-
|Incoming || '''string''' || 0 - исходящее сообщение, 1 - входящее || 1
|-
|login || '''string''' || Логин || 123456
|-
|EnvelopeID || '''string''' || EnvelopeID сообщения || BD9D1189-A58E-482B-A108-ADF7D2459BFD
|-
|SoftVersion || '''string''' || Версия альбома и спецификации || 5.14.2/3.3.21
|-
|ParticipantID || '''string''' || ID декларанта
|-
|CustomsCode || '''string''' || Код таможни сообщения ||
|-
|InitialEnvelopeID || '''string''' || EnvelopeID родительского сообщения (на которое ссылается данное сообщение) ||
|-
|PreparationDateTime || '''string''' || Дата и время сообщения ||
|-
|ExchType || '''string''' || Служебное поле в заголовке сообщения || 19200
|-
|ProccessID || '''string''' || ID процедуры сообщения || 1a2ab345-1a12-1a01-1234-1234a5678bc1
|-
|SenderInformation || '''string''' || Отправитель сообщения || smtp://eps.customs.ru/gateway
|-
|ReceiverInformation || '''string''' || Получатель сообщения || smtp://eps.customs.ru/102770123456789.as
|-
|Sign || '''string''' || Электронная подпись || ФЕДЕРАЛЬНАЯ ТАМОЖЕННАЯ СЛУЖБА
|-
|canView || '''string''' || 1 – возможен ли просмотр сообщения ||
|-
|type || '''string''' || arch – документ из архива (возможен запрос документа по ArchDocID) ||
|-
|ArchID || '''string''' || ID архива таможни ||
|-
|ArchDocID || '''string''' || ID документа в архиве таможни ||
|}

запрос также проверяет доступ к ИНН, если не прописан доступ к ИНН, то вернет ошибку

=== Получение сообщения. Печать в html ===

Запрос похож на предыдущий, добавляется только EnvelopeID

<code>/messages/ID/</code>

, где ID = EnvelopeID_ProccessID_Login, пример: b1b2abcd-1a2b-1a23-a123-a12b345cde1a_1a2ab345-1a12-1a01-1234-1234a5678bc1_123456

EnvelopeID, ProccessID и Login обязательны

возвращается сообщение в html виде

если сообщение содержит несколько документов, то все они будут склеены в один html

НО разделены комментариями <nowiki> </nowiki>

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

<source lang="xml">



<!DOCTYPE html ....
html.... тело документа со всеми стилями


<!DOCTYPE html ....
html.... тут следующее тело со стилями
</source>

надо ориентироваться, если в начале документа есть параметр count 2, то значит в сообщении 2 документа

== Типы данных ==

{| class="wikitable"
|'''string''' || строковый параметр
|-
|'''array''' || массив значений, нумерация элементов начинается с 0, вложенные элементы могут быть всех типов
|-
|'''object''' || объект значений или именованный массив. ключи - могут быть как числовые так и текстовые, вложенные элементы могут быть всех типов
|}

== Ошибки ==

При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки.
При работе с сервисом возможны следующие ошибки:

{| class="wikitable"
!Код || Описание
|-
|'''100''' || Нет обязательных параметров
|-
|'''200''' || АПИ ключ не найден или не действительный
|-
|'''201''' || Неверный хэш
|-
|'''202''' || Ошибка авторизации, обратитесь к администратору
|-
|'''204''' || Нет права выполнять эту операцию(запрос)
|-
|'''203''' || Слишком много запросов. Запрос отклонен.
|-
|'''300''' || Метод API не найден, возможно неверная версия АПИ
|-
|'''301''' || В запросе(методе) отсутствует необходимый параметр
|-
| || Строка запроса содержит синтаксическую ошибку
|-
|'''500''' || Обработка запроса потерпела неудачу из-за неизвестной ошибки, исключения.
|}

пример ошибок

<source lang='json'>
{
"error": 200,
"text": "BAD api key, USER not found"
}
{
"error": 201,
"text": "ERROR HASH"
}
{
"error": 203,
"q": "v1/decl/",
"request_wait": 3.05,
"text": "Sory, You have Limit requests to API: 5 requests per 10 seconds. Please wait 3.05 sec for next request"
}
</source>

== Примеры реализации простого клиента ==

=== простой клиент на питоне ===

на питоне 2.7, надо установить библиотеку pip install requests

<source lang="Python">
apikey = "api_key" # ваш ключ апи
secret = "secret" # ваш секрет апи
v = 1 # версия
func = "docs" # вызываемая функция
param = "" # параметр используется для получения конкретного документа, например /docs/ID/ /docs/100000000/
# доп параметры запроса
params = {
'd': '123',
'param1': 'xxxxx',
'param2': 'yyyyyy'
}
# урл для запроса
api_url = "https://report.alta.ru/api/v%d/%s/" % (v, func) + (param + "/" if param else "")

if __name__ == "__main__":
# рассчитываем хэш секрет для запроса
# идем по всем параметрам по порядку
str = ""
for p in params:
str += params[p]
print p, params[p]
# и в конце прибавляем ключ
str = "%d%s%s%s%s" % (v, func + (param if param else ""), str, hashlib.md5(apikey).hexdigest(), hashlib.md5(secret).hexdigest())
# считаем хэш
hash = hashlib.md5(str).hexdigest()
# добавляем эти параметры в запрос
params['hash'] = hash # + "1111"
params['apikey'] = apikey
print str, hash, api_url
# делаем запрос, я отключил проверку сертификата SSL а то не давало сделать запрос
r = requests.get(api_url, params, verify=False)
# выдаем ответ
if r.status_code != 200:
print r.status_code, "Похоже возникли ошибки: \n", r.text, r.content
else:
print "ОТВЕТ", r.content
</source>

[[Категория:Автоматизация]]

XML-API для ТиК онлайн

2022-03-28T08:33:38Z

Admin: Перенаправление на API онлайн-сервиса Товары и Коды

#REDIRECT [[API_онлайн-сервиса_Товары_и_Коды]]

XML-API для получения справки о товаре (Такса)

2022-03-28T08:32:14Z

Admin: Перенаправление на API для получения справки о товаре (Такса)

#REDIRECT [[API_для_получения_справки_о_товаре_(Такса)]]

XML-API Подбор кода

2022-03-28T08:29:40Z

Admin: Перенаправление на API онлайн-сервиса Подбор кода

#REDIRECT [[API_онлайн-сервиса_Подбор_кода]]

API онлайн-сервиса Товары и Коды

2022-03-25T16:07:05Z

Admin: Admin переименовал страницу API-XML для ТиК онлайн в API онлайн-сервиса Товары и Коды без оставления перенаправления

==О сервисе==
XML-API «Товары и коды» позволяет интегрировать возможности сервиса в сторонние программы и сайты.

По искомому слову или словосочетанию сервис выдает список кодов ТН ВЭД и 100 первых записей по каждому коду, имеющих данное вхождение.

При необходимости можно отдельно тарифицируемым запросом дозапросить следующие 100 записей определенного кода ТН ВЭД, содержащих искомое словосочетание.

==API==
Доступ к API предоставляется по URL https://www.alta.ru/tik/xml/. Входные параметры передаются с помощью запроса HTTP GET. Для использования сервиса необходима авторизация с помощью сервисного логина и пароля.

'''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''словосочетание + логин + пароль''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword: 
Создаем запрос: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin 
Вычисляем секрет: secret = md5("зерно:testlogin:md5(testpassword)") 
Добавляем хеш-строку и получаем итоговый URL: https://www.alta.ru/tik/xml/?srchstr=зерно&login=testlogin&secret=557272e59fce7d51f7d550301eb5753f

Ниже приводится полный список входных параметров:
{| class="wikitable" width="75%"
|+
!Параметр !!Тип !!Описание

|- highlight
|colspan=3 |'''Обязательные'''

|-
|srchstr||string||Слово или словосочетание; от 3-х букв

|- highlight
|colspan=3 |'''Необязательные'''

|-
|login||string||Логин к сервису

|-
|secret||string||MD5-секрет для данного запроса

|-
|tncode||string||Код ТН ВЭД; от 2 до 10 цифр для ограничения поиска по подразделам, группам, подгруппам и т.п.

|-
|page||int||Номер страницы при дополнительном запросе данных по определенному коду; от 2

|}

==Примеры запросов==
Подбор кодов по словосочетанию: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testlogin&secret=557272e59fce7d51f7d550301eb5753f

Дополнительные записи по словосочетанию и коду 1104291700: 
https://www.alta.ru/tik/xml/?tnfiltr=1104291700&srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&page=2&login=testlogin&secret=557272e59fce7d51f7d550301eb5753f

==XML-ответ==

{| class="wikitable" width="75%"
|-
|TikList||Корневой элемент документа
|-
|colspan=2|'''Общая информация'''
|-
|TikList->Code||Код ТН ВЭД
|-
|TikList->Count||Количество записей для данного кода
|-
|colspan=2|'''Записи для кода'''
|-
|TikList->Notes||Список из записей
|-
|TikList->Notes->Note||Запись для кода
|}

==Ошибки==
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки. 
При работе с сервисом возможны следующие ошибки:

{| class="wikitable" width="75%"
|+
!Код!!Описание
|-
|100||Пользователь не авторизирован
|-
|110||Лимит запросов для данного пользователя исчерпан
|-
|120||Ошибка тарификации
|-
|200||Строка поиска должна состоять из 3-х или более символов
|-
|210||По данному запросу информация не найдена
|}

==Примеры ошибок==
Пользователь не авторизирован: 
https://www.alta.ru/tik/xml/?srchstr=test

Лимит запросов для данного пользователя исчерпан: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testloginlimit&secret=ce3642297fe33bcb943829acf4cda884

Строка поиска не должна быть слишком короткая: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5&login=testlogin&secret=ff5e9bec5d9f81665eb7920bee3a6a2f

По данному запросу информация не найдена: 
https://www.alta.ru/tik/xml/?srchstr=%D0%B7%D0%B5%D1%80%D0%BD%D0%BE%D0%B7%D0%B5%D1%80%D0%BD%D0%BE&login=testlogin&secret=1415376d0aae6e94875c43e1d8e79b7e

[[Категория:Автоматизация]]
[[Категория:Web-Сервисы]]
[[Категория:ТиК]]

API для получения справки о товаре (Такса)

2022-03-25T16:05:40Z

Admin: Admin переименовал страницу API-XML для получения справки о товаре (Такса) в API для получения справки о товаре (Такса) без оставления перена…

==О сервисе==
Сервис «Справка о товаре» (Такса) предоставляет разработчикам возможность получения информации из внешних программ и сайтов в XML-формате. С помощью данного сервиса возможно выгружать следующую информацию о коде ТН ВЭД:

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

==API==
Доступ к API '''«Справка о товаре»''' предоставляется по URL https://www.alta.ru/tnved/xml/. 
Доступ к информации о '''мерах нетарифного регулирования''' предоставляется по URL https://www.alta.ru/tnved/xml_nodes/. 
Входные параметры передаются с помощью запроса HTTP GET. Для использования сервиса необходима авторизация с помощью сервисного логина и пароля.

'''Для авторизации с помощью пары логин/пароль''' необходимо в GET-запрос добавить логин в открытом виде и MD5-хеш от сгенерированной строки '''Код ТН ВЭД + логин + md5-хэш от пароля''', разделенный знаком двоеточия «:», например для пользователя с логином testlogin и паролем testpassword: 
для запроса: https://www.alta.ru/tnved/xml/?tncode=0101291000&login=testlogin 
вычисляем секрет: secret = md5("0101291000:testlogin:md5(testpassword)") 
итоговый URL: https://www.alta.ru/tnved/xml/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558 
или https://www.alta.ru/tnved/xml_nodes/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558

----
<code>
Для тестового подключения и предварительной настройки используйте: 
логин: '''testlogin''' 
пароль: '''testpassword''' 
Для тестового пользователя доступны только коды 0101291000, 0102297100, 1506000000, 2402209000, 5102297100, 6202930000
</code>
----

Ниже приводится полный список входных параметров:
{| class="wikitable" width="75%"
|+
!Параметр!!Тип!!Описание

|- highlight
| colspan="3" |'''Обязательные'''

|-
|tncode||string||Код ТН ВЭД, 10 цифр

|- highlight
| colspan="3" |'''Необязательные'''

|-
|login||string||Логин к сервису

|-
|secret||string||MD5-секрет для данного запроса

|-
|сountry||int||Цифровой код страны, для которой необходима справка о товаре https://www.alta.ru/information/oksm/

|-
|date||date YYYY-MM-DD||Дата расчета, по умолчанию – сегодня

|-
|certificate||boolean||Наличие сертификата происхождения товара. 
Возможные значения:

*1 (по умолчанию) – сертификат в наличии
*0 – сертификат отсутствует

|-
|sp_certificate||boolean||Наличие сертификата происхождения товара для применения режима свободной торговли с выбранной страной. 
Возможные значения:

*1 – сертификат в наличии
*0 (по умолчанию) – сертификат отсутствует

|-
|mode||string||Таможенный режим* 
<nowiki>*</nowiki>'''параметр доступен только при получении информации о мерах нетарифного регулирования''' 
Возможные значения:

*import(по умолчанию) – импорт
*export – экспорт
|}

==Примеры запросов==
Ответ с несколькими блоками НДС: 
https://www.alta.ru/tnved/xml/?tncode=0101291000&login=testlogin&secret=eb8da09643eae8a3f5885e33884dd558

Ответ со сложным акцизом: 
https://www.alta.ru/tnved/xml/?tncode=2402209000&login=testlogin&secret=a88e61a8236ef2415b1d663e43415e0e

Изменение пошлины в зависимости от страны и наличия сертификата соответствия: 
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&certificate=1&country=398&secret=23d8cf433cf6603b457d4ba10756afbe 
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&certificate=0&country=398&secret=23d8cf433cf6603b457d4ba10756afbe 
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&certificate=1&country=818&secret=23d8cf433cf6603b457d4ba10756afbe 
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&certificate=0&country=818&secret=23d8cf433cf6603b457d4ba10756afbe 

Изменение пошлины для преференциальных товаров при применении режима свободной торговли с Вьетнамом. 
https://www.alta.ru/tnved/xml/?tncode=6202930000&login=testlogin&country=704&secret=7bbbd32641299761b45c352973dfd3f8&sp_certificate=1 
https://www.alta.ru/tnved/xml/?tncode=6202930000&login=testlogin&country=704&secret=7bbbd32641299761b45c352973dfd3f8&sp_certificate=0 

==XML-ответ==

{| class="wikitable" width="75%"
|-
|GoodInfo||Корневой элемент документа
|-
| colspan="2" |'''Общая информация'''
|-
|GoodInfo -> Code||Код ТН ВЭД
|-
|GoodInfo -> Name||Наименование кода ТН ВЭД
|-
|GoodInfo -> Prim||Примечание кода ТН ВЭД
|-
| colspan="2" |'''Пошлина'''
|-
|GoodInfo -> Importlist||Список применяемых ставок
|-
|GoodInfo -> Importlist -> Import||Информация о ставке
|-
|GoodInfo -> Importlist -> Import -> Value||Ставка
|-
|GoodInfo -> Importlist -> Import -> ValueDetail||Составляющие компоненты ставки
|-
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCount||Числовая составляющая ставки
|-
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueUnit||Единицы измерения
|-
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCurrency||Валюта
|-
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCount2||Числовая составляющая блока ставки "не менее"
|-
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueUnit2||Единицы измерения блока ставки "не менее"
|-
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCurrency2||Валюта блока ставки "не менее"
|-
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCount3||Числовая составляющая блока ставки "не более"
|-
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueUnit3||Единицы измерения блока ставки "не более"
|-
|GoodInfo -> Importlist -> Import -> ValueDetail -> ValueCurrency3||Валюта блока ставки "не более"
|-
|GoodInfo -> Importlist -> Import -> ValueDetailAdd||Составляющие компоненты второй части ставки, если она, например, вида: N%+Mевро/кг
|-
|GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueCount||Числовая составляющая ставки
|-
|GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueUnit||Единицы измерения
|-
|GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueCurrency||Валюта
|-
|GoodInfo -> Importlist -> Import -> Order||Документ-основание для начисления ставки
|-
|GoodInfo -> Importlist -> Import -> OrderСond||Примечание по документу-основанию для начисления ставки
|-
|GoodInfo -> Importlist -> Import -> Measure||Мера измерения ставки
|-
|GoodInfo -> Importlist -> Import -> Measure -> Name||Название меры измерения ставки
|-
|GoodInfo -> Importlist -> Import -> Measure -> Razm||Размерность меры измерения ставки
|-
|GoodInfo -> Importlist -> Import -> Link||Ссылка на документ
|-
| colspan="2" |'''Акциз'''
|-
|GoodInfo -> Exciselist||Список применяемых акцизов
|-
|GoodInfo -> Exciselist -> Excise||Элемент применяемого акциза
|-
|GoodInfo -> Exciselist -> Excise -> Value||Ставка акциза
|-
|GoodInfo -> Exciselist -> Excise -> ValueDetail||Составляющие компоненты ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueCount||Числовая составляющая ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueUnit||Единицы измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueCurrency||Валюта ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueCount2||Числовая составляющая блока "не менее" ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueUnit2||Единицы измерения блока "не менее"ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> ValueDetail -> ValueCurrency2||Валюта ставки блока "не менее" акциза
|-
|GoodInfo -> Importlist -> Import -> ValueDetailAdd||Составляющие компоненты второй части ставки акциз, если она, например, вида: N%+Mевро/кг
|-
|GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueCount||Числовая составляющая ставки
|-
|GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueUnit||Единицы измерения
|-
|GoodInfo -> Importlist -> Import -> ValueDetailAdd -> ValueCurrency||Валюта
|-
|GoodInfo -> Exciselist -> Excise -> Condition||Описание или условие, при котором акциз применяется
|-
|GoodInfo -> Exciselist -> Excise -> Document||Документ-основание для начисления акциза
|-
|GoodInfo -> Exciselist -> Import -> Measure||Мера измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Import -> Measure -> Name||Название меры измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Import -> Measure -> Razm||Размерность меры измерения ставки акциза
|-
|GoodInfo -> Exciselist -> Excise -> Link||Ссылка на документ
|-
|GoodInfo -> Exciselist -> Excise -> Prim||Примечание по расчету ставки акциза
|-
| colspan="2" |'''НДС'''
|-
|GoodInfo -> VATlist||Список применяемых НДС
|-
|GoodInfo -> VATlist -> VAT||Элемент применяемого НДС
|-
|GoodInfo -> VATlist -> VAT -> Value||Ставка НДС
|-
|GoodInfo -> VATlist -> VAT -> ValueDetail||Составляющие компоненты ставки НДС
|-
|GoodInfo -> VATlist -> VAT -> ValueDetail -> ValueCount||Числовая составляющая ставки НДС
|-
|GoodInfo -> VATlist -> VAT -> ValueDetail -> ValueUnit||Единицы измерения ставки НДС
|-
|GoodInfo -> VATlist -> VAT -> ValueDetail -> ValueCurrency||Валюта ставки НДС
|-
|GoodInfo -> VATlist -> VAT -> Directory||Информация о справочнике
|-
|GoodInfo -> VATlist -> VAT -> Directory -> RuName||Русское название справочника
|-
|GoodInfo -> VATlist -> VAT -> Directory -> EnName||Служебное название справочника
|-
|GoodInfo -> VATlist -> VAT -> MainCondition||Описание категории, для которой НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Condition||Описание или условие, при котором НДС применяется
|-
|GoodInfo -> VATlist -> VAT -> Document||Документ-основание для начисления НДС
|-
|GoodInfo -> VATlist -> VAT -> Link||Ссылка на документ
|-
| colspan="2" |'''Меры нетарифного применения'''
|-
|colspan="2" |Перечень особенностей нетарифного регулирования для данного кода вынесен в отдельный xml

|}

==XML-ответ особенностей нетарифного регулирования ==

{| class="wikitable" width="75%"
|-
|GoodInfo||Корневой элемент документа
|-
|GoodInfo -> Notes||Перечень особенностей для данного кода
|-
|GoodInfo -> Notes -> Note||Элемент
|-
|GoodInfo -> Notes -> Note -> Name||Наименование
|-
|GoodInfo -> Notes -> Note -> Description||Описание
|-
|GoodInfo -> Notes -> Note -> Prim||Примечание
|-
|GoodInfo -> Notes -> Note -> Document||Документ-основание
|-
|GoodInfo -> Notes -> Note -> Link||Ссылка на документ
|-
|GoodInfo -> Notes -> Note -> Table||Если в Описании или Примечании Элемента содержались таблицы, в тексте они заменены на текст Таблица <№ п/п в границах элемента>. Содержимое таблиц выносятся в соответствующем порядке в раздел(ы) Table текущего Элемента
|-
|GoodInfo -> Notes -> Note -> Table -> Row||Строка таблицы
|-
|GoodInfo -> Notes -> Note -> Table -> Col||Столбец строки таблицы
|}

==Ошибки==
При возникновении ошибки в корневом элементе появляется блок с кодом и описанием ошибки. 
При работе с сервисом возможны следующие ошибки:

{| class="wikitable" width="75%"
|+
!Код!!Описание
|-
|100||Пользователь не авторизирован
|-
|110||Лимит запросов для данного пользователя исчерпан
|-
|120||Ошибка тарификации
|-
|200||Информация по данному коду ТН ВЭД не найдена, несуществующий код ТН ВЭД
|-
|210||Формат даты не соответствует
|-
|220||На запрошенную дату код не действует. «Действие кода прекращено с…» или «Действие кода начнется с…»
|-
|250||Код страны не найден
|}

==Примеры ошибок==
Пользователь не авторизирован: 
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin1&secret=23d8cf433cf6603b457d4ba10756afbe

Лимит запросов для данного пользователя исчерпан: 
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testloginlimit&secret=2871c36a477fe95b4dc7786efadaca1d

Формат даты не соответствует: 
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&date=03.07.17&secret=23d8cf433cf6603b457d4ba10756afbe

Информация по данному коду ТН ВЭД не найдена, несуществующий код ТН ВЭД: 
https://www.alta.ru/tnved/xml/?tncode=5102297100&login=testlogin&secret=e300194edf9719fec95fedccb33f12e4

На запрошенную дату код не действует: 
https://www.alta.ru/tnved/xml/?tncode=0102297100&login=testlogin&secret=2e49388b0703b7a2e8b58548ad922cbd

Код страны не найден: 
https://www.alta.ru/tnved/xml/?tncode=1506000000&login=testlogin&secret=23d8cf433cf6603b457d4ba10756afbe&country=3417

[[Категория:Автоматизация]]
[[Категория:Web-Сервисы]]
[[Категория:Такса]]

API онлайн-сервиса Товары и Коды

2022-03-25T14:37:42Z

Admin: Admin переименовал страницу XML-API для ТиК онлайн в API-XML для ТиК онлайн без оставления перенаправления

API для получения справки о товаре (Такса)

2022-03-25T14:37:13Z

Admin: Admin переименовал страницу XML-API для получения справки о товаре (Такса) в API-XML для получения справки о товаре (Такса) без оставления пере…

Экспорт в 1С:Предприятие 8.х

2017-11-07T09:05:36Z

Admin: /* Экспорт данных */

= Основные сведения =

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

Выгрузка является универсальной и может использоваться в таких конфигурациях, как "Управление торговлей" и "Бухгалтерия предприятия".
Однако в связи с тем, что все конфигурации 1С отличаются друг от друга от версии к версии, с какими то из них обработка может не работать.
В таких случаях необходимо написать письмо в адрес техподдержки "Альта-Софт" с описанием и, по возможности, скрином ошибки.

ПРИМЕЧАНИЕ: выгрузка в 1С версии 7.7 не поддерживается!

= Экспорт данных =

Экспорт данных осуществляется в следующей последовательности:

1. Сначала необходимо выгрузить ДТ из программы "Альта-ГТД" в XML-файлы во внутреннем формате: Каталог - Выгрузка в XML (Альта) ...

2. Открыть в программе 1С внешнюю обработку IMPORTGTD_U.EPF (для конфигураций с управляемыми формами) или IMPORTGTD_O.EPF (для старых конфигураций с обычными формами): Файл - Открыть ...

Сама обработка находится в папке Alta\Export1C.

3. В появившемся окне выбрать файлы для загрузки (кнопка "Добавить файлы"), отметить флажками, какие типы документов должны быть сформированы (ГТД по иморту и/или Поступление товаров и услуг), и выбрать метод загрузки данных - Использовать или нет дополнение к гр.31, по которому загрузка товаров производится либо по гр.31 либо по артикулам из описания к гр.31.

[[Файл:import1c.png]]

4. Загрузить данные нажатием соответствующей кнопки. Результат операции будет отображен в поле статуса операции.

[[Категория:Альта-ГТД]]
[[Категория:1C]]
[[Категория:Автоматизация‏‎]]

Параметры командной строки (Такса)

2014-08-21T08:30:04Z

Admin: /* Генерация справки о товаре */

== Параметры командной строки "Такса" '''taxwin.exe''' ==

* '''/ini2profile''' - хранить все настроечные и пользовательские файлы в папке текущего профиля (типа C:\Documents and Settings\User\Local Settings\Application Data\Alta\Taxwin). Рекомендуется при установке на терминал-сервер.
* '''/Z"путь"''' - загрузить INI-файл в формате Заполнителя (файл будет удален!)
* '''/I"путь к ini"''' - использовать указанный файл для хранения настроек. Так же хранить все пользовательские файлы в указанной папке рядом с ini
* '''/noAdo''' - не использовать библиотеку MDAC (доступ к MDB). Аналог '''noAdo=1''' в секции '''[common]''' в config.ini.
* /E"путь к файлу-макросу" - обработать спец.файл с инструкциями (выдача справки по запросу, расчет списка товаров и т.д.)
* '''/?''' - показать данную подсказку

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

В качестве сигнального символа допускается и / и -. Например

taxwin.exe -Z /Z

Дополнительные строковые параметры пишутся слитно с ключём, без пробелов, либо в кавычках, например

taxwin.exe /Zc:\Alta\In\F112A4D5.ini
taxwin.exe /Z"c:\"Program Files (x86)\Alta\In\F112A4D5.ini"

== Выполнение файлов-макросов ==

Ключем '''/E''' можно инициировать обработку Таксой файла специального формата с инструкциями.
При помощи такого макроса можно заставить программу сгенерировать [[Справка о товаре|Справку о товаре]] или рассчитать платежи для переданного в XML файле списка товаров.

=== Генерация справки о товаре ===

Если вызвать Таксу с ключем '''-E'''

taxwin.exe -eC:\Alta\IN\my_request.ini
или
taxwin.exe -e"C:\Documents and Settings\Семён\Мои документы\my_request.ini"

указав на [[w:.ini]]-файл следующей структуры

<source lang=ini>
[TaxMacro]
ACTION=MAKESPRAVKA
TNVED=3921190000
REGIM=ИМ
COUNTRY=DE
TRADEMARK=
OKP=
DATE=14.01.14
IE=0
FileName=C:\USERS\Василий\APPDATA\LOCAL\TEMP\67653163.htm
CustomerWndClass=TMain
CustomerWndHandle=2755280
CustomerMSG=1025
CustomerExec=C:\ERP\myERP.exe %Filename
</source>

то Такса сгенерирует справку о товаре в виде [[w:HTML]] файла с именем указанным в ключе '''FileName'''.

Ключи '''TNVED, REGIM, COUNTRY, TRADEMARK, OKP, DATE''' задают соответственно код ТНВЭД товара, режим (ИМ или ЭК), буквенный код страны происхождения, код ОКП товара и на какую дату необходимо сгенерировать справку.

Ключ '''IE''' в значении '''=1''' приведет к отображению справки о товаре в стандартном [[w:Браузер]]е. При значении '''=0''' Такса будет пытаться обработать ключи с префиксом '''Customer...'''.

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

Если заполнен ключ '''CustomerExec''', то будет выполнена указанная команда.
Иначе будет отослано сообщение (Windows Message) с кодом CustomerMSG в запущенное приложение с handle окна '''CustomerWndHandle''' или именем класса окна '''CustomerWndClass'''.

=== Расчет списка товаров ===

Если вызвать Таксу с ключем -E и указать на ini файл структуры вида

<source lang=ini>
[TaxMacro]
ACTION=CALCINVOICE
FileName=C:\USERS\Василий\APPDATA\LOCAL\TEMP\67653163.XML
OutPutFileName=C:\USERS\Василий\APPDATA\LOCAL\TEMP\67653163.XML
CustomerWndClass=TMain
CustomerWndHandle=2755280
CustomerMSG=1025
CustomerExec=C:\ERP\myERP.exe %Filename
Silent=0
</source>

а в файл, указанный в ключе '''FileName''' поместить информацию о списке товаров в формате XML в виде структуры

<source lang=xml>
<?xml version="1.0" encoding="UTF-8"?>
<INVOICE>
<HEAD>
<CURRENCY>EUR</CURRENCY>
<DATE>21.12.2013</DATE>
<REGIM>ИМ</REGIM>
</HEAD>
<GOODS>
<GOOD>
<TNVED>2208601900</TNVED>
<DESCR>ВОДКА, С КОНЦЕНТРАЦИЕЙ СПИРТА 45,4 ОБ% ИЛИ МЕНЕЕ, В СОСУДАХ ЕМКОСТЬЮ БОЛЕЕ 2 Л</DESCR>
<COUNTRY>DE</COUNTRY>
<COUNTRYNAME>ГЕРМАНИЯ</COUNTRYNAME>
<PRICE>552</PRICE>
<ART>VDK1003345</ART>
<UNIT2>20</UNIT2>
<NETTO>912.56</NETTO>
<BRUTTO>1012.56</BRUTTO>
<FIRM>ZAFIROFF</FIRM>
<DESCREN>VODKA ZAFIROFF vol.2,5 litre</DESCREN>
<WEIGHT>41</WEIGHT>
<ACCWEIGHT>40</ACCWEIGHT>
<QTY>21</QTY>
<DEFNDS>18</DEFNDS>
</GOOD>
<GOOD>
... Следующий товар ...
</GOOD>
... и т.д. ...
</GOODS>
</INVOICE>
</source>

то программа загрузит XML в список товаров и произведет расчет платежей. С помощью элементов в теге <HEAD> можно управлять основными параметрами расчета: CURRENCY (валюта), DATE (дата), REGIM (режим, определяется по первой букве значения И/Э).
При необходимости дополнительной детализации будут заданы вопросы о характеристиках товаров
влияющих на расчет платежей. Данные вопросы можно отключить параметром Silent=1 в ini-файле, тогда программа отработает в тихом режиме, а при необходимости вмешательства оператора в работу напишет об этом в результирующем файле в теге <PAYS>: "Для окончания расчета требуется вмешательство оператора". Если все ответы будут получены, вопросов вообще не возникнет или указан параметр Silent=1,
то результаты расчета будут выгружены в XML файл схожей структуры с именем указанном в ключе '''OutPutFileName'''.
Пир этом первоначальный XML удаляется.

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

Поля XML с характеристиками товара означают:

* TNVED - * код ТНВЭД
* DESCR - Описание товара
* COUNTRY - * буквенный (ALFA2) код станы происхождения товара
* PRICE - * стоимость товара
* ART - Артикул товара
* UNIT2 - количество в дополнительных единицах измерения
* NETTO - вес нетто, кг
* BRUTTO - вес брутто, кг
* FIRM - название производителя
* DESCREN - описание на англиском
* WEIGHT - '''* Основа для расчета Пошлины'''
* ACCWEIGHT - '''*Основа для расчета Акциза'''
* QTY - количество в штуках
* DEFNDS - ставка НДС по умолчанию

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

<source lang=xml>
<?xml version="1.0" encoding="UTF-8"?>
<INVOICE>
<HEAD>
<CURRENCY>EUR</CURRENCY>
<DATE>21.12.2013</DATE>
<PAYS>
<PAY>
<NAME>Таможенный сбор</NAME>
<BASE>35 207.47</BASE>
<RATE>375РУБ.</RATE>
<SUMM>375.00</SUMM>
</PAY>
</PAYS>
<REGIM>ИМ</REGIM>
</HEAD>
<GOODS>
<GOOD>
<TNVED>2208601900</TNVED>
<DESCR>ВОДКА, С КОНЦЕНТРАЦИЕЙ СПИРТА 45,4 ОБ% ИЛИ МЕНЕЕ, В СОСУДАХ ЕМКОСТЬЮ БОЛЕЕ 2 Л</DESCR>
<COUNTRY>DE</COUNTRY>
<COUNTRYNAME>ГЕРМАНИЯ</COUNTRYNAME>
<PRICE>552</PRICE>
<ART>VDK1003345</ART>
<UNIT2>20</UNIT2>
<NETTO>912.56</NETTO>
<BRUTTO>1012.56</BRUTTO>
<FIRM>ZAFIROFF</FIRM>
<DESCREN>VODKA ZAFIROFF vol.2,5 litre</DESCREN>
<WEIGHT>41</WEIGHT>
<ACCWEIGHT>40</ACCWEIGHT>
<QTY>21</QTY>
<DEFNDS>18</DEFNDS>
<PAYS>
<PAY>
<NAME>Пошлина</NAME>
<BASE>41.00 л</BASE>
<RATE>1.83евро/л</RATE>
<SUMM>3412.95 руб</SUMM>
</PAY>
<PAY>
<NAME>Акциз</NAME>
<BASE>40.00 л.сп</BASE>
<RATE>500руб/л.сп</RATE>
<SUMM>20000.00 руб</SUMM>
</PAY>
<PAY>
<NAME>НДС</NAME>
<BASE>41825.57 руб</BASE>
<RATE>18%</RATE>
<SUMM>7528.60 руб</SUMM>
</PAY>
</PAYS>
</GOOD>
<GOOD>
... Следующий товар ...
</GOOD>
... и т.д. ...
</GOODS>
</INVOICE>
</source>

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

Если заполнен ключ CustomerExec, то будет выполнена указанная команда. Иначе будет отослано сообщение (Windows Message) с кодом CustomerMSG в запущенное приложение с handle окна CustomerWndHandle или именем класса окна CustomerWndClass.

[[Категория:Такса]]
[[Категория:Автоматизация]]

Экспорт данных в офисные приложения

2014-07-21T13:21:18Z

Admin: /* Специальные идентификаторы */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

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

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

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

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

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

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

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

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

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

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

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

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

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

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

==== Для извлечений из гр.31 ДТ ====

* '''%%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)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

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

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

==== Обработка по условию =====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

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

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

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

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

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

Примеры использования дополнительных параметров

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код

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

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

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

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

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Экспорт данных в офисные приложения

2014-07-21T13:19:46Z

Admin: /* Правила составления идентификаторов */

== Общие сведения о функции ==

Для наиболее эффективной организации вывода документов на печать программы Альта (ГТД, Такса) позволяют переносить данные в офисные приложения Microsoft (Word, Excel) или OpenOffice. Данные оформляются согласно шаблонам – предопределенным в программе или изготовленным пользователем. В шаблонах могут быть задействованы все возможности указанных редакторов (форматирование таблиц, вставка графики и пр.). Экспорт осуществляется при помощи OLE-серверов, внедренных в офисные приложения, т.о. требуется обязательная установка этих приложений на компьютер пользователя.
Для случаев, когда офисные приложения на компьютере пользователя не установлены, в программе предусмотрена выгрузка данных в файлы либо простого текстового формата (.txt), либо формата HTML. При этом выгрузка в текстовый формат имеет ограниченную функциональность (не поддерживаются форматирование и таблицы). Выгрузка в HTML имеет полноценную функциональность, но требует определенных навыков для подготовки и оформления шаблонов.

== Окно настройки выгрузки ==

Выбор и настройка шаблонов для последующей выгрузки документа выполняется в окне «Печать документа в шаблон Office», вызываемом по команде главного меню Печать|Печать в Word/Excel/OpenOffice (для ГТД) или по нажатию Ctrl+Shift+F9.

== Шаблоны ==

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

=== Выбор шаблона ===
Необходимый шаблон можно либо выбрать среди уже имеющихся, либо создать новый.
Способы выбора шаблона:
* по кнопке <Выбрать шаблон> (в левой части окна) – раскрывается основной список всех имеющихся шаблонов (при вызове окна «Печать документа в шаблон Office» этот список раскрыт по умолчанию);
* по кнопке <Недавние шаблоны> (в левой части окна) – открывается история печати, т.е. список последних использовавшихся для печати шаблонов (дата и время указаны в колонке «Изменен»). С шаблонами из этого списка можно производить [[#.D0.9A.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.B0.D0.BC.D0.B8|те же команды]], что и с шаблонами из основного списка. Список недавно использовавшихся шаблонов можно очистить по кнопке <Очистить историю печати>. Сами шаблоны при этом не удаляются.

=== Создание основы для нового шаблона ===
Если в основном списке подходящего шаблона нет, то можно либо создать его самостоятельно либо использовать один из имеющихся стандартных.
Чтобы взятый за основу шаблон (вновь созданный или стандартный) стал доступен для редактирования, необходимо внести его в основной список. 
:'''Для стандартных:'''
# нажмите на кнопку <Готовые шаблоны> (в левой части окна);
# в появившемся списке стандартных шаблонов выберите подходящий;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите на кнопку <Создать> в правом нижнем углу окна) – шаблон будет перенесен в основной список (раскрываемый по кнопке <Выбрать шаблон>) и станет доступным для редактирования, печати и т.д.
'''''Примечание'''''. Стандартные шаблоны хранятся в папке alta\template\default\. Список шаблонов – в файле template\default\template.ini. После выбора стандартного шаблона и нажатия кнопки <Создать> шаблон будет скопирован из template\default\ в рабочую папку документа с шаблонами. 
:'''Для новых шаблонов:'''
# нажмите кнопку <Создать шаблон> (в левой части окна);
# выберите из списка пустой шаблон требуемого формата;
# дважды щелкните левой клавишей мыши по выбранному шаблону (или нажмите кнопку <Создать> в правом нижнем углу окна) – будет предложено два варианта:
## создать табличный шаблон с выбранными полями – в этом случае выбирается блок текущего документа (товары или дополнение) и поля этого блока, которые будут автоматически будут вставлены в шаблон в виде таблицы.
## создать обычный шаблон – будет создан пустой шаблон.
Новый шаблон появится в основном списке и станет доступным для редактирования, печати и т.д. 
'''''Примечание'''''. Отображение форматов, доступных для создания нового шаблона, зависит от того, какое ПО установлено на данном компьютере: форматы TXT и HTML, раскрываемые стандартными программами ОС, доступны всегда; форматы DOC/XLS (MS Office) и ODT/ODS (OpenOffice) доступны только в том случае, если на компьютере установлены соответствующие офисные приложения.

=== Команды для работы с шаблонами ===
К шаблонам, отображаемым в основном списке, можно применить следующие команды:
* Печатать документ согласно шаблону (кнопка <Печатать>, кнопка на панели инструментов или Ctrl+P) – выбранный шаблон открывается в соответствующем офисном приложении (Word, Excel или OpenOffice), при этом в него выгружаются данные из текущего электронного документа;
'''''Примечание'''''. В процессе загрузки данных в шаблон на экране отображается окно с индикатором процесса выгрузки.
При необходимости выгрузку можно отменить по нажатию кнопки <Отмена>. При нажатии на кнопку <Подробно> будет отображаться протокол выгрузки (в нем отображаются сопровождающие процесс уведомления, предупреждения и сообщения об ошибках).
По окончании выгрузки протокол можно сохранить в текстовом формате, нажав на кнопку <Сохранить отчет>. Сохраненный протокол может понадобиться при обращении в техподдержку в случае возникновения ошибок.
* Редактировать шаблон (кнопка или F4) – выбранный шаблон открывается для редактирования в соответствующем офисном приложении, не загружая данные из документа;
* Удалить шаблон (кнопка или кнопка Del или Ctrl+D) – шаблон удаляется из основного списка (а также сам файл шаблона из соответствующей папки);
* Открыть папку, содержащую файлы шаблонов (кнопка или Ctrl+E).
'''''Примечание'''''. Выбор папок для хранения шаблонов осуществляется для каждого типа документов (ГТД, ДТС и т.д.). По умолчанию используются стандартные папки в alta\template\. При необходимости редактирования путей к этим папкам нажмите кнопку <Настройки> (в левой части окна).
* Редактировать комментарий к документу (кнопка или Ctrl+Z). Комментарий – это строка, которая в основном списке отображается вместо названия файла шаблона.
'''''Примечание'''''. Команды работы с шаблонами, расположенные на панели инструментов, дублируются в меню, вызываемом щелчком правой клавишей мыши по выбранному шаблону.

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

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

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

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

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

'''%%START'''[BLOCK,3,8] %%31.NAME '''%%END'''[BLOCK] - будут выгружены описания товаров только с 3 по 8 товар.

Частный случай - %%START[BLOCK,2,2] - в этом случае выгрузятся поля из одного товара - второго. 
Частный случай - %%START[BLOCK,0,0] - в этом случае выгрузятся поля из всех товаров в одну строку через запятую. 
%%START %%END будучи размещенными в одной строке, при размножении формируют таблицу. Если разместить их в начале и конце страницы, то получится лист-карточка для для каждого товара. 
При добавлении ! в начале идентификатора (после %%, например %%!33_1) проверяется на повторы значений в цикле START/END. Повторяющиеся значения в шаблон не выводятся. 
Для получения информации из вложенных блоков, т.е. блоков содержащихся в основном блоке используются директивы 

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

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

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

Чтобы выгрузить поле из определенного блока вне цикла START/END, используется такая запись: '''%%BLOCK\2\TXT\3\TEXT'''. 
Для выгрузки значений поля из всех товаров через запятую - '''%%BLOCK\0\33_1'''. 

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

==== Для извлечения из справочников ====

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

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

==== Для извлечений из гр.31 ДТ ====

* '''%%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)

* '''%%LABELEDFIELD(''<КОММЕНТАРИЙ>'', ''<ИМЯ_ПОЛЯ>'')''' – Выводит значение поля <ИМЯ_ПОЛЯ> с комментарием. Например:

'''%%LABELEDFIELD'''(Код ТНВЭД:, 33_1)

* '''%%BLOCKNUM''' – выводится номер текущего выгружаемого товара (используется внутри %%START[BLOCK] %%END[BLOCK]); 
* '''%%BLOCKCOUNT''' – выводится количество товаров в документе; 
* '''%%NUMBLOCK(''<ИМЯ_БЛОКА>'')''' – выводится количество записей в блоке, например:

'''%%NUMBLOCK(BLOCK)''' - количество товаров ДТ
'''%%NUMBLOCK(BLOCK\1\TOVG)''' - количество артикулов в первом товаре ДТ;

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

* '''%%USERNAME''' - автор документа. 
* '''%%TOVGCOUNT''' - количество записей в дополнениях TOVG (артикулов) во всей ДТ. 
* '''%%SUMMARY''' - суммирует значения поля из дополнения по всему документу, например:

'''%%SUMMARY(BLOCK\TOVG\KOLVO)''' - просуммирует поле KOLVO по всей ДТ. 

* '''%%SUMALL(''<ИМЯ_ПОЛЯ>'')''' - сумма значений поля <ИМЯ_ПОЛЯ> по всем документам (при выгрузке списка документов в один шаблон)

==== Обработка по условию =====

* '''%%IIF(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ1>'', ''<ЗНАЧЕНИЕ2>'')''' – В зависимости от значения поля <ИМЯ_ПОЛЯ> (True, False) выведет либо <ЗНАЧЕНИЕ1> либо <ЗНАЧЕНИЕ2>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Примеры:

'''%%IIF(IMPORT,происхождения,назначения)'''
'''%%IIF(ONECOUNTRY,%%REF(COUNTRS,CODE,Country,KrName),РАЗНЫЕ)'''

* '''%%NZ(''<ИМЯ_ПОЛЯ>'', ''<ЗНАЧЕНИЕ>'')''' – если значение поля <ИМЯ_ПОЛЯ> непустое, то выгружает его, иначе выгружает <ЗНАЧЕНИЕ>. Вместо ЗНАЧЕНИЯ может использоваться идентификатор с %%. Например:

'''%%NZ(REF(COUNTRS,CODE,Country,DESCR),Прочая)'''

* '''%%STARTDEL[''<ИМЯ_ПОЛЯ>'']...%%ENDDEL''' - если заключить фрагмент текста в шаблоне в эти операторы, то при пустом или равном "0" значении поля <ИМЯ_ПОЛЯ> данный фрагмент будет удален из шаблона. 

==== Для извлечения из взаимосвязанных документов ====

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

%%'''INV.'''42_ZAEDINIC

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

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

'''%%START'''[BLOCK] ''Начало основного блока (товар ГТД)''
'''%%STARTSUB'''[INVDOC] ''Начало вложенного блока (товары инвойса, из которых состоит данный товар ГТД)''
'''%%BLOCK\INVDOC\31_ARTICUL''' ''поля из товаров инвойса''
'''%%ENDSUB'''[INVDOC] ''Конец вложенного блока''
'''%%END'''[BLOCK] ''Конец основного блока''

==== Для гр.44 ДТ или гр. "Документы 1-15" Инвойса ====

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

- %%@44_!_код документа_дополнительные параметры.

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

Примеры использования:

'''%%@44_!_06011''' – выгрузятся все документы гр.44 с кодом 06011,
'''%%@44_!_04021''' - выгрузятся все инвойсы
'''%%@44_!_01''' - выдаст все документы с кодами начинающиеся на 01

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

Примеры использования дополнительных параметров

'''%%@44_!_06011_О''' - выдавший орган для сертификатов (пишется в конце строчки после последней даты, без запятой),
'''%%@44_!_06011_ДО''' – выгружает номер с первой и со второй датой,
'''%%@44_!_06011_nodate''' – выгружает номер без дат,
'''%%@44_!_06011_date''' - только первая дата,
'''%%@44_!_04021''' - номер и дату инвойса.
'''%%@44_!_04021_date''' - только дату инвойса.
'''%%@44_!_01_wcode''' - выдаст все документы с кодами начинающиеся на 01, дописать перед номером
документа его пятизначный код

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

Аналогично эти идентификаторы работают и в документе [[Инвойс]]. В нем они извлекают данные из полей Документ1-15 и дополнения "Документы переданные из программы Артикул"

==== Для графы 47 и B документа ДТ ====

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

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

- %%@B_код вида платежа. Пример:

'''%%@B_1010''' – выгрузится сумма платежей по коду 1010.

=== Выгрузка нескольких документов в один шаблон ===

Выгрузка нескольких документов в один шаблон запускается из списка документов (Печать\Печать в Word\Excel\OpenOffice..). 
При этом будет предложено выгрузить все документы из текущей папки либо выбранные документы. 
Далее выбирается шаблон и запускается печать как обычно.
В табличный шаблон будут выгружены товары из всех выбранных документов. Если в шаблоне есть поля из шапки документа, то эти поля будут взяты из первого выбранного документа.

Для выгрузки списка документов (только поля из шапки) предназначены идентификаторы %%START[DOC] ... %%END[DOC], которые образуют таблицу с количеством строк по количеству выбранных документов. 
Пример:

%%START[DOC] %%7_1 %%8_NAM %%9_NAM %%END[DOC]

=== Окно с полями документа для редактирования шаблонов ===
Окно с полями документа открывается при редактировании шаблона если включена соответствующая настройка (стоит галочка в закладке с настройками).
В окне отображаются все поля соответствующего документа (например ГТД) в виде дерева. Идентификаторы полей перетаскиваются в шаблон мышью. Кроме того можно перетаскивать [[#.D0.9F.D1.80.D0.B0.D0.B2.D0.B8.D0.BB.D0.B0_.D1.81.D0.BE.D1.81.D1.82.D0.B0.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|специальные идентификаторы]] и [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|пользовательские идентификаторы (свои поля)]]. Ниже дерева с полями есть строка для быстрого поиска нужного поля. 
Чтобы перетащить сразу несколько идентификаторов, выделите их все, удерживая нажатым Ctrl или Shift. После перетаскивания, поля расположатся в шаблоне в том же порядке, в каком они идут в окне. Порядок можно поменять используя кнопки "Переместить выделенные поля выше/ниже" на панели инструментов (выделить нужные поля и нажать соответствующую стрелку для перемещения выше или ниже).
Есть также следующие настройки:
* Прозрачность окна – меняется ползунком;
* Использовать START END – при перетаскивании полей они автоматически образуют собой таблицу со START[''<ИМЯ_БЛОКА>''] и END[''<ИМЯ_БЛОКА>''] (неприменимо для полей из заголовка документа).
* Перетаскивать поля с именами – совместно с идентификатором в шаблон вставляется и русское наименование поля;
* Не показывать больше это окно – выключение отображения окна с полями при редактировании шаблона, включить можно в [[#.D0.9E.D1.81.D1.82.D0.B0.D0.BB.D1.8C.D0.BD.D1.8B.D0.B5_.D0.BA.D0.BE.D0.BC.D0.B0.D0.BD.D0.B4.D1.8B_.D0.BE.D0.BA.D0.BD.D0.B0_.D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_.D0.B2.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B8|закладке с настройками]];
Одновременно можно редактировать несколько шаблонов. Если это шаблоны разных типов документов, то все такие типы добавятся в окно в виде отдельных деревьев и переключаются соответствующими кнопками с наименованиями типов в верхней части окна.

== Остальные команды окна настройки выгрузки ==
Помимо команд для работы с шаблонами, в окне настройки выгрузки можно открыть для просмотра и редактирования список пользовательских идентификаторов для данного документа (кнопка <Свои поля>).

'''''Примечание'''''. Использование пользовательских идентификаторов в шаблонах аналогично использованию стандартных идентификаторов. Создание и настройка пользовательских идентификаторов рассматриваются [[#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D1.80.D0.B5.D0.B4.D0.B0.D0.BA.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D1.85_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.BE.D0.B2|в следующем разделе]]. Пользовательские идентификаторы со всеми своими параметрами хранятся в файле [[ALTA\ExtraFields.ini]].

В настройках (кнопка <настройки>) можно настроить для каждого типа документа индивидуальный каталог, где будут сохраняться шаблоны этого документа. Кроме того есть следующие настройки:
* Окно контроля выгрузки – в зависимости от положения бегунка, при выгрузке в шаблон, в окне контроля будут отображаться все сообщения, только ошибки и предупреждения, или окно вообще не будет отображаться.
* Показывать процесс выгрузки – при снятой галочке шаблон не будет виден до окончания выгрузки.
* Показывать окно с полями при редактировании документа – при включенной настройке рядом с открытым для редактирования шаблоном будет показано окно с полями для текущего документа. Из этого окна мышью можно перетаскивать нужные поля прямо в шаблон. Если перетаскивать сразу несколько полей, в шаблоне автоматически будет создана таблица.
* Обрезать большие описания – можно настроить обрезку больших полей при выгрузке
* Выгружать в открытый файл - если какой-либо файл уже открыт в текстовом или табличном редакторе офиса, то будет предложено выгрузить в этот файл, без создания нового. Для Excel будет создан новый лист, для Word - через разрыв страницы.
* Выгружать список документов в отдельные шаблоны - обычно при выгрузке нескольких документов, они выгружаются в одну таблицу. По этой настройке можно выгружать каждый документ в свою таблицу (отдельный шаблон).

== Создание и редактирование пользовательских идентификаторов ==

Помимо идентификаторов, предопределенных в системе (их перечень содержится в файле [[alta\data\gtdwin.dcf]]), при создании шаблонов можно использовать пользовательские идентификаторы.

=== Описание команд меню ===
Список пользовательских идентификаторов открывается по нажатию кнопки <Свои поля> в окне печати. Здесь же идентификаторы можно создавать и редактировать.
В нижней части окна расположены поля для задания [[#.D0.9F.D0.B0.D1.80.D0.B0.D0.BC.D0.B5.D1.82.D1.80.D1.8B_.D0.B8.D0.B4.D0.B5.D0.BD.D1.82.D0.B8.D1.84.D0.B8.D0.BA.D0.B0.D1.82.D0.BE.D1.80.D0.B0|параметров идентификатора]], в верхней части – панель инструментов, где находятся кнопки для выполнения следующих команд:
* Создать новый идентификатор. Вызывает окно для ввода названия нового идентификатора. К названию будет автоматически добавлен двойной знак процента – %%;
* Дублировать идентификатор. Создает новый идентификатор, являющийся точной копией того, к которому была применена эта команда. Необходимо задать только имя идентификатора;
* Сохранить изменения. Сохраняет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла;
* Переименовать идентификатор;
* Выгрузить идентификаторы в файл. Все сохраненные в программе пользовательские идентификаторы хранятся в конфигурационном файле [[alta\ ExtraFields.ini]]. Однако по данной команде идентификаторы можно сохранить в отдельном ini-файле. Выберите один или несколько идентификаторов из списка в появившемся окне (порядок следования можно изменить кнопками-стрелочками) и по нажатию <OK> раскроется стандартное окно сохранения файла, в котором следует выбрать путь (по умолчанию – корневой каталог программы) и название ini-файла;
* Загрузить идентификаторы из файла. Команда загружает в программу идентификаторы, сохраненные ранее в отдельных ini-файлах по команде «Выгрузить идентификаторы в файл». Если при загрузке обнаружится совпадение имен с уже имеющимися в редакторе идентификаторами, то будет предложено заменить имеющийся на новый или задать для нового другое имя.
* Отменить все изменения. Команда отменяет все изменения в списке идентификаторов, включая создание, удаление и загрузку из файла.

=== Параметры идентификатора ===
В нижней части окна со списком пользовательских идентификаторов располагается группа полей для ввода параметров выбранного идентификатора.
После выполнения команды «Создать» для нового идентификатора отображаются только два основных поля:
* Выберите тип идентификатора – здесь из выпадающего списка выбирается действие, которое необходимо будет произвести с выбранным полем документа. Если в списке выбрать пункт «Не назначено», то при выгрузке идентификатор будет заменен на значение выбранного поля документа.
* Выберите поле – сюда следует ввести или выбрать из списка имя стандартного идентификатора поля (если выделить поле в окне редактирования электронного документа, то соответствующий этому полю стандартный идентификатор появится в статусной строке - в правом нижнем углу окна). Если в этом поле оставить изначальное значение noname, то при выгрузке этот пользовательский идентификатор будет проигнорирован (на его месте ничего вставлено не будет);
На данный момент в программе доступны следующие варианты действий с полем:
* Применить регулярное выражение – при выборе этого варианта открывается поле для ввода регулярного выражения, которое будет применено при выводе значения указанного поля.
* Взять значение из справочника – в этом случае открываются дополнительные поля:
*# два поля группы Выбор справочника – в левом поле справочник выбирается из списка (раскрывающегося по нажатию кнопки в правой части поля), правом – путем выбора файла .dbf (по умолчанию, для выбора файла со справочником предлагается папка alta\ref). При выборе значения любого из этих полей второе поле заполняется автоматически;
*# Выберите ключевое поле – поле в справочнике, с которым будет соотнесено значение поля документа, т.е. поле документа будет использоваться в качестве ключа при поиске;
*# Выберите возвращаемое поле – выбирается поле в справочнике, значение которого будет возвращено в качестве результата применения идентификатора.
* Взять часть поля посимвольно – из строки значения поля выбрать подстроку, начинающуюся и заканчивающуюся символами с номерами, указанными в соответствующих полях С и По. Кроме того, можно задать обратный порядок отсчета символов (флажок «Отсчитывать с конца»).
* Извлечь слова – аналогично предыдущему варианту, с той лишь разницей, что из значения поля выбираются не символы, а целые слова.
* Значение по запросу – задается несколько вариантов значений для вставки в шаблон при выгрузке (варианты разделяются построчно). Если в процессе выгрузки документа программа обнаружит в шаблоне идентификатор такого типа, выгрузка приостановится и появится окно с предложением выбрать один из заданных вариантов. Если не было задано ни одного варианта или ни один из заданных не подходит, можно в поле ввода ввести произвольное значение. Введенное значение будет вставлено в шаблон.
* Значение в зависимости от значения поля – для выбранного поля предлагается создать список диапазонов значений, которым будут соответствовать какие-то выводимые значения. Пример для кода ТНВЭД (33_1):

0101000000 0101999999 0
4012000000 4012999999 1
0000000000 9999999999 Другое

В этом примере при выгрузке товаров в шаблон для товаров с кодом ТНВЭД от 0101000000 до 0101999999 будет выведено значение «0», для кода от 4012000000 до 4012999999 – значение «1», для всех остальных кодов будет выведено значение «Другое».

== Планировщик печати ==

Используется для автоматической выгрузки документов в шаблон при запуске ГТД. 
Для автозапуска планировщика необходимо прописать для gtdw.exe параметр командной строки -w и после параметра указать путь к файлу с настройками планировщика. Например:

C:\Alta\gtdw -w C:\1.ini

В файле с настройками должна быть секция [PrintParams], в которой допускаются следующие параметры:

* DocType - тип документа,
* Dir - наименования папок, из которых выгружать документы (необязательный),
* RootDir - выгружать или нет из корневого каталога (по умолчанию не выгружает),
* DateFrom - начальная дата документа,
* DateTill - конечная дата документа,
* TemplateName - путь к шаблону,
* Registered - выгружать только зарегистрированные (по умолчанию выгружает все),
* DirNoPrint - папки, из которых НЕ выгружать (не обязательный).

Например:

[PrintParams]
DocType = GTD
Dir = Dir1,Dir2,Dir2\SubDir
RootDir = 1
DateFrom = 22.12.2011
DateTill = 28.12.2011
TemplateName = C:\Alta\template\GTD\Platechi.XLS
Registered = 1

[[Категория:Альта-ГТД]]

Обсуждение:Ошибки в SQL режиме (FAQ)

2013-01-23T21:31:46Z

Admin: Новая страница: «Предлагаю как-то структурировать FAQ. Добавить <nowiki> == Заголовок == </nowiki> по категориям вопр…»

Предлагаю как-то структурировать FAQ.
Добавить <nowiki> == Заголовок == </nowiki> по категориям вопросов хотя бы.
Но в идеале оглавление статьи должно состоять из как раз вопросов. Только коротко сформулированных, весь текст длинных вопросов в заголовки плохо тянуть.
--[[Участник:Admin|Admin]] ([[Обсуждение участника:Admin|обсуждение]]) 01:31, 24 января 2013 (MSK)

Получение статуса ГТД

2013-01-21T13:49:46Z

Admin:

Для получения статуса необходимо получить для данной ГТД из базы SQL значение поля [EDSTAT], которое содержится в таблице [Docs]. Для конвертации полученного кода в текстовое сообщение можно использовать нижеприведенный код программы на паскале (функция EDDocStatusStr). Данный код можно портировать на любую другую платформу, но надо учитывать, что данный код (как и коды статусов) постоянно меняются, что требует их пополнения и обновления.

<source lang=delphi>
unit EdConsts;

interface
Uses Windows, Graphics, DB;

const
//Статусы ГТД при ЭД
esReqProcess = 1; //Поставили в очередь и ждем ProcessId
esRegistered = 2; //Присвоен номер
esChecking = 3; //Идет проверка (основное состояние)
esInspecting = 4; //Идет досмотр
esCheckDone = 5; //Проверка закончена
esDone = 7; //Выпуск разрешен
esArrived = 11; //Груз прибыл (ПРД)

esPiSend = 8; //ПИ отослано
esPiRegistered = 9; //ПИ зарегистрированно
esConditionalPayment = 12; // Выпуск при условии обеспечения уплаты таможенных платежей
esDiffResultOnGoods = 17; // Решение различно по товарам

//Архивные док-ты
esArchWaiting = $20; //Отправлена в архив, ждем
esArchSent = $21; //Лежит в архиве

//"Плохие" варианты
esError = $1000; //Системная Ашипка
esDecline = $2000; //Декларация не принята
esToPaper = $4000; //Переход на обычный порядок оформления
esRecalled = $8000; //Декларация отозвана декларантом

EDDocStArch:array[$20..$21] of string = ( 'Отправлен в архив...',
'В архиве');
EDDocStExt:array[1..16] of string = ( 'Запрошены док-ты!',
'Уведомление о досмотре!',
'Получен протокол ошибок!',
'?',
'Системная ошибка!',
'Отказано в приеме ГТД',
'Переход на "бумагу"',
'Декларация отозвана',
'ГТД отправлена',
'ГТД получена',
'Требуется КТС',
'Проверка стоимости',
'Проверка ТНВЭД',
'Проверка страны',
'Приостановка проверки',
'Отмена приостановки');

EDDocStStr:array[1..17] of String = ( 'Открытие процедуры',
'ГТД присвоен номер',
'Идет проверка',
'Идет досмотр',
'Проверка закончена',
'Условно выпущена',
'Выпуск разрешен',
'ПИ отослана',
'ПИ зарегистрирована',
'ГТД не подана',
'Товар прибыл (ПРД)',
'Выпуск с обеспечением уплаты',
'ГТД отозвана',
'Считается не поданной',
'Выпуск приостановлен',
'Неизвестное решение?',
'Частично выпущена');

function EDDocStatusStr(N:integer):string;
function EDDocColor(K:integer):integer;
function EDMsgColor(DataSet:TDataSet):integer;

const CMNMsgs='''CMN.00001'',''CMN.00002'',''CMN.00003'',''CMN.00004'''; //Не отвечаем
//Статусы сообщений при обмене по ЭД
emsOutNew = 0;
emsOutSent = 1;
emsOutDelivered = 2;
emsOutComplete = 3;
emsOutDelayed = 9;
emsOutBuffered = $10;
emsOutBad = $FF;
emsOutTest = $200;
emsOutDeclined = $1000;
//
emsInNew = $100;
emsInProcessed = $101;
emsInRequest = $109;
emsInUnknown = $1FE;
emsInBad = $1FF;
emsInErrMsg = $300;

implementation

function EDDocColor(K:integer):integer;
begin
Result := clWhite;
if K and (esDecline+esToPaper+esRecalled)>0 then
Result := $EEEEEE
else if K and esError>0 then
Result := $00FFFF
else if K and $F700>0 then
Result := $88DDFF
else if K and $F0=$20 then Case K of
esArchWaiting: Result := $FFFFDD;
esArchSent : Result := $DDFFFF;
end else Case K and $FF of
esReqProcess,esPISend: Result := $FFFFDD;
esRegistered,esPiRegistered: Result := $DDFFFF;
esChecking: Result := $FFDDFF;
esInspecting: Result := $FFCCDD;
esCheckDone: Result := $DDFFEE;
esArrived: Result := $FFDDCC;
esDone: ;//Result := clWhite;
esConditionalPayment: ;
esDiffResultOnGoods: Result := $DDCCFF;
else Result := $EEEEEE;
end;

end;

function EDDocSt(N:integer; Ext:boolean):string;
begin
if Ext then
if N=0 then Result:='' else
if (N<1) or (N>High(EDDocStExt)) then Result:='???'
else Result:=EDDocStExt[N]
else
if (N<1) or (N>High(EDDocStStr)) then Result:='???'
else Result:=EDDocStStr[N];
end;

function EDDocStatusStr(N:integer):string;
var k:integer;
begin
try
if N and $F0=$20 then begin
if (N>=$20) and (N<=$21) then Result:=EDDocStArch[N]
else Result:='???';
Exit;
end else
Result:=EDDocSt(N and $1F,false);
if N>$FF then begin
k:=1; N:=N shr 8;
If N>=$400 then begin
N := N shr 4;
K := 11+N-$40;
N := 1;
end;
while N>0 do begin
if (N and 1>0) then Case k of
4:; //не показываем
6,7,8: Result:=EDDocSt(k,true);
else Result:=Result+'; '+ EDDocSt(k,true);
end;
N:=N shr 1; inc(k);
end;
end;
except
Result:='!!!'
end
end;

function EDMsgColor(DataSet:TDataSet):integer;
begin
with DataSet do begin
Result:=0;
case FieldByName('Status').AsInteger of
emsOutNew : Result:=$DDFFDD;
emsOutSent : Result:=$FFFFDD;
emsOutDelivered : Result:=$DDFFFF;
emsOutComplete : If FieldByName('Incoming').AsBoolean then Result := $88ddFF;
emsOutDelayed : Result:=$DDDDDD;
emsOutBad : Result:=$88FFFF;
emsOutBuffered : Result:=$FFCCDD;
emsInNew : Result:=$DDDDFF;
emsInProcessed : If not FieldByName('Incoming').AsBoolean and (FieldByName('MessageType').AsString<>'ED.11001') then Result := $88ddFF;
emsInRequest : Result:=$8888FF;
emsInUnknown : Result:=$88FFFF;
emsInBad : Result:=$88FFFF;
else Result:=$88FFFF;
end;
if Result=0 then
if Pos(''''+FieldByName('MessageType').AsString+'''',CMNMsgs)>0 then
Result:=$EEEEEE
else
Result:=clWindow
end
end;

end.

</source>

[[Категория:Альта-ГТД]]
[[Категория:Автоматизация]]
[[Категория:Техническая Информация]]
[[Категория:SQLServer]]

Проблема при просмотре ЭД документов

2013-01-21T13:45:35Z

Admin: /* "Expected 0" */

'''Возможные проблемы при просмотре ЭД документов и их решения.''' 

== Access Violation после смены темы Windows ==

При просмотре ЭД документов, после смены темы Windows на не стандартную, может возникнуть ошибка:

[[Файл:aaaaa.jpg]] 

Для решения достаточно переключиться на стандартную и обратно. 

Переключается - правой кнопкой на рабочем столе, "свойства", "темы" - классическая. 

== "Expected 0" ==

Появляется вот такая ошибка:

[[Файл:kkkkk.jpg]] 

Для решения проблемы: 
Скорее всего попорчен файл '''UsrHighLighterStyles.xml''' Надо удалить этот файл.
Он находится: 
- Для терминального режима: 
в папке профиля пользователя C:\Users\<Имя_пользователя>\AppData\Local\Alta\GTD 
- Для обычного режима: 
в папке, куда установлена программа. По умолчанию это C:\alta. 

Если не поможет, то удалите еще файл HighLighterStyles.xml. Он расположен в папке, куда установлена программа. 
По умолчанию это C:\alta. После чего обновите программу. 

[[Категория:Альта-ГТД]]
[[Категория:ЭД-2‏‎]]

Руководство пользователя Инвойс, Оглавление

2013-01-21T13:44:04Z

Admin: /* Заключение */

Это прототип будущего руководства пользователя по приложению [[Инвойс]].
Постепенно все главы будут дополнятся отдельными статьями из которых можно будет собрать полное руководство.

== Назначение приложения Инвойс ==
=== Общая роль Инвойса в автоматизации ===
=== Применение в готовом решении ПК "Акртикул" ===
=== Использование Инвойса для интеграции с корпоративными системами клиента ===

== Накопление и формализация данных ==
=== Создание Инвойса ===
=== Управление внешним видом ===
=== Дозаполнение данных ===
=== Справочник «Артикульная система ===
=== Хранение и перенос документов ===
=== Объединение нескольких реальных инвойсов ===

== Группировка Инвойса==

== Создание ГТД из Инвойса ==

== Создание ЭД2-документов из Инвойса ==

== Получение данных из ГТД обратно в Инвойс ==
=== Перенос платежей в Инвойс ===
=== Выгрузка данных для внешних программы ===
''Основная статья: '''[[Руководство пользователя Инвойс, Выгрузка данных для внешних программы]]''' ''

== Заключение ==

[[Категория:Инвойс]]
[[Категория:Руководства пользователя]]
[[Категория:Незаконченные статьи]]

ЭД Сервис

2013-01-21T13:40:14Z

Admin:

==Описание==

ЭД Сервис является частью ГТД-Сервера, которая отвечает за обмен ЭД сообщениями. Работает на уровне службы системы. 
Файл протокола обмена для ЭД Сервиса называется svd.log и расположен в корневом каталоге ГТД-Сервера.

==Работа с файлом конфигурации==
Перед установкой и запуском службы нужно сначала настроить ЭД сервис с помощью конфигуратора (CONFIGUREEDSERVICE.EXE).
После запуска в трее появится иконка Конфигуратора [[Файл:значок.jpg]], при нажатии на ней правой кнопки мыши появится диалоговое окно

[[Файл:выпад.jpg]] 

'''Внимание:''' Если у вас уже есть настроенная на передачу программа Альта ГТД на этом компьютере, то выбираете пункт «Импорт настроек из Альта ГТД» и переходите сразу к Пункту '''Запуск'''

==Настройка SQL-базы ГТД==

Для начала нужно выбрать настройки подключения к MS SQL Server в меню «Соединение с БД» (Выполняется аналогично настройкам подключения к БД в ГТД-PRO).
В типе БД оставляете по умолчанию «База данных Microsoft SQL Server».
В меню «Имя или IP-адрес сервера» вводите или ip-адрес сервера (если он не появился автоматически в выпадающем меню), либо имя компьютера, на котором установлен MS SQL Server. Если MS SQL Server установлен на том же компьютере, то выбираете (локальный).
В меню «Пользователь» выбираете тип авторизации.
Если подключение к MS SQL Server успешно, то в списке «Имя базы данных» должен появиться список ваших баз данных.

[[Файл:SQL.jpg]] 

В конце необходимо нажать кнопку «Проверить соединение».

==Настройка ЭД2==

После успешного подключения к БД нужно зайти в меню «Настройка ЭД-2» и настроить подключение к серверу пересылок.

[[Файл:Настройка ЭД2.jpg]]

===При подключении через сервер компании «Альта-Софт»===

[[Файл:Настройка ЭД2.jpg]]

Выполните следующие действия: 
'''1.''' В разделе '''Способ доставки сообщений''' установите переключатель на варианте Через сервер Альта-Софт (по протоколу HTTPS) 
'''2.''' В разделе '''Настройки доставки сообщений''' заполните поля Логин и Пароль, а в разделе '''Реквизиты декларанта в системе ЭД-2''' – поля Отправитель (декларант), Получатель (таможня) и ID декларанта (согласно данным, полученным от «Альта-Софт») 
'''3.''' В поле Сертификат ЭЦП (раздела '''ЭЦП и реквизиты декларанта''') нажмите кнопку [[Файл:значок2.jpg]] и выберите Ваш личный сертификат ЭЦП 
'''4.''' Нажмите кнопку «ОК» для сохранения настроек. 

'''Примечание:''' Ваша статистика будет доступна на сайте https://svd.alta.ru (для входа потребуются Логин и Пароль), для быстрого перехода используйте кнопку «Вход на сервер ЭД».

===При подключении напрямую к ЦИТТУ ФТС России===

[[Файл:Гнивц.jpg]]

Выполните следующие действия: 
'''1.''' В разделе '''Способ доставки сообщений''' установите переключатель на варианте "Почта с этого компьютера (E-mail)"; 
'''2.''' В разделе '''Способ доставки сообщений''' заполните поля Кому, От кого, SMTP, POP3, Логин и Пароль, а в разделе '''Реквизиты декларанта в системе ЭД-2''' – поля Отправитель (декларант), Получатель (таможня) и ID декларанта (согласно данным, полученным от ЦИТТУ – см. ниже); 
'''3.''' В поле Сертификат ЭЦП (раздела '''ЭЦП и реквизиты декларанта''') нажмите кнопку [[Файл:Значок2.jpg]] и выберите Ваш личный сертификат ЭЦП; 
'''4.''' Нажмите кнопку «ОК» для сохранения настроек. 

'''Пример:''' 

Данные для заполнения п. 3) приходят от ЦИТТУ обычно в таком виде (пример для фирмы ООО «МАЛИНА»): 
Внешний шлюз: ip 10.1.1.2 
Mail(login): malina@eps.customs.ru 
Passw: JeG4UH2WR 
Адресат для отправки: gateway@eps.customs.ru 
Тема письма: EDS 
Идентиф. декларанта: 1027739046593 
Электронное декларирование 
Альбом форматов: 4.3.0 
Специф. обмена: 2.6.0 
<SenderInformation>smtp://eps.customs.ru/malina</SenderInformation> 
<ReceiverInformation>smtp://eps.customs.ru/gateway</ReceiverInformation> 
<SoftVersion>4.3.0/2.6.0</SoftVersion> 
Вводить эти данные надо следующим образом: 

[[Файл:Таблица.jpg]]

===При подключении нескольких фирм и нескольких операторов===

[[Файл:Несколько.jpg]]

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

'''1.''' Установить галочки напротив пунктов '''Несколько ЭЦП''', '''Несколько логинов'''. 
'''2.''' Поставить галочку напротив пункта '''Только доставка сообщений, без обработки'''. После этого на компьютере, на котором стоит ГТД Сервер, может работать вообще без ЭЦП. И без установки Крипто-Про. 
'''3.''' Нажмите кнопку «ОК» для сохранения настроек. 

Остальные настройки в данном случае не важны.

==Установка==

Установка происходит в контекстном меню Конфигуратора. Меню Сервис/установить сервис

==Запуск==

Запуск ЭД Сервиса осуществляется в контекстном меню пунктом «Запустить сервис» либо в меню настроек «ГТД Сервер». 
'''Внимание:''' После запуска сервиса становится невозможным поменять настройки подключения к БД, к серверу ЭД-2, и настроек прокси-сервера. Их можно менять только после остановки службы (Остановить сервис). В этом случае передача сообщений через ЭД Сервис прекращается.

[[Файл:выпад.jpg]]

[[Категория:ГТД Сервер]]
[[Категория:ЭД-2]]
[[Категория:ЭД-2]]

Документы ПИ 5.0.0 и 5.0.5

2013-01-21T13:10:30Z

Admin:

=== Таблица соответствия документов ПИ версии 5.0.0 (2011 год) и 5.0.5 (2012 год) ===
{|class="standard"
!Версия 5.0.0
!Версия 5.0.5
|-
!Colspan="2" class="bright"|Автомобильный транспорт (CMN.12001, CMN.12013, CMN.12068)
|-
!ЭД-2 Транзит
!ТД (ПИ, Транзит)
|-
|PI_TranzitInformation
|ESADout_CU (общий для ПИ и ГТД! выгружается из TD1)
|-
|Предварительное уведомление о транзите товаров.
|Предварительная информация о транзите товаров. * ''Если машина далее будет ехать по территории РФ(ТС) до СВХ(ЗТК)''
|-
!ЭД-2 Карнет ТИР (предв.)
!TIR (ПИ, Транзит)
|-
|PI_TIRCarnet
|CUTIR_Carnet (общий для ПИ и ГТД!)
|-
|Предварительное представление карточки МДП при транзите товаров
|Предварительная информация о транзите товаров с использованием книжки МДП
|-
! -
!ПИ авто (если нет ВТТ)
|-
| -
|PI_AutoArrive
|-
| -
|Предварительная информация о прибытии товаров, перевозимых автомобильным транспортом. * ''Если таможенное оформление производится прямо на границе РФ(ТС)''
|-
!Colspan="2" class="bright"|Ж/Д транспорт (CMN.12015)
|-
!ЭД-2 ЖД информация
!ПИ Ж/Д
|-
|PI_RwInformation
|PI_RwArrive
|-
|Предоставление предварительной информации о товарах перевозимых ж/д транспортом
|Предварительная информация о прибытии товаров, перевозимых ж/д транспортом
|-
!Colspan="2" class="bright"|Воздушный транспорт (CMN.12038, CMN.12076)
|-
!ЭД-2 Сведения о воздушном судне
!ПИ Авиа
|-
|PI_AirInformation
|PI_AirArrive
|-
|Предоставление сведений о воздушном судне
|Предварительная информация о прибытии товаров, перевозимых воздушными судами
|-
! -
!ПИ Авиа (пакет)
|-
| -
|AirOpn (внутри GeneralDeclarationAirTransport, CargoManifest, AirWaybill, ApplicationStore и т.д.)
|-
| -
|Пакет документов на воздушное судно (контейнер)
|-
!Colspan="2" class="bright"|Водный транспорт (CMN.12066, CMN.12078)
|-
! -
!ПИ Морской
|-
| -
|PI_SeaArrive
|-
| -
|Предварительная информация о прибытии товаров, перевозимых морскими судами. * ''Для журнала прибытия судов в порт''
|-
! -
!ПИ Морской (пакет)
|-
| -
|SeaOpn (внутри "Общая декларация" и "Коносаменты")
|-
| -
|Предоставление пакета документов на морское судно. * ''Для принятия решения о разгрузке судна в порту''
|-
!Colspan="2" class="bright"|ПИ в целях декларирования (CMN.12010)
|-
!Colspan="2"|не реализовано!
|-
|Colspan="2"|ESADoutP
|-
|Colspan="2"|Предоставление предварительной информации в целях декларирования товаров
|}

[[Категория:ЭД-2]]
[[Категория:Cправочная информация]]

Документы ПИ 5.0.0 и 5.0.5

2013-01-21T13:10:02Z

Admin:

=== Таблица соответствия документов ПИ версии 5.0.0 (2011 год) и 5.0.5 (2012 год) ===
{|class="standard"
!Версия 5.0.0
!Версия 5.0.5
|-
!Colspan="2" class="bright"|Автомобильный транспорт (CMN.12001, CMN.12013, CMN.12068)
|-
!ЭД-2 Транзит
!ТД (ПИ, Транзит)
|-
|PI_TranzitInformation
|ESADout_CU (общий для ПИ и ГТД! выгружается из TD1)
|-
|Предварительное уведомление о транзите товаров.
|Предварительная информация о транзите товаров. * ''Если машина далее будет ехать по территории РФ(ТС) до СВХ(ЗТК)''
|-
!ЭД-2 Карнет ТИР (предв.)
!TIR (ПИ, Транзит)
|-
|PI_TIRCarnet
|CUTIR_Carnet (общий для ПИ и ГТД!)
|-
|Предварительное представление карточки МДП при транзите товаров
|Предварительная информация о транзите товаров с использованием книжки МДП
|-
! -
!ПИ авто (если нет ВТТ)
|-
| -
|PI_AutoArrive
|-
| -
|Предварительная информация о прибытии товаров, перевозимых автомобильным транспортом. * ''Если таможенное оформление производится прямо на границе РФ(ТС)''
|-
!Colspan="2" class="bright"|Ж/Д транспорт (CMN.12015)
|-
!ЭД-2 ЖД информация
!ПИ Ж/Д
|-
|PI_RwInformation
|PI_RwArrive
|-
|Предоставление предварительной информации о товарах перевозимых ж/д транспортом
|Предварительная информация о прибытии товаров, перевозимых ж/д транспортом
|-
!Colspan="2" class="bright"|Воздушный транспорт (CMN.12038, CMN.12076)
|-
!ЭД-2 Сведения о воздушном судне
!ПИ Авиа
|-
|PI_AirInformation
|PI_AirArrive
|-
|Предоставление сведений о воздушном судне
|Предварительная информация о прибытии товаров, перевозимых воздушными судами
|-
! -
!ПИ Авиа (пакет)
|-
| -
|AirOpn (внутри GeneralDeclarationAirTransport, CargoManifest, AirWaybill, ApplicationStore и т.д.)
|-
| -
|Пакет документов на воздушное судно (контейнер)
|-
!Colspan="2" class="bright"|Водный транспорт (CMN.12066, CMN.12078)
|-
! -
!ПИ Морской
|-
| -
|PI_SeaArrive
|-
| -
|Предварительная информация о прибытии товаров, перевозимых морскими судами. * ''Для журнала прибытия судов в порт''
|-
! -
!ПИ Морской (пакет)
|-
| -
|SeaOpn (внутри "Общая декларация" и "Коносаменты")
|-
| -
|Предоставление пакета документов на морское судно. * ''Для принятия решения о разгрузке судна в порту''
|-
!Colspan="2" class="bright"|ПИ в целях декларирования (CMN.12010)
|-
!Colspan="2"|не реализовано!
|-
|Colspan="2"|ESADoutP
|-
|Colspan="2"|Предоставление предварительной информации в целях декларирования товаров
|}

[[Категория:ЭД2]]
[[Категория:Cправочная информация]]

Проблема при просмотре ЭД документов

2013-01-21T13:08:17Z

Admin:

SAFE.DBF, SOOTV.DBF и т.д.

2013-01-21T13:03:59Z

Admin:

За проставление в гр.44 документов с кодом 01191 отвечают несколько справочников:

{|class="standard"
!для ГТД
!для Таксы
!Программа для сборки
!Комментарий
|-
|SAFE
|SAFE_M
|safe2ref.exe
|Единый список продукции, подлежащей обязательной сертификации в РФ
|-
|SOOTV
|SOOTV_M
|safe2ref.exe
|Единый список продукции, требующей подтверждения (декларирования) соответствия в РФ
|-
|TS_REGUL
|TSREGULM
|kts2ref.exe
|Единый перечень продукции, подлежащей обязательной оценке (подтверждению) соответствия в рамках ТС
|-
|TECH_REG
|TECHREGM
|txt2mem.exe
|Технические регламенты РФ
|-
|CERTPROD
| 
|txt2ref.exe
|Информация о подтверждении соответствия (коды ОКП)
|-
|SOOTV_TR
| 
|вручную
|Технические регламенты РФ (ручной клон TECH_REG? Устарел?)
|}

Исходники для автоматической сборки у Зиновьева и/или Кудешова.

[[Категория:Техническая Информация]]
[[Категория:Справочники]]

Docs2SQL

2013-01-21T13:02:46Z

Admin:

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

База данных документов может размещаться либо на сервере Microsoft SQL Server 2000, либо в файле Microsoft Access 2000/XP/2003 (*.mdb).

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

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

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

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

[[Файл:docs2sqltray.png]]

== Настройка программы ==
Для вызова окна настроек программы необходимо выбрать пункт меню "Настройка". Окно состоит из трех закладок.

'''Закладка База данных'''

[[Файл:docs2sqlopt1.png]][[Файл:docs2sqlopt2.png]]

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

''Тип БД'' - задает тип базы данных, в которой будут размещаться документы: на сервере Microsoft SQL Server или в файле Microsoft Access.

Для Microsoft SQL Server:

''Имя или IP-адрес сервера'' - задает имя компьютера, на котором установлен SQL Server, или его IP-адрес. Если SQL Server находится на том же компьютере, где и программа, то вместо имени можно использовать вариант "(Локальный)".

''Имя базы данных'' - задает имя базы данных на сервере, в которую будут выгружаться документы. Должно быть указано обязательно.

Пользователь - задает способ подключения к базе данных:

''Всегда спрашивать имя и пароль'' - при каждой попытке выгрузить документы или просмотреть базу данных пользователю будет предложено ввести свой логин и пароль, под которым следует подключиться к БД (только для "интерактивного" режима, т.е. при выключенных настройках "Не показывать сообщения" и "Запускать как сервис Windows NT").

''Авторизация Windows NT'' - для подключения к базе данных будут использоваться учетные сведения пользователя Windows NT. Т.е. фактические права доступа к базе данных будут зависеть от того, в сеансе какого пользователя Windows запущена программа. При запуске в виде сервиса Windows NT это будет зависеть от того, под какой учетной записью выполняется сервис, т.е. чаще всего "LocalService"!

''Использовать указанные'' - для подключения к базе данных всегда будет использоваться указанное имя логина и пароль. Пароль хранится в зашифрованном виде.

'''Примечание.''' Если указано имя базы данных, несуществующей на сервере, то при выгрузке будет предпринята попытка создать ее. Для успешного выполнения этой операции необходимо, чтобы указанный пользователь был включен в серверную роль "Database Creators" или "System Administrators". Если же для выгрузки будет использоваться уже существующая база данных (созданная самостоятельно), то для успешной работы программы необходимо, чтобы указанному пользователю (или нескольким) был разрешен доступ к этой базе данных и он был включен в следующие роли в этой базе: "public", "db_ddladmin", "db_datareader" и "db_datawriter", либо в роль "db_owner".
Подробнее о средствах защиты и администрирования SQL Server - см. справочную систему SQL Server.

Для Microsoft Access:

''Путь к файлу БД'' - задает путь и имя файла, где будут размещаться данные.

''Пользователь'' - как для Microsoft SQL Server, но кроме варианта Авторизация Windows NT.

Примечание. Если указано имя файла, который не существует, то он будет создан при выгрузке. Но указанная папка должна существовать на диске.
Если Вы хотите использовать средства защиты Microsoft Access, т. е. установить не пустой пароль пользователя Admin или использовать другое имя пользователя, то Вы должны самостоятельно создать файл mdb, завести пользователей и группы (которые хранятся в файле рабочей группы *.mdw) и назначить им права доступа. В этом случае необходимо указать путь к файлу рабочей группы в параметре Системная база данных (mdw). И только в этом случае можно будет использовать вариант "Всегда спрашивать имя и пароль".
Подробнее о средствах защиты и администрирования Microsoft Access - см. справочную систему Microsoft Access.

В случае, когда база данных уже существует, можно проверить правильность указания всех параметров соединения, нажав кнопку <Проверить соединение>.

'''Закладка Параметры'''

[[Файл:docs2sqlparam.png]]

Здесь указываются следующие параметры:

· Путь к документам для выгрузки - задает папку, которая используется для взаимодействия с "Альта-ГТД". Должен указывать на ту же папку, которая задана в настройках "Альта-ГТД". Обычно это папка OUT, находящаяся в той же папке, что и DOCSWIN.

· Путь к файлу gtdwin.dcf - задает папку, в которой размещается файл gtdwin.dcf. Обычно это папка DATA в каталоге, где установлена "Альта-ГТД".

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

· Удалять разрегистрированные док-ты - задает удаляются ли из базы данных документы (и их резервные копии) при снятии статуса "зарегистрирован".

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

· Пауза после ошибки <N> минут - задает интервал времени, в течение которого программа НЕ предпринимает повторных попыток выгрузить документы, если во время последней выгрузки произошла ошибка, т. е. документы не были полностью выгружены, например вследствие отсутствия связи с SQL-сервером или недоступности сетевого диска. Работает только в режиме "Не показывать сообщения".

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

· Запускать как сервис Windows NT - если включено, программа будет автоматически запускаться при загрузке операционной системы и не требовать загрузки пользователя, т.е. будет работать как сервис. Эта функция работает только на ОС семейства Windows NT (NT 4.0, 2000, XP, 2003).

· Макс. размер журнала <N> КБ - задает ограничение размера файла журнала (Docs2SQL.log) в килобайтах.

'''Закладка Документы'''

[[Файл:docs2sqldocum.png]]

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

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

Кнопка <Все> позволяют отмечать или снимать отметки со всех документов.

Кнопка <АРМ ТИ> позволяет отметить только документы, относящиеся к формату АРМ ТИ.

Чтобы сохранить внесенные в настройки изменения, надо нажать кнопку <ОК>. Для отмены изменений - кнопку <Отмена>.

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

В меню '''Настройка|Внешние программы''' на закладке Служебные должна быть установлена галочка Выгружать в SQL-базу зарегистрированные док-ты.
Если программа выгрузки стоит на том же компьютере, то необходимо указать путь к ней, в противном случае поставить галочку Репликатор установлен на сервере.
Параметр Путь выгрузки должен совпадать с настройкой Путь к документам для выгрузки.

[[Файл:docs2sqlgtd.png]]

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

[[Файл:docs2sqllog.png]]

== Просмотр базы и восстановление файлов ==
Для просмотра накопленной базы документов необходимо выбрать пункт меню '''Просмотр базы'''. Окно состоит из двух закладок.

'''Закладка ГТД'''

[[Файл:docs2sqlgtdpage.png]]

На этой закладке показываются все документы ГТД, имеющиеся в базе данных.

Для быстрого поиска документа надо ввести его номер или любую часть номера в поле "№ ГТД" (в верхней части окна) и нажать кнопку [[Файл:docs2sqlbtfind.png]] или клавишу <Enter>. При этом будут показаны все документы, в чьем номере содержатся введенные символы. Для отмены фильтра надо нажать кнопку [[Файл:docs2sqlbtfind.png]] еще раз.

Для поиска по любому столбцу необходимо установить курсор в этот столбец и нажать клавиши <Ctrl+F>. В появившемся окне ввести строку для поиска и выбрать тип поиска, затем нажать кнопку <Найти далее>:

[[Файл:docs2sqlfind.png]]

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

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

Для восстановления файлов документов ГТД (и взаимосвязанных с ними) во внутреннем формате "Альта-ГТД" надо выделить нужные документы в списке, нажать кнопку <Восстановить> и указать одну из рабочих папок программы "Альта-ГТД" (в каталоге DOCSWIN).

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

'''Закладка Прочие'''

[[Файл:docs2sqlother.png]]

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

'''''Примечание.''''' В списках показаны только существующие в базе данных таблицы и соответствующие им документы.

По аналогии со списком ГТД таблицу можно сортировать по любому столбцу (или нескольким столбцам), щелкнув мышью на его заголовке. Для поиска по столбцу надо нажать <Ctrl+F>.

== Параметры командной строки ==
При запуске программы в обычном режиме (т.е. не в виде NT-сервиса) можно использовать один из следующих параметров в командной строке:

'''-O''' - показать диалог настроек

'''-X''' - автозавершение программы после одной попытки выгрузки

Примечание: Буквы латинского алфавита.

[[Категория:SQLServer]]
[[Категория:ГТД Сервер]]

Ошибки при установке SQL server

2013-01-21T13:01:44Z

Admin:

Здесь описываются ошибки, возникающие в процессе установки [[w:Microsoft_SQL_Server|SQL сервера]]

== Setup is missing prerequisites: - MSXML6 ==

Очень странная ошибка, возникает при установке SQL Express 2005 на Windows XP, при этом в окне отображения процесса установки на пункте Установка XML стоит флаг Установлено.
Для решения данной проблемы необходимо:

- установить MSXML6 отдельно от SQL Server (скачать [http://www.microsoft.com/downloads/ru-ru/details.aspx?FamilyID=d21c292c-368b-4ce1-9dab-3e9827b70604])

- после этого зайти в Панель управления - Установка и удаление программ, выбрать установленный MSXML6, нажать Изменить, затем Восстановить

- заново запустить установку SQL Server

[[Категория:SQLServer]]

DBUtils

2013-01-21T12:58:19Z

Admin:

Утилита предназначена для выполнения различных операций по обслуживанию баз данных SQL, таких как:
* создание новой базы данных
* [[резервное копирование базы данных]]
* [[восстановление базы данных]] из резервной копии

Утилита находится в папке Utils.

[[Категория:SQLServer]]
[[Категория:Утилиты]]

Объединение двух баз ГТД

2013-01-21T12:57:21Z

Admin:

Утилита MergeDB (находится в папке Utils) позволяет объединять списки документов и ЭД сообщений из двух SQL базы данных, находящихся на одном SQL сервере.

Для переноса данных необходимо:
# Ввести параметры подключения к серверу
# Выбрать исходную базу данных (откуда копировать данные)
# Выбрать конечную базу данных (куда копировать данные)
# Нажать кнопку Выполнить

ВАЖНО: Перед запуском настоятельно рекомендуется сделать бэкап обеих БД.

[[Категория:SQLServer]]
[[Категория:Утилиты]]

Объединение двух баз ГТД

2013-01-21T12:56:47Z

Admin:

DBUtils

2013-01-21T12:56:12Z

Admin:

Пояснения к ТНВЭД

2013-01-21T12:52:01Z

Admin:

== Структура пояснений (примечаний) к ТНВЭД ==

=== 1. Примечания к ТНВЭД ТС ===
1.1 Являются неотъемлемой частью "ТНВЭД и таможенного тарифа ТС", который утверждается решением ЕЭК (ранее КТС и ФТС) на русском языке. Содержит примечания к разделам (римские цифры) и к группам (два знака). Коды в тексте могут быть детализированы до 10 знаков включительно.
{| class="standard" style="background:#FFFFEE" cellpadding="10"
|ГРУППА 01 
ЖИВЫЕ ЖИВОТНЫЕ 
 
Примечание: 
1. В данную группу включаются все живые животные, кроме: 
а) рыб, ракообразных, моллюсков и прочих водных беспозвоночных товарной позиции 0301, 0306, 0307 или 0308; 
б) культур микроорганизмов и других продуктов товарной позиции 3002; и 
в) животных товарной позиции 9508. 
|}
1.2 "Дополнительные примечания ТС" также относятся не к переводной, а к юридически обязывающей российской части. Они могут публиковаться отдельными приказами и в разное время, отдельно от импортного тарифа. Поэтому для оптимизации обновления программы "Альта-Софт" хранят их в отдельном файле.
{| class="standard" style="background:#FFFFEE" cellpadding="10"
|Дополнительные примечания Таможенного союза: 
1. В подсубпозиции 0202 10 000 1, 0202 20 100 1, 0202 20 300 1, 0202 20 500 1, 0202 20 900 1, 0202 30 100 4, 0202 30 500 4 и 0202 30 900 4 включается мясо крупного рогатого скота, замороженное, в отношении которого установлена тарифная квота, при наличии лицензии, выданной компетентным органом. 
|}
1.3 В начале каждой товарной позиции (4 знака) в программе показывается табличка со всеми относящимися к ней кодами. Она генерируется автоматически на основе текущей версии ТНВЭД ТС (файл tn2.tnf), что исключает расхождения текста в окнах "Пояснения" и "ТНВЭД". Таким образом отдельного перевода этой таблицы не требуется.
{| class="standard" style="background:#FFFFEE"
|-
|01 01...||Лошади, ослы, мулы и лошаки живые
|-
|01 01 2...||-лошади
|-
|01 01 210000||--чистопородные племенные животные
|-
|01 01 29...||--прочие
|}
1.4 Английский аналог ТНВЭД от Комиссии Евросоюза "EEC Combined Nomenclature" по смыслу очень близок к российскому, но в программе на данный момент никак не используется.
{| class="standard" style="background:#EEFFFF" cellpadding="10"
|CHAPTER 1 
LIVE ANIMALS 
Note 
1. This chapter covers all live animals, except: 
(a) fish and crustaceans, molluscs and other aquatic invertebrates, of heading 0301, 0306, 0307 or 0308; 
(b) cultures of micro-organisms and other products of heading 3002; and 
(c) animals of heading 9508. 
|}

=== 2. Пояснения ВТО (Всемирной Таможенной Организации) ===
Изначально существуют на английском языке в виде "WORLD CUSTOMS ORGANIZATION: HARMONIZED SYSTEM EXPLANATORY NOTES". Переводов несколько, разных лет и разных организаций (МЭРТ, ФТС, КТС, собственный перевод "Альта-Софт"). Частично дублируют пункт 1, но не полностью - и там, и там есть собственные дополнительные параграфы. Коды детализированы максимум до 6 знаков:
{| class="standard" style="background:#EFEFFF" cellpadding="10"
|//это взято ровно из английского ТНВЭД Chapter 1 
live animals 
Note. 
1.- This Chapter covers all live animals except : 
(a) Fish and crustaceans, molluscs and other aquatic invertebrates, of heading 03.01, 03.06, 03.07 or 03.08; 
(b) Cultures of micro‑organisms and other products of heading 30.02; and 
(c) Animals of heading 95.08. 
 
//это по сути то же самое, но в другой интерпретации 
GENERAL 
This Chapter covers all living creatures (for food or other purposes) except : 
(1) Fish and crustaceans, molluscs and other aquatic invertebrates. 
(2) Cultures of micro‑organisms and other products of heading 30.02. 
(3) Animals forming part of circuses, menageries or other similar travelling animal shows (heading 95.08). 
 
//это добавление от ВТО, в ТНВЭД не было 
Animals which die during transport are classified in headings 02.01 to 02.05, 02.07 or 02.08 if they are edible animals fit for human consumption. In other cases, they are classified in heading 05.11. 
 
//это в чистом виде кусок ТНВЭД с кодами, сюда уместно сунуть русский вариант 
01.01 ‑ Live horses, asses,mules and hinnies (+). 
- Horses : 
0101.21 - - Pure-bred breeding animals 
0101.29 - - Other 
0101.30 - Asses 
0101.90 - Other 
 
//это пояснение ВТО к позиции 0101 
This heading covers horses (mares, stallions, geldings, foals and ponies), asses, mules and hinnies, whether domestic or wild. 
Mules are the hybrid offspring of the ass and the mare. The hinny is bred from the stallion and the ass. 
 
Subheading Explanatory Note. 
Subheading 0101.21 
For the purposes of subheading 0101.21, the expression “ pure‑bred breeding animals ” covers only those breeding animals which are regarded as “ pure‑bred ” by the competent national authorities. 
|}

=== 3. Пояснения КЕС (Комиссии Европейского Союза) ===
Изначально существуют на английском языке под именем "EUROPEAN COMMISSION: EXPLANATORY NOTES TO THE COMBINED NOMENCLATURE OF THE EUROPEAN UNION". Являются дополнением к примечаниям ВТО. Имеется в нескольких переводах. В переводе Альта-Софт включены в пояснения как примечания для групп, товарных позиций и субпозиций (6-8й знаки). Содержит классификацию кодов до 8-го знака:
{| class="standard" style="background:#EEFFFF" cellpadding="10"
|CHAPTER 1

LIVE ANIMALS

0101 Live horses, asses, mules and hinnies

0101 90 11 and 0101 90 19 Horses

Wild horses, such as the Przewalski horse or tarpan (Mongolian horse), are included in these subheadings. However,
zebras (Equus zebra, Equus grevyi, Equus burchelli, Equus quagga, etc.) are classified in subheading 0106 19 90, even though
they belong to the equidae family.
Hybrids of the mare and zebra (zebrule) are classified in subheading 0106 19 90.

0101 90 30 Asses

Both domestic and non-domestic asses fall in this subheading. Among the latter are Mongolian djiggetai, the Tibetan
kiang, the onager and the hemione or half-ass (Equus hemionus).
Hybrids of the ass and zebra (zebrass) are classified in subheading 0106 19 90.

0101 90 90 Mules and hinnies

This subheading covers the animals described in the final paragraph of the HS Explanatory Note to heading 0101.
|}

== Порядок сборки пояснений по группе (товарной позиции) в программах ==
В программе "Примечания" автоматически собираются из 1.1, 1.2, 1.3, а также русских переводов 2 и 3. При этом фактически текст находится в пяти разных файлах, которые могут обновляться независимо, так как имеют разные источники. Параграфы разного происхождения разделены значками: 1.1 - "российский флаг", 1.2 - "восклицательный знак", 2 - "глобус". Секции 1.3 и 3 на данный момент никак не выделены, а просто пристыковываются подряд.

В окне программы "Пояснения" представлены в виде дерева, содержащего три уровня (в версии с неполными примечаниями - первые два уровня). Источники отображаемого на каждом уровне текста показаны ниже в виде таблицы:
{| class="standard"
|-
|Вид пояснений||Раздел I||Группа 01||Позиция 0101
|-
|1.1 Примечания к ТНВЭД ТС||align="center"|●||align="center"|●||
|-
|1.2 Дополнительные примечания ТС|| ||align="center"|●||
|-
|1.3 Коды ТНВЭД ТС|| || ||align="center"|●
|-
|2 Пояснения ВТО|| ||align="center"|●||align="center"|●
|-
|3 Пояснения КЕС|| ||align="center"|●||align="center"|●
|}

[[Категория:Альта-ГТД]]
[[Категория:Техническая Информация]]

Заглавная страница

2013-01-21T12:50:27Z

Admin:

__NOTOC__

=='''Добро пожаловать в Энциклопедию Альта.'''==

Здесь Вы можете найти информацию о программах разрабатываемых фирмой [[Альта-Софт]]. Для [[Как добавить страницу|создания и редактирования]] статей необходимо [[Служебная:UserLogin|представиться системе]].

== Категории статей по программам ==

* [[:Категория:Альта-ГТД|Альта-ГТД]]
* [[:Категория:Такса|Такса]]
* [[:Категория:Заполнитель|Заполнитель]]
* [[:Категория:Инвойс|Инвойс]]
* [[:Категория:ТамДок|ТамДок]]
* [[Обновление]]
* [[ГТД Сервер]]
**[[ЭД-обмен]]
**[[ГТД Сервер ПЛЮС]]
**[[Docs2SQL]]
**[[ЭД Монитор]]
**[[ЭД Сервис]]
**[[Репликатор]]

== Другие категории статей ==
* [[:Категория:Техподдержка|Техподдержка]]
* [[:Категория:Термины|Термины]]

== Некоторые полезные ресурсы ==
* [[Служебная:Categories|Все категории]]
* [[Служебная:Allpages|Все статьи]]
* [[Как добавить страницу]]
* [http://ru.wikipedia.org/wiki/ВП:КПС Справка по синтаксису (на "большой" Вики)]
* [http://ru.wikipedia.org/wiki/Википедия:Руководство_для_быстрого_старта Руководство для быстрого старта (на "большой" Вики)]
* [http://www.mediawiki.org/wiki/Manual:Configuration_settings Список возможных настроек];
* [http://www.mediawiki.org/wiki/Manual:FAQ Часто задаваемые вопросы и ответы по MediaWiki];
* [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce Рассылка уведомлений о выходе новых версий MediaWiki].

SAFE.DBF, SOOTV.DBF и т.д.

2013-01-21T12:48:44Z

Admin:

ЭД Монитор

2013-01-21T12:47:38Z

Admin: /* Доступ по HTTP */

Монитор Электронного Декларирования (далее Монитор ЭД) - средство, входящее в состав ГТД сервера, которое позволяет получать информацию о статусе документов ГТД участвующих в процессе электронного декларирования.

К ЭД монитору принадлежат следующие файлы

edmonitor.exe - программа ЭД монитор.

edmonitor.ini - пользовательские настройки программы ЭД монитор.

edmonitor.dat - фиксированные настройки ЭД монитор.

edmonitor.log - журнал работы программы ЭД монитор.

edmonitor.elf - журнал критических ошибок. Сюда попадают ошибки, которые по каким-либо причинам не были обработаны программой и не попали в основной журнал (edmonitor.log) программы.

ВАЖНО! При возникновении проблем с работой программы требуется написать письмо в тех.поддержку Альта-Софт с кратким описаием проблемы (ошибки), указать версию программы ЭД монитор и приложить к письму файлы edmonitor.ini, edmonitor.dat, edmonitor.log, edmonitor.elf (если такой имеется).

==Основные сведения==
Типичное окно программы Монитор ЭД изображено на следующем рисунке

[[Файл:edmongeneral.png]]

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

1. Поданные ГТД - ГТД, которые были поданы в таможенные органы, но не получили ещё подтверждения и присвоенного регистрационного номера.

2. Зарегистрированные ГТД - ГТД, которые получили подтверждение из таможенных органов и которым был присвоен регистрационный номер.

3. Выпущенные ГТД - ГТД, которые прошли проверку в таможенных органах и готовы к выпуску.

4. Кол-во выпущенных ГТД по дням - своего рода статистика выпущенных ГТД (количество) по дням.

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

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

==Настройка Монитора ЭД==
Настройка Монитора ЭД содержится на вкладке '''Настройки'''

[[Файл:edmonoptions.png]]

Вся настройка Монитора ЭД сводится к настройке доступа к базе данных MS SQL сервера, на котором хранятся все сообщения процесса электронного декларирования.

Поле Сервер - позволяет из выпадающего списка выбрать один из доступных MS SQL серверов, существующих в сети.

Авторизация - позволяет выбрать тип авторизации на MS SQL сервере. В случае, если выбрана Использовать указанные, то требуется ввести Логин и Пароль доступа на MS SQL сервер в соответствующих полях.

База данных - позволяет из выпадающего списка выбрать базу данных, в которой хранятся сообщения электронного декларирования.

<Проверить связь> - нажатием на эту кнопку можно проверить настройки доступа на MS SQL сервер и проверить связь с ним.

<Взять настройки из ГТД сервера> - если установлен ГТД сервер и в нем уже были произведены настройки доступа на MS SQL сервер, то нажатие на эту кнопку позволит импортировать эти настройки в Монитор ЭД. Если в ГТД сервере нет данных настроек, то данная кнопка будет неактивна.

<Сохранить> - позволяет сохранить настройки в конфигурационный файл.

Также можно настроить доступ к Монитору ЭД по сети по протоколу HTTP и получать информацию используя лубой браузер (Internet Explorer, Opera, FireFox и т.п.). Для этого надо установить галочку HTTP сервер и прописать Порт. Для проверки работы HTTP монитора можно нажать кнопку <Открыть...>. При этом запустится браузер с начальной страницей Монитора ЭД.

ЭД монитор позволяет организовать просмотр декларантами своей статистики по HTTP. Для этого имеет набор настроек. В частности поле Список пользователей позволяет задать ИНН и пароль для пользователей, которые смогут по HTTP просматривать свою статистику. Есть кнопка <АвтоДобавление>, нажатие на которую позволяет добавить в список всех пользователей ЭД, которые существуют в базе SQL. По умолчанию в качестве логина и пароля при этом устанавливается ИНН (графа 14_4). Также можно из списка Колонки таблицы GtdList выбрать галочками те колонки, которые будут показываться клиентам при выводе их статистики по HTTP.

Настройка размера лог-файла, производится на вкладке '''Журнал'''.

[[Файл:edmonlog.png]]

==Работа с программой==
При первом запуске программы может появиться одно из следующих сообщений

[[Файл:edmonstart1.png]]

Это сообщение означает, что не были найдены настройки для доступа на MS SQL сервер. Причем настройки не найдены как в своем конфирурационном файле так и конфигурационном файле ГТД сервера.

[[Файл:edmonstart2.png]]

Это сообщение означает, что не были нейдены настройки для доступа на MS SQL сервер в конфигурационном файле, но эти настройки найдены в конфигурационном файле ГТД сервера. Предлагается импортировать эти настройки в программу Монитор ЭД, либо отказаться от импортирования.

После запуска окно программы имеет следующий вид

[[Файл:edmongen.png]]

Окно программы имеет 4 таблицы и небольшую область для задания параметров фильтрации/сортировки (снизу справа).

Таблицы отображают результаты обработки базы данных электронного декларирования:

1. Поданные ГТД - ГТД, которые были поданы в таможенные органы, но не получили ещё подтверждения и присвоенного регистрационного номера.

2. Зарегистрированные ГТД - ГТД, которые получили подтверждение из таможенных органов и которым был присвоен регистрационный номер.

3. Выпущенные ГТД - ГТД, которые прошли проверку в таможенных органах и готовы к выпуску.

4. Кол-во выпущенных ГТД по дням - своего рода статистика выпущенных ГТД (количество) по дням.

Получение результатов осуществляется нажатием кнопки <Обновить> (сверху слева). При этом происходит обращение к базе данных MS SQL сервера и вывод результатов в таблицы.

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

Данные в таблицах можно дополнительно сортировать по возрастанию/убыванию, щелкая по заголовку столбца, по которому требуется провести сортировку. Некоторую особенность имеет сортировка по номеру документа. При наведении курсора мыши на заголовок данного столбца, он (заголовок) через небольшой промежуток времени меняет свой вид, который представлен на рисунке сверху в первой таблице. Заголовок преобразуется в трехсекционный со стрелками. Щелкая на нужной стрелке вверх/вниз можно пересортировать данные по соответствующей секции номера документа по возрастанию/убыванию.

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

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

[[Файл:edmonsert.png]]

'''Архивные документы.'''

[[Файл:edmonarch.png]]

Здесь можно задать диапазон дат. В таблицу будут выводиться сведения о документах помещенных в архив в указанном диапазоне дат. Обновление данных в таблице производится при нажатии кнопки <Обновить>. В таблице справа выводится статистика документов помещенных в архив по декларантам.

В программе также есть возможность просматривать исходные сообщения ЭД. Для этого в программе существует закладка '''Сообщения ЭД-2'''.

[[Файл:edmonmsgs.png]]

Здесь можно задать диапазон дат. В таблицу будут выводиться сообщения, полученные в указанном диапазоне дат. Обновление данных в таблице производится при нажатии кнопки <Обновить>.

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

[[Файл:edmonviewmsgs.png]]

'''Статистика ЭД сообщений'''

[[Файл:edmonstatmsgs.png]]

На данной вкладке можно получить статистику (дату и время) получения ЭД сообщений для документов. С правой стороны есть поле, которое позваляет выбирать какие из сообщений будут выводиться в колонки таблицы. Галочка Сообщения в заголовках позвоялет переключать вывод в заголовках типов сообщений на их описание. Галочка Одно сообщение для каждого документа позвоялет выводить в таблицу для каждого документа либо только одно последнее сообщение, либо все сообщения данного типа, которые были. Обновление информации производится по кнопке <Обновить>.

Результаты можно сохранять в файл Excel. Для этого имеется кнопка <В Excel...>.

==Конструктор отчетов==
На данной вкладке можно самостоятельно сконструировать таблицу с требуемыми столбцами, SQL запрос для нее, а также сохранить/загрузить её вид в некотором произвольном конфигурационном файле.

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

[[Файл:edmonconstruct.png]]

==Доступ по HTTP==
Монитор ЭД позволяет получать информацию на любом компьютере в сети имеющего доступ по протоколу HTTP.

Для этого Монитор ЭД должен быть запущен и у него должен быть включен HTTP сервер (см. Настройка Монитора ЭД).

Предположим Монитор ЭД запущен на компьютере имеющего адрес в сети IP равный 192.168.2.5 и в настройках Монитора ЭД стоит порт 8080. Тогда на любом компьютере из той же сети в браузере можно набрать адрес

http://192.168.2.5:8080/edmonitor

При этом появится запрос на ввод пароля и логина для доступа. По умолчанию логин и пароль для администратора (admin admin). По умолчанию логин и пароль для пользователей ЭД это их ИНН из графы 14_4.

[[Файл:edmonitor.png]]

Пользователи могут самостоятельно менять свой пароль для доступа к своей статистике (Смена пароля).

[[Файл:edmonitor1.png]]

Статистика для Администратора выглядит следующим образом.

[[Файл:edmonitor2.png]]

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

Есть возможность просмотра исходных сообщений ЭД. Для этого необходимо перейти по ссылке '''ЭД-сообщения'''. При этом вид страницы изменится.

[[Файл:edmonitor3.png]]

Для переходы назад к просмотру статистики необходимо перейти по ссылке '''Статистика декларирования'''.

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

[[Файл:edmonitor4.png]]

[[Категория:ГТД Сервер]]

ЭД Монитор

2013-01-21T12:46:38Z

Admin: /* Доступ по HTTP */

Расчет числа мест гр.6

2013-01-21T12:43:37Z

Admin:

Если все места полные - считается '''обычная сумма мест''' по всем товарам.

Проблемы возникают когда есть несколько записей типа "часть места". Тогда уже точно сказать сколько всего мест нельзя. Есть только верхняя и нижняя оценка. Например если 100 товаров и все "1 (1 часть)" то всего мест может быть любое количество от 1 (все в
одном ящике) до 50 (в каждом ящике по 2 товара). Программа в этом случае ставит 1 - и может быть не права.

В графе 31 "2-..." пишется 2 цифры - "всего мест" (обозначим буквой М) и "в т.ч. неполностью занятых мест" (буква Ч).

Общий алгоритм расчета такой:

'''SUM(М-Ч)+MAX(Ч)'''

Он дает точную цифру при Ч=0 и нижнюю оценку при Ч>0

Например для двух товаров
* 5 (2 ЧАСТЬ)
* 3 (2 ЧАСТЬ)
Алгоритм дает (5-2)+(3-2)+2 = 3 + 1 + 2 = 6 мест 
3 полностью заняты первым товаром, 1 - вторым и 2 смешанных.

Есть еще экзотическая настройка "Считать число мест гр.6 по контейнерам гр.31 3-".
Но вероятно АИСТ-М на такой авангард будет ругаться.

Если гр.6 передается снаружи (Инвойс, XML) можно в Альте отключить ее пересчет ("Настройка ГТД", закладка "Разное") 
У этой галочки есть побочный эффект - гр.6 стирается при дублировании, чтобы в новой ГТД ее не забыли поменять руками.

[[Категория:Альта-ГТД]]

WGtdUser.dat

2013-01-21T12:34:47Z

Admin: /* Старый механизм */

Файл '''WGtdUser.dat''' предназначен для индивидуальной настройки правил копирования данных между взаимосвязанными документами.

== Назначение ==

Она важнейших возможностей программы [[Альта-ГТД]] - автоматическое заполнение документов создаваемых как взаимосвязанные из уже существующих.
Например, заполнив таможенную ''Декларацию на Товары'', можно создавать из нее ДТС, КТС и все прочие таможенные документы.

С введением [[Электронное Декларирование|Электронного Декларирования]] появилась необходимость заполнять в электронной форме массу формализованных документов, таких как, ЭД2-Инвойсы, ЭД2-CMR, ЭД2-Контракты и многих других.
Из-за отсутствия однозначных правил заполнения формализованных документов зачастую невозможно создать универсальный перенос, который бы удовлетворял всем возможным ситуация возникающим у различных пользователей программы.
Чтобы дать возможность персонально настраивать или корректировать взаимосвязи документов, было решено создать пользовательский файл WGtdUser.dat.
Файл должен находиться в одной папке с gtd.ini (по умолчанию в коневой программы [[Альта-ГТД]]), быть в Windows 1251 кодировке и содержать альтернативные описания переноса данных.

== Механизм описания взаимосвязи документов ==

Связи между документами описываются в файле '''DATA\WGTDInfo.dat'''. Этот файл является дистрибутивным и вносить изменения в него запрещено, т.к. при следующем же обновлении файл будет восстановлен на стандартный.
Связи и обработка документов могут описываться в секциях вида

* [Документ2<-Документ1]
* [Документ2<-Документ1.Script]
* [Документ.Revise]

Рассмотрим их подробнее

=== [Документ2<-Документ1] ===

Самый простой способ описания взаимосвязи. Если документам достаточно копирования поле-в-поле заголовка и полей главного блока (товаров), то нужно перечислить
поля в формате "поле_нового_документа = поле_исходного".

Пример создания Описи из документа ТД (ГТД)

[OPN<-GTD]
1_2= 14.NAME
1_3= 14_6
1_5= 14.ADDRESS
1_6= 14_4+" "+14_5
4_1= 54_3
4_1NM= 54_3NM
4_1MD= 54_3MD
4_2= 54_7
4_3= 54_4
4_4= 54_5
4_5= 54_60
4_6= 54_61
5_1= 54_8
5_3= 54_101
5_21= 54_12
5_2= 54_100

Специфические особенности:

* Справа можно использовать склейки из нескольких полей и добавлять текст, например пробел: 14_4+" "+14_5
* Копирование товаров (главных блоков документа) друг в друга происходит только при условии, что совпадают имена блоков. Например блок с товарами и в ГТД, и в ДТС называется '''BLOCK''', поэтому поля товара можно просто перечислить в секции. При создании ДТС из ГТД, в ДТС будет создано столько же записей о товарах, сколько и в ГТД. Каждый товар будет перенесен согласно соотвествию заданному в секции.
* Если главные блоки документов в целом соответствуют друг другу, но имеют разные названия, то перенос можно принудительно инициировать инструкцией
ConformBasis=1
* Возможен перенос поле-в-поле вложенных блоков (дополнений) при условии что их поля имеют одинаковые названия. Для этого надо сопоставить имена блоков поставив перед ними символ '''@'''. Пример переноса из ГТД в документ учета

[DUT<-GTD]
1_1= "ДУ"
1_2= 1_2
2= 2
31= 31
...
44= "1-"+@44_2+"#2-"+@44_4.1+"#3-"+53_1
46_1= 46_1
54_1= 54_3
54_20= 54_20
54_7= 54_7
@DKD= @DKD
@G40= @G40
@G44= @G44
@TXT= @TXT

=== [Документ2<-Документ1.Script] ===

Очень часто в сложных документах перенос поле-в-поле затруднителен. Например требуется некая конвертация данных, обработка по условию, запрос к пользователю и т.д.
В таких случая перенос программируется при помощи [[w:Pascal|паскале]]образного скрипта. Написание программного кода требует определенных навыка и специфических знаний об структуре документов. Пример секции для переноса данных из ГТД в ЭД2-CMR

[CMR<-GTD.Script]
var s,num,TmpStr: string;
i: word;
begin
s:=''; TmpStr:='1';
num := ExtractWord(1, Doc1.GetField('27_4'), ' ');
if DBFOPEN('SKL_VH') then
if DBFFINDKEY('NLIC', num) then
if num<>'' then s :=DBFGETFIELD('ADRS') else s:='';
DBFOPEN('');
if _1_1='ИМ' then
begin
__C_1:=_2;
__C_2:=_8;
__C_3_1:='Лиц.СВХ N '+num;
__C_3_2:=s;
__C_3_3:='Россия';
__C_4_3:=_15_1;
end else
begin
__C_1:=_2;
__C_2:=_8;
__C_4_1:='Лиц.СВХ N '+num;
__C_4_2:=s;
__C_4_3:='Россия';
__C_3_3:=_17_1;
end;
if InputQuery('Какой товар переносить?', 'Номер товара', TmpStr) then
begin
i:=Doc1.BlocksNum(0);
Doc1.NBlock(StrToInt(TmpStr)-1);
s:=Doc1.GetField('31.NAME');
ClearEnter(s);
__C_6:=s+#13+Doc1.GetField('31.PLACE')+#32+Doc1.GetField('31.PLACE2')+#32
+Doc1.GetField('31.PAL')+#32+Doc1.GetField('31.PAL2');
end;
end.

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

=== [Документ.Revise] ===

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

[BIL.Revise]
Var I : Integer;

function Sum(F:String):Real;
begin
S :=0;
For I := 0 to Doc1.BlocksNum(0)-1 do begin
Doc1.NBlock(I);
S := S+GetVal(Doc1.GetField(F));
end;
Result:=S;
end;

begin
if (Fid='VSEGONDS') then begin
Doc1.NBlock(0);
S:=Sum('VSEGONDS');
_ITOG3:=S;
end;
if (Fid='SUMNDS') then begin
Doc1.NBlock(0);
S:=Sum('SUMNDS');
_ITOG2:=S;
end;
if (Fid='SUM') then begin
Doc1.NBlock(0);
S:=Sum('SUM');
_ITOG1:=S;
end;
if (Fid='PRICE') then begin
_SUM:=GetVal(_KOL)*GetVal(_PRICE);
Doc1.NBlock(0);
S:=Sum('SUM');
_ITOG1:=S;
end;
if (Fid='NDS') then begin
_SUMNDS:=GetVal(_NDS)*GetVal(_SUM)/100;
Doc1.NBlock(0);
S:=Sum('SUMNDS');
_ITOG2:=S;
_VSEGONDS:=GetVal(_SUMNDS)+GetVal(_SUM);
Doc1.NBlock(0);
S:=Sum('VSEGONDS');
_ITOG3:=S;
_PROPIS:=Propis(_ITOG3);
end;
end.

== Использование WGTDUser.dat ==

'''WGTDUser.dat''' позволяет перекрывать стандартные или добавлять собственные редакции правил переноса данных.
Файл является пользовательским и не меняется после обновления, т.е. однажды сделанные пользователем изменения сохраняются.

=== Отключение стандартного переноса или скрипта ===

Для отключение стандартного переноса или Revise надо в WGTDUser.dat добавить секцию с префиксом '''SKIP.''' или переменную с тем же именем в секцию SKIP.
Например, для отключения пересчета в документе ''ЭД2 Счет-Фактура'' необходимо или создать пустую секцию

[SKIP.COMMERCIALINVOICE.Revise]

или в секции SKIP завести переменную с именем отключаемой секции

[SKIP]
COMMERCIALINVOICE.Revise=1

=== Добавление собственного скрипта ===

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

'''ВНИМАНИЕ!''' На данный момент существует ограничение: перекрыть можно только существующую в '''WGtdInfo.dat''' секцию.
Если в стандартном файле документы на прямую не связаны, но секции из '''WGtdUser.dat''' применяться не будут, т.к.
программа будет предлагать маршруты создания нового документа через другие промежуточные.

=== Добавление нескольких скриптов для одного документа ===

Иногда требуется какой-то документ создавать по-разному в зависимости от конкретного случая.
Для можно создать несколько скриптов, перечислить из в спец.секции с именем [Документ2<-Документ1.ScriptList] и тогда программа будет каждый раз задавать вопрос
какой именно скрипт использовать. Например, предположим что при создании ЭД2 Платежного требования, мы хотим выполнять разные скрипты.
Создаем секцию со всеми возможными вариантами:

[PAYMENTDEMAND<-GTD.ScriptList]
A. Требование к ООО "РиК" на 10000
B. Требование к ООО "Вектор М" на 5000
12. Требование к ООО "Ромашка" на всю гр.12

Идентификатор варианта - это первое слово в строке. Может быть и цифровым, и буквенным.
Используется текст до первого знака препинания или пробела.
Затем перечисляются все варинты переносов:

[PAYMENTDEMAND.A<-GTD]
PaymentAmount="10000"

[PAYMENTDEMAND.B<-GTD]
PaymentAmount="5000"

[PAYMENTDEMAND.12<-GTD]
PaymentAmount=12_1

При создании Требования из ГТД будет задан вопрос

[[Изображение:HowPAYMENTDEMANDDo.png]]

И будет выполнен только выбранный перенос.
Т.к. исходная секция переноса и скрипт переноса не отключалась, то перенос будет сделан в ДОПОЛНЕНИЕ к стандартному.

== Старый механизм ==

Еще до создания WGtdUser.dat существовала возможность выполнить скрипт после создании нового взаимосвязанного документа.
Для этого в папку '''DATA\''' надо было поместить текст скрипта в файле с именем '''ИмяДокумента_my.scr'''.

Например '''DATA\CommercialInvoice_my.scr''' для обработки ЭД2 Счета-Фактуры. Однако при помощи этого механизма нельзя было отключать
существующие стандартные секции.

[[Категория:Альта-ГТД]]
[[Категория:Файлы настройки]]

Эцп

2012-10-16T12:50:19Z

Admin:

В этой статье приводятся приемы работы/настройки [[w:ЭЦП]]

== В Windows 7 IE не видит сертификат ==

Если после установки программы при попытке отправить что-либо появляется сообщение о том, что личная подпись не найдена - зайдите в Internet Explorer'е Сервис->Свойства обозревателя->Содержание->Сертификаты.
Если в личных сертификатах пусто, а в Альте-ГТД в Настройках->Сервер и сетевые настройки->Настройка ЭД-2 при нажатии на кнопку для добавления ЭЦП показывает сертификат - значит Internet Explorer не видит установленные сертификаты.
Данная проблема возникает очень редко и только в Internet Explorer 8 на Windows 7. Для исправления данной ошибки необходимо установить обновление с сайта Майкрософт http://support.microsoft.com/hotfix/KBHotfix.aspx?kbnum=977222&kbln=ru ,а затем заново поставить личный сертификат с ЭЦП.

== Firefox и пароль к eToken ==

Чтобы браузер Mozilla Firefox не просил ввести пароль от eToken, надо сделать следующие действия:

В FireFox: Меню Инструменты -> Настройки -> закладка Дополнительные -> Шифрование -> кнопка "Устройства защиты" -> встать слева на раздел eToken -> нажать кнопку "Выгрузить".

[[Файл:Ffox_1.jpg]]

== Восстановление заблокированного eToken'а ==
1) Сначала заходим в etoken properties и смотрим что закончились попытки ввода пароля пользователя.
[[Файл:etok1.gif|540px]]

2) Далее выбираем подробное отображение свойств (шестерёнка), слева выбираем строчку etoken и проверяем, активна ли кнопка входа под администратором. Она активируется при первом правильном вводе пароля пользователя. Если она не активна - перевыпуск ЭЦП.
[[Файл:etok2.gif|540px]]

3) Нажимаем на вход под администратором и вводим пароль пользователя ЭЦП, выданный ГНИВЦем.
[[Файл:etok3.gif|540px]]

4) Нажимаем "сменить пароль пользователя" и вводим дважды ГНИВЦевский пароль.
[[Файл:etok4.gif]]

== ЭЦП в терминальном режиме ==

Чтобы ЭЦП работало в терминальном режиме надо:

* Установить крипто на сервер
* Установить двайвер eToken и на сервер, и на клиентское место
* Вставить eToken в клиентскую машину
* в свойствах RDP включить галочку "Пробрасывать SMART-карты"
* PROFIT

== Вставлен другой контейнер ==
Если при попытке подписи пишет что вставлен неправильный контейнер и пишет фигню в имени контейнера (типа 00000_Rauser)
# Проверить, есть ли сертификат в Других пользователях
# Зайти в Крипто-про\Сертификаты, переместить его из Других пользователей в Личные и удалить
# Переставить сертификат

== Не найден ключевой носитель, Не удалось подписать файл ...\temp\...xml ==
Данная ошибка не связана с сертификатом подписи ЭЦП, а означает лишь проблему записи в стандартную папку temp.
Решается заменой в Настройка\Каталоги\Каталог временных файлов %temp на специально созданную папку с полными разрешениями, например c:\Alta\temp\

[[Категория:ЭД-2]]
[[Категория:Альта-ГТД]]

MediaWiki:Sidebar

2012-10-16T11:11:34Z

Admin:

MediaWiki:Sidebar

2012-10-16T11:11:01Z

Admin:

* navigation
** recentchanges-url|recentchanges
** randompage-url|randompage
* Быстрый переход
** Special:AllPages|Все статьи
** Special:Categories|Все категории
* SEARCH
* TOOLBOX
* LANGUAGES

MediaWiki:Common.css

2012-10-16T10:26:15Z

Admin: Новая страница: «/** Размещённый здесь CSS будет применяться ко всем темам оформления */ /* [[Википедия:Офор…»

/** Размещённый здесь CSS будет применяться ко всем темам оформления */

/* [[Википедия:Оформление таблиц]] */
table.standard, table.wide, table.prettytable
{border:1px solid #aaa; border-collapse: collapse}
table.standard th, table.wide th, table.prettytable th
{border:1px solid #aaa; padding-left:0.2em; padding-right:0.2em; background:#eef}
table.standard td, table.wide td, table.prettytable td
{border: 1px solid #aaa; padding-left:0.2em; padding-right:0.2em}
table.standard caption, table.wide caption, table.tiles caption
{font-weight:bold; padding-top: 0.2em; padding-bottom:0.2em}
table.wide {width: 100%}

table.simple {border-color:#aaa; border-collapse:collapse}
table.simple th, table.simple td {border-color:#aaa; padding-left:0.2em; padding-right:0.2em}

table.tiles {border-collapse:separate; border-spacing:2px}
table.tiles th {padding-left:0.2em; padding-right:0.2em; background:#eef}
table.tiles td {padding-left:0.2em; padding-right:0.2em; background:#f0f0f0}

table.graytable {background:#f0f0f0; padding:1em; width: 100%}
table.graytable caption {padding-top:0.5em; background:#f0f0f0; font-weight:bold}
table.graytable caption span.subcaption {font-size:80%; font-weight:normal}
table.graytable th, table.graytable td {font-size:80%}

tr.highlight th, table tr th.highlight {background:#eef}
tr.highlight td, table tr td.highlight {background:#ffe; font-weight:normal}
tr.bright th, table tr th.bright {background:#ccf}
tr.bright td, table tr td.bright {background:#fec}
tr.shadow th, tr.shadow td, table tr th.shadow, table tr td.shadow {background:#f0f0f0}
tr.dark th, tr.dark td, table tr th.dark, table tr td.dark {background:#ccc}
.transparent {background:transparent !important}

table.toccolours th {background:#ccf}

/* {ambox} */
table.ambox {
width: auto;
margin: 0 10%;
border-collapse: collapse;
background:#FBFBFB;
border: 1px solid #aaa;
border-left: 10px solid #1E90FF
}
table.ambox th, table.ambox td {
padding: 0.25em 0.5em;
}
table.ambox td.ambox-widthhack {
padding: 0;
}
table.ambox td.ambox-text {
width:100%;
}
table.ambox td.ambox-text .ambox-text-small {
font-size:smaller;
}
table.ambox td.ambox-image {
width: 52px;
padding: 2px 0 2px 0.5em;
text-align: center;
}
table.ambox td.ambox-imageright {
width: 52px;
padding: 2px 4px 2px 0;
text-align: center;
}
table.ambox td.ambox-image div,
table.ambox td.ambox-imageright div {width:52px} /* Фикс для изображений разной ширины */
table.ambox-delete,
table.ambox-serious {
border-left: 10px solid #B22222
}
table.ambox-content {
border-left: 10px solid #F28500
}
table.ambox-style {
border-left: 10px solid #F4C430
}
table.ambox-good {
border-left: 10px solid #66CC44
}
table.ambox-discussion {
border-left: 10px solid #339966
}
table.ambox-notice {
border-left: 10px solid #1E90ff
}
table.ambox-merge {
border-left: 10px solid #9932CC
}
table.ambox.ambox-mini {
float: right;
clear: right;
margin: 0 0 0.5em 1em;
width: 20%;
}

MediaWiki:Sidebar

2012-10-16T09:11:58Z

Файл:Edinvaist.png

2012-10-09T15:22:01Z

Admin:

Файл:Edinvcalc.png

2012-10-09T15:21:45Z

Admin:

Файл:Edmonitor4.png

2012-10-09T15:19:01Z

Admin:

Файл:Edmonitor3.png

2012-10-09T15:18:47Z

Admin:

Файл:Edmonitor2.png

2012-10-09T15:18:32Z

Admin: