Conheça as informações de layout dos arquivos de importação Palm para o Shop.
O layout dos arquivos de importação Palm para Shop define como os arquivos devem ser estruturalmente.
A importação irá criar um pedido / orçamento segundo as informações contidas nos arquivos.
Cada linha do arquivo representa um registro no Shop.
Cada coluna da linha representa um campo no Shop. As colunas são separadas pelo carácter 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 ou 9 caracteres segundo configuração. Exemplo "00002";
- O que representa o arquivo ("pedido", "item" ou "cliente") e esses nomes devem ser em letras minúsculas;
A extensão do arquivo é o Código de Fechamento, que é um sequencial próprio de 001 à 999 gerado na criação do pedido e representado por ".*". Exemplo "081".
Exemplo:"$pedido.*" será "00002pedido.081".
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 é a vírgula "," 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 |
Fechamento | É um sequencial renovável de 1 à 999. É igual ao Código de Fechamento da extensão do arquivo. | "001" à "999" |
Branco | Não é utilizado pelo Shop, mas consta no layout. | Não preencher |
Layout do arquivo de pedidos ( "$pedido.*" ):
A coluna Código do Pedido é um código auxiliar, o Número do Pedido definitivo será gerado pelo Shop na importação.
O vendedor do pedido será aquele do Código do Vendedor $ no nome do arquivo.
O cliente é localizado pelo seu CNPJ / CPF.
O total do pedido é dado pelo somatório dos valores totais líquido dos itens.
Índice | Coluna | Tipo | Tamanho | Observações | Exemplo |
---|---|---|---|---|---|
1 | Código do Pedido | Código / Número | 5 | 30 | |
2 | CNPJ / CPF do Cliente | Texto | 14 | 45151185000173 | |
3 | Data | Data | 20170121 | ||
4 | Hora | Hora | 103241 | ||
5 | Tipo do Pedido | Branco | |||
6 | Código da Prazo do Pagamento | Código | 3 | 006 | |
7 | Código da Forma de Pagamento | Código | 3 | 004 | |
8 | Código da Tabela de Preço | Branco | |||
9 | Observação | Texto | 50 | Observação | |
10 | Quantidade de Itens | Branco | |||
11 | Total dos Itens | Branco | |||
12 | Alíquota de Desconto / Acréscimo | Valor | Valor Positivo é Desconto. Valor Negativo é Acréscimo. | 5,00 | |
13 | Total do Pedido | Branco | |||
14 | Origem | Texto | 1 | "E" para E-commerce. Outro valor será Palm. | E |
15 | Urgente | Branco | |||
16 | Prazo 1 | Branco | |||
17 | Prazo 2 | Branco | |||
18 | Prazo 3 | Branco | |||
19 | Prazo 4 | Branco | |||
20 | Prazo 5 | Branco | |||
21 | Código da Visita | Branco | |||
22 | Fechamento | Fechamento | 081 | ||
23 | Valor do Frete | Valor | 21,43 | ||
24 | Total de Pedido com Frete | Branco | |||
25 | Data de Entrega | Data | Se estiver em branco, irá ser preenchida com a data atual mais a quantidade de dias padrão de entrega. | 20170207 |
30|45151185000173|20170121|103241||006|004||Observação|||5,00||E||||||||081|21,43||20170207
Layout do arquivo de itens do pedido ( "$item.*" ):
Deve ter o mesmo Código de Fechamento do arquivo do pedido.
Índice | Coluna | Tipo | Tamanho | Observações | Exemplo |
---|---|---|---|---|---|
1 | Código do Item | Código / Número | 5 | 42 | |
2 | Código do Pedido | Código / Número | 5 | 30 | |
3 | Código do Produto | Código | 15 | 000158 | |
4 | Tipo do Item | Branco | |||
5 | Quantidade | Valor | 3,00 | ||
6 | Preço Unitário | Valor | 100,00 | ||
7 | Diferença de Preços | Branco | |||
8 | Alíquota de Desconto | Branco | |||
9 | Preço Unitário com Desconto | Branco | |||
10 | Valor Total Líquido do Item | Valor | 300,00 | ||
11 | Status | Branco | |||
12 | Fechamento | Fechamento | 081 |
42|30|000158||3,00|100,00||||300,00||081
43|30|000096||3,00|100,00||||270,00||081
Layout do arquivo de clientes editados ( "$cliente.*" ):
Este arquivo só deve ser preenchido quando o cadastro de um cliente for alterado ou inserido no aplicativo / site que gera o pedido.
Quando ocorrer todo o registro desse cliente deve ser preenchido e ao ser importado irá alterar / inserir o cadastro desse cliente no Shop.
Índice | Coluna | Tipo | Tamanho | Observações | Exemplo |
---|---|---|---|---|---|
1 | Sequencial | Número | 5 | 14 | |
2 | Código do Cliente | Branco | |||
3 | Nome Fantasia | Texto | 20 | Nome do Cliente | |
4 | Razão Social | Texto | 40 | É obrigatório. | Razão Social |
5 | Logradouro e Número | Texto | 40 | Separados por ", ". | Rua Principal, 31 |
6 | Bairro | Texto | 20 | Bairro Principal | |
7 | Código da Cidade | Código | 5 | 00165 | |
8 | CEP | Número | 8 | 12345678 | |
9 | Fax | Texto | 15 | 12121212 | |
10 | Texto | 30 | cliente@email.com | ||
11 | Pessoa Física ou Jurídica | Texto | 1 | "F" ou "J". | J |
12 | CPF / CNPJ | Número | 14 | 45151185000173 | |
13 | Inscrição Estadual | Texto | 20 | IE0001 | |
14 | Inscrição Municipal | Texto | 18 | IM0002 | |
15 | Contato 1 | Texto | 15 | Contado do Cliente | |
16 | Contato 2 | Branco | |||
17 | Observação 1 | Texto | 15 | Observação 1 | |
18 | Observação 2 | Texto | 15 | Observação 2 | |
19 | Telefone 1 | Texto | 15 | 1198765432 | |
20 | Telefone 2 | Branco | |||
21 | Aniversário 1 | Data | 19960321 | ||
22 | Aniversário 2 | Branco | |||
23 | V.I.P. | Branco | |||
24 | Limite de Crédito | Valor | 10000,00 | ||
25 | Total de Títulos Vencidos | Branco | |||
26 | Total de Títulos à Vencer | Branco | |||
27 | Saldo | Branco | |||
28 | Logradouro e Número do Endereço de Entrega | Texto | 40 | Separados por ", ". | Rua Entrega, 11 |
29 | Bairro do Endereço de Entrega | Texto | 20 | Bairro Entrega | |
30 | Código da Cidade do Endereço de Entrega | Código | 5 | 00165 | |
31 | CEP do Endereço de Entrega | Número | 8 | 12121212 | |
32 | Logradouro e Número do Endereço de Cobrança | Branco | |||
33 | Bairro do Endereço de Cobrança | Branco | |||
34 | Código da Cidade do Endereço de Cobrança | Branco | |||
35 | CEP do Endereço de Cobrança | Branco | |||
36 | Código da Categoria | Branco | |||
37 | Código da Atividade | Branco | |||
38 | Caixa Postal | Branco | |||
39 | Home Page | Texto | 30 | cliente@site.com | |
40 | Código da Tabela de Preços Padrão | Branco | |||
41 | Código da Condição de Pagamento Padrão | Branco | |||
42 | Código da Forma de Pagamento Padrão | Branco | |||
43 | Fechamento | Fechamento | 081 |