Author: Maria Santos

This example shows how to use the Gestix ERP CRM to generate invoices from CSV files in a custom format.

The first section focus on the routinely operation of importing a CSV file and generating invoices from it. The last section focus on the initial set up that is to be performed only once for a given CSV layout.

We assume all data supplied to the system comes from the CSV file. In the process, when the customer doesn’t exist in the file, it is created. Otherwise it is updated if their details have changed since previous import. The same behavior applies to products (stored in the Articles file) and to services (stored in the Services file).

Note: the user interface language inside Gestix is independent of the language of the produced invoices. Users can as well choose the language in which to print the invoices at the time they print or store the pdf.

Routinely Import Invoices

Gestix ERP CRM is available for European counties as well as for non European countries. Some countries, including Portugal, require the invoicing software to provide the SAF-T xml file reported to the Tax Authority. This particular setup is for a company subject to Portuguese Tax Authority rules. In this case, invoices are to be issued in two steps:

• Phase 1, load the CSV into the system producing a batch of proforma invoices;
• Phase 2, generate a batch of final invoices from the outstanding proforma invoices imported in phase 1.

Phase 1: Import the CSV file

Enter the Orders menu and select Proforma Invoice. Then click on Data Import.

Select a CSV layout pressing the arrow next to its description.

Press the Choose File button to upload the CSV file for the current batch.

Press the Test button to preview the documents before they are stored on to the system.

Press Back when ready.

Finally press the Import File button. Allow some time for the process to complete.

Then the report of stored documents is shown. If an error occurs during the processing of each document it will be noticed in this report.

Click the Search button to list the imported documents.

Phase 2: Generate the Invoices

Enter the Invoicing menu and open the Report tab.

Press the Automatic Billing By Document button.

Select the Document Set for the invoices to be generated. You can specify the Invoice Date as well (current date assumed by default). At this point you can also control which invoices to process by checking or unchecking each line.

Press the Continue button to proceed to the confirmation page.

Finally, confirm the operation by pressing Save.

You can find your newly created invoices in the following Fiscal Report.

The overall process terminates at this point.

Initial setup – Define the CSV layout

The first line of the CSV is expected to contain column headings. Each line in the source invoice is represented by a line in the CSV file. If the invoice has three lines, for instance, there will be three lines in the CSV file will all column data repeated except for the columns related to the items.

1. Customer data (number, name, billing address, shipping address, VAT ID number, etc.)
2. Invoice header data (invoice number and date, etc.)
3. Item data (product code, description, quantity, unit price, etc.)

The Item Status Type field allows for telling Gestix whether the item is to be considered an Article (P), a Service (S), or plain Text (T). If the item code is not supplied the item is assumed to be stored as plain text.

Note: you don’t need to go through this steps each time you want to import invoices. Generally this task is required only once, on initial setup.

Sample CSV File for this example (extra blank lines added for clarity):

“Nº Sequencial”;”Data Fatura”;”Data Vencimento”;”Referencia”;”V/ Refª”;”Cond. Pag.”;”Vendedor”;”Nº Contribuinte”;”Código Cliente”;”Nome”;”Telefone”;”Fax”;”Email”;”Morada”;”Morada 2″;”Código Postal”;”Pais”;”Desconto”;”Total Final”;”Notas/ Comentários”;”Refª Item”;”Descrição”;”Qtde”;”Unidade”;”Preço Unitário”;”IVA”;”Desconto1″;”Desconto2″;”Ref. Pagamento”;”Status Item Type”

“2020/DA10562″;”02-12-2020″;”01-01-2021″;”119628/DO0105934″;” Folha de Participação Nº. 31511″;”30 Dias”;;506819523;1111;”WESTIX”;;;;”RUA LUIS CAMOES 32″;;”2130-062 BENAVENTE”;”PT”;0;”1082,4″;”Local de Intervenção: R. José Nº. 1 Lj.
Os serviços prestados foram realizados em 30/11/2020(DL. 256/2003 Art. 36)
IBAN para transferência: PT50 xxx 34333 YYYYY (pf indicar nº. de factura ou Nota Visita nas transferências)”;149;”desentupimento e/ou limpeza: rede geral de esgotos residuais e/ou pluviais”;1;;880;23;0;0;”Factura Por Liquidar”;”S”

