Neste ecrã são criados os documentos XML necessários:

Nome do documento
Nome identificativo para este documento

Nº Interno
Este é o número interno do documento

Nome de Perfil MAPI
O perfil de utilizador por E-mail é o nome do sistema de E-mail que está instalado por defeito no sistema operativo. Para saber qual o perfil deverá verificar no registry a seguinte chave :

HKEY_CURRENT_USER\Software\Microsoft\Windows Messaging Subsystem\Profiles

Os casos mais habituais são :

Microsoft Outlook Internet Settings
. se possuir o Outlook ligado diretamente à Internet

Microsoft Exchange Settings
. se possuir o Microsoft Exchange na sua rede

Password de Perfil MAPI
Permite indicar a password do utilizador. Esta opção só é utilizada se o cliente de Mail é do tipo MAPI.

Método de Receção
Para a receção de um documento XML, o tipo de receção (Ficheiro ou Mail), é definido na própria ficha de cada documento.

Tipo de XML
Este campo permite selecionar o tipo de XML que se pretende configurar. Pode optar-se por XML livre ou XML Padrão

URL
Serve para definir o URL para enviar a mensagem por HTTP.

Diretoria
Serve para definir a diretoria a utilizar para a transferência por ficheiro. O botão permite selecionar a diretoria desejada, ou até criar novas diretorias.
Se nesta diretoria não existirem ficheiros XML para receber, quando o utilizador escolher a opção Receber Documentos Via XML, o software avisa com a mensagem: "Não existiam mensagens não lidas".

Nota:
Quando o campo Endereço eletrónico para documentos não está preenchido na ficha do Cliente, Fornecedor, Entidade ou Contacto, é utilizado o definido no próprio documento XML.


Universal Resource Name
Trata-se da identificação que cada tipo de documento tem na iniciativa BizTalk.
Exemplo: url:www.basda.org/schema/eBIS-XML_invoice_v3.00.xml

Folha de estilo a aplicar no documento XML (XSL)
Esta folha de estilo serve para que quando um utilizador abre um documento destes no seu Browser, possa visualizá-lo de uma forma lógica para ele e não como um documento XML. Esta folha de estilo deve ser introduzida utilizando a linguagem XSL.


Os seguintes campos pertencem ao XML Livre, pelo que apenas ficarão disponíveis se o utilizador selecionar este tipo de XML.

Configuração do ficheiro de cabeçalhos a importar
Serve para introdução da configuração do ficheiro externo a utilizar para definir o cabeçalho do documento.

Configuração do ficheiro de linhas a importar
Serve para introdução da configuração do ficheiro externo a utilizar para definir as linhas de detalhe do documento.

Se pretende renumerar os documentos que são recebidos.

Se pretende que seja gerado um erro de cada vez que se tentar importar um documento que já existe.

O limite máximo da diferença entre o valor original do documento e o valor calculado na aplicação (ao importar o documento) para que o documento seja importado.

Configuração
É aqui que é efetuada a configuração do cabeçalho da mensagem. Esta configuração depende da seleção ou não do campo Com o seguinte cabeçalho. Se estiver inativo a configuração segue os seguintes parâmetros:

A configuração e texto da identificação da mensagem BizTalk.
Exemplos:
Configuração: /delivery/message/messageID
Texto: invoice_teste

A configuração da data de envio no documento BizTalk.
Exemplo: /delivery/message/sent

A configuração e Texto do Assunto do documento BizTalk.
Exemplos:
Configuração: /delivery/message/subject
Texto: Envio de fatura

A configuração e Texto do Remetente do documento BizTalk.
Exemplos:
Configuração: /delivery/message/basda:SENDER
Texto: Phc

A configuração do Destinatário do documento BizTalk. O texto será o nome da entidade para quem se envia o documento.
Exemplo: /delivery/message/basda:RECIPIENT

A configuração do Endereço de entrega do documento BizTalk. O texto será o que consta do " Endereço Eletrónico para Documentos " da ficha da entidade para onde se envia o documento.
Exemplo: /delivery/to/address

A configuração e Texto do Endereço do remetente do documento BizTalk.
Exemplos:
Configuração: /delivery/from/address
Texto: xpto@xxxx.xx

Para mais informações, se possuir o módulo de Gestão, consulte o capítulo sobre a Comunidade.


Se o campo Com o seguinte cabeçalho estiver ativo o utilizador pode definir outro tipo de cabeçalho, diferente da usual.
Assim, em vez dos campos acima explicados, passam a existir os seguintes:

Cabeçalho
Este campo de texto permite configurar outro cabeçalho em Xml. Por exemplo:



NOTA: Esta configuração não admite espaços.

