Demonstrar como os arquivos de exportação Shop para Palm devem ser estruturados.

Layout dos arquivos de exportação Shop para Palm

O layout dos arquivos de exportação Shop para Palm define como os arquivos devem ser estruturalmente.

A exportação irá gerar os arquivos com as informações de vários cadastros que o aplicativo / site irá ler para atualizar seus próprios cadastros.

O módulo "Integração Shop X Palm" (AltShopProc_IntegracaoOrcamentoPDALogicalAFV.exe) é o responsável por gerar esses arquivos. Algumas opções desse módulo serão explicadas ao longo do artigo.

O módulo irá gerar um lote de arquivos para cada vendedor inserido na lista de vendedores, por isso o Código do Vendedor é um ID importante que está presente no nome dos arquivos gerados.

Cada linha do arquivo representa um registro de um cadastro do Shop.

Cada coluna da linha representa um campo de um registro de um cadastro do Shop. As colunas são separadas pelo caracter Pipe "|".

O nome do arquivo é montado com as seguintes informações:

  1. O Código do Vendedor que é representado por "$", deve ser do tipo Número e tem 5 caracteres, ou 9 se a opção "Exportar o código dos vendedores com 9 caracteres" estiver marcada;
  2. O que representa o arquivo ("cliente", "cidade", "produto" e ...);
  3. A extensão do arquivo texto que é ".txt".

    Exemplo:

    "$cliente.txt" será "12345cliente.txt".

O tamanho da coluna determina a quantidade máxima de caracteres mas permite ter menos caracteres exceto nas colunas do tipo Código.

Tipo da informação da coluna

TipoDetalheExemplo
 Código É o identificador que estabelece as relações dos registros entre os arquivos.
 Geralmente é do tipo "Texto".
 123ab
 Texto Qualquer texto com letras, números e símbolos. Ab12
 Número Número de valor inteiro e positivo, ou seja, sem casas decimais e sem símbolos. 123
 Valor Número com casas decimais onde o separador decimal é o ponto "." e não tem separador de milhares. 1234.56
 Data Data no formato "aaaammdd", ou seja, ano-mês-dia. "20011231" que é 2001/12/31
 Hora Hora no formato "hhmmss", ou seja, hora-minuto-segundo. "012132" que é 01:21:32
 Branco Não é utilizado pelo Shop mas consta no layout. Não preencher


Layout do arquivo do vendedor ( "$vendedor.txt" ):

Contem apenas o vendedor selecionado para a geração do lote de arquivos.

A opção "Exportar o código dos vendedores com 9 caracteres" define que a coluna Código do Vendedor terá 9 caracteres se estiver marcada ou 5 quando desmarcada.

ÍndiceColunaTipoTamanhoObservações
 1 Código do Vendedor Código / Número 5 ou 9 
 2 Nome Texto 20 
 3 Senha Branco  
 4 Alíquota de Desconto Máximo do Vendedor Valor  
 5 Nome da Empresa Texto 20 
 6 Telefone da Empresa Texto 15 


Layout do arquivo de clientes ( "$cliente.txt" ):

A opção "Exportar todo cadastro de clientes para cada funcionário selecionado" define que todo o cadastro de clientes será exportado para cada vendedor se estiver marcada. Se estiver desmarcada irá exportar apenas os clientes que tem o vendedor selecionado como vendedor padrão.

Se a opção "Exportar os totais dos títulos vencidos e títulos a vencer" estiver marcada irá exportar os valores de Total de Títulos Vencidos, Total de Títulos à Vencer e Saldo restante do Limite de Crédito.

