Exportação de Documentos de Facturação para XML

Para responder à necessidade da aplicação produzir um Xml onde contenha mais informação de forma a poder ser entregue a diversas entidades existe um Formato XML Padrão PHC que possui um formato fixo.

Desta forma quem possuir o Módulo Documentos Electrónicos, pode através da configuração dos documentos de facturação, na página Documento electrónico escolher a opção Inclui Formato Xml Padrão PHC.
Este xml possuí informação sobre o documento de facturação, o cliente e a empresa que emite a factura.

No caso do Documento Electrónico, ao seleccionar esta opção o XML Padrão substitui o xml configurável.

Existe um parâmetro chamado Código GLN da própria empresa, quando este parâmetro está vazio, no xml o valor do GLN da empresa é preenchido com o Código EAN da Empresa.

Na ficha do Cliente existem alguns campos que passam para o documento de facturação quando este é criado. São eles, por exemplo o Código GLN do cliente, Nº de fornecedor no cliente e Local de entrega.
Estes campos são obrigatórios no xml, assim como a morada, o código postal e o código EAN do cliente.
Quando o código GLN não está preenchido na ficha do cliente, na construção do xml este campo é preenchido com o valor do código EAN.

Dica:
Gln são códigos de localização.
Um EAN13 identifica uma empresa, um GLN identifica um local (tipo um armazém, uma loja).
Uma mesma empresa (1 código EAN) pode ter vários GLN (vários locais).


No Documento de Facturação, na página Documento electrónico aparecem os novos campos da ficha do Cliente e o Código GLN da empresa que são preenchidos por defeito.
Aparece também o campo data de entrega e hora, que serve para registar a data de entrega da mercadoria.

Na produção do Xml são também validados alguns campos da ficha completa da empresa, são eles: Nome, Morada, Código Postal, Nº Contribuinte, Capital Social e Conserv. Reg. Social.

Se possuir a gama Enterprise é possível definir um evento AposPrepararCursorXmlPadrao para o ecrã SFT, onde se pode alterar os cursores criados de forma a acrescentar outros dados ao Xml. Os nome dos cursores usados são: Documento, Linhas, LinhasDesconto, LinhasTaxa, LinhasReferencias e TaxaSubTotal.

O XML Padrão dos documentos de facturação contém os seguintes elementos:

<Documento> - Que agrupa os campos identificativos do documento, da entidade emissora do documento e do respectivo cliente.
<Linhas> - Elemento que agrega os dados relacionados com as linhas do documento de facturação, apresentando-os divididos nos seguintes elementos:
<LinhasDesconto> - Guarda o desconto em valor do documento;
<LinhasTaxa> - Guarda as taxas aplicadas á linha respectiva, no documento.
<LinhasReferencia> - Guarda a informação de documentos que estejam na sua origem, como por exemplo, Encomenda de Cliente.
<TaxaSubTotal> - Elemento que guarda os valores totais das taxas aplicadas nas linhas.


Os elementos decisivos do XML Padrão são aqueles que guardam os campos do cabeçalho, o elemento Documento e os campos das linhas, o elemento Linhas, respectivamente.
Os elementos têm campos considerados obrigatórios e facultativos. Na criação do documento electrónico os campos obrigatórios têm de ser todos preenchidos.

O próximo quadro apresenta todos os elementos, obrigatórios e facultativos:





* O tipo Interno de documento é um campo numérico que guarda o número respectivo de acordo com o tipo de documento que constitui o XML;
1 - Documento de Facturação
2 - Documento de Débito
3 - Documento de Crédito
4 - Guias de Remessa / Facturas proforma

Nota: Quando a Factura tem Lotes e provém de cópia de uma Guia de Remessa o campo da referência fica vazio. Quando tal acontece a aplicação lê o campo Oref determinando a correcta actualização dos restantes campos ligados a Lotes, como por exemplo a validade do lote.

Para além destes campos que caracterizam o XML Padrão, se o utilizador pretender pode mapear outros.
Para tal, deve na configuração do documento de facturação seleccionar o Documento XML que configurou com os novos campos.
Na configuração basta escolher os novos campos e ao criar o documento electrónico, o XML é criado com estes elementos adicionais.

Independentemente de se criarem os elementos com letra maíuscula e minúscula, todos os elementos do XML Padrão vão ser criados com letra minúscula.