Nó do Corpo do XML
Este campo permite definir o nó a partir do qual será escrito o detalhe do documento. Deve estar incluído no cabeçalho definido. Ou seja, se o cabeçalho tiver como designação "MinhaFatura", é esta designação que deve ser colocada no campo Nó do corpo do XML.

Notas finais
Quando se escolhe a opção Receber Documentos via XML, os ficheiros XML que estão no caminho especificado na Diretoria depois de serem importados o software altera automaticamente as extensões dos ficheiros para ."lido". Por exemplo, um ficheiro "testes.xml" depois de importado fica como "testes.xml.lido".




XML Padrão

Nos Dados Principais deve selecionar-se o documento XML do tipo XML Padrão para que a página XML Padrão seja disponibilizada.

Nesta página existe uma grelha que permite a inserção de linhas que correspondem aos novos campos a acrescentar ao XML Padrão.
Esta grelha permite acrescentar campos para dois tipos de documentos; Documentos de Faturação e Dossiers Internos (se possuir o módulo Documentos Eletrónicos).

Quando se cria uma configuração XML Padrão para um Documento de Faturação, para se poder exportar o mesmo documento, na sua configuração deve estar selecionada a configuração aqui criada. Caso o utilizador possua o módulo de Documentos Eletrónicos, deve na configuração do documento eletrónico, selecionar a configuração aqui criada.
Quando se cria uma configuração XML Padrão para um Dossier Interno para se poder importar o dossier, na sua configuração deve estar selecionada a configuração aqui criada.

É de notar que os campos adicionados nos documentos de faturação são adicionados ao XML aquando da emissão do documento eletrónico.

Os elementos adicionados na grelha relativos aos dossiers correspondem aos elementos que foram previamente incluídos nos XML e que se pretendem importar para a aplicação, como por exemplo, Encomendas de Clientes.



Na grelha, para se configurar os novos campos a adicionar ao XML, basta selecionar a tabela a que os mesmo pertencem. De imediato, os campos que fazem parte da tabela selecionada são disponibilizados na coluna Campo. De seguida é necessário definir o nome do novo elemento do XML. O Nome do elemento no ficheiro XML, quando se destina á importação de dossiers internos tem de ser exatamente igual ao que é configurado no Documento XML, incluindo letras maiúsculas e minúsculas. Quando o novo campo a ser adicionado se destina á exportação de um documento de faturação, independentemente de utilizar maiúsculas ou minusculas, o nome dos elementos é sempre criado no XML Padrão com letras minúsculas. A aplicação não permite espaços no nome do elemento.

A aplicação controla a utilização de carateres especiais não permitindo que o utilizador os utilize, prevenindo assim quaisquer erros ou problemas na criação do XML.

Esta funcionalidade permite ainda definir uma Função em X-Base a aplicar ao campo.
Se por algum motivo o XBASE tenha sido mal gerado o ficheiro XML é criado corretamente. No entanto, o elemento que continha o código XML incorreto não é criado no XML.

O Tipo de Campo apenas é necessário preencher quando é utilizado uma função xbase, em que o valor retornado é diferente do tipo do campo.


Os restantes campos da página XML Padrão permitem guardar a restante configuração necessária para a importação de Dossiers Internos e são os seguintes:

Código do Documento a importar. Apenas são importados os documentos que tenham o elemento coddoc com este valor.
Por exemplo, se o coddoc do documento xml a importar for "220", então este campo tem de conter este valor.

O campo Nº Interno do Dossier deve conter o valor do campo com o mesmo nome referente ao tipo de dossier interno (criado na Configuração dos Dossiers Internos) para onde será importado o xml.

O campo Código do Documento de Referência corresponde ao elemento refnumdoc que existe no elemento LinhaReferencias. Este código guarda o valor do tipo de documento que este na origem do dossier a ser importado.
Por exemplo, uma encomenda de cliente poderá não necessitar do elemento LinhaReferencias, no entanto este campo deve estar preenchido com o valor 5 relativo ao seu próprio código de referência. No entanto, um Aviso de receção ou uma alteração á encomenda inicial devem conter neste campo o código do documento na qual tiveram origem, ou seja, o código da Encomenda de cliente, com o valor 5.
A Encomenda é assim o documento de referência a ser utilizado num circuito que pode envolver mais documentos, como o caso acima explicado.