ÍndiceColunaTipoTamanhoObservações
 1 Código do Cliente Código 15 
 2 Nome Fantasia Texto 50 
 3 Razão Social Texto 50 
 4 Logradouro e Número Texto 40 Separados por ", ".
 5 Bairro Texto 60 
 6 Código da Cidade Código 5 
 7 CEP Número 8 
 8 Fax Texto 20 
 9 E-mail Texto 60 
 10 Pessoa Física ou Jurídica Texto 1 "F" ou "J".
 11 CPF / CNPJ Número 14 
 12 Inscrição Estadual Texto 15 
 13 Inscrição Municipal Texto 30 
 14 Contato 1 Texto 20 
 15 Contato 2 Branco  
 16 Observação 1 Branco  
 17 Observação 2 Branco  
 18 Telefone 1 Texto 20 
 19 Telefone 2 Texto 20 
 20 Aniversário 1 Data  No formato "ddmm" sem o ano.
 21 Aniversário 2 Branco  
 22 V.I.P. Branco  
 23 Limite de Crédito Valor  
 24 Total de Títulos Vencidos Valor  
 25 Total de Títulos à Vencer Valor  
 26 Saldo restante do Limite de Crédito Valor  Resultado de Limite de Crédito menos os Totais de Títulos.
 27 Logradouro e Número do Endereço de Entrega Texto 40 Separados por ", ".
 28 Bairro do Endereço de Entrega Texto 60 
 29 Código da Cidade do Endereço de Entrega Código 5 
 30 CEP do Endereço de Entrega Número 8 
 31 Logradouro e Número do Endereço de Cobrança Branco  
 32 Bairro do Endereço de Cobrança Branco  
 33 Código da Cidade do Endereço de Cobrança Branco  
 34 CEP do Endereço de Cobrança Branco  
 35 Lista de Códigos de Características do Cliente Texto 200 É a lista com todas as características do cliente.
 36 Código da Atividade Branco  
 37 Caixa Postal Branco  
 38 Home Page Texto 30 
 39 Código da Tabela de Preços Padrão Branco  
 40 Código da Prazo de Pagamento Padrão Código 3 
 41 Código da Forma de Pagamento Padrão Código 3 


Layout do arquivo de últimas vendas ou pedidos ( "$compra.txt" ):

Esse arquivo lista as últimas 3 movimentações (vendas ou pedidos) de cada cliente do arquivo de clientes por Data de Emissão.

