Manual do Script Importação/Exportação EDI de documentos de venda

Manual do Script Importação/Exportação EDI de documentos de venda Abril de 2008

ÍNDICE O MANUAL DO SCRIPT IMPORTAÇÃO/EXPORTAÇÃO EDI... 1 Introdução... 1 Objectivos... 1 Condições de Utilização... 1 SCRIPTS... 2 O que são... 2 Os scripts no GesPOS... 2 Antes de executar um script... 2 Cópia de segurança da base de dados... 2 Executar um script... 3 No Recovery... 3 Na Gestão Comercial... 4 IMPORTAÇÃO/EXPORTAÇÃO EDI DE DOCUMENTOS DE VENDA... 7 Importar encomendas de clientes... 8 Estrutura do ficheiro a importar... 8 Criação de Clientes... 9 Criação de Produtos... 9 Resultado final...10 Conversão de documentos de venda...11 Exportar Guias de Remessa / Facturas...11 Notas de Crédito e Notas de Débito...12 Ficheiros exportados...12 Resultado final...12 ANEXOS...14 Anexo 1 - Estrutura do ficheiro ORDERS...14 Cabeçalho (CAB)...14 Desconto de cabeçalho (DSC)...15 Detalhe de linha de artigo (DET)...15 Desconto de linha (DSL)...15 Totais (TOT)...16 Anexo 2 - Estrutura do ficheiro DESAGV...16 Cabeçalho (CAB)...16 Embalagens (EMB)...17 Detalhe de artigo (DET)...17 Totais (TOT)...18 Anexo 3 - Estrutura do ficheiro INVOICE...18 Cabeçalho (CAB)...18 Desconto de cabeçalho (DSC)...19 Detalhe (DET)...19 Detalhe impostos (IML)...20 Descontos linha (DSL)...20 Totais (TOT)...20 Resumo de impostos (IMP)...21

O manual do script Importação/Exportação EDI Introdução Face ao novo contexto nacional e internacional em que operam as organizações portuguesas, contexto esse que obriga a uma permanente adaptação e modernização, cada vez mais é necessário apostar na aquisição de novos equipamentos e novas tecnologias, uma vez que a capacidade de resistir e competir reside cada vez mais na potencialidade dos recursos informáticos. Deste modo, a actualização desses recursos deverá sempre ser pensada tendo em consideração qual o seu contributo para uma maior produtividade, consequência directa da eficácia na implementação e utilização dos mesmos. As aplicações informáticas só terão interesse se estiverem inseridas na estratégia da organização e em pleno funcionamento, contribuindo de forma inequívoca para o seu desenvolvimento. Objectivos O presente manual foi elaborado com o objectivo de detalhar o script Importação/Exportação EDI de documentos de venda, guiando o utilizador na primeira vez que o utiliza, quando necessita de esclarecer dúvidas que possam surgir no processo de execução ou auxiliar na resolução de situações especiais ou anomalias. Na concepção deste manual existiu a preocupação de não o tornar demasiado exaustivo, de modo que a sua leitura seja o mais agradável possível. Toda a estrutura foi elaborada tendo sempre presente a figura do utilizador, por se considerar que é este último aquele que irá retirar o máximo proveito da sua leitura, de modo a que todos os procedimentos possam ser explorados. Condições de Utilização Para maior comodidade e para obter melhores resultados na exploração da aplicação, concebemos este manual para ser consultado pelos operadores em geral e pelos administradores do sistema informático. Ao longo do manual os exemplos dados têm como base a empresa de demonstração, cujo objectivo é mostrar as funcionalidades do sistema. Convenções usadas no manual Texto a verde ou negrito Indica ficheiros, tabelas, opções de menu ou outras secções do manual, cuja leitura deve fazer de forma a completar a informação; Texto a verde em itálico Refere botões, campos ou zonas das tabelas ou dos ecrãs; Texto a verde com o símbolo ou sublinhado Notas e chamadas de atenção; Texto em itálico Exemplos das funcionalidades documentadas. 1

Scripts O que são Um script pode ser definido como um conjunto de comandos, escritos em qualquer linguagem de programação e que podem ser executados sem interacção do utilizador. Um script não é compilado para gerar um programa executável, ao invés disso, cada linha do script é interpretado e executada. Em suma, um script contém todos os passos, devidamente estruturados, que efectuam determinado procedimento. No caso do GesPOS a linguagem de programação utilizada na criação de scripts é Visual Basic, usando para isso o Script Engine (Interpretador de scripts) da Microsoft. Os scripts no GesPOS A utilização dos scripts no GesPOS é possível a partir da versão 3.8 do GesPOS. Todas as funcionalidades implementadas em cada aplicação GesPOS, são previamente analisadas para que cada uma dessas opções consiga responder às necessidades do maior número de clientes possível. No entanto, existem opções específicas quer para determinado negócio quer para um cliente particular que não fariam sentido serem incluídas no GesPOS pela sua especificidade. Assim, ao invés de implementar uma opção dentro da aplicação que apenas será usada por um cliente ou um grupo restrito de clientes, a partir da versão 3.8, o departamento Research & Development da Sage Portugal tem vido a desenvolver scripts específicos para responder às necessidades especiais, garantindo que a informação se mantém coerente e não é posta em causa a integridade da base de dados. Antes de executar um script Tratando-se de uma operação crítica, aconselha-se a execução de uma cópia de segurança da base de dados antes de executar qualquer script. Cópia de segurança da base de dados Antes de fazer a cópia de segurança, certifique-se que todos os utilizadores fecharam a aplicação. Para efectuar uma cópia de segurança, entre no GesPOS Gestão Comercial, aceda ao menu Sistema e de seguida na opção Seguranças, seleccione a localização onde pretende guardar a informação e os dados a incluir na cópia de segurança e clique no botão Arquivar. No caso de ter mais de um posto, a cópia de segurança deverá ser efectuada no servidor (computador que contém a base de dados). O computador servidor é o único computador que contém, na directoria de instalação do GesPOS, o ficheiro server.ini. 2

