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

Transcrição

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

2

3 Í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

4

5 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

6 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

7 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: 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: 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

8 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

9 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

10 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

11 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 , onde 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

12 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

13 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 ord 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

14 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

15 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

16 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

17 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

18 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 Fixo AAAAMMDDhhmm Data/Hora de Entrega Desejada Fixo AAAAMMDDhhmm Data/Hora Limite de Entrega Fixo AAAAMMDDhhmm Data/Hora de Levantamento Fixo AAAAMMDDhhmm Código do Emissor da Mensagem Esquerda Código do Destinatário da Mensagem Esquerda Código do Fornecedor Esquerda Nome Fornecedor Esquerda Código do Comprador Esquerda Nome do Comprador Esquerda Código Departamento Comprador Esquerda Nome Departamento Comprador Esquerda Sucursal Comprador Esquerda Código do Local de Entrega Esquerda Nome do Local de Entrega Esquerda Morada do Local de Entrega Esquerda Localidade do Local de Entrega Esquerda Código Postal do Local de Entrega Esquerda 14

19 Forma de Pagamento Esquerda Condições de Entrega Esquerda Prazo de Pagamento Direita c/ Zeros Número de dias Código da Moeda Esquerda EUR = Euros Texto Livre 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 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 Esquerda Código Interno do Artigo Comprador Esquerda Código Interno do Artigo Fornecedor Esquerda Descrição do Artigo Esquerda Descrição do Artigo Esquerda Data/Hora de Entrega Desejada Fixo AAAAMMDDhhmm Data/Hora Limite de Entrega Fixo AAAAMMDDhhmm Quantidade Encomendada Direita c/ Zeros 11 inteiros, 3 decimais Quantidade Gratuita Direita c/ Zeros 11 inteiros, 3 decimais Unidade de Medida de Quantidades Esquerda KGM = Quilos Preço Bruto Unitário Direita c/ Zeros 11 inteiros, 3 decimais Preço Líquido Unitário Direita c/ Zeros 11 inteiros, 3 decimais Unidade de Medida de Preços Esquerda KGM = Quilos Quantidade, em Embalagens Direita c/ Zeros Inteiro Tipo de Embalagem Esquerda BX = Caixa Pack Size Direita c/ Zeros Inteiro Níveis Direita c/ Zeros Inteiro Lastro Direita c/ Zeros Inteiro Taxa de IVA Direita c/ Zeros 3 inteiros, 2 decimais Montante Líquido da Linha 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

20 Percentagem 5 6 Direita c/ Zeros 3 inteiros, 2 decimais Montante de Desconto 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 Direita c/ Zeros 11 inteiros, 3 decimais Montante Liquido do Documento 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 Fixo AAAAMMDDhhmm Data/Hora de Expedição Fixo AAAAMMDDhhmm Data/Hora Prevista de Entrega Fixo AAAAMMDDhhmm Número da Encomenda Comprador Esquerda Data/Hora Encomenda Comprador Fixo AAAAMMDDhhmm Número Encomenda Fornecedor Esquerda Código do Emissor da Mensagem Esquerda Código do Destinatário da Mensagem Esquerda Código do Comprador Esquerda Código Interno do Comprador Esquerda Nome do Comprador Esquerda Morada do Comprador Esquerda Localidade do Comprador Esquerda Código Postal do Comprador Esquerda Departamento Comprador Esquerda Sucursal Comprador Esquerda Código do Fornecedor Esquerda Código Interno do Fornecedor Esquerda Nome do Fornecedor Esquerda Morada do Fornecedor Esquerda Localidade do Fornecedor Esquerda 16

21 Código Postal do Fornecedor Esquerda Código do Local de Entrega Esquerda Código Interno Local Entrega Esquerda Nome do Local de Entrega Esquerda Morada do Local de Entrega Esquerda Localidade do Local de Entrega Esquerda Código Postal do Local de Entrega Esquerda Peso Total Bruto Direita c/ Zeros Peso Total Liquido Direita c/ Zeros Volume Total Direita c/ Zeros 11 inteiros, 3 decimais inteiros, 3 decimais inteiros, 3 decimais 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 Direita c/ Zeros Inteiro Tipo de Embalagem 26 3 Esquerda BX Caixa; CT Palete Etiqueta / Número de Série (SSCC) 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 Esquerda Código Interno do Artigo - Comprador Esquerda Código Interno do Artigo - Fornecedor Esquerda Código DUN do Artigo Esquerda Descrição do Artigo Esquerda Número da Encomenda Comprador Esquerda Data/Hora Encomenda Comprador Esquerda AAAAMMDDhhmm Número Linha Encomenda Comprador Direita c/ Zeros Inteiro Número Encomenda Fornecedor Esquerda Data/Hora Encomenda Fornecedor Esquerda AAAAMMDDhhmm Quantidade Expedida Direita c/ Zeros 11 inteiros, 3 decimais Quantidade Gratuita Direita c/ Zeros Unidade de Medida de Quantidades Esquerda Pack Size Direita c/ Zeros 11 inteiros, 3 decimais inteiros, 3 decimais País de Origem Esquerda PT = Portugal Data de Validade Esquerda AAAAMMDD Número de Lote Esquerda 17

