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:
- 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;
- O que representa o arquivo ("cliente", "cidade", "produto" e ...);
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
Tipo | Detalhe | Exemplo |
---|---|---|
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.
Índice | Coluna | Tipo | Tamanho | Observaçõ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.
Índice | Coluna | Tipo | Tamanho | Observaçõ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 | 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.
Índice | Coluna | Tipo | Tamanho | Observaçõ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.
Índice | Coluna | Tipo | Tamanho | Observaçõ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.
Índice | Coluna | Tipo | Tamanho | Observaçõ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" ):
Índice | Coluna | Tipo | Tamanho | Observaçõ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.
Índice | Coluna | Tipo | Tamanho | Observaçõ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.
Índice | Coluna | Tipo | Tamanho | Observaçõ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 Produto | Texto | 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" ):
Índice | Coluna | Tipo | Tamanho | Observaçõ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" ):
Índice | Coluna | Tipo | Tamanho | Observações |
---|---|---|---|---|
1 | Código da Forma de Pagamento | Código | 3 | |
2 | Nome | Texto | 30 |
Layout do arquivo de meta do vendedor ( "$metafixa.txt" ):
Índice | Coluna | Tipo | Tamanho | Observaçõ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" ):
Índice | Coluna | Tipo | Tamanho | Observaçõ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:
- Praticado, com o código "PRATI";
- Sugerido, com o código "SUGER".
Índice | Coluna | Tipo | Tamanho | Observaçõ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" ):
Índice | Coluna | Tipo | Tamanho | Observaçõ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.
Índice | Coluna | Tipo | Tamanho | Observaçõ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.
Índice | Coluna | Tipo | Tamanho | Observaçõ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.
Índice | Coluna | Tipo | Tamanho | Observaçõ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 |