# Utilização do recursos Exportar no ERPx/ERP
Nossas soluções disponibilizam recursos nativos que podem otimizar entregas relacionadas a exportação de dados via arquivos sem a necessidade de customizações ou desenvolvimentos.
**O Recurso está disponivel em Configuração > Exportar** conforme ilustrado na imagem abaixo:
[](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/ZrIfDfUbOYWapaeD-image.png)
As respectivas telas seguem um padrão ao acessar: No cabeçalho disponibilizamos os filtros necessários para listar registros na grade, e no rodapé você informa o layout a ser utilizado, onde finalmente clicamos no botão Exportar para gerar os registros.
[](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/3m3xGUvFjCprG8OM-image.png)
**E como configuramos os layouts de exportação?** **Está disponivel em Configuração > Layout de arquivos** conforme ilustrado na imagem abaixo, pois este recurso **não** é utilizado somente para operações de remessa e retorno bancário.
[](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/aWokh0MTPlasMmYP-image.png)
Na tela da consulta de layouts de arquivos, você pode cadastrar, editar ou inativar um layout, e na mesma tela você clica com o direito e tem opções para exportação ou importação dos layouts, bem como a configuração do mesmo:
[](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/M4bmihRN7O9SA99Z-image.png)
Qual a diferença entre Exportar/Importar PEX das demais? O "Exportar" e "Importar" é referente ao Registro/Configuração do layout em sua totalidade, já o "Exporta PEX...' e "Importar PEX ..." só exporta ou importa os dados das funções que tem configuradas dentro do layout. Como sugestão para evitar qualquer problema, Utilize o Exportar e/ou Importar.
Abaixo detalhamos como funciona a configuração do Layout de arquivos quando cadastra/edita:
[](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/EHOa2pgnOsFJMSGv-image.png)
- **Aba Dados principais:**
- Descrição: Nome do arquivo do layout
- Tipo de arquivo: São os repositórios de dados, ou seja onde o sistema vai buscar informações para estruturação na aba 'Configuração do layout'
[](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/5gf16dm9kCrNJUHH-image.png)
- - Diretório: Local onde será salvo o arquivo.
- Nome Arquivo: Nome do arquivo a ser gerado! Existem alguns parametros(Mascara) que podemos utilizar na estrutura do nome do arquivo para formatar data, hora e/ou alguma outra informação para importação no sistema do terceiro.
- | Mascara | O que vira |
|`DD` | dia atual com 2 dígitos |
|`MM` | mês atual com 2 dígitos |
|`YYYY` | ano atual com 4 dígitos |
|`YY` | ano atual com 2 dígitos |
|`HH` | hora atual |
|`NN` | minuto atual |
|`#` | código de mês Sicredi: jan-set =`1`..`9`, out =`O`, nov =`N`, dez =`D` |
|`@`,`@@`,`@@@`... | sequencial da remessa, com zeros à esquerda conforme a quantidade de`@` |
|`SSS` | sequencial diário, quando “Controla sequência dia” está ativo |
|`SS` | sequencial diário com 2 dígitos, mas só no fluxo de remessa de pagamento |
|`CCCC` ou`CCC` | convênio, só no fluxo de remessa de pagamento |
- Exemplo: se o nome for`REMDDMMYY@@.TXT`, no dia 08/07/2026 e sequência`5`, o arquivo fica`REM08072605.TXT`.
Sobre o exemplo`@@`: ele vira o sequencial automático com 2 dígitos. Se a sequência atual for`1`, vira`01`; se for`12`, vira`12`. Depois de gerar o arquivo é incrementado quando “Auto inc. sequência” está marcado.
- Prefixo: Um nome fixo 'antes' do nome Arquivo acima.
- Separador: Campo que vai 'separar' os dados no arquivo, se informar "|" por exemplo, entre um campo e outro vai ter este separador.
- Sequencia: O`sequenciaarq` é o **sequencial do arquivo/remessa** gravado no cadastro do layout. Ele serve principalmente como base para numerar remessas e, em alguns fluxos, alimentar o`@` do campo`nomearq`.
Exemplo: se`sequenciaarq = 15` e`nomearq = REM@@@.TXT`, o nome pode sair como`REM015.TXT`.
Nos borderôs/remessas financeiras, ele tem um papel extra: o sistema usa`sequenciaarq` como número-base da remessa, incrementa, grava no borderô e também atualiza o cadastro do layout para a próxima geração. Há ainda uma exceção: se a conta financeira estiver configurada com “sequencial único”, o número vem da conta financeira, não do layout.
Um detalhe importante: se a opção**“Incrementa sequência do nome do arquivo auto?”** (`autoincsequencia`) estiver marcada, o`@@` não usa diretamente`sequenciaarq`; ele usa o contador salvo/consultado e depois incrementa esse contador no INI.
- Quebra linha: Utilizado para configurar no layout quando 'quebra linha', a opção #13 volta o cursor para o começo da linha, e o #10 avança para a próxima linha, o padrão é #13#10 para quebrar linha e voltar para o primeiro caracter.
- Incrementa sequencial do nome do arquivo: Utilizado normalmente para layout de remessa bancária,e esta descrito no ultimo paragrafo do tópico sequencial acima.
- Controlar sequencial de arquivo por dia: Também utilizado para controle de sequencial de remessa bancária, neste caso diario(Zera contador sequencial a cada dia) e tem um parametro abaixo relacionado ao Sicredi.
- **Aba configuração:** Nesta aba você configura a estrutura do seu arquivo conforme a quantidade de 'linhas' esperadas, seja para exportação quanto importação(no caso retorno de cobrança e pagamentos).
- Cabeçalho, Cabeçalho2: Carrega os dados configurados no Tipo arquivo da aba 'Dados principais'.
- Detalhe, SubDetalhe1, SubDetalhe2: Você configura a fonte de dados 'por recurso.
- Rodapé 2, Rodapé: Carrega os dados configurados no Tipo arquivo da aba 'Dados principais'.
- Quantidade de linhas do retorno: Utilizado SOMENTE no retorno bancário!
[](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/y5XlAHTvMoUsQf1N-image.png)
E ao clicar com botão direito sobre o layout - Configurar Layout, o sistema abre a tela de configuração baseada nos parametros definidos inicialmente quando você cadastrou:
[](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/tcorY0YSLaW1AWHx-image.png)
- O Tipo vai abrir as opções de configuração do layout conforme aba configuração quando realizou o cadastro.
- Botão Filtro: É um recurso que você pode customizar para filtrar alguma informação ao utilizar o layout na exportação.
- Se a função retornar:
- True: a linha/registro é gerada normalmente.
- False: o registro atual é cancelado e aquela linha não entra no arquivo.
- Então ele serve para regras do tipo: “só gerar detalhe se tal campo tiver valor”, “não gerar rodapé em certa condição”, “pular registros de determinado cliente/item/título”, etc.
- Na grade abaixo do tipo, existem os campos que você selecionar e utilizar os botões no rodapé para incluir na grade a direita onde serão dispostos no arquivo.
- Botão **>** é para inserir o registro na grade a direita
- Botão **S** é para substituir um campo inserido na grade
- Botão **F** é para inserir um texto Fixo
- Botão **A** é um contador de auto incremento
- Ao inserir o item na grade a direita, você pode 'digitar qualquer texto' na coluna campo todavia se não for um texto 'Fixo' ou 'Func' o sistema automaticamente vai carregar o respectivo dado que você selecionou na grade a esquerda
- Tamanho: É o tamanho do campo que automaticamente preencher as colunas Ini e Fim.
- Mascara: É a mascara utilizada no campo, normalmente para preencher o restante do campo (ex: Preencher com 0)
- Valor fixo: Quando você habilitar a coluna Fixo
- Desp: O campo desprezar da grid (Desp.) define qual lado do valor será descartado quando o conteúdo ficar maior que o tamanho (tamanho) configurado para aquele item, exemplo com tamanho = 5 e valor 123456789:
- desprezar = E -> 56789 desprezar = D -> 12345
- Fixo: Ao habilitar o sistema respeita a coluna valor fixo descrito anteriormente.
- Soma: Faz a soma do respectivo campo.
- Conta: Faz a contagemd o respectivo campo.
- Func: Ao clicar o sistema abre a função PEX para você customizar o que desejar. (Necessário conhecimento basico em programação PEX).
- - Importante! Se você acessar a função e não digitar nada, ao clicar em OK o sistema não marca como habilitado. Então quando você 'desmarca' a função que tinha um código e depois vai ali, clica (que abre a tela) e só clica em OK, vais observar que a função não fica 'habilitada', para isso terás que mexer em algo dentro da função, nem que seja para colocar um espaço ai o sistema entende que houve manipulação na tela e habilita a função.
- Na função PEX quando você manipula e/ou faz alguma ação sobre o 'asValor' (Ex: Result := asValor;), o sistema automaticamente já faz algumas tratativas e formatações do campo, por isso algumas funções abaixo estamos buscando o campo na sua forma original (ex: adDataSet.GetStr('iditem'));
- Abaixo detalhamos algumas funções e suas respectivas caracteristicas para usar conforme necessário, lembrando que ao abrir a função no cabecalho da tela tem três botões e ao clicar no ultimo botão tem diversos recursos com modelos de códigos pré definidos, o que ajuda e otimizar seu trabalho:[](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/PJkjQNLjsRTV2Nw1-image.png)
- Alinhar a esquerda um determinado campo, tamanho 10 e preeenhendo com '.' os campos vazios (Você cola o código abaixo entre o begin e o End; da função):
- Result := TSTR.AlinhaEsq(adDataSet.GetStr('iditem'), 10, '.');
- Tira acentos e formata texto em MAIUSCULO (Você cola o código abaixo entre o begin e o End; da função):
- Result := TSTR.TiraAcentos(UpperCase(asValor));
- Durante a hora do aprender, tentamos alinhar a direita o conteudo acima e não foi possivel, isso era porque estavamos utilizando 'asValor', abaixo um exemplo buscando o campo original e fazendo o devido tratamento (Primeiro alinhamos a esquerda e depois realizamos os respectivos tratamentos):
- Result := TSTR.AlinhaEsq(adDataSet.GetStr('descricao'), 80, '.');
- Result := TSTR.TiraAcentos(UpperCase(Result));
- Verificar no cadastro da UN vinculada ao item está habilitado para 'Fracionar na venda', caso sim seta 'P' ( Peso) senao 'U'(Unidade), esta função é normalmente utilizada em exportação de itens para balança. (Você cola o código abaixo na função depois de retirar o begin e o End; da função pois eles já estão dentro do código):
- - var
- loCDS: TlibCDS;
- begin
- loCDS := nil;
- try
- loCDS := of\_CriaCDSporSQL(Format('select fracionarvenda from unidade where idunidade = (select idunidadebasica from item where iditem = %0:d)', \[adDataSet.GetInt(\['IDITEM'\])\]));
- if loCDS.GetBol('fracionarvenda') then
- Result := 'P'
- else
- Result := 'U';
- finally
- loCDS.Free;
- end;
- end;
Pronto! Agora você pode acessar a respectiva tela e informar o layout de exportação para gerar o arquivo conforme filtros utilizados:
[](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/Giu9RXqV5SgsYZtQ-image.png)
**Agora vamos praticar:**
Nosso cliente adquiriu uma balança Todelo e precisa exportar os itens que tiveram alteração de preços no periodo, o nome do arquivo é TOLEDO.TXT e deve ser salva na pasta C:\\temp onde o sistema da balança vai buscar este arquivo.
O layout deve ser da seguinte forma:
Codigo do item - Tamanho 10 - Alinhado a Esquerda - Preenche com Zeros
Descrição - Tamanho 80 - Alinhado a Esquerda
Preço de venda - tamanho 12 - Alinhado a direita - Preenche com Zeros