22 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 Fixo AAAAMMDDhhmm Número Encomenda do Comprador Esquerda Data/Hora Encomenda Comprador Fixo AAAAMMDDhhmm Número Encomenda do Fornecedor Esquerda Data/Hora Encomenda Fornecedor Fixo AAAAMMDDhhmm Número da Factura Referida Esquerda Data/Hora Factura Referida Fixo Número do Aviso de Expedição Esquerda Data/Hora Aviso Expedição Fixo AAAAMMDDhhmm Código do Emissor da Mensagem Esquerda Código do Destinatário da Mensagem Esquerda Código do Comprador Esquerda Código Interno do Comprador Esquerda Contribuinte do Comprador Esquerda Nome do Comprador Esquerda Morada do Comprador Esquerda Localidade do Comprador Esquerda Código Postal do Comprador Esquerda Apenas preenchido se Tipo de Documento = 381 ou 382 AAAAMMDDhhmm Apenas preenchido se Tipo de Documento = 381 ou

23 Departamento Comprador Esquerda Sucursal Comprador Esquerda Código do Fornecedor Esquerda Código Interno do Fornecedor Esquerda Contribuinte do Fornecedor Esquerda Nome do Fornecedor Esquerda Morada do Fornecedor Esquerda Localidade do Fornecedor Esquerda Código Postal do Fornecedor Esquerda Capital Social Fornecedor em Euros Direita c/ Zeros Código da Entidade Facturada Esquerda Código Interno Entidade Facturada Esquerda Contribuinte da Entidade Facturada Esquerda Nome da Entidade Facturada Esquerda Morada da Entidade Facturada Esquerda Localidade da Entidade Facturada Esquerda Código Postal da Entidade Facturada Esquerda Código do Local de Entrega Esquerda Código Interno do Local de Entrega Esquerda Nome do Local de Entrega Esquerda Morada do Local de Entrega Esquerda Localidade do Local de Entrega Esquerda Código Postal do Local de Entrega Esquerda Local de Carga Esquerda Data/Hora de Entrega Fixo AAAAMMDDhhmm Matricula do Transporte Esquerda Número de Dias para Pagamento Direita c/ Zeros 000 Data de Vencimento Esquerda AAAAMMDD Código da Moeda Esquerda EUR = Euros Texto Livre 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 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 Esquerda Código Interno do Artigo - Comprador Esquerda Código Interno do Artigo - Fornecedor Esquerda Descrição do Artigo Esquerda 19

24 Quantidade Facturada Direita c/ Zeros 11 inteiros, 3 decimais Quantidade Gratuita Direita c/ Zeros 11 inteiros, 3 decimais Unidade de Medida de Quantidades Esquerda KGM = Quilos Preço Bruto Unitário Direita c/ Zeros 11 inteiros, 3 decimais Preço Líquido Unitário Direita c/ Zeros 11 inteiros, 3 decimais Unidade de Medida de Preços Esquerda KGM = Quilos Quantidade, em Embalagens Direita c/ Zeros Inteiro Tipo de Embalagem Esquerda BX = Caixa Número Encomenda do Comprador Esquerda Data/Hora Encomenda do Comprador Fixo AAAAMMDDhhmm Numero Linha Encomenda Comprador Direita c/ Zeros Inteiro Número Aviso de Expedição Esquerda Data/Hora Aviso de Expedição Fixo AAAAMMDDhhmm Número Linha Aviso de Expedição Direita c/ Zeros Inteiro Montante Líquido da Linha 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 Direita c/ Zeros 11 inteiros, 3 decimais Montante de Imposto 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 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 Direita c/ Zeros 11 inteiros, 3 decimais Montante Total Bruto Direita c/ Zeros 11 inteiros, 3 decimais Montante Total Tributável Direita c/ Zeros 11 inteiros, 3 decimais Montante Total de Imposto Direita c/ Zeros 11 inteiros, 3 decimais 20

25 Montante Total de Descontos Direita c/ Zeros 11 inteiros, 3 decimais Montante Total de Encargos Direita c/ Zeros 11 inteiros, 3 decimais Montante Total EcoValor Direita c/ Zeros Montante Total Custo Embalagem Direita c/ Zeros 11 inteiros, 3 decimais inteiros, 3 decimais Montante Total da Factura 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 Direita c/ Zeros 11 inteiros, 3 decimais Montante de Imposto Direita c/ Zeros 11 inteiros, 3 decimais 21