“2020/DA10562″;”02-12-2020″;”01-01-2021″;”119628/DO0105934″;” Folha de Participação Nº. 31511″;”30 Dias”;;506819523;1111;”WESTIX”;;;;”RUA LUIS CAMOES 32″;;”2130-062 BENAVENTE”;”PT”;0;”1082,4″;”Local de Intervenção: R. José Nº. 1 Lj.
Os serviços prestados foram realizados em 30/11/2020(DL. 256/2003 Art. 36)
IBAN para transferência: PT50 xxx 34333 YYYYY (pf indicar nº. de factura ou Nota Visita nas transferências)”;;”Serviços de Limpeza”;;;;;;0;”Factura Por Liquidar”;”T”

“2020/DA10562″;”02-12-2020″;”01-01-2021″;”119628/DO0105934″;” Folha de Participação Nº. 31511″;”30 Dias”;;506819523;1111;”WESTIX”;;;;”RUA LUIS CAMOES 32″;;”2130-062 BENAVENTE”;”PT”;0;”1082,4″;”Local de Intervenção: R. José Nº. 1 Lj.
Os serviços prestados foram realizados em 30/11/2020(DL. 256/2003 Art. 36)
IBAN para transferência: PT50 xxx 34333 YYYYY (pf indicar nº. de factura ou Nota Visita nas transferências)”;;”Deslocação para o local de intervenção”;;;;;;0;”Factura Por Liquidar”;”T”

Enter the Orders menu, select Pro-forma Invoice and then enter the Data Import menu from the top menu.

Crate a New Layout by pressing the plus sign (+).

Give it a name and press the Choose File button.

Then press Save.

Select the newly added layout by pressing the arrow next to its Description.

Go through each column and press Check as needed to update the view with your choices.

When ready, press the Test button to preview the results.

At this time the system is ready for the routinely operations.

• Inventário AT 2020, valorização das existências, ferramentas para acertar stocks com contagem física
• Nota de Crédito e de Débito interna para acertos de Conta Corrente, sem efeitos no SAF-T
• Alerta do fim de prazo de submissão do ficheiro SAF-T
• Correção de problemas identificados nas versões anteriores do software
• Otimização para operação em tablete e smartphone com acesso a toda a funcionalidade num interface comum
• Informação sobre as correções e melhoramentos introduzidos em cada versão
• Novidades publicadas no blog.gestixsoftware.com

Versão 6.9.15 Setembro 2021

• Nova opção na introdução de faturas e outros documentos, Gravar e Continuar, para agilizar o processo de lançamento de vários documentos do mesmo tipo
• Nova opção para obter o Certificado de Licença Gestix a partir do menu Admin / Licenciamento
• Configuração de Texto padrão para o envio de mails com nova opção para preencher assinatura (Admin | Texto | SENDMAIL: com parágrafo 1 em branco, o parágrafo 2 funciona como assinatura)
• Otimização dos menus de Faturação, Encomendas e Central de Reparações para maior fluidez na operação
• Revisão da Listagem ABC de Clientes (acumulado)
• Nova Listagem ABC de Clientes por País (acumulado)
• Envio direto do ficheiro SAF-T por mail
• Corrigida falha que obrigava a introdução manual do Serial Number do Artigo ao fazer Guia de Remessa a partir de Encomendas importadas de aplicação externa (Amazon)
• Corrigida falha na exportação de dados para CSV que fazia sair o CSV em branco
• Atribuição de preço em Kit/Pacote na Gestão de Produção não considerava corretamente o respetivo Modelo de Produto
• Correção de falha que podia permitir erro no cálculo do desconto em documento de compra
• Correção de falha na procura nas descrições das Tarefas
  Correção de falha na duplicação de Modelo de Produto na Gestão de Produção

Versões anteriores

• Modelo de fatura “Portugal” com QR-Code
• QR-Code em todas as faturas e documentos fiscalmente relevantes, exceto no modelo “Europa”, para quem não pretenda incluir o QR-Code antes de 2022.
• Opção para tornar obrigatório o registo do mail do cliente em Admin | Definições