As opções de tratamento do preço, também se refletem nos descontos e no IVA a aplicar em cada documento.
Assim, quando a opção Preenche com o valor do ficheiro de artigos se encontra ativa, ao importar o XML a aplicação coloca nos campos relativos aos preços, os valores que se encontram definidos na ficha dos respetivos artigos. Relativamente ao IVA e independentemente do que se encontrar no XML, o documento vai assumir sempre o IVA definido no ficheiro de artigos, para cada artigo. No que dez respeito aos descontos, independentemente de estes se encontrarem ou não preenchidos no XML, quando se importar um dossier com esta opção de tratamento de preço ativa, a aplicação atribui ao documento os descontos do cliente, em detrimento dos que possam existir no XML.

Quando a opção Preenche com o valor do documento de referência se encontra ativa, ao receber o documento XML, os campos relativos aos preços vão assumir o valor que se encontra definido no documento de origem, ou seja, no dossier interno indicado no elemento LinhasReferencia do XML. Também o IVA e os descontos respeitam a opção de tratamento de preço selecionada, pelo que independentemente dos valores do XML, o IVA e os dexcontos assumidos no dossier são os que se encontram no dossier de origem indicado no XML.

Se estiver vazio preenche com o valor do ficheiro de artigos
Esta opção, uma vez ativa, permite que a aplicação coloque nas linhas dos dossiers importados os valores definidos nas respetivas fichas de artigos.
Esta opção faz a verificação do preço unitário utilizando o campo PRECOLIQUIDO. Assim, na ausência deste campo no XML ou na falta do seu preenchimento, mesmo que o XML utilize o campo PRECOTOTAL e este se encontre preenchido, a aplicação vai entender o XML, como um documento sem preço unitário preenchido. Nestes casos, a aplicação coloca nos campos Preço unitário e IVA os valores guardados na ficha do respetivo artigo e coloca no campo desconto o desconto do cliente. Ou seja, após verificar que o preço unitário se encontra vazio a aplicação vai ao Ficheiro de Artigos e coloca o preço e o valor do IVA que se encontra no ficheiro e o desconto do cliente, que se encontrar ativo.
Se o campo PRECOLIQUIDO se encontrar preenchido, a aplicação já não vai consultar ao ficheiro de artigos, pelo que coloca no preço unitário e no IVA os valores do XML. Se o XML não tiver o IVA preenchido a aplicação preenche este campo com o IVA da tabela 2. Relativamente aos descontos, a aplicação coloca sempre no dossier importado os valores encontrados no XML.

Se a opção Sem tratamento se encontrar ativa, ao importar os dossiers a aplicação vai colocar exatamente a informação que encontrou no XML, sem efetuar algum tipo de tratamento. Assim, a informação a passar para o dossier importado é a constante no XML; preços, IVA e descontos. Como exceção se o XML não tiver o IVA preenchido, a aplicação coloca nas linhas do dossier importado o IVA da tabela 2.

Relativamente aos descontos, os contemplados por esta rotina são:

Dossiers de Preços (apenas dossiers com descontos.)

Desconto Artigo/Cliente

Desconto Habitual da ficha do cliente /li>

Os descontos nesta rotina não acumulam, pelo que se existir um dossier de preços para o cliente do XML a importar, são sempre os descontos do dossier de preços que passam para o dossier.
Se não existirem dossiers de preços e o cliente tiver Desconto Artigo/Cliente e Desconto habitual em simultâneo o que prevalece é o Desconto Artigo/Cliente.
Ou seja o Desconto habitual apenas é assumido se não existirem nenhum dos outros dois.

Apenas é possível ativar a opção Diferença máxima entre o total de origem e calculado quando o tratamento de preço escolhido é Sem tratamento. Esta opção permite definir um limite máximo em Euros, de diferença entre o valor total do documento XML e o valor total calculado pela aplicação, de forma a permitir importar os dossiers cuja diferença de valor não ultrapasse o limite definido.
A opção A designação dos artigos é sempre do ficheiro de artigos permite que ao importar os dossiers as referências importadas assumam sempre a designação que se encontra no ficheiro de artigos, em vez da designação que existe no ficheiro XML.

A opção Preenche os valores do ecovalor ao importar, apenas se encontra disponível de o utilizador possuir o módulo Ecovalor e permite de uma forma automática preencher esses valores á semelhança do que é feito ao inserir um artigo com ecovalor na aplicação. Caso a opção não esteja selecionada, a aplicação importa os dados disponíveis no XML, que de base, apenas tem o valor total para cada tipo de ecovalor por linha.
Ao criar novos campos a ser adicionados aos ficheiros XML é necessário ter em atenção que o nome do campo no ficheiro XML deve ser exatamente igual ao que é configurado no Documento XML, incluindo letras maiúsculas e minúsculas.

NOTA: Quando o utilizador fecha o ecrã as dimensões da grelha são guardadas para que quando o este o volte a aceder, encontre a grelha da mesma forma que a deixou.