A opção "Exportar os 3 últimos orçamentos/vendas dos clientes que constam nos últimos ## meses" define se o arquivo será preenchido e quantos meses (##) a partir da data atual devem ser considerados.

ÍndiceColunaTipoTamanhoObservações
 1 Número do Movimento de Vendas ou Pedidos Código 8 
 2 Código do Cliente Código 15 
 3 Data de Emissão Data  
 4 Valor Total do Pedido Valor  Preenchido para Pedido e zerado para Venda.
 5 Valor Total da Venda Valor  Preenchido para Venda e zerado para Pedido.
 6 Status da Venda ou Pedido Texto 1 Para Venda será "T".
 Para Pedido será "N".
 7 Descrição do status da Venda ou Pedido Texto 50 Para Venda será "Totalmente Atendido".
 Para Pedido será "Não Atendido".


Layout do arquivo dos itens das últimas vendas ou pedidos ( "$compradetalhe.txt" ):

Esse arquivo lista todos os itens que pertencem aos movimentos contidos no arquivo de últimas vendas ou pedidos.

ÍndiceColunaTipoTamanhoObservações
 1 Número do Movimento de Vendas ou Pedidos Código 8 
 2 Código do Produto Código 15 
 3 Nome do Produto Texto 50 
 4 Quantidade Pedida Valor  
 5 Quantidade Faturada Valor  
 6 Alíquota de Desconto Valor  
 7 Preço Unitário Valor  
 8 Preço Total Valor  
 9 Preço Total Faturado Valor  
 10 Preço original da Tabela de Preço Valor  
 11 Data de Emissão Data  
 12 Código de Prazo de Pagamento Código 3 
 13 Status do Item Texto 1 
 14 Descrição do Status do Item Texto 50 
 15 Média das Últimas Compras Valor  
 16 Número do Pedido Número 6 
 17 Enviado Texto 1 Para Venda será "S".
 Para Pedido será "N".


Layout do arquivo de títulos à receber em aberto dos clientes ( "$titulo.txt" ):

Esse arquivo lista os títulos à receber em aberto dos clientes contidos no arquivo de clientes.

ÍndiceColunaTipoTamanhoObservações
 1 Código da Cliente Código 15 
 2 Número do Título Texto 6 
 3 Parcela Número 1 Fixo "1"
 4 Data de Emissão Data  
 5 Data de Vencimento Data  
 6 Valor Total do Título Valor  
 7 Valor Recebido Valor  
 8 Juros Valor  Fixo "0.00"


Layout do arquivo de cidades ( "$cidade.txt" ):

ÍndiceColunaTipoTamanhoObservações
 1 Código da Cidade Código 5 
 2 Nome Texto 30 
 3 UF Texto 2 
 4 Código da Cidade no IBGE Número 20 


Layout do arquivo de características do cliente ( "$categoria.txt" ):

Esse arquivo lista apenas as características e não as suas relações com os clientes.

ÍndiceColunaTipoTamanhoObservações
 1 Código da Característica Código 8 
 2 Nome Texto 30 


Layout do arquivo de produtos ( "$produto.txt" ):

Com a opção "Exportar o estoque atual dos produtos" marcada é enviado o estoque atual do produto.

Com a opção "Não exportar os produtos inativos" marcada apenas os produtos ativos são exportados.

A coluna "Preço Unitário Padrão" só é preenchida apenas se a opção "Tipo de preço para exportar" for "Praticado" ou "Sugerido". 

Essa opção afeta também os arquivos de tabela de preços e seus itens.

ÍndiceColunaTipoTamanhoObservações
 1 Código da Produto Código 15 
 2 Código do Grupo Código 3 
 3 Nome do Produto Texto 50 
 4 Sigla da Unidade Texto 10 
 5 Mínimo de Venda Valor  Fixo "0.00".
 6 Preço Unitário Padrão Valor  
 7 Código Principal do ProdutoTexto 18 
 8 Estoque Valor  
 9 Observações Texto 30 
 10 É um Produto de Grade Texto 1 Para Sim será "S" e Não será "N".
 11 Produto em Falta Texto 1 Para Sim será "S" e Não será "N".
 12 Produto Novo Texto 1 Para Sim será "S" e Não será "N".
 13 Produto tem Característica em Promoção Texto 1 Para Sim será "S" e Não será "N".
 14 Alíquota de Desconto Máximo do Produto Valor  
 15 Código da Família Código 15 Disponível a partir da versão Shop 6.1324.


Layout do arquivo de prazos de pagamento ( "$condicao.txt" ):

ÍndiceColunaTipoTamanhoObservações
 1 Código da Prazo de Pagamento Código 3 
 2 Nome Texto 30 
 3 Alíquota de Desconto ou Acréscimo Valor  Acréscimo é positivo.
 Desconto é negativo.


Layout do arquivo de formas de pagamento ( "$forma.txt" ):

ÍndiceColunaTipoTamanhoObservações
 1 Código da Forma de Pagamento Código 3 
 2 Nome Texto 30 


Layout do arquivo de meta do vendedor ( "$metafixa.txt" ):

ÍndiceColunaTipoTamanhoObservações
 1 Código da Meta Código 5 
 2 Nome Texto 20 
 3 Valor da Meta Valor  
 4 Valor Atingido Valor  
 5 Diferença Valor  
 6 Percentual Atingido Valor  
 7 Percentual de Descontos Valor  
 8 Total de Descontos Valor  


Layout do arquivo de grupos ( "$grupo.txt" ):

ÍndiceColunaTipoTamanhoObservações
 1 Código do Grupo Código 3 
 2 Nome Texto 30 


Layout do arquivo de tabela de preços ( "$tabela.txt" ):

É preenchida apenas se a opção "Tipo de preço para exportar" for "Ambos".

No Shop, existem apenas 2 tabelas de preços:

  1. Praticado, com o código "PRATI";
  2. Sugerido, com o código "SUGER".
ÍndiceColunaTipoTamanhoObservações
 1 Código da Tabela de Preços Código 5 
 2 Nome Texto 30 


Layout do arquivo dos itens das tabelas de preços ( "$produtotabela.txt" ):

ÍndiceColunaTipoTamanhoObservações
 1 Código da Tabela de Preços Código 5 
 2 Código do Produto Código 15 
 3 Preço do Produto Valor  


Layout do arquivo de características do produto ( "$caracteristica.txt" ):

Esse arquivo lista apenas as características e não as suas relações com os produtos.

O arquivo será gerado apenas se a opção "Exportar arquivos adicionais" estiver marcada.

ÍndiceColunaTipoTamanhoObservações
 1 Código da Característica Código 15 
 2 Nome Texto 30 


Layout do arquivo de famílias ( "$familia.txt" ):

Esse arquivo lista apenas as características e não as suas relações com os clientes.

O arquivo será gerado apenas se a opção "Exportar arquivos adicionais" estiver marcada. 

A partir da versão Shop 6.1324, a geração desse arquivo não irá mais observar essa opção.

ÍndiceColunaTipoTamanhoObservações
 1 Código da Família Código 15 
 2 Nome Texto 30 


Layout do arquivo de extras do produto ( "$produtoextra.txt" ):

Esse arquivo complementa as informações do arquivo de produtos.

O arquivo será gerado apenas se a opção "Exportar arquivos adicionais" estiver marcada.

ÍndiceColunaTipoTamanhoObservações
 1 Código do Produto Código 15 
 2 Código da Família Código 15 
 3 Lista de Códigos de Características do Produto Texto 200 É a lista com todas as características do produto.
 4 Descrição Complementar do Produto Texto 200