Layout dos arquivos de exportação Shop para Palm

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

Layout dos arquivos de exportação Shop para Palm
Tipo da informação da coluna
Layout do arquivo do vendedor ( "$vendedor.txt" ):
Layout do arquivo de clientes ( "$cliente.txt" ):
Layout do arquivo de últimas vendas ou pedidos ( "$compra.txt" ):
Layout do arquivo dos itens das últimas vendas ou pedidos ( "$compradetalhe.txt" ):
Layout do arquivo de títulos à receber em aberto dos clientes ( "$titulo.txt" ):
Layout do arquivo de cidades ( "$cidade.txt" ):
Layout do arquivo de características do cliente ( "$categoria.txt" ):
Layout do arquivo de produtos ( "$produto.txt" ):
Layout do arquivo de prazos de pagamento ( "$condicao.txt" ):
Layout do arquivo de formas de pagamento ( "$forma.txt" ):
Layout do arquivo de meta do vendedor ( "$metafixa.txt" ):
Layout do arquivo de grupos ( "$grupo.txt" ):
Layout do arquivo de tabela de preços ( "$tabela.txt" ):
Layout do arquivo dos itens das tabelas de preços ( "$produtotabela.txt" ):
Layout do arquivo de características do produto ( "$caracteristica.txt" ):
Layout do arquivo de famílias ( "$familia.txt" ):
Layout do arquivo de extras do produto ( "$produtoextra.txt" ):

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

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