Local no disco onde será efectuada a cópia de segurança. Caso pretenda alterar esta localização, deverá clicar no botão Actualizar lista Dados a incluir na cópia de segurança Executar um script No Recovery O Recovery foi concebido para executar rotinas de intervenção técnica a nível das bases de dados. Só um técnico especializado (Parceiro Sage GesPOS com formação Recovery ) deverá utilizar este aplicativo). Para ter acesso ao Recovery, deverá executar o download deste executável no site de parceiros, garantindo que a versão do Recovery é igual à versão da aplicação instalada. Este ficheiro encontra-se compactado com a password 88gespos88 e, após a sua descompactação, deverá ser copiado para a pasta onde se encontra instalado a aplicação GesPOS. Ao executar este ficheiro, será solicitada uma primeira password: a do utilizador administrador do GesPOS. Após a leitura e aceitação do texto informativo, será solicitada nova password (Partner.log). Esta última password terá de ser gerada pelo parceiro Sage GesPOS com o executável REVLOG.exe, usando a password 88gespos88 para descompactar o ficheiro. Poderá encontrar o executável em: http://www.mygespos.com/mirror/download/aplicativos/gespos3/revlog.zip. Para mais informações acerca da geração da password do parceiro, por favor consulte o manual do Recovery. A opção Executar scripts encontra-se disponível no menu Migração de Dados do Recovery. Ao aceder à opção, deverá efectuar uma leitura atenta do texto informativo do próprio Recovery, seguidamente Ler e Aceitar os termos e condições de uso e por fim inserir a password técnica (Partner.log) para que possa executar um script. Esta última password terá de ser gerada pelo parceiro Sage GesPOS com o executável REVLOG.exe, usando a password 88gespos88 para descompactar o ficheiro. Poderá encontrar o executável em: http://www.mygespos.com/mirror/download/aplicativos/gespos3/revlog.zip. Para mais informações acerca da geração da password do parceiro, por favor consulte o manual do Recovery. Seguidamente será mostrada a seguinte janela: 3

Botão que permite Editar o script Botão que permite Executar o script Caminho onde se encontra o ficheiro com o script Designação do script Aqui poderá: Alterar o caminho onde se encontra o script, usando para isso o campo Caminho; Neste campo deverá também indicar o nome do script, por exemplo: C:\Programas\GesPos3\Scripts\Fashion Portugal.vb$ No campo Script, por defeito preenchido com o nome do ficheiro do script, poderá alterar a designação do script (por exemplo, alterar para Importação factura). Editar o script no bloco de notas, usando o botão Editar. Caso o script se encontre encriptado, ao editar o ficheiro, a primeira linha contém a menção ENCRYPTED indicando que o ficheiro se encontra codificado e por isso o código do script não pode ser visualizado. Executar o script, clicando para isso no botão Executar. Na Gestão Comercial Também na Gestão Comercial GesPOS poderá executar scripts. Para tal, aceda a Diversos Configurações Parâmetros e posicione-se na pasta Integração de Dados. 4

Nesta pasta deverá definir a informação necessária para a correcta execução do script, nomeadamente: Directoria de Exportação: Caso o script exporte algum ficheiro, deverá definir neste campo a directoria de criação do mesmo. Se este campo não se encontrar preenchido, o ficheiro exportado será criado na directoria GesPOS presente nos Meus Documentos. Directoria de Importação: Neste campo deverá definir a localização do ficheiro a importar. Usando o botão irá aceder a uma janela que lhe permitirá, mais facilmente, escolher a directoria que contém o ficheiro. Scripts a executar: Neste campo, deverá digitar o nome do ficheiro script tal como está gravado na subdirectoria Scripts da directoria de instalação do GesPOS. Venda / Compra / Promo / Stock: Para o script definido no campo anterior, deverá seleccionar o ecrã onde o mesmo estará disponível via botão Executar Scripts: ecrã de compras, vendas, planeamento de descontos ou stocks. Este é o botão que estará disponível nos ecrãs de Compras, Vendas, Planeamento de descontos e Stocks caso exista algum script configurado para o ecrã em questão. No exemplo dado, o botão Executar Scripts estará apenas visível no ecrã de compras uma vez que apenas a opção Compra se encontra seleccionada para o script Fashion Portugal.vb$. Descrição: Aqui poderá digitar uma descrição que o ajudará a identificar mais facilmente o script que irá ser executado. Notifica: Esta opção, caso se encontre marcada, define que, ao clicar no botão Executar Scripts, é apresentada a mensagem abaixo a confirmar a execução do script. 5

Designação do script definida no campo Descrição Depois de introduzir toda a parametrização, clique no botão para adicionar o script à grelha de scripts a executar. Poderá definir vários scripts para o mesmo ecrã, tendo em atenção, que os scripts serão executados no ecrã específico pela ordem em que estão colocados nesta janela. Existindo os seguintes scripts: Descrição do script Ecrã Notas Exportação factura formato 1 Venda Exporta a factura de venda num formato específico Importação factura Fornecedor XPTO Compra Importa facturas de um ficheiro de texto com um formato facultado pelo fornecedor XPTO Importação factura Fornecedor ABC Compra Importa facturas de um ficheiro de texto com um formato facultado pelo fornecedor ABC No ecrã de vendas, uma vez que só existe um script, será executado o script Exportação factura formato 1. No ecrã de Compras, ao clicar no botão Executar Scripts, primeiramente será executado o script Importação factura Fornecedor XPTO e depois o Importação factura Fornecedor ABC, já que esta é a ordem pela qual estão configurados na janela Integração de dados. 6

Importação/Exportação EDI de documentos de venda SONAE MAKRO AUCHAN RECHEIO LECLERC GESTIRETALHO EL CORTE INGLÉS FNAC DIA JM GCT UNICOFA FEIRA NOVA PINGO DOCE MANUEL NUNES & FERNANDES Este script foi criado para possibilitar aos utilizadores GesPOS importar encomendas de clientes proveniente do EDI e exportar as respectivas Guias de Remessa, Facturas, Notas de crédito e / ou Notas de débito. Antes de definir o script em si, é importante esclarecer o que é o EDI. O EDI (Electronic Data Interchange) pode ser definido como um movimento electrónico de documentos padrão de negócio entre, ou dentro, de empresas, que usando um formato de dados estruturado de recolha automática, permite que os dados sejam transformados sem serem reintroduzidos, em termos simples, permite a criação automática de documentos. Uma vez que se trata de um standard aberto, as duas entidades que decidem comunicar documentos entre si, acordam o formato dos ficheiros para que ambas tenham conhecimento do mesmo, por isso EDI é o processo e não o ficheiro. Para assegurar a comunicação entre os intervenientes no processo de envio e recepção dos documentos, deve existir uma entidade que forneça as chamadas Soluções de integração que efectuam a tradução dos formatos das mensagens e garantem que os dados enviados e recebidos são fidedignos. No mercado português poderemos encontrar as seguintes entidades: INFLUE (do grupo GENERIX) e AZERTIA (adquirida em Dezembro de 2007 pela INDRA. Para que a comunicação entre os utilizadores GesPOS e as superfícies comerciais acima referidas usando o EDI seja efectuada correctamente, foi criado um script que permite importar e exportar documentos de venda no formato acordado com a INFLUE, AZERTIA (actual INDRA) e SAPHETY. No entanto, nem todos os campos necessários para a correcta importação e exportação de documentos de venda existem por defeito no GesPOS, pelo que ao executar o script, são criados automaticamente Campos Extra que permitirão a troca de dados entre o emissor e o receptor dos documentos, identificando inequivocamente cada um dos elementos (emissor, receptor, tipo de documento, produtos, descontos, etc.). Os campos extra criados pelo script são os seguintes: Código Cliente: Este campo extra, criado na ficha do cliente, permitirá indicar na base de dados qual o número de fornecedor do utilizador GesPOS do ponto de vista do seu cliente. A este número será acrescido o código do local da entrega da mercadoria quando esta estiver pronta. O campo extra Código Cliente poderá ser preenchido com 5600000002122-4095, onde 5600000002122 identifica o receptor da nota de encomenda (número de fornecedor do utilizador GesPOS perante o seu cliente) e 4095 o código do local onde deverá ser enviada a mercadoria. Exportado para texto?: Este campo extra do documento, contém 3 zonas a actualizar: Uma zona numérica que irá conter o número do documento exportado. Uma data, que irá conter a data em que o documento foi exportado. Uma check box que ficará marcada quando o documento for exportado. Estas 3 zonas do campo extra Exportado para texto?, serão actualizadas automaticamente pelo script quando o documento for exportado. Os quatro campos extra seguintes irão ser preenchidos pelo script no momento da importação das encomendas e irão conter os dados do local onde a mercadoria deve ser entregue: Código Local Entrega; Nome Local Entrega; Morada Local Entrega; Localidade Local Entrega e Código Postal Local Entrega. 7

Importar encomendas de clientes Este script criará na base de dados, não só os documentos de vendas, como também os restantes elementos necessários à correcta importação / exportação da informação, nomeadamente os clientes e os produtos. Fornecedor e Família usados por defeito na criação de novos produtos Ficheiros com o formato ord*.txt existentes na directoria de importação Nesta janela do script destacamos duas zonas distintas: Para a criação de novos produtos utilizar: Deverá nesta zona do ecrã indicar o Fornecedor e a Família que serão usados por defeito na criação de novos produtos que poderão existir na nota de encomenda importada e não na base de dados. Ficheiros a importar: Nesta zona serão listados os ficheiros de texto (extensão TXT) existentes na directoria definida no campo Directoria de Importação presente em Diversos Configurações Parâmetros Integração de dados, cujo nome começa por ord. Utilize o botão Verificar para actualizar a lista de ficheiros existentes na directoria de importação e o botão Remover para eliminar da lista os ficheiros que não pretende importar. Depois de definidos os campos Fornecedor e Família e as encomendas de clientes a importar, deverá clicar no botão Importar para proceder à incorporação dos documentos de venda no sistema, garantindo que o documento NE (Nota de encomenda de clientes) existe na base de dados. Caso o documento NE não exista na base de dados, não será importada qualquer informação. Aquando da importação das encomendas, se os produtos e os clientes presentes nas encomendas não existirem na base de dados, o script procede à criação dos mesmos. Estrutura do ficheiro a importar O ficheiro que contém a encomenda a importar, bem como os dados necessários à correcta criação dos produtos e do cliente, é constituído por: Uma linha de cabeçalho (CAB), com a informação geral da mensagem; Uma ou várias linhas de desconto de cabeçalho (DSC) com os dados relativos aos descontos globais; Uma ou várias linhas de detalhe (DET) com os dados gerais relativos a cada linha de artigo; Associadas a cada uma das linhas de detalhe (DET), podem existir uma ou várias linhas de desconto de linha (DSL) com os dados relativos aos descontos ao nível da linha de artigo; Uma linha de totais (TOT) com os totais da mensagem. Consulte o Anexo 1- Estrutura do ficheiro ORDERS para mais detalhes acerca do ficheiro de encomenda. 8

Criação de Clientes Se o cliente indicado no ficheiro da encomenda não existir na base de dados, será exibida uma mensagem que lhe permitirá: Criar um cliente novo, caso seleccione a opção Não; Ou Escolher um cliente de entre a lista de clientes existentes, escolhendo para isso a opção Sim. Caso opte por criar um cliente novo, a ficha do mesmo será preenchida tendo em consideração os dados existentes no ficheiro que contém a encomenda (ficheiro ord0000000123.txt). Dados do cliente presentes no ficheiro de encomenda. Código identificativo do receptor da nota de encomenda e código do local onde deverá ser enviada a mercadoria. Criação de Produtos No que diz respeito à criação dos produtos, são utilizados, para o preenchimento da ficha, os campos Família e o Fornecedor definidos na janela do script, sendo os restantes dados (Referência, Descrição, Código de Barras, Imposto e Unidade de Venda) preenchidos de acordo com o conteúdo do ficheiro a importar. 9

Fornecedor e Família definidos na janela de interface do script. Resultado final Para além da criação dos produtos e dos clientes, o script criará, na data de importação e usando a numeração definida na base de dados, a nota de encomenda de clientes tendo em consideração os dados contidos no ficheiro. Data de entrega pretendida Número do documento no cliente Linhas do documento importadas pelo script 10

Conversão de documentos de venda Depois de recebida e importada a encomenda, a encomenda deverá, obrigatoriamente, ser convertida via função Conversão de documentos, presente nos Documentos de venda, caso contrário os campos extra, necessários à correcta exportação dos documentos, não serão preenchidos. Não utilize o botão Converter presente no ecrã de movimentação para proceder à conversão dos documentos, uma vez que os campos extra não serão copiados para o documento destino. Estando pronta a mercadoria, o próximo passo será converter a Nota de encomenda de cliente no documento pretendido (Guia de Remessa, Factura, Nota de Crédito ou Nota de Débito). Exportar Guias de Remessa / Facturas Já com o documento convertido, deverá proceder-se à exportação do ficheiro, devendo para isso executar o script e aceder à pasta Exportar Guias de Remessa/Facturas. Filtros usados na selecção dos documentos a exportar Campo que define o layout/documento a ser exportado Lista de documentos que preenchem os critérios definidos Código fornecido pelo cliente Nesta janela poderá definir as informações necessárias à correcta exportação dos documentos de vendas. Documento / Entre e./ Cliente: Nestes campos deverá definir o documento existente na base de dados, o intervalo de datas e o cliente para o qual pretende exportar o(s) documento(s). Seguidamente deverá usar o botão Actualizar para que a lista de documentos seja actualizada. Na combo box localizada em frente ao campo Documento, deverá indicar o tipo de layout/documento a exportar, podendo escolher um dos seguintes documentos: Aviso de Expedição, Factura, Nota de Crédito ou Nota de Débito. Código: Deverá digitar neste campo o código identificativo da empresa fornecido pelo cliente que efectuou a encomenda. Este código será gravado no Editor de Registos do Windows do computador e será sugerido na próxima exportação efectuada para o mesmo cliente. Uma vez definidos todos os campos, deverá clicar em Exportar para gerar os documentos na directoria definida em Directoria de Exportação, presente na pasta Integração de Dados dos Parâmetros. Caso o campo Directoria de Exportação não se encontre preenchido, os ficheiros serão gravados na directoria GesPOS criada nos Meus documentos. 11

Notas de Crédito e Notas de Débito Na exportação de Notas de Crédito ou Notas de Débito deverá, para além de seleccionar todos os campos referidos anteriormente, indicar qual a Nota de Encomenda que deu origem ao documento, para isso, ao seleccionar o layout/documento Nota de Crédito ou Nota de Débito, serão mostrados 2 novos campos que lhe permitirão indicar a série e o número da nota de encomenda que deu origem à Nota de crédito que irá ser exportada. Série da Nota de Encomenda que deu origem à Nota de Crédito Número da Nota de Encomenda que deu origem à Nota de Crédito Ficheiros exportados Dependendo do tipo de layout/documento definido na janela e do número de documentos seleccionados na listagem, será criado um vários ficheiros com os seguintes nomes: DESAGV2001.txt: Onde 2001 identifica o número do documento exportado e tendo em conta que se seleccionou o layout/documento Aviso de Expedição. Serão gerados tantos ficheiros DESAGV quantos os documentos seleccionados na listagem. Poderá consultar a estrutura deste ficheiro no Anexo 2 - Estrutura do ficheiro DESAGV. Ou INVOICE2001.txt: Onde 2001 identifica o número do documento exportado e tendo em conta que se seleccionou o layout/documento Factura. Serão gerados tantos ficheiros INVOICE quantos os documentos seleccionados na listagem. Poderá consultar a estrutura deste ficheiro no Anexo 3 - Estrutura do ficheiro INVOICE. Resultado final Após a exportação: O campo extra Exportado para texto? dos documentos exportados será actualizado com o número do documento, com a data de exportação e marcado como já exportado. 12

Indicação que o documento já foi exportado Número do documento exportado (neste exemplo foi a factura nº 2001) Data de sessão em que o documento foi exportado Os restantes campos extra mantêm-se inalterados. Na pasta Exportar Guias de Remessa/Factura, caso algum documento já exportado esteja incluído nos critérios de selecção, a linha do documento ficará a vermelho e desmarcado por defeito. O documento FAC 2001 já foi exportado, logo a sua linha está a vermelho e desmarcada. Um ficheiro já exportado poderá ser reexportado, seleccionado para isso a respectiva linha. 13

Anexos Anexo 1 - Estrutura do ficheiro ORDERS O ficheiro que contém os dados da encomenda tem a estrutura definida de seguida e abrange os seguintes parceiros da área da distribuição: SONAE GESTIRETALHO MAKRO AUCHAN EL CORTE INGLÉS FNAC MANUEL NUNES & FERNANDES GCT LECLERC UNICOFA DIA RECHEIO FEIRA NOVA PINGO DOCE As linhas a vermelho correspondem às informações importadas pelo GesPOS. Cabeçalho (CAB) Esta linha do documento contém a informação geral da mensagem: emissor e receptor da mensagem, tipo e número de documento, entre outros. Tipo de Linha 1 3 Fixo = CAB (Cabeçalho Geral) Número do Documento 4 35 Esquerda Tipo de Documento 39 3 Esquerda Tipo de Encomenda 42 3 Esquerda 9 = Original 7 = Duplicado 220 = Encomenda Normal 224 = Encomenda Urgente Data/Hora do Documento 45 12 Fixo AAAAMMDDhhmm Data/Hora de Entrega Desejada 57 12 Fixo AAAAMMDDhhmm Data/Hora Limite de Entrega 69 12 Fixo AAAAMMDDhhmm Data/Hora de Levantamento 81 12 Fixo AAAAMMDDhhmm Código do Emissor da Mensagem 93 35 Esquerda Código do Destinatário da Mensagem 128 35 Esquerda Código do Fornecedor 163 35 Esquerda Nome Fornecedor 198 35 Esquerda Código do Comprador 233 35 Esquerda Nome do Comprador 268 35 Esquerda Código Departamento Comprador 303 35 Esquerda Nome Departamento Comprador 338 35 Esquerda Sucursal Comprador 373 35 Esquerda Código do Local de Entrega 408 35 Esquerda Nome do Local de Entrega 443 35 Esquerda Morada do Local de Entrega 478 70 Esquerda Localidade do Local de Entrega 548 35 Esquerda Código Postal do Local de Entrega 583 9 Esquerda 14

Forma de Pagamento 592 35 Esquerda Condições de Entrega 627 35 Esquerda Prazo de Pagamento 662 3 Direita c/ Zeros Número de dias Código da Moeda 665 3 Esquerda EUR = Euros Texto Livre 668 255 Esquerda Desconto de cabeçalho (DSC) As linhas referentes aos descontos de cabeçalho serão iniciadas por DSC e identificam os dados relativos aos descontos globais. Tipo de Linha 1 3 Fixo = DSC (Desconto de Cabeçalho) Número do Desconto 4 1 Direita c/ Zeros 1 9 Percentagem 5 6 Direita c/ Zeros 3 inteiros, 2 decimais Montante de Desconto 11 15 Direita c/ Zeros 11 inteiros, 3 decimais Detalhe de linha de artigo (DET) Existirão tantas linhas de detalhes DET quantos os artigos da encomenda, contendo os dados gerais de cada um dos artigos (código de artigo, descrição, quantidade, preços, etc.). Tipo de Linha 1 3 Fixo = DET (Detalhe de Linha de Artigo) Número de Linha 4 6 Direita c/ Zeros Inteiro (contador sequencial) Código EAN do Artigo 10 35 Esquerda Código Interno do Artigo Comprador 45 35 Esquerda Código Interno do Artigo Fornecedor 80 35 Esquerda Descrição do Artigo 1 115 35 Esquerda Descrição do Artigo 2 150 35 Esquerda Data/Hora de Entrega Desejada 185 12 Fixo AAAAMMDDhhmm Data/Hora Limite de Entrega 197 12 Fixo AAAAMMDDhhmm Quantidade Encomendada 209 15 Direita c/ Zeros 11 inteiros, 3 decimais Quantidade Gratuita 224 15 Direita c/ Zeros 11 inteiros, 3 decimais Unidade de Medida de Quantidades 239 3 Esquerda KGM = Quilos Preço Bruto Unitário 242 15 Direita c/ Zeros 11 inteiros, 3 decimais Preço Líquido Unitário 257 15 Direita c/ Zeros 11 inteiros, 3 decimais Unidade de Medida de Preços 272 3 Esquerda KGM = Quilos Quantidade, em Embalagens 275 10 Direita c/ Zeros Inteiro Tipo de Embalagem 285 3 Esquerda BX = Caixa Pack Size 288 10 Direita c/ Zeros Inteiro Níveis 298 10 Direita c/ Zeros Inteiro Lastro 308 10 Direita c/ Zeros Inteiro Taxa de IVA 318 6 Direita c/ Zeros 3 inteiros, 2 decimais Montante Líquido da Linha 324 15 Direita c/ Zeros 11 inteiros, 3 decimais Desconto de linha (DSL) Associadas aos detalhes de linha de artigo (DET) poderão existir uma ou várias linhas de desconto de linha, que irão conter os dados relativos aos descontos dos produtos. Tipo de Linha 1 3 Fixo = DSL (Desconto de Linha) Número do Desconto 4 1 Direita c/ Zeros 1 9 15

Percentagem 5 6 Direita c/ Zeros 3 inteiros, 2 decimais Montante de Desconto 11 15 Direita c/ Zeros 11 inteiros, 3 decimais Totais (TOT) Os totais do documento serão inscritos na linha iniciada por TOT. As linhas TOT não são consideradas na importação da encomenda uma vez que o script irá recalcular os totais aquando da gravação do(s) documento(s). Tipo de Linha 1 3 Fixo = TOT (Totais) Número de Linhas do Documento 4 6 Direita c/ Zeros Inteiro Montante Bruto do Documento 10 15 Direita c/ Zeros 11 inteiros, 3 decimais Montante Liquido do Documento 25 15 Direita c/ Zeros 11 inteiros, 3 decimais Anexo 2 - Estrutura do ficheiro DESAGV Este ficheiro é criado sempre que se selecciona, para a exportação, o documento Aviso de Expedição e abrange os seguintes parceiros da área da distribuição: EL CORTE INGLÉS UNICOFA JM SONAE As linhas a vermelho correspondem às informações exportadas pelo GesPOS. O texto marcado a azul corresponde a campos exportados com valor fixo. Cabeçalho (CAB) Esta linha do ficheiro contém a informação geral da mensagem. Tipo de Linha 1 3 Fixo = CAB (Cabeçalho) Número do Documento 4 35 Esquerda Data/Hora do Documento 39 12 Fixo AAAAMMDDhhmm Data/Hora de Expedição 51 12 Fixo AAAAMMDDhhmm Data/Hora Prevista de Entrega 63 12 Fixo AAAAMMDDhhmm Número da Encomenda Comprador 75 35 Esquerda Data/Hora Encomenda Comprador 110 12 Fixo AAAAMMDDhhmm Número Encomenda Fornecedor 122 35 Esquerda Código do Emissor da Mensagem 157 35 Esquerda Código do Destinatário da Mensagem 192 35 Esquerda Código do Comprador 227 35 Esquerda Código Interno do Comprador 262 35 Esquerda Nome do Comprador 297 35 Esquerda Morada do Comprador 332 70 Esquerda Localidade do Comprador 402 35 Esquerda Código Postal do Comprador 437 9 Esquerda Departamento Comprador 446 35 Esquerda Sucursal Comprador 481 35 Esquerda Código do Fornecedor 516 35 Esquerda Código Interno do Fornecedor 551 35 Esquerda Nome do Fornecedor 586 35 Esquerda Morada do Fornecedor 621 70 Esquerda Localidade do Fornecedor 691 35 Esquerda 16

Código Postal do Fornecedor 726 9 Esquerda Código do Local de Entrega 735 35 Esquerda Código Interno Local Entrega 770 35 Esquerda Nome do Local de Entrega 805 35 Esquerda Morada do Local de Entrega 840 70 Esquerda Localidade do Local de Entrega 910 35 Esquerda Código Postal do Local de Entrega 945 9 Esquerda Peso Total Bruto 954 15 Direita c/ Zeros Peso Total Liquido 969 15 Direita c/ Zeros Volume Total 984 15 Direita c/ Zeros 11 inteiros, 3 decimais 00000000000.000 11 inteiros, 3 decimais 00000000000.000 11 inteiros, 3 decimais 00000000000.000 Embalagens (EMB) As linhas iniciadas por EMB identificam os dados relativos à embalagem e marcas dos artigos expedidos. O script não exporta informações relativas à embalagem, pelo que ao seleccionar o layout/documento Aviso de Expedição, não existirão linhas iniciadas por EMB. Tipo de Linha 1 3 Fixo = EMB (Embalagens) Nível Hierárquico 4 6 Direita c/ Zeros Inteiro Nível Hierárquico Superior 10 6 Direita c/ Zeros Inteiro Número de Embalagens 16 10 Direita c/ Zeros Inteiro Tipo de Embalagem 26 3 Esquerda BX Caixa; CT Palete Etiqueta / Número de Série (SSCC) 29 35 Esquerda Detalhe de artigo (DET) Associadas a cada uma das linhas EMB existirá uma ou várias linhas de detalhe de artigo (DET) contendo os dados relativos ao produto expedido. Tipo de Linha 1 3 Fixo = DET (Detalhe de Artigo) Número de Linha 4 6 Direita c/ Zeros Inteiro Código EAN do Artigo 10 35 Esquerda Código Interno do Artigo - Comprador 45 35 Esquerda Código Interno do Artigo - Fornecedor 80 35 Esquerda Código DUN do Artigo 115 35 Esquerda Descrição do Artigo 150 35 Esquerda Número da Encomenda Comprador 185 35 Esquerda Data/Hora Encomenda Comprador 220 12 Esquerda AAAAMMDDhhmm Número Linha Encomenda Comprador 232 6 Direita c/ Zeros Inteiro Número Encomenda Fornecedor 238 35 Esquerda Data/Hora Encomenda Fornecedor 273 12 Esquerda AAAAMMDDhhmm Quantidade Expedida 285 15 Direita c/ Zeros 11 inteiros, 3 decimais Quantidade Gratuita 300 15 Direita c/ Zeros Unidade de Medida de Quantidades 315 3 Esquerda Pack Size 318 15 Direita c/ Zeros 11 inteiros, 3 decimais 00000000000.000 11 inteiros, 3 decimais 00000000000.000 País de Origem 333 3 Esquerda PT = Portugal Data de Validade 336 8 Esquerda AAAAMMDD Número de Lote 344 35 Esquerda 17

Totais (TOT) A linha iniciadas por TOT identifica os dados relativos ao total do documento. Tipo de Linha 1 3 Fixo = TOT (Totais) Número de Linhas da Mensagem 4 6 Direita c/ Zeros Inteiro Anexo 3 - Estrutura do ficheiro INVOICE Este ficheiro usa a estrutura definida de seguida, é criado sempre que se exportam Facturas, Notas de Crédito e Notas de Débito e abrange os seguintes parceiros da área da distribuição: SONAE GESTIRETALHO MAKRO AUCHAN EL CORTE INGLÉS FNAC MANUEL NUNES & FERNANDES GCT UNICOFA FEIRA NOVA PINGO DOCE As linhas a vermelho correspondem às informações exportadas pelo GesPOS. O texto marcado a azul corresponde a campos exportados com valor fixo. Cabeçalho (CAB) Esta linha do ficheiro contém a informação geral da mensagem. Tipo de Linha 1 3 Fixo = CAB (Cabeçalho) Número do Documento 4 35 Esquerda Tipo de Documento 39 3 Esquerda 380 = Factura; 381 = Nota de Crédito; 382 = Nota de Débito. Data/Hora do Documento 42 12 Fixo AAAAMMDDhhmm Número Encomenda do Comprador 54 35 Esquerda Data/Hora Encomenda Comprador 89 12 Fixo AAAAMMDDhhmm Número Encomenda do Fornecedor 101 35 Esquerda Data/Hora Encomenda Fornecedor 136 12 Fixo AAAAMMDDhhmm Número da Factura Referida 148 35 Esquerda Data/Hora Factura Referida 183 12 Fixo Número do Aviso de Expedição 195 35 Esquerda Data/Hora Aviso Expedição 230 12 Fixo AAAAMMDDhhmm Código do Emissor da Mensagem 242 35 Esquerda Código do Destinatário da Mensagem 277 35 Esquerda Código do Comprador 312 35 Esquerda Código Interno do Comprador 347 35 Esquerda Contribuinte do Comprador 382 20 Esquerda Nome do Comprador 402 35 Esquerda Morada do Comprador 437 70 Esquerda Localidade do Comprador 507 35 Esquerda Código Postal do Comprador 542 9 Esquerda Apenas preenchido se Tipo de Documento = 381 ou 382 AAAAMMDDhhmm Apenas preenchido se Tipo de Documento = 381 ou 382 18

Departamento Comprador 551 35 Esquerda Sucursal Comprador 586 35 Esquerda Código do Fornecedor 621 35 Esquerda Código Interno do Fornecedor 656 35 Esquerda Contribuinte do Fornecedor 691 20 Esquerda Nome do Fornecedor 711 35 Esquerda Morada do Fornecedor 746 70 Esquerda Localidade do Fornecedor 816 35 Esquerda Código Postal do Fornecedor 851 9 Esquerda Capital Social Fornecedor em Euros 860 15 Direita c/ Zeros Código da Entidade Facturada 875 35 Esquerda Código Interno Entidade Facturada 910 35 Esquerda Contribuinte da Entidade Facturada 945 20 Esquerda Nome da Entidade Facturada 965 35 Esquerda Morada da Entidade Facturada 1000 70 Esquerda Localidade da Entidade Facturada 1070 35 Esquerda Código Postal da Entidade Facturada 1105 9 Esquerda Código do Local de Entrega 1114 35 Esquerda Código Interno do Local de Entrega 1149 35 Esquerda Nome do Local de Entrega 1184 35 Esquerda Morada do Local de Entrega 1219 70 Esquerda Localidade do Local de Entrega 1289 35 Esquerda Código Postal do Local de Entrega 1324 9 Esquerda Local de Carga 1333 35 Esquerda Data/Hora de Entrega 1368 12 Fixo AAAAMMDDhhmm Matricula do Transporte 1380 35 Esquerda Número de Dias para Pagamento 1415 3 Direita c/ Zeros 000 Data de Vencimento 1418 8 Esquerda AAAAMMDD Código da Moeda 1426 3 Esquerda EUR = Euros Texto Livre 1429 255 Esquerda Desconto de cabeçalho (DSC) Poderão existir uma ou várias linhas iniciadas por DSC que irão conter os dados relativos aos descontos globais do documento. Tipo de Linha 1 3 Fixo = DSC (Desconto de Cabeçalho) Número do Desconto 4 1 Direita c/ Zeros 1 9 Percentagem 5 6 Direita c/ Zeros 3 inteiros, 2 decimais Montante de Desconto 11 15 Direita c/ Zeros 11 inteiros, 3 decimais Detalhe (DET) Por cada linha de artigo extsirente no documento, o ficheiro irá conter uma linha DET com os dados gerais relativos a cada artigo. Tipo de Linha 1 3 Fixo = DET (Detalhe de Linha de Artigo) Número da Linha 4 6 Direita c/ Zeros Inteiro Código EAN do Artigo 10 35 Esquerda Código Interno do Artigo - Comprador 45 35 Esquerda Código Interno do Artigo - Fornecedor 80 35 Esquerda Descrição do Artigo 115 35 Esquerda 19

Quantidade Facturada 150 15 Direita c/ Zeros 11 inteiros, 3 decimais Quantidade Gratuita 165 15 Direita c/ Zeros 11 inteiros, 3 decimais 00000000000.000 Unidade de Medida de Quantidades 180 3 Esquerda KGM = Quilos Preço Bruto Unitário 183 15 Direita c/ Zeros 11 inteiros, 3 decimais Preço Líquido Unitário 198 15 Direita c/ Zeros 11 inteiros, 3 decimais Unidade de Medida de Preços 213 3 Esquerda KGM = Quilos Quantidade, em Embalagens 216 10 Direita c/ Zeros Inteiro Tipo de Embalagem 226 3 Esquerda BX = Caixa Número Encomenda do Comprador 229 35 Esquerda Data/Hora Encomenda do Comprador 264 12 Fixo AAAAMMDDhhmm Numero Linha Encomenda Comprador 276 6 Direita c/ Zeros Inteiro Número Aviso de Expedição 282 35 Esquerda Data/Hora Aviso de Expedição 317 12 Fixo AAAAMMDDhhmm Número Linha Aviso de Expedição 329 6 Direita c/ Zeros Inteiro 000000 Montante Líquido da Linha 335 15 Direita c/ Zeros 11 inteiros, 3 decimais Detalhe impostos (IML) Associadas a cada uma das linhas de detalhe (DET), existirá uma linha (IML) contendo os impostos da linha de artigo. Tipo de Linha 1 3 Fixo = IML (Impostos Detalhe) Tipo Imposto 4 3 Fixo Codigo da Taxa de Imposto 7 3 Esquerda = VAT Iva = ACT IEC = ENV Eco Valor Taxa de Imposto 10 6 Direita c/ Zeros 3 inteiros, 2 decimais Montante Tributável 16 15 Direita c/ Zeros 11 inteiros, 3 decimais Montante de Imposto 31 15 Direita c/ Zeros 11 inteiros, 3 decimais Descontos linha (DSL) Também associadas a cada uma das linhas de detalhe (DET), poderão existir uma ou várias linhas de desconto de linha (DSL) com os dados relativos aos descontos ao nível da linha de artigo. Tipo de Linha 1 3 Fixo = DSL (Desconto de Linha) Número do Desconto 4 1 Direita c/ Zeros 1-9 Percentagem 5 6 Direita c/ Zeros 3 inteiros, 2 decimais Montante de Desconto 11 15 Direita c/ Zeros 11 inteiros, 3 decimais Totais (TOT) No final do ficheiro existirá sempre uma linha de totais TOT que irá conter os totais do documento. Tipo de Linha 1 3 Fixo = TOT (Totais) Número de Linhas da Factura 4 6 Direita c/ Zeros Inteiro Montante Total das Linhas de Artigo 10 15 Direita c/ Zeros 11 inteiros, 3 decimais Montante Total Bruto 25 15 Direita c/ Zeros 11 inteiros, 3 decimais Montante Total Tributável 40 15 Direita c/ Zeros 11 inteiros, 3 decimais Montante Total de Imposto 55 15 Direita c/ Zeros 11 inteiros, 3 decimais 20

Montante Total de Descontos 70 15 Direita c/ Zeros 11 inteiros, 3 decimais Montante Total de Encargos 85 15 Direita c/ Zeros 11 inteiros, 3 decimais Montante Total EcoValor 100 15 Direita c/ Zeros Montante Total Custo Embalagem 115 15 Direita c/ Zeros 11 inteiros, 3 decimais 00000000000.000 11 inteiros, 3 decimais 00000000000.000 Montante Total da Factura 130 15 Direita c/ Zeros 11 inteiros, 3 decimais Resumo de impostos (IMP) O ficheiro terminará sempre com uma ou várias linhas de resumo de impostos (IMP) com os totais por taxa de imposto. Tipo de Linha 1 3 Fixo = IMP (Resumo de Imposto) Tipo Imposto 4 3 Fixo Codigo da Taxa de Imposto 7 3 Esquerda = VAT Iva = ACT IEC = ENV Eco Valor Taxa de Imposto 10 6 Direita c/ Zeros 3 inteiros, 2 decimais Montante Tributável 16 15 Direita c/ Zeros 11 inteiros, 3 decimais Montante de Imposto 31 15 Direita c/ Zeros 11 inteiros, 3 decimais 21