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:

  1. 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";
  2. O que representa o arquivo ("pedido", "item" ou "cliente") e esses nomes devem ser em letras minúsculas;
  3. 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

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

ÍndiceColunaTipoTamanhoObservaçõesExemplo
 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
Exemplo do conteúdo do arquivo de pedido "00002pedido.081"

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.

ÍndiceColunaTipoTamanhoObservaçõesExemplo
 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
Exemplo do conteúdo do arquivo de item "00002item.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.

ÍndiceColunaTipoTamanhoObservaçõesExemplo
 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 E-mail 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
Exemplo do conteúdo do arquivo de cliente "00002cliente.081"

14||Nome do Cliente|Razão Social|Rua Principal, 31|Bairro Principal|00165|12345678|12121212|cliente@email.com|J|45151185000173|IE0001|IM002|Contato do Cliente||Observação 1|Observação 2|1198765432||19960321|||10000,00||||Rua Entrega, 11|Bairro Entrega|00165|12121212||||||||cliente@site.com||||081