Glossário

  • SKU: O termo Stock Keeping Unit (SKU), em português Unidade de Manutenção de Estoque está ligado à logística de armazém e designa os diferentes itens do estoque, estando normalmente associado a um código identificador. Um posto de gasolina, por exemplo, pode trabalhar com quatro SKUs (gasolina sem chumbo, com chumbo, aditivada e diesel) e um hipermercado pode trabalhar com 60 mil SKUs, pois qualquer diferença na mercadoria (tamanho, cor, sabor, etc), mesmo sendo de uma mesma marca, representa um SKU diferente.
  • Produto Pai: Produto principal que aparece no site (como uma vitrine), porém não contêm estoque, já que o produto pai nunca é vendido, são vendidos os seus filhos.
  • Ele obrigatoriamente deve conter variações (de tamanho, cor, etc), estas variações são seus filhos. Por exemplo, uma camiseta seria o produto principal (produto pai). A camiseta P, a camiseta M e a camiseta G, os produtos filhos. O estoque do produto pai exibido no site corresponde a soma de todos os produtos filhos deste item.
  • Produto Filho: Variação de um produto que está vinculada a um produto pai. Por exemplo, os tamanhos de um calçado (37 ,38, 39, etc), são todos produtos filhos.
    • Outro exemplo de produto pai e filho:
      • Camiseta Feminina – produto pai
      • Camiseta Feminina P – produto filho do pai Camiseta Feminina
      • Camiseta Feminina M – produto filho do pai Camiseta Feminina
      • Camiseta Feminina G – produto filho do pai Camiseta Feminina
      • Camiseta Feminina GG – produto filho do pai Camiseta Feminina
  • Market Place: Loja virtual onde se vendem bens e serviços. Este modelo de negócios é conhecido por conectar diretamente clientes e fornecedor sem a participação de intermediários. Exemplo: Mercado Livre.
  • Nível de Produto: Ordem de disposição de um produto no site, as categorias de um site. Por exemplo, um telefone celular está dentro da categoria Telefones.
  • Plataforma de e-commerce: Sistema responsável pelo gerenciamento e visualização da loja virtual na internet.
  • API: Aplicativo de Integração entre ERP e plataformas, é o integrador e comunicador de dados.

INTRODUÇÃO

Destinado a clientes que possuem lojas virtuais, o produto ONECM (e-commerce) possibilita um controle fácil e eficiente da loja virtual. Com ele, há a sincronização dos cadastros de produtos, categorias, características, vendas, estoque, etc.

Este manual destina-se a apresentar os conceitos da integração e-commerce no sistema Onclick.

Atualmente integramos com as seguintes plataformas de e-commerce:

  • TRAY
  • BIZCOMMERCE
  • BIS2BIS
  • RAKUTEN/IKEDA
  • VTEX
  • FBITS

Possuímos também nossa própria plataforma (E-COMMERCE).

Como Configurar:

Em  Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Alterar >> Tela [0444] CONFIGURAÇÕES DO SISTEMA >> 17.Módulos Habilitados

Para habilitar a integração WEB no ERP, a opção 24. ONCLICK PEDIDOS/PEDIDOS INTERNET deve estar marcada, assim as Telas pertinentes à integração e-commerce serão habilitadas.

Configurações Lojas WEB

Em Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB.

Esse cadastro é responsável pelos dados de configuração de todas as lojas WEB integradas.

Agrupamento 1 Integração: Selecione com qual parceiro e-commerce a loja será hospedada. De acordo com a escolha, uma nova aba com configurações específicas de cada integração será apresentada.

1.20 Habilitar Integração Linx: Campo responsável por criar triggers e views para leituras do integrador Linx.

1.21 Habilitar Monitoramento Online: Ao marcar essa opção, serão criadas tabelas de produtos, preços e estoque para integração. O integrador passará a ler os registros dessas tabelas e importar os produtos para o ERP.

2.1 URL Loja: Utilizado para integrações que necessitam informar uma URL específica por loja. Este campo é utilizado nas seguintes integrações: 1.2 Tray, 1.3 E-commerce, 1.5 Ikeda, 1.6 VTEX, 1.7 Chleba e 1.8 Rakuten.

2.2 Nome Loja: Responsável pela identificação da loja dentro do ERP. Campo obrigatório em todas integrações.

2.3 ID Loja: Utilizado para acesso ao parceiro, onde cada loja possui um código. Este campo é utilizado nas seguintes integrações: 1.1 Fast, 1.2 Tray, 1.7 Chleba e 1.3 E-commerce.

2.4 Login: Utilizado para acesso ao parceiro, onde cada loja possui um login de acesso ao backoffice da plataforma. Este campo é utilizado nas seguintes integrações: 1.1 Fast, 1.2 Tray, 1.6 Vtex, 1.7 Chleba (Opcional) e 1.3 E-commerce (Opcional).

2.5 Senha: Utilizado para acesso ao parceiro, onde cada loja possui uma senha de acesso ao backoffice da plataforma. Este campo é utilizado nas seguintes integrações: 1.1 Fast, 1.2 Tray, 1.6 Vtex, 1.7 Chleba (Opcional) e 1.3 E-commerce (Opcional).

2.6 Endereço de Faturamento Igual ao Endereço de Entrega: Com esta opção marcada, ao processar o pedido, os dados de Faturamento no Cadastro do Cliente serão exatamente iguais aos dados do endereço de Entrega.

2.8 Bloquear Pedidos com Itens Sem Lote Disponível: Ao processar pedidos que contenham itens que trabalham com lote e o mesmo não possuir estoque disponível no lote, o pedido ficará bloqueado no ERP.

2.9 Enviar Estoque de Segurança para Loja Web: Com essa opção marcada, será somado o estoque de segurança do produto ao estoque disponível. Este campo é utilizado nas seguintes integrações: 1.2 Tray, 1.3 E-commerce, 1.5 Ikeda, 1.6 Vtex, 1.7 Chleba.

3.1 Enviar Para o Site: Ao marcar uma das opções de código, este será enviado ao site no momento da exportação do produto. Este código será o código de referência do item no site.

4.1 Almoxarifado Padrão: Ao importar o pedido pelo integrador, o mesmo irá dar baixa no almoxarifado informado nesse campo.

4.2 Almoxarifados para estoque: Este campo possibilita no momento de enviar o produto, somar o estoque de almoxarifados distintos e enviar o total deles.

5.1 Atendimento Site: Responsável pela identificação das lojas WEB dentro do ERP. Campo obrigatório para todas integrações.

6. Tabela de Preço: Ao selecionar uma tabela de preço específica, no momento de enviar produto e preço no integrador, será exportado o valor correspondente a essa tabela.

7.1 Habilitar Integração SISFRETE para Pedidos Internet: Ao marcar esta opção, serão desbloqueados campos e botões referentes à integração SISFRETE no ERP.

7.2 Token: Token informado pela SISFRETE para realizar cotação de preços dos pedidos específicos da WEB.

8. Forma de Desconto no Pedido: Permite a distribuição de desconto nos pedidos WEB, inserindo o desconto nos itens ou no total do pedido.

Aba Parâmetros Comuns de Integração

Essa aba foi criada para utilização de todas as integrações, mas atualmente apenas o integrador TRAY a considera. Para campos referentes ao agendamento automático, cada integração possui a funcionalidade em sua respectiva aba.

Dados Gerais

1.1 Minutos para Importar Pedido: Minutos para disparo do agendamento automático no integrador para importação de pedidos.

1.2 Minutos para Atualizar Preço e Estoque: Minutos para disparo do agendamento automático no integrador para atualização do preço e do estoque.

1.3 Minutos para Atualizar Status do Site: Minutos para disparo do agendamento automático no integrador para atualizar o status do pedido.

1.4 Minutos para Exportar Lista de Desejo: Minutos para disparo do agendamento automático no integrador para atualizar a lista de presente. Esta opção está disponível somente para a integração TRAY.

1.5 Minutos para Importar Lista de Desejo: Minutos para disparo do agendamento automático no integrador para importar lista de presente. Esta opção está disponível somente para a integração TRAY.

1.6 Minutos para Importar Clientes sem Pedido: Minutos para disparo do agendamento automático no integrador para importar clientes sem pedidos. Esta opção está disponível somente para a integração TRAY.

1.7 Dias p/ Mostrar Pedidos na Importa Internet: Quantidade de dias retroativos a partir do dia atual, para carregar pedidos pendentes a serem processados na tela PEDIDO WEB. Esta opção está disponível somente para a integração TRAY.

1.8 Minutos para Processamento Automático na Importa Internet: Minutos para disparo do agendamento automático para processar os pedidos importados que se encontram disponíveis na tela de PEDIDOS WEB. Esta opção está disponível somente para a integração TRAY.

1.9 Mostrar e Processar Pedidos Apenas da Empresa Logada: Ao marcar essa opção, os pedidos apresentados na tela de PEDIDOS WEB serão os da empresa logada no ERP.

Módulos Habilitados

São campos criados para utilização do integrador E-commerce. A seguir serão apresentadas as abas específicas de cada integração:

Aba FAST

Essa aba foi criada para complementar informações de loja com o parceiro FAST Commerce. A aba será habilitada somente se o campo 1.1 FAST do parâmetro 1. Integração da aba Parâmetros por Integração estiver habilitado.

3

1.1 Trabalha com Sub Produtos (Produto / SKU): Opção responsável pela forma de envio dos produtos no integrador FAST. Ao marca-lo, é possível enviar produtos e SKUS. Opção disponível nas integrações FAST e E-commerce.

1.6 Minutos Para Verificar E-mail: Minutos para disparo do agendamento automático no integrador para verificar pedidos realizados através do e-mail configurado.

1.7 Servidor E-mail: Campo para configurar o servidor de e-mail.

1.8 Conta de E-mail: Campo para configurar conta de e-mail.

1.9 Senha de E-mail: Campo para configurar senha de e-mail.

1.10 Porta: Campo para configurar porta de e-mail.

1.11 Servidor Requer uma Conexão Segura: Configuração do integrador para link de integração segura.

1.12 Atualizar Status ao Receber um Pedido Existente: Ao marcar essa opção, o integrador passa a atualizar algumas informações de um pedido já processado no ERP caso o pedido seja importado novamente (se o tipo do pedido permitir). Essa opção está disponível para as integrações: 1.1 Fast, 1.3 E-commerce e 1.5 Ikeda.

1.13 Trabalha com Níveis de Categorias de Produtos: Habilita a árvore de níveis no arquivo XML para cadastro e vinculação ao produto no ERP.

1.14 Ao Importar Pedidos Considerar o Código: Campo que define como será pesquisado o produto ao importar os itens do pedido, pelo campo código internet ou campo de referência (Código de Barras, Código Fabricante ou Código Auxiliar).

1.15 Utiliza Envio de Produto por Bloco: Com a opção desmarcada, o aplicativo irá montar um único arquivo XML para cada processo e nele todos os registros de envio. Caso marcado, serão enviados vários arquivos XML (quantidade definida no campo abaixo) com os registros de envio.

1.16 Quantidade de XML Enviado por Bloco: Quantidade de registros que irão compor cada arquivo XML gerado pelo integrador.

Campos Descritores

2.1 Trabalha com Multivalorados (multivalor): Opção que libera a utilização de mais de um valor dos descritores no envio de produtos. Também é alterado o layout e cadastro de produtos no ERP.

Marca: Define em qual campo no XML de produtos será enviado a marca.

Grupo: Define em qual campo no XML de produtos será enviado o grupo.

Subgrupo: Define em qual campo no XML de produtos será enviado o subgrupo.

Categoria: Define em qual campo no XML de produtos será enviado a categoria.

Grupo2: Define em qual campo no XML de produtos será enviado o grupo 2.

Grupo3: Define em qual campo no XML de produtos será enviado o grupo 3.

Grupo4: Define em qual campo no XML de produtos será enviado a marca. Apenas se trabalhar com multivalorados.

Tabela de Preço B2B: Define qual tabela de preço será enviada no campo referente a “Business to Business” no XML de produto.

Aba TRAY

Essa aba foi criada para complementar informações de loja com o parceiro Tray Commerce. A aba será habilitada somente se a opção 1.2 TRAY do campo 1.Integração da aba Parâmetros por Integração estiver habilitada.

4

1.1 Máximo de Níveis Exibidos na Tela de Produtos: Define a quantidade máxima de níveis no cadastro de produto para visualização.

1.2 Tipo do Peso Para o Site: Define se o peso que será enviado com o produto será o líquido ou bruto.

1.3 Imprime na Nota Fiscal as Observações do Cliente: Define se na Nota Fiscal serão apresentadas as observações preenchidas no site pelo cliente.

1.4 Utiliza Editor HTML do Site como Principal: Define se a utilização do editor HTML será o da TRAY, neste caso, o integrador não envia o texto cadastrado no ERP (cadastro do produto >> aba Integração Web).

1.5 Fórmula Peso Cúbico para o Site: Cálculo definido pelos correios para envio de mercadorias. (A x L x C) / x (valor que a plataforma informa, influencia no valor do frete).

1.6 Filial Padrão para Lista de Desejo: Ao importar lista de desejos da TRAY, uma filial padrão pode ser definida de acordo com essa configuração.

1.7 Vendedor Padrão para Lista de Desejo: Ao importar lista de desejos da TRAY, um vendedor padrão pode ser definido de acordo com essa configuração.

1.8 Permitir Alteração no Vendedor da Lista de Desejo: No cadastro de Lista de Presente, é possível ou não alterar o vendedor.

1.9 Tipo de Medida para Altura/Largura/Comprimento: Tipo de metragem informada no cadastro de produto (m ou cm). Assim será realizada a conversão automaticamente para o padrão TRAY.

1.10 Utiliza TrayCheckout: Define se a loja irá trabalhar com TrayCheckout.

Cópia entre loja principal e secundária

2.1 Tornar Essa Loja Principal: Ao marcar essa opção, essa loja se torna principal e possibilita a cópia de lojas secundárias a partir dela.

2.2 Copiar da Loja: Essa loja passa a copiar códigos de integração da loja principal informada nesse campo.

Aba E-commerce

Essa aba foi criada para complementar informações de loja com parceiros que utilizam nosso integrador E-COMMERCE. Será habilitada somente se a opção 1.3 E-COMMERCE do campo 1. Integração da aba Parâmetros por Integração estiver marcada.

5

1.6 Utiliza Certificado de Segurança (SSL): Define se a conexão com o parceiro será segura (por exemplo HTTPS).

1.8 Tipo de Leitura: Define se a integração com o parceiro será por meio de um WebService ou Arquivo XML.

1.9 Diretório Padrão Para Exportação do XML: Caso trabalhar com tipo de leitura por arquivo XML, é necessário informar a pasta que será exportado os arquivos gerados pelo integrador.

1.10 Utiliza Envio de Produto por Bloco: Com a opção desmarcada, a Onclick irá montar um único arquivo XML para cada processo com todos os registros de envio. Caso marcado, serão enviados vários arquivos XML (quantidade definida no campo abaixo) com os registros de envio.

1.11 Quantidade de XML Enviado por Bloco: Quantidade de registros que irão compor cada arquivo XML gerado pelo integrador.

1.12 Segundos de espera para próximo XML: Define o tempo para processamento do arquivo XML de envio.

1.13 Envia Marcas: Define se o integrador irá exportar as marcas cadastradas no ERP ao enviar produtos.

2. Tabela de Preço a Enviar: Grid onde serão preenchidas as tabelas de preço que serão exportadas pelo integrador ao enviar produtos (será utilizado o preço dessa tabela). Para informar a tabela de preço, utilizar o INSERT do teclado. O campo NOME DE INTEGRAÇÃO será responsável por vincular o ERP ao Parceiro.

Aba IKEDA

Essa aba foi criada para configurar informações de loja com o parceiro RAKUTEN EC SERVICE/IKEDA. A aba será habilitada somente se o campo 1.5 IKEDA do parâmetro 1. Integração da aba Parâmetros por Integração estiver habilitado.

6

1.6 Versão: Define qual versão do parceiro Ikeda será integrado. Atualmente deverá ser preenchida com os valores 2.1 ou 2.2 pois existem apenas essas duas versões liberadas por eles.

1.7 Status para Pedidos com Vale Presente: Tipo do Pedido padrão que será vinculado a pedidos utilizando o vale presente.

2.1 Status para Compra de Lista de Presentes (Primário): Ao importar um pedido de uma lista de presente que será entregue futuramente ao presenteado, o tipo de pedido ficará com o configurado nesse campo. Opção disponível apenas para as integrações 1.5 Ikeda e 1.6 Vtex.

2.2 Status para Compra de Lista de Presentes (Secundário): Ao importar um pedido de uma lista de presente que será entregue futuramente ao presenteado, ao fatura-lo será gerado um segundo pedido que deverá ser despachado com o produto para o presenteado. O tipo de pedido, desse segundo pedido espelho será o que está configurado nesse campo. Opção disponível apenas para as integrações 1.5 Ikeda e 1.6 Vtex.

3. Código de Barras para Itens da Lista de Presente: Ao importar pedidos de uma lista do tipo crédito, será substituído o produto original pelo item configurado nesse campo. Opção disponível apenas para as integrações 1.5 Ikeda e 1.6 Vtex.

Lista do tipo crédito: quando os itens de uma lista são apenas simbólicos. Ao comprar o item, o valor do produto é convertido em créditos, podendo ser usado para a compra de outros produtos.

Aba VTEX

Essa aba foi criada para configurar informações de loja com o parceiro VTEX. A aba será habilitada somente se o campo 1.6 VTEX do parâmetro 1. Integração da aba Parâmetros por Integração estiver habilitado.

7

4. Versão: Esse campo é responsável por informar como a integração irá trabalhar, com o modelo antigo Checkout V1 ou o novo, chamado de Smart CheckOut.

5. Código de Integração do Almoxarifado Padrão: Caso o cliente trabalhe com mais de um almoxarifado na VTEX e deseja que o estoque dos produtos alimente um específico, deverá ser informado nesse campo o código de integração deste almoxarifado. Caso esse campo fique em branco, o estoque será replicado para todos almoxarifados cadastrados no site.

6. Tipo de Pedido para Bonificação: Inclui uma CFOP de bonificação para este tipo de pedido.

Copiar Produtos: Na Tela [0962] CADASTRO DE LOJAS WEB, há o botão COPIAR PRODUTOS, este botão copia todos os registros (produtos, marcas e etc…) liberados de uma loja de origem para uma nova loja.

Loja Origem a Ser Copiada: Ao informar a loja nesse campo, serão copiados todos registros liberados nela para a nova loja selecionada na tela anterior. As seguintes informações serão liberadas: Produto, Fabricante, Departamento, Categoria, Seção, Característica, Vinculação Entre Produto e Característica, Informação, Vinculação Entre Produto e Informação, Perfil, Cor, Nível De Produto.

Copiar Site Código da Loja de Origem: Ao marcar essa opção, serão copiados os códigos de integração (das propriedades informadas acima) da loja origem para a nova loja.

Cadastros de Produto

Cadastro de Perfil

Em Cadastros >> Produtos >> Tabelas diversas >> Perfil >> Tela [0959] CADASTRO DE PERFIL.

A Tela [0959] CADASTRO DE PERFIL é responsável pela criação de um novo perfil com determinadas características selecionadas.

  • Descrição: Campo destinado ao nome do perfil que será criado no site.
  • Características Cadastradas: Apresenta as características disponíveis para vinculação com o perfil.
  • Característica Selecionadas: Apresenta as características já vinculadas ao perfil.

Cadastro Nível de Produto

Em Cadastros >> Produtos >> Nível >> Tela [0889] CADASTRO DE NÍVEL PRODUTO.

Essa tela é responsável pela categorização dos produtos no site, conhecido também como departamentos de um site. Está disponível para as integrações:

  • Fast (caso a opção “Trabalha com Níveis de Categorias de Produto” da tela Cadastro de Loja Web estiver marcada);
  • Tray;
  • E-commerce;
  • Ikeda; 
  • VTEX

Loja Selecionada: Se houver mais de uma loja WEB cadastrada no ERP, essa opção será mostrada para que defina qual nível de categoria deseja trabalhar atualmente. Caso não houver mais de uma loja, o campo será automaticamente carregado com a loja atual.

Botão “Cadastrar Nível”: Abrirá a Tela [0892] CADASTRO DE NÍVEIS. Ela é responsável por gerenciar os níveis de categorias que serão exportadas para o site.

Código: Código interno no ERP do nível de categoria.

Descrição: Nome do nível que será enviado para o site.

Código Internet: Código de integração com o parceiro (deixar zerado caso for um nível novo).

Perfil: Perfil que o nível ficará vinculado. Opção disponível para Integração TRAY.

Nível Loja Principal: Esse campo é responsável pela amarração entre a loja principal e secundária. Ao criar um nível na loja secundária, deverá ser informado qual nível da principal é equivalente a ela, assim ao atualizar o código de integração da principal o sistema saberá qual nível da secundária deverá ser replicado. (Caso as opções “Loja principal” e “Loja Secundária” na Tela CADASTRO DE LOJA WEB estiverem preenchidas). Opção disponível para Integração TRAY.

Botão “Carregar”: Esse botão é responsável por carregar o cadastro de árvore de níveis. Será mostrada toda a estrutura que será apresentada no site.

Após cadastrados os níveis desejados, será necessário clicar no Botão CARREGAR para que inicie uma nova estrutura de árvore de níveis.

8

  • O ícone C:Usersmarcus.viniciusDesktopimg10.JPG na frente da descrição do nível de categoria, significa que ele é a “base” da árvore de níveis ou que ele não está vinculado a ninguém.

Para adicionar um subnível ao exemplo “Casa”, deverá clicar no botão “Adicionar Nível”.

Botão “Adicionar Nível”: Esse botão é responsável por adicionar subníveis a uma árvore de níveis. Ao clicar nesse botão, será aberta a Tela [0890] ADICIONAR NÍVEL.

Código: Campo responsável por pesquisar o código interno no ERP do nível. Ao informar e sair do campo, a descrição será carregada.

Botão “Cadastrar Nível”: Abrirá a Tela [0892] CADASTRO DE NÍVEIS.

Botão “Pesquisar Nível”: Esse botão é responsável por uma melhor pesquisa dos níveis cadastrados. Será aberta a Tela [0891] PESQUISAR NÍVEL.

Após pesquisar e encontrar o nível desejado a ser adicionado a árvore de níveis da primeira tela, dar um duplo clique que será carregado na tela anterior.

Após clicar em gravar. O nível pesquisado será adicionado como um subnível do principal.

Fazer o mesmo processo até montar toda a árvore de níveis.

9

Botão “Remover Nível”: Esse botão é responsável por remover um subnível de uma árvore de níveis.

Ao clicar nesse botão, será apresentada uma mensagem de confirmação.

Esse botão desvincula o nível selecionado na àrvore junto com os níveis abaixo dele. No exemplo do “Anel”, serão removidos também os níveis “Ouro” e “Rhodium”.

  • Os níveis “Ouro” e “Rhodium” continuam vinculados ao nível “Anel”. Esse botão apenas remove o nível selecionado do nível acima, porém os níveis abaixo dele continuam amarrados.

Botão “Remover Nível Completo”: Esse botão é responsável por desvincular todos os níveis e subníveis de uma árvore.

Esse botão desvincula todos os níveis na arvore de níveis de categoria. No exemplo acima o “Anel”, “Ouro” e “Rhodium” serão desvinculados entre eles.

A diferença entre os botões “Remover Nível” e “Remover Nível Completo” é que o segundo botão desvincula por completo todos os níveis da árvore, já o primeiro apenas remove o nível selecionado mantendo os subníveis vinculados a ele.

Cadastro de Marca

Em Cadastros >> Produtos >> Tabelas Diversas >> Marca >> Tela [0308] CADASTRO DE MARCA.

Essa tela é responsável pela criação de marcas para posteriormente vincular ao produto no site.

Descrição: Descrição que será apresentado no site do parceiro.

Esse mesmo recurso existe nas seguintes telas: Marca, Grupo, SubGrupo, Categoria, Característica e Evento.

Aba Integração WEB

Local onde apresenta em quais lojas estão liberadas essa marca. Nela é possível informar o código de integração manualmente, caso não souber, deixar em branco para que o integrador preencha automaticamente no momento da integração.

Esse mesmo recurso existe nas seguintes telas: Marca, Grupo, SubGrupo, Categoria, Característica e Evento.

Botão “Gravar”: Ao clicar em gravar e não ter liberado para nenhuma loja, o ERP apresenta uma mensagem perguntando se deseja liberar para todas as lojas automaticamente. Caso clicar em “SIM”, libera com o código de integração zerado.

Para lojas Web que apresentem vinculação entre loja principal e secundária, caso libere manualmente para a loja principal, será forçada a liberação para a secundária, para que os códigos de integração fiquem sincronizadas entre elas.

Cadastro de Características

Em Cadastros >> Produtos >> Tabelas Diversas >> Características >> na tela [0749] CADASTRO DE CARACTERÍSTICAS.

Tela responsável pelo cadastro de características para uma posterior vinculação aos produtos ou SKUs.

Características são atributos que diferenciam um mesmo produto, por exemplo Cor, Tamanho, Voltagem e etc.

Botão “Valores”: Ao clicar nesse botão, será aberta a Tela [0899] CADASTRO DE VALORES para cadastrar os valores da característica. No exemplo abaixo, foram cadastrados valores para a característica COR.

Descrição: A descrição do valor que será amarrado a característica.

Código Internet: Código de integração com o parceiro, caso não souber, deixar zerado para que o integrador preencha automaticamente.

Cadastro de Produtos.

Em Cadastros >> Produtos >> Tela [0293] CADASTRO DE PRODUTOS >> Alterar >> Tela [0324] ALTERAÇÃO DE PRODUTOS.

Nessa tela, além dos dados básicos para o ERP, será necessário preencher informações voltadas para Integrações Web.

Aba DADOS GERAIS

Nessa aba algumas informações que são preenchidas para uso interno no ERP também serão consideradas para enviar ao site.

Tipo: Tipo do produto, normalmente utilizado “PRODUTO ACABADO” ou “KIT DE PRODUTOS”.

Estoque De Segurança: Dependendo da configuração na loja Web, ele será somado ou não ao estoque do produto.

Peso Bruto: Peso bruto do produto.

Peso Líquido: Peso líquido do produto.

Altura: Altura do produto.

Largura: Largura do produto.

Comprimento: Comprimento do produto.

Volume Cúbico: Volume cúbico do produto.

Dias para Entrega: Quantidade de dias necessários para o manuseio e entrega do produto. Opção disponível para as integrações Ikeda e E-commerce.

Aba INTEGRAÇÃO WEB

Caso haja mais de uma loja web, será necessário informar qual loja deseja liberar para esse produto. Assim serão apresentados campos dinâmicos para cada tipo de integração diferente.

Se houver apenas uma única loja, automaticamente ela será carregada.

ID Produto: Campo correspondente ao código de integração do produto junto ao site do parceiro. Esse código deverá ser único por loja.

ID Produto Pai: Campo correspondente ao código de integração do produto pai junto ao site do parceiro. Esse código deverá ser único por loja.

Referência: De acordo com a opção “3.1 Enviar Para o Site” na Tela de Cadastro de Loja Web, esse campo será preenchido automaticamente com Código de Barras, Auxiliar ou Fabricante. É possível altera-lo manualmente diretamente nesse campo.

Marca: Campo destinado a marca do produto. Serão apresentadas apenas marcas que estão liberadas para essa loja.

Descrição: Nome ou título do produto que será apresentado no site.

Descrição Longa: Descrição detalhada do produto, normalmente será apresentado como corpo do anuncio no site.

Enviar Produto Para o Site: Opção responsável pela liberação ou não do produto para o site.

Destaque: Opção que informa se o produto deverá ficar como destaque no site.

Lançamento: Opção informa se o produto deverá ficar como lançamento no site.

Produto Disponível: Opção que informa se o produto deverá ficar como disponível para venda ou não no site.

URL Externa: Opção que indica se o produto possui uma URL externa para redirecionamento. Disponível para as integrações E-commerce e FAST.

Frete Grátis: Indica que o produto pode ficar com frete grátis no carrinho de compra. Disponível para a integração Rakuten.

SKU Padrão: Campo responsável por informar que esse produto é o principal a ser apresentado na vitrine da loja. Disponível para a integração Rakuten.

Est. Mínimo: Estoque mínimo desse produto no site.

Estoque: Campo não habilitado para edição. Para alterar, deverá ser acessado pelas telas de manutenção do estoque.

Campos dinâmicos integração TRAY

Campos que serão habilitados caso a opção TRAY esteja marcada no cadastro de Lojas Web.

C:Usersmarcus.viniciusDesktopimg12.JPG

Cod. Auxiliar / ML: Recebe a mesma informação do campo “Auxiliar” da aba Dados Gerais.

Garantia: Campo que define quanto tempo de garantia o produto possui.

Disponibilidade: Campo que informa a disponibilidade do produto no site.

Texto Personalizado: Campo para identificar o texto personalizado no pedido, normalmente usados em camisetas onde será preenchido um nome. Ex: ‘Digite seu Nome aqui’.

Informações: Tabela para cadastrar mais informações do produto, como vídeo, especificação e etc. O campo informação da tabela deverá ser texto pré-definido no manual de integração TRAY. O campo descrição é o valor.

C:Usersmarcus.viniciusAppDataLocalMicrosoftWindowsINetCacheContent.Word15.jpg

Campos dinâmicos integração E-COMMERCE, FAST e IKEDA

Campos que serão habilitados caso a opção E-COMMERCE, FAST ou IKEDA esteja marcada no cadastro de Lojas Web.

C:Usersmarcus.viniciusAppDataLocalMicrosoftWindowsINetCacheContent.Word14.jpg

Descrição Curta: Descrição resumida que será apresentada na loja. Disponível para todas as integrações.

Descrição HTML: Caso o produto tenha uma descrição HTML e deseja carrega-la na página do site. Disponível para a integração FAST.

URL Apoio: URL para redirecionamento de mais detalhes do produto. Disponível para as integrações FAST e VTEX.

Imagem Principal: URL da imagem principal do produto. Disponível para a integração FAST.

Imagem de Detalhe: URL da imagem em detalhe. Disponível para a integração FAST

Imagem Ampliada: URL da imagem ampliada. Disponível para a integração FAST.

Data Vencimento: Data de Vencimento do produto. Disponível para as integrações E-commerce, FAST, e VTEX.

Categoria: Campo que será enviado no XML de produto de acordo com a configuração de descritores no Cadastro de Loja WEB. Disponível para a integração FAST.

Grupo: Campo que será enviado no XML de produto de acordo com a configuração de descritores no cadastro de loja web. Disponível para a integração FAST.

SubGrupo: Campo que será enviado no XML de produto de acordo com a configuração de descritores no cadastro de loja web. Disponível para a integração FAST.

Característica: Campo que será enviado no XML de produto de acordo com a configuração de descritores no cadastro de loja web. Disponível para a integração FAST.

Informação: Campo que será enviado no XML de produto de acordo com a configuração de descritores no cadastro de loja web. Disponível para a integração FAST.

Cor: Campo que informa a cor do produto. Disponível para a integração FAST.

Ordem: Campo destinado para que o integrador saiba qual a sequência de apresentação do produto no site. Disponível para as integrações E-commerce e FAST.

Máx Parc: Número máximo de parcelas para pedidos que incluam este produto. Disponível para a integração FAST.

XML Parc: Identifica o número de parcelas utilizadas para exibir o parcelamento na página que lista os produtos em XML. A lista de produtos em XML é utilizada pelos portais de comparação de preços e shopping virtuais, para capturar os produtos da loja. Disponível para a integração FAST.

Máx Venda: Quantidade máxima desse produto por venda. Disponível para a integração IKEDA.

Fator Conv: Fator de conversão utilizada ao importar um pedido com esse produto. Disponível para a integração E-commerce.

Min. Venda: Quantidade mínima do produto no site (igual ao campo Est. Mínimo). Disponível para a integração IKEDA.

Aba DESCRIÇÃO HTML

Essa aba contém um editor simples de HTML para enviar um texto já formatado com a descrição do produto para o parceiro web. Disponível para as integrações E-comnerce, IKEDA e TRAY (Desmarcar a opção “Utiliza Editor HTML do Site como Principal” no cadastro de Loja Web).

Aba CARACTERÍSTICAS

Essa aba é responsável pelos atributos e diferenciação de um mesmo produto, por exemplo uma Geladeira 220v ou 110v é a mesma geladeira, o que muda entre elas é sua voltagem. Disponível para as integrações E-commerce, IKEDA, FAST (marcar a opção “Trabalha com Multivalorados” no cadastro de Loja Web), VTEX e TRAY (para produtos SKUs).

Característica: Campo para seleção de qual característica deseja acessar.

Valores: Na tabela Valores, serão carregados todos os valores cadastrados para aquela característica selecionada.

Valores Selecionados: Essa tabela é apenas para visualização dos valores selecionados daquela característica.

Características Escolhidas: Uma árvore de todas as características e valores que foram cadastrados para aquele produto.

Aba Níveis de Categorias

Essa aba é responsável pela categorização do produto dentro do site. Por exemplo uma Geladeira normalmente se encontra na categoria “Eletrodomésticos” junto com outras geladeiras.

Essa aba é apresentada apenas para produtos únicos ou pais (menos E-commerce), pois os SKUs sempre serão herdados do produto principal.

Disponível para as integrações: TRAY, E-commerce, FAST (marcar a opção “Trabalha com Níveis de Categorias de Produtos” no cadastro de loja Web), VTEX e IKEDA.

17

Descrição: Ao dar duplo clique no nível de categoria desejado, ele irá expandir seus subníveis. Repetindo o processo, chegará até o final da árvore de níveis. Para amarrar o produto ao nível desejado, apenas deixe selecionado e clique em gravar.

Enviar Níveis Adicionais: Essa opção é apresentada apenas para lojas TRAY. Ao marcar a opção, será aberta uma tabela na lateral para ser adicionado mais de um nível no produto.

Os níveis adicionais serão considerados apenas se tiver mais de um nível na tabela “Níveis Adicionais”. O primeiro nível será considerado o principal do produto e o restante como adicional. Assim deverá ser desconsiderado a árvore de níveis do lado esquerdo.

18

Aba CUSTOS E PREÇOS

Na aba Custos e Preços encontram-se alguns campos que serão utilizados para a integração com todos os parceiros web.

Preço de Venda: Campo responsável pelo valor do produto no site. Caso o usuário trabalhe com mais de uma tabela de preço e esta estiver configurada no Cadastro de Lojas Web, poderá ir o valor desta tabela e não o que foi cadastrado nesse campo.

Promoção/Valor em R$: Campo responsável pelo valor de promoção no site. Caso o usuário trabalhar com mais de uma tabela de preço, poderá ir o valor da tabela e não do qual foi cadastrado nesse campo.

Promoção/Início: Data de início da promoção desse produto.

Promoção/Fim: Data do fim da promoção desse produto.

Vinculação Produto Pai e Filho

Em Cadastros >> Produtos >> Tela [0293] CADASTRO DE PRODUTOS >> Funções >> Vincular Produto Pai X Filho >> Tela [0853] VINCULAR PRODUTO PAI X FILHONessa tela é possível realizar a vinculação manual de vários produtos únicos transformando-os em pai e filhos.

Um produto pai é o que é mostrado na listagem de exportação dos produtos nos integradores e também é o que será apresentado na vitrine da loja.

Exemplo de produto pai no site:

Ao acessar um produto pai que está na vitrine, serão mostradas as opções do produto, nesse caso as variações de tamanhos (no ERP são chamadas de características):

Ao acessar a Tela [0853], serão apresentados todos os produtos que são possíveis vincular ao novo pai. Ao marcar ou desmarcar os produtos filhos, clique no botão PROCESSAR e a vinculação estará realizada.

Cadastro Automático de SKUs

Em Cadastros >> Produtos >> Tela [0293] CADASTRO DE PRODUTOS >> Funções >> Cadastro Automático de SKUs >> Tela [0980] CADASTRO AUTOMÁTICO DE SKUS.

Nessa tela é possível atribuir SKUs a um produto (atribuir FILHOS a um produto PAI), porém é necessário que produto PAI esteja com uma loja WEB vinculada a ele e que tenha um almoxarifado inicializado.

Para inicializar o almoxarifado, no cadastro do produto que será o “PAI”, clique em LOCAL DE ARMAZENAGEM E INICIALIZAÇÃO DE ESTOQUE POR ALMOXARIFADO, e depois em INICIALIZAR ESTOQUE; já para configurar a loja WEB, na aba Integração WEB, selecione a loja no campo LOJA SELECIONADA.

De volta à Tela [0980] CADASTRO AUTOMÁTICO DE SKUS:

Selecione a característica e seus respectivos valores, por exemplo, na inclusão de SKUs para o produto CAMISETA, foram selecionadas as características GÊNERO, COR e TAMANHO, e os valores FEMININO, MASCULINO, AZUL, BRANCA, PRETA, GG, G, M, P e PP.

Ao simular a criação dos produtos, foram criadas todas as combinações possíveis entre os valores selecionados a partir da primeira característica citada (GÊNERO). Os valores poderão ser ordenados da forma que o usuário preferir, por exemplo, para a característica TAMANHO, a ordenação que está como G, GG, M, P e PP; pode ser alterada através das setas para cima e para baixo para PP, P, M, G e GG.

Após selecionar todas as características e valores desejados, clique em SIMULAR, serão exibidos na mesma Tela todos os produtos criados. Os produtos “FILHOS” serão criados seguindo o nível (ordem) definido pelo usuário na seleção das características e de seus valores. Utilizando o produto CAMISETA como exemplo, foi definido como primeiro nível a característica GÊNERO, como segundo nível a característica COR e como terceiro nível a característica TAMANHO, sendo assim, o produto será criado partindo do primeiro valor do primeiro nível (FEMININO), criando-se todas as combinações a partir deste valor e posteriormente a partir do segundo valor do primeiro nível (MASCULINO), e assim sucessivamente, caso haja outros valores. Sendo assim, deve-se atentar a criação dos níveis, já que a sequência do cadastro dos produtos filhos criados deverá respeitar a ordenação realizada no quadro Valores Selecionados.

Características: Serão carregadas as características cadastradas no ERP. Ao selecionar, será carregado automaticamente a tabela VALORES com os valores vinculados a ele.

Tabela Valores Selecionados: Ao dar duplo clique no valor, ele será transferido para os valores selecionados. Poderá informar quantos valores desejar para montar as combinações de SKUs.

Adicionar Valores das Características na Descrição do Produto: Ao ser marcado, irá atribuir aos campos DESCRIÇÃO e DESCRIÇÃO SITE os valores das características, facilitando posteriormente a localização deste produto. Marque a opção e clique em SIMULAR para as descrições serem alteradas.

Gerar Cód. Barras Automaticamente: Ao ser marcado, será gerado para os SKUs exibidos na Tela (produtos filho), um código de barras no padrão EAN13 ou EAN18 de acordo com o configurado no sistema em (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Alterar >> Tela [0444] CONFIGURAÇÕES DO SISTEMA >> 5. Produtos/Preços >> agrupamento 2.Cadastro de Produtos >> 2.3 CÓDIGO DE BARRAS PADRÃO). Marque a opção e clique em SIMULAR para o código ser gerado. Se desmarcado, o campo código de barras será preenchido com o código produto.

Ao clicar em GRAVAR, os produtos exibidos na Tela [0980] serão inclusos no Cadastro de Produtos (tabela PRODUTO). Após este procedimento, os produtos ‘filho’ automaticamente estarão vinculados ao produto ‘pai’, não sendo permitida a exclusão do produto ‘pai’. O almoxarifado do produto FILHO será o mesmo do produto PAI.

Lista de Presentes ou Lista de Desejos

Em Vendas >> Pedidos e Orçamentos >> Lista >> Tela [0922] LISTA DE PRESENTES.

Com a tela lista de presente, é possível criar uma lista no ERP e usá-la internamente ou exportá-la para integração TRAY.

Ao incluir no botão incluir, será aberta a Tela [0923] LISTA DE PRESENTES.

  • Enviar Lista Para o Site: Define se a lista será destinada ao site ou não. Existe a possibilidade de não ser somente para loja física.
  • Loja Web: Caso o campo acima seja marcado, deverá informar para qual loja será exportada. Os produtos a serem informados na lista também serão carregados de acordo com a loja definida.
  • Cliente: Campo destinado para informar o nome do dono da lista.
  • E-mail: E-mail de contato do dono da lista
  • Endereço: Endereço do dono da lista.
  • Telefone: Telefone do dono da lista.
  • Participante 2: Nome do segundo participante (nome do noivo ou noiva por exemplo).
  • Email: E-mail de contato do participante.
  • Telefone: Telefone do participante.
  • Tabela de Preço: Tabela de preço cujo os valores dos produtos serão apresentados na lista.
  • Evento: Tipo do evento da lista de presente (casamento, chá de cozinha por exemplo).
  • Data Evento: Dia que o evento será realizado.
  • Horário: Horário que o evento será realizado.
  • Local: Local do evento que será realizado.
  • URL: Caso o evento possuía algum link de divulgação.
  • Descrição: Pequena descrição do evento.
  • Mensagem: Mensagem de agradecimento.
  • Status: Status do evento.
  • Envia Cartão: Envia cartão de agradecimento para os convidados.
  • Recebimento: Quando os produtos serão recebidos.
  • Envia E-mail: Envia e-mail automático para o dono da lista para cada compra.
  • Vendedor: As vendas serão vinculadas a algum vendedor.
  • Filial: Qual filial a lista será vinculada.
  • Valido até: Data que a lista ficará disponível.
  • Digitar: Campo de escolha para pesquisar e adicionar o produto na lista.
  • Item: Qual o número do item na lista.
  • Código: Código de identificação do produto para adicionar à lista.
  • Qtde: Quantidade desejada para o produto.
  • Coletor de Dados – Arquivo Texto: Campo para carregar uma lista de presente diretamente por arquivo.
  • Botão “Estorno”: Botão destinado para devolução de itens. O botão Estorno ficará habilitado apenas para os itens que já foram faturados – ou seja, para os produtos em que já houve a emissão da nota ou cupom fiscal.

Tipos de Pedido

Em Vendas >> Tabelas Diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE PEDIDO.

Essa tela é responsável pela integração dos tipos de pedidos entre o ERP e o Parceiro Web.

Ao incluir um novo tipo de pedido, será necessário informar na aba INTEGRAÇÃO WEB a descrição e o código de integração.

No tipo de Pedido FATURADO, existe um campo destinado a pedidos sem código de rastreio e com rastreio, assim pode-se ter dois status diferentes para a mesma Nota Fiscal mas em situações que tem ou não rastreio.

  • Com Rastreio: Após faturar o pedido e ser adicionado um código de rastreio, o integrador enviará a descrição e código do parceiro configurado nesse campo.
  • Sem Rastreio: Após faturar o pedido e não conter código de rastreio, o integrador enviará a descrição e código do parceiro configurado nesse campo.
  • Fixo: Esse campo define que caso o tipo de pedido está atrelado ao pedido, o integrador não poderá alterar por meio da integração caso o tipo de pedido no site estiver diferente. Se esse campo não está marcado, o integrador irá alterar o tipo de pedido do site e sobrepondo o do ERP atualmente. Disponível para as integrações e-commerce, FAST, VTEX, IKEDA.

Status Web.

Disponível somente para TRAY.

Será possível vincular ao TIPO DE PEDIDO de Venda, vários STATUS referente as mercadorias e ao próprio Pedido de Venda, como A ENVIAR, AGUARDANDO DISPONIBILIDADE, etc. Estes STATUS, serão denominados de STATUS WEB e permitirão o acompanhamento das operações, sem a necessidade de alteração no tipo do PEDIDO DE VENDA.

O cadastro de Status Web é utilizado atualmente apenas para integração TRAY. É um formato mais flexível de controlar o Status Web do pedido, podendo criar e alterar o status mesmo após o pedido ser faturado.

Configurações

Em Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba Parâmetros por Integração >> aba Geral >> 5. Atendimento Site.

Para que o STATUS WEB seja exibido na inclusão do Pedido de Venda; a loja WEB deve possuir um Tipo de Atendimento vinculado a ela. Tipos de Atendimento são cadastrados em (Vendas >> Tabelas Diversas >> Tipos de Atendimento >> Tela [0038] TIPOS DE ATENDIMENTO).

6

Em Vendas >> Tabelas Diversas >> Tabelas Diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE PEDIDO >> Status WEB >> Tela [1109] CADASTRO DE STATUS WEB.

O atalho Status WEB abrirá a Tela [1109] CADASTRO DE STATUS WEB.

1

2

Na Tela [1109] CADASTRO DE STATUS WEB, poderão ser inclusos STATUS para o TIPO DE PEDIDO selecionado anteriormente, por exemplo, aguardando pagamento, pedido aprovado, aguardando disponibilidade, etc.

Poderão ser inclusos mais de um STATUS para o mesmo TIPO DE PEDIDO, porém não será permitida a inclusão de mais de um STATUS com a mesma descrição, por exemplo, dois STATUS com a descrição A ENVIAR, mesmo que este STATUS esteja vinculado a outro TIPO DE PEDIDO. Será obrigatório também, marcar um STATUS como STATUS PADRÃO.

Ainda na Tela [1109] CADASTRO DE STATUS WEB, na aba INTEGRAÇÃO WEB, deverá ser selecionada a(s) Loja(s) Web que utilizará(ão) o STATUS criado.

8

Os STATUS WEB do tipo de pedido FATURADO, terão a opção de configurar o PADRÃO COM RASTREIO:

11

Com esta opção marcada, ao gerar uma Etiqueta de Postagem a partir de uma Nota Fiscal de Venda, o STATUS WEB do PEDIDO DE VENDA que gerou a NOTA FISCAL DE VENDA será alterado para o STATUS WEB que possui a opção PADRÃO COM RASTREIO marcada.

Processos

Em Vendas >> Pedidos e Orçamentos >> Pedido >> Tela [0418] ORÇAMENTO / PEDIDO DE VENDA >> Incluir >> Tela [0574] INCLUSÃO DE PEDIDOS/ORÇAMENTOS >> aba INTERNET >> campo STATUS WEB.

Na Tela [0574] INCLUSÃO DE PEDIDOS/ORÇAMENTOS e na Tela [0574] ALTERAÇÃO DE PEDIDOS/ORÇAMENTOS, será exibido o campo STATUS WEB, que trará os STATUS cadastrados na Tela [1109] CADASTRO DE STATUS WEB, porém os status exibidos neste campo serão de acordo com o TIPO DE PEDIDO e TIPO DE ATENDIMENTO selecionados no PEDIDO DE VENDA.

7

Na inclusão de um Pedido de Venda, ao ser selecionado um TIPO DE PEDIDO, no campo STATUS WEB serão exibidos somente os STATUS cadastrados para aquele TIPO DE PEDIDO.

Se o TIPO DE PEDIDO for alterado, a informação do campo STATUS WEB será alterada para o STATUS definido como padrão no cadastro do novo TIPO DE PEDIDO informado.

Caso a loja WEB utilize o TrayCheckout, o botão ALTERAR da Tela [0574] ALTERAÇÃO DE PEDIDOS/ORÇAMENTOS ficará desabilitado. A utilização do TrayCheckout é definida em (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba Parâmetros por Integração >> aba TRAY >> 7.16 UTILIZA TRAYCHECKOUT), com o parâmetro 7.16 marcado, o botão ALTERAR ficará desabilitado.

Já o parâmetro 7.16 UTILIZA TRAYCHECKOUT, ficará habilitado apenas se a empresa utilizar o Faturamento direto de Pedidos, configurado em (Utilitários>> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Alterar >> Tela [0444] CONFIGURAÇÕES DO SISTEMA >> 7. Vendas >> aba Nota Fiscal >> Agrupamento 6. Importação do Pedido de Venda >> 6.10 Utiliza Faturamento Direto de Pedidos).

A loja WEB é definida através do TIPO DE ATENDIMENTO selecionado na Tela [0574] ALTERAÇÃO DE PEDIDOS/ORÇAMENTOS, onde cada TIPO DE ATENDIMENTO está vinculado a uma LOJA WEB, como definido no Cadastro de Lojas WEB (Tela [0962] CADASTRO DE LOJAS WEB).

Em Vendas >> Pedidos e Orçamentos >> Pedido >> Tela [0418] ORÇAMENTO / PEDIDO DE VENDA >> Funções >> Atualização de Status Web >> Tela [1110] ATUALIZAÇÃO DE STATUS WEB.

Na Tela [1110] ATUALIZAÇÃO DE STATUS WEB, poderá ser realizada uma alteração em massa do campo STATUS WEB dos PEDIDOS DE VENDA selecionados.

9

Nesta Tela, os filtros WEBLOJA e TIPO DE PEDIDO serão obrigatórios, onde o botão Pesquisar só ficará habilitado após o preenchimento destes dois campos.

Poderá ser alterado o STATUS WEB de qualquer pedido de venda, inclusive os que estão com o tipo FATURADO.

Para a opção Atualização de Status Web ser exibida no menu Funções da Tela [0418] ORÇAMENTO / PEDIDO DE VENDA, o usuário deverá possuir permissão de acesso habilitada para alteração de Pedidos de Venda em (Utilitários >> Perfil e Usuários >> Perfil >> Tela [0984] CADASTRO DE PERFIL >> Permissões >> Tela [0645] PERFIL – PERMISSÃO DE ACESSO >> 3.Vendas >> aba Pedido >> Agrupamento 2.Pedido de Venda >> 2.1 Cadastro >> opção Alterar).

(Expedição >> Etiquetas de Expedição >> Etiquetas de Postagem nos Correios >> Tela [0711] ETIQUETAS DE POSTAGEM)

Ao gerar etiquetas de postagem, o STATUS WEB do PEDIDO DE VENDA Faturado será alterado para o STATUS WEB configurado na Tela [1109] CADASTRO DE STATUS WEB, caso algum dos STATUS do Tipo de Pedido Faturado esteja com o PADRÃO RASTREIO marcado.

Exemplo:

Considerar um Pedido de Venda com o tipo PEDIDO e STATUS WEB Aguardando Disponibilidade. Este Pedido de Venda é faturado, alterando assim seu tipo para FATURADO e STATUS WEB para Enviado a Transportadora (STATUS WEB cadastrado para o tipo de pedido FATURADO). É gerada uma etiqueta de postagem a partir da Nota Fiscal de Venda que importou este Pedido, o STATUS WEB do Pedido de Venda é alterado para FINALIZADO (STATUS WEB do TIPO DE PEDIDO FATURADO, que possui a opção PADRÃO RASTREIO marcada).

10

Forma de Pagamento.

Em Financeiro >> Tabelas Financeiras >> Cartões de Crédito >> Tela [0130] OPERADORAS DE CARTÕES DE CRÉDITO E FINANCEIRA.

Configuração das formas de pagamento utilizadas atualmente pelas Integrações Web.

  • Utiliza TrayCheckout: Recurso exclusivo para formas de pagamento Tray Checkout, ao marcar essa opção na tela CARTÃO DE CRÉDITO no ERP, define que cálculos como desconto e data de pagamento ao lojista serão informados pelo parceiro TRAY.
  • Dias para Crédito: Preencher o campo com os dias para crédito separados por “/”. Por exemplo um cartão Visa 3x pode ser cadastrado como 30/60/90.
  • Site Código: Campo que define o código de integração para cartões de crédito fornecida pelos parceiros. Disponível para as integrações VTEX e IKEDA.
  • Descrição Site: Campo que define a descrição de integração para cartões de crédito fornecida pelos parceiros. Disponível para as integrações TRAY, FAST e E-commerce.

Visualizar XML.

Em Utilitários >> Utilitários >> Visualizar XML Web >> Tela [0968] PESQUISA DE XML.

Para cada troca de informação entre o integrador e o parceiro, normalmente é enviado um arquivo XML e espera-se resposta de outro arquivo XML. Com isso é salvo no banco de dados do ERP e tem validade por 7 dias. Na Tela [0968] PESQUISA DE XML é possível uma fácil visualização.

  • Pesquisar Palavra: Campo destinado a pesquisar uma palavra em específico dentro do XML.
  • Período de: Data inicial para pesquisa do XML. Ele se baseia na data de criação do arquivo.
  • Período até: Data final para pesquisa do XML.
  • Loja: Busca o XML apenas em uma determinada loja de integração.

Ao selecionar um ou mais XML, o mesmo poderá ser salvo no computador para ser compartilhado posteriormente.

Caso desejar visualizar, de um duplo clique no arquivo e será apresentado o corpo do XML.

Processar pedido WEB.

Em Vendas >> Pedidos e Orçamentos >> Pedidos via WEB >> Tela [0013] IMPORTAÇÃO PEDIDOS INTERNET) ou Tela inicial do Onclick >> Pedidos via WEB >> Tela [0013] IMPORTAÇÃO PEDIDOS INTERNET.

Ao importar pedidos da internet pelo integrador, eles serão apresentados na Tela [0013] IMPORTAÇÃO DE PEDIDOS WEB, para que confirme se o pedido é válido e o processe para efetivá-lo.

  • Filtro de período – De e até: Filtro de datas para demonstração do pedido. Por padrão ele preenche sempre um dia, mas pode ser configurado em UTILITÁRIOS >> SISTEMA >> [0030] CONFIGURAÇÕES DO SISTEMA >> LOJAS WEB >> ABA PARÂMETROS COMUNS DE INTEGRAÇÃO >> 1.7 DIAS P/ MOSTRAR PEDIDOS NA IMPORTA INTERNET.
  • Botão lateral PEDIDOS: Nessa tela serão carregados os pedidos de acordo com o filtro de datas. Para cada pedido selecionado, na tabela abaixo serão apresentados os itens desse pedido. Selecione os pedidos desejados e clique no botão “PROCESSAR”.
  • O ERP irá iniciar uma série de validações e cálculos de impostos, ao finalizar o processo dos pedidos, será apresentada uma mensagem avisando o usuário.
  • Os pedidos via web se encontrarão na tela de PEDIDOS e a partir de então, eles serão trabalhados normalmente sem diferenciações entre pedidos web ou não.
  • Botão lateral CLIENTES: Ao clicar nesse botão, serão apresentados os clientes que tem ou não pedidos vinculados. É recomendado que sempre seja processado o pedido pois o sistema automaticamente irá processar o cliente atrelado a ele. Caso houver cliente sem pedidos, será necessário marcá-lo e processá-lo para que seu cadastro fique válido no ERP.
  • Botão lateral LISTA DE DESEJOS: O mesmo processo ocorre para lista de presente (ou desejo) importadas pelo integrador Tray. Ao clicar no botão “Lista de Desejos”, serão apresentadas todas as listas pendentes para validação. Ao selecionar a lista escolhida, serão apresentados os produtos vinculados a ela. Clique em processar e o ERP deixará ela como uma lista de desejo válida e disponível. Integração disponível somente para integração Tray.
  • Botão ATUALIZAR PEDIDOS: Processo que realiza uma atualização nos registros pendentes para processar da tela.
  • Botão VISUALIZAR XML: Será apresentado a tela para pesquisar XML trocados entre o ERP e o parceiro web.
  • Botão SISFRETE: Será aberto uma tela que automaticamente percorrerá os pedidos pendentes e indicará uma melhor transportadora de acordo com o parceiro SisFrete.

Como regra, o sistema irá definir uma transportadora que entregue até o mesmo período da transportadora original do pedido por um custo melhor ao lojista. Ao selecionar os pedidos, clique em Trocar Transportadora para que os dados de transporte sejam atualizados.

Atualizar Status WEB.

Vendas >> Pedidos e Orçamentos >> PEDIDO >>Tela [0418] ORÇAMENTO/PEDIDO DE VENDA >> Funções >> Atualização de Status Web > Tela [1110] ATUALIZAÇÃO DE STATUS WEB.

Além da possibilidade de atualizar o status web alterando diretamente um pedido, há a Tela [1110] ATUALIZAÇÃO DE STATUS WEB que possibilita uma atualização em massa dos pedidos.

  • Loja Web: É obrigatório informar a loja web que deseja atualizar o status dos pedidos.
  • Tipo Pedido: O tipo de pedido é obrigatório para que o campo Status Web carregue apenas status vinculados a aquele tipo.
  • Cliente (F2): Campo para pesquisa do cliente por código.
  • Nome: Campo para pesquisa do cliente por nome.
  • Pedido Internet: Campo para pesquisa de um pedido em específico.
  • Tipo: Se é um tipo ORÇAMENTO ou PEDIDO.
  • Período De: Data inicial para pesquisar um pedido importado nesse dia informado.
  • Até: Data final para pesquisar um pedido importado nesse dia informado.

Após carregar os pedidos de acordo com o filtro definido, selecione um ou mais pedidos que deseja atualizar o status web.

Atualizar Para: Campo onde deve informar para qual status web deseja vincular aos pedidos selecionados.

Clique no botão “PROCESSAR” e o ERP irá atualizar todos pedidos com o status desejado e apresentar uma mensagem que o processo foi realizado com sucesso.

Permissões de Acesso.

Atualmente nas integrações com a Tray é possível definir algumas permissões de acesso ao usuário logado no integrador, para configurar tais permissões acesse: Utilitários >> Perfil e Usuários >> Perfil >>Tela [0984] CADASTRO DE PERFIL >> Permissões >> Tela [0645] PEFIL – PERMISSÃO DE ACESSO >> 15. INTEGRAÇÃO WEB.

1.1 PERMITE ENVIAR PRODUTOS: Desmarcando tal opção o botão ENVIAR PRODUTOS no integrador será desabilitado para o usuário vinculado ao perfil.

1.2 PERMITE ENVIAR PREÇO/PROMOÇOES DE PRODUTOS: Desmarcando tal opção o botão ENVIAR PROMOÇÃO no integrador será desabilitado para o usuário vinculado ao perfil.

1.3 PERMITE ENVIAR ESTOQUE DE PRODUTOS: Desmarcando tal opção o botão ENVIAR PREÇOS E ESTOQUE no integrador será desabilitado para o usuário vinculado ao perfil.

1.4 PERMITE ENVIAR NÍVEIS DE CATEGORIAS: Desmarcando tal opção o botão ENVIAR NÍVEIS no integrador será desabilitado para o usuário vinculado ao perfil.

1.5 PERMITE ENVIAR STATUS DE PEDIDOS: Desmarcando tal opção o botão ENVIAR STATUS DOS PEDIDOS no integrador será desabilitado para o usuário vinculado ao perfil.

1.6 PERMITE ENVIAR LISTA DE DESEJOS: Desmarcando tal opção o botão ENVIAR LISTA DE DESEJOS no integrador será desabilitado para o usuário vinculado ao perfil.

2.1 PERMITE IMPORTAR PEDIDOS: Desmarcando tal opção o botão IMPORTAÇÃO DE PEDIDOS no integrador será desabilitado para o usuário vinculado ao perfil.

2.2 PERMITE IMPORTAR CLIENTES: Desmarcando tal opção o botão IMPORTAR CLIENTES SEM PEDIDO no integrador será desabilitado para o usuário vinculado ao perfil.

2.3 PERMITE IMPORTAR LISTA DE DESEJOS: Desmarcando tal opção o botão IMPORTAÇÃO DE LISTAS DE DESEJOS no integrador será desabilitado para o usuário vinculado ao perfil.

2.4 PERMITE IMPORTAR ARQUIVOS: Desmarcando tal opção o botão IMPORTAR XLS no integrador será desabilitado para o usuário vinculado ao perfil.

3. EXPORTAÇÃO DE DADOS AUTOMÁTICO: Desmarcando as opções disponíveis, que são as mesmas descritas acima, a rotina automática de exportação não será iniciada no integrador cujo o usuário vinculado ao perfil estiver logado.

4. IMPORTAÇÃO DE DADOS AUTOMÁTICO: Desmarcando as opções disponíveis, que são as mesmas descritas acima, a rotina automática de importação não será iniciada no integrador cujo o usuário vinculado ao perfil estiver logado.

5. SUGESTÕES DE LOJAS AO INICIAR O INTEGRADOR: Tal opção permite selecionar qual loja web deseja que já venha selecionada no integrador para realizar as importações e exportações. Lembrando tal opção é uma sugestão, o usuário poderá selecionar outras lojas no integrador. Opção disponível somente para o integrador Tray.

Integrações.

A seguir serão apresentadas plataformas de e-commerce utilizadas por clientes que comercializam seus produtos através de lojas virtuais. O integrador (API), faz a conexão entre o sistema Onclick e a plataforma da loja virtual utilizada pelo cliente (ADMIN), levando e trazendo (exportando e importando) informações sobre produtos, clientes e pedidos do sistema Onclick para a plataforma e vice-versa.

Integração E-COMMERCE ou BIS2BIS

Login

Temos os seguintes campos na tela de login da API:

Empresa: Empresa liberada no terminal.

Usuário: Usuário do ERP.

Senha: Senha do usuário do ERP.

Filial: Filiais cadastradas/liberadas para esta empresa.

Loja Web: A demonstração das Lojas WEB é feita por filial, como o cadastro é feito por filial então o usuário precisa selecionar uma filial antes de escolher qual loja ele deseja enviar/receber dados.

Agendamento

O menu Agendamento exibe informações sobre os horários das importações/exportações efetuadas.

Exportações: Nesta coluna são demonstradas quais as exportações (envio) que a API realiza. Exporta informações de Estoque, Preços, Status do pedido e Cadastro de produto do sistema Onclick para a plataforma (ADMIN) da loja virtual do cliente.

Importações: Nesta coluna são demonstradas quais as importações (recebimentos) que a API realiza. Importa informações de Pedido e Clientes da plataforma para o sistema Onclick.

Intervalo: Exibe as Horas e Minutos, configuradas no cadastro de lojas web para que possa ser feita a atualização automática das informações. A configuração é realizada em (Onclick >> Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba Parâmetros Comuns de Integração >> 1. Dados Gerais).

Última Atualização: Exibe a Data e o Horário em que foi realizada a última ExportaçãoImportação de informação pela API.

Próxima Atualização: Exibe a Data e o Horário em que será a realizada a próxima ExportaçãoImportação de informações pela API.

As seguintes informações são enviadas e recebidas pela API:

Estoque: Apresenta a data em que foi realizada a última atualização de estoque, e caso esteja configurado o tempo de agendamento, será exibido quando será realizada a próxima atualização de estoque pela API.

Preços: Apresenta a data em que foi realizada a última atualização de preço, e caso esteja configurado o tempo de agendamento, será exibido quando será realizada a próxima atualização de preço pela API.

Status de Pedido: Apresenta a data em que foi realizada a última atualização de Status do Pedido pela API, e caso esteja configurado o tempo de agendamento, será exibido quando será a próxima atualização de Status pela API.

Cadastro de Produtos: Apresenta a data em que foi realizado o último envio de produtos pela API, não há configuração para envio automático de produtos, por isso nunca exibirá quando será a próxima atualização.

Pedido: Apresenta a data em foi realizada a atualização dos pedidos e caso esteja configurado o tempo de agendamento, será exibido quando será a próxima atualização pela API.

Cliente: Apresenta a data em que foi realizada a atualização dos clientes, e caso esteja configurado o tempo de agendamento, será exibido quando será realizada a próxima atualização.

Exportação de Clientes

O envio dos dados de clientes e vendedores do sistema Onclick para a plataforma (ADMIN) da loja virtual do cliente é realizado através da opção EXPORTAÇÃO DE CLIENTES do Integrador.

Período De..Até: Período em que compreenderá a Data de Cadastro ou Alteração, de Clientes ou Vendedores, para Exportação do sistema Onclick para a plataforma. Caso o campo esteja em branco será utilizada a data e hora do último envio.

Botão Exportar Clientes: O sistema considerará o filtro informado, ou caso não tenha filtro informado considerará a data da última atualização. Neste processo irá enviar os clientes cadastrados no ERP Onclick para a plataforma. Caso seja um cliente novo, esse cliente será cadastrado na plataforma e será retornado um arquivo XML contendo o Código de Referência do Cliente na plataforma (Site Codigo). O Envio de Clientes não permite a configuração “Enviar Por Bloco”. Segue abaixo os campos enviados:

Execucao: Tipo de Operação a ser executada, onde I = Inserir ou A = Alteração.

CodigoEcommerce: Código de Referência do Cliente na plataforma (Site Codigo).

CodigoCliente: Código do cliente no ERP.

DtCadastro: Data de Cadastro no ERP.

TipoCliente: Tipo de Pessoa, onde F = Física ou J = Jurídica.

Empresa: Razão Social do ERP.

ContatoCliente: Descrição (Nome) do Contato que o Cliente tem (Cadastro).

SexoCliente: Sexo do Cliente no ERP.

DtNascCliente: Data de Nascimento no ERP.

EmailCliente: E-Mail do cliente no ERP.

CNPJ/CPF: CNPJ ou CPF do cliente.

IE/RG: Inscrição Estadual ou RG do cliente.

RamoCliente: Ramo de Atividade do Cliente.

PercentualDesc: Porcentagem de Desconto C.R.

EnderecoCliente: Endereço de Faturamento.

NumeroEnd: Número do Endereço de Faturamento.

Complemento: Complemento do Endereço de Faturamento.

BairroCliente: Bairro do Endereço de Faturamento.

CidadeCliente: Cidade do Endereço de Faturamento.

EstadoCliente: Estado do Endereço de Faturamento.

PaisCliente: Pais do Endereço de Faturamento.

CEPCliente: CEP do endereço de Faturamento.

TelefoneCliente: Telefone do Cliente (Enviado apenas se estiver preenchido).

CelularCliente: Celular do Cliente (Enviado apenas se estiver preenchido).

FAXCliente: Fax do cliente (Enviado apenas se estiver preenchido).

ObsCurta: Observação Curta sobre o cliente

Newsletter: Campo se Permite o Envio de E-mail promocional para o cliente.

Comissionado: Caso o campo “% COMISSÃO – A VISTA” esteja com valor maior que 0 é enviado como “T” (True), caso contrário é enviado “F” (False).

Porcentagem: Campo enviado apenas se o “% COMISSÃO – A VISTA” estiver preenchido, é enviada a porcentagem da comissão à vista.

Observação: Observação sobre o cliente.

Vendedor: Enviado o Código do Vendedor do ERP

Botão Exportar Vendedores: O sistema considerará o filtro informado, ou caso não tenha filtro informado considerará a data da última atualização. Neste processo irá enviar os vendedores cadastrados no ERP Onclick para a plataforma. O Envio de Vendedores não permite a configuração “Enviar Por Bloco”. Segue abaixo os campos enviados:

Execução: Tipo de Operação a ser executada, onde I = Inserir ou A = Alteração.

CodigoEcommerce: Código de Referência do Vendedor na plataforma (Site Codigo), este campo só é enviado caso a Execução seja “A”.

Vendedor:Código do Vendedor no ERP.

Nome: Nome do Vendedor.

Email: E-mail do vendedor.

Importação de Clientes

O envio dos dados de clientes da plataforma (ADMIN) da loja virtual do cliente para o ERP Onclick é realizado através da opção IMPORTAÇÃO DE CLIENTES do Integrador.

Período De…Até: Período em que compreenderá a Data de Cadastro ou Alteração de clientes, para importação da plataforma para o sistema Onclick. Caso o campo esteja em branco será considerada a data e hora do último envio.

Botão Importar Clientes: O sistema considerará o filtro informado, ou caso não tenha filtro informado considerará a data da última atualização. Caso o cliente já exista no ERP Onclick, seus dados serão apenas atualizados, caso não exista, seus dados serão gravados na tabela SITE_CLIFOR para posterior processamento. Quando informado o parâmetro da Data Inicial e Final de cadastro dos clientes, será gerado o seguinte arquivo XML:

Codigoecommerce: Código de Referência do Cliente na Plataforma (SITE CODIGO da tabela CLIFOR).

Dtcadastro: Data de Cadastro do Cliente na Plataforma.

Tipocliente: Tipo de Pessoa do Cliente, onde F = Física, e J = Jurídica.

Empresa: Razão Social do Cliente ou Empresa.

Contatocliente: Descrição de Contatos do Cliente.

Sexocliente: Sexo do Cliente (Feminino ou Masculino).

Dtnasccliente: Data de Nascimento do Cliente (informado na Plataforma).

Emailcliente: E-mail de cadastro do Cliente.

CNPJ/CPF: CPF ou CNPJ do Cliente.

IE/RG: Inscrição Estadual ou RG do cliente/empresa.

Ramocliente: Campo não utilizado.

Percentualdesc: Desconto que o cliente pode ter no ERP (Desconto C.R.), valor em percentual.

Enderecocliente: Endereço de Cobrança e de Faturamento do cliente.

Numeroend: Número do Endereço de Cobrança e de Faturamento do cliente.

Complemento: Complemento do Endereço de Cobrança e do Faturamento do cliente.

Bairrocliente: Bairro do Endereço de Cobrança e do Faturamento do cliente.

Cidadecliente: Cidade do Endereço de Cobrança e do Faturamento do cliente.

Estadocliente: Estado do Endereço de Cobrança e do Faturamento do cliente.

Paiscliente: Pais do Endereço de Cobrança e do Faturamento do cliente.

Cepcliente: CEP do Endereço de Cobrança e do Faturamento do cliente.

Telefonecliente: Telefone de Cobrança e de Faturamento do cliente.

Celularcliente: Celular de Cobrança e de Faturamento do cliente.

Faxcliente: FAX do cliente.

Obscurta: Observação curta do cliente e do vendedor.

Formapagamento: Campo Não utilizado.

Newsletter: Campo se Permite o Envio de E-mail promocional para o cliente.

Comissionado: Campo não utilizado.

Porcentagem: Porcentagem de desconto/comissão a Vista.

Observação: Campo Observação do cadastro de cliente.

Vendedor: Campo “Vendedores” do cadastro de cliente.

Exportação de Produtos.

O envio de produtos do sistema Onclick para a plataforma (ADMIN) da loja virtual do cliente é realizado através da opção EXPORTAÇÃO DE PRODUTOS do Integrador.

Neste menu são apresentadas 3 opções, onde cada uma refere-se à informação que será enviada:

Enviar Produtos: Enviará informações sobre o cadastro de produto, como descrição, código, marca, peso, categoria, quantidade do estoque, preço, estoque mínimo, garantia e complemento. Só será exibido o produto pai, mas caso este tenha filho, enviará o produto filho também.

Enviar Estoque: Enviará somente o estoque atual dos produtos que sofreram alteração no estoque, independente deste ser pai ou filho.

Enviar Preços: Enviará somente o preço da tabela de preço dos produtos que sofreram alteração em seu preço, independente deste ser pai ou filho.

Período De…Até: Período em que compreenderá a Data de Cadastro ou Alteração de produtos, para exportação do sistema Onclick para a plataforma. Caso o campo esteja em branco será considerada a data e hora do último envio.

Cód Produto/Barra/Fabricante/Auxiliar: Selecionar a opção que deseja considerar no filtro, entre Código de Produto, Barra, Fabricante ou Auxiliar. Quando informado um valor neste campo, nenhum outro filtro é considerado, todos os outros campos são desabilitados.

Categoria: Níveis de cadastros no ERP liberados para a Loja WEB selecionada.

Marca: Marcas cadastradas no ERP liberadas para a Loja WEB selecionada.

Característica: Características cadastradas no ERP liberadas para a loja WEB selecionada

Enviar Níveis de Categorias ao exportar produtos: Quando selecionado no Envio de Produtos, irá enviar todos os níveis de categoria cadastrados no ERP para a plataforma.

Enviar marcas ao exportar produtos: Quando selecionado no Envio de Produtos, serão enviadas todas as marcas cadastradas no ERP para a plataforma.

Botão Enviar Produtos.

Para exportar os produtos, informe no filtro PERÍODO DE…ATÉ, a data desejada de cadastro ou alteração do produto e/ou informe os dados do(s) produto(s) a serem exportados através dos filtros código do produto, categoria, marca e característica. Clique então em ENVIAR PRODUTOS. Será aberta a Tela EXPORTAÇÃO DE PRODUTOS que listará os produtos pesquisados de acordo com os filtros informados.

Os produtos listados nesta Tela, obedecerão as seguintes regras:

Só serão exibidos produtos pai ou produtos únicos;

Caso seja informado o filtro de data/hora (PERÍODO DE…ATÉ), serão exibidos os itens cadastrados ou alterados no período informado; caso não seja informado o filtro, serão exibidos os itens cadastrados ou alterados desde o último envio até o momento presente, de acordo com o campo DTCAD da tabela PRODUTO; ou

Os itens que sofreram alteração na tabela de preço, de acordo com o campo DATA da tabela referente à tabela de preço utilizada para a loja web; ou

Os itens que sofreram alteração em seu estoque atual, de acordo com o campo DTALTESTOQUE da tabela PRODUTO; ou

Os itens que foram reservados neste período (inclusos em um pedido de venda), de acordo com o campo DTRESERVA da tabela PRODUTO_RESERVA.

A tabela de preço utilizada na loja WEB é a informada no parâmetro 2. TABELA DE PREÇO A ENVIAR em (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba e-commerce). Caso não haja tabela de preço configurada nesta opção, será utilizada a informada no parâmetro 6.TABELA DE PREÇO em (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba Geral >> 6.Tabela de Preço). Caso também não haja tabela de preço informada neste campo, será utilizada a tabela de preço padrão do sistema.

Na Tela EXPORTAÇÃO DE PRODUTOS, selecione os produtos que serão exportados e clique em CONFIRMAR.

O envio começará e será exibido na parte inferior da Tela:

O envio de produtos é realizado considerando-se as seguintes informações:

Serão considerados tanto os campos de data (filtro período de..até), quanto os campos de produto (filtros código do produto, categoria, marca e característica).

Serão enviados somente os produtos cujo cadastro no sistema Onclick esteja com o tipo de produto configurado como ACABADO ou KIT DE PRODUTOS em (Onclick >> Cadastros >> Produtos >> Produtos >> Tela [0293] CADASTRO DE PRODUTOS >> Alterar >> Tela [0324] ALTERAÇÃO DE PRODUTOS >> aba Dados Gerais >> campo Tipo).

Serão enviados somente os produtos cujos os parâmetros ENVIAR PRODUTO PARA O SITE e PRODUTO DISPONÍVEL do cadastro do produto estiverem marcados em (Onclick >> Cadastros >> Produtos >> Produtos >> Tela [0293] CADASTRO DE PRODUTOS >> Alterar >> Tela [0324] ALTERAÇÃO DE PRODUTOS >> aba Integração Web).

Os almoxarifados deverão estar inicializados e o produto deve possuir estoque.

O produto deve ser pai, ou ser um produto único.

O produto deve possuir as informações de peso bruto, peso líquido, largura, altura, comprimento e volume cúbico preenchidos.

Em produtos do tipo kit, quando houver alteração de algum produto que compõe o kit, será enviado o kit também.

O arquivo XML gerado conterá:

Característica: Envia as características cadastradas no ERP, para vinculação entre ERP x Plataforma, pode ser utilizado “Envio Por Bloco” nesta operação, caso o processo dê erro na operação, nenhuma operação irá ser executada. Abaixo os campos enviados:

  • Execucao: Tipo de Operação a ser executada, I – Inserir ou A – Alteração.
  • CodigoEcommerce: Código de Referência no site, só é enviado quando a característica estiver no site (Execução = A).
  • CodigoCaract: Código Interno da Característica (Codigo).
  • DescricaoCaract: Descrição da Característica cadastrada no ERP.

Nível de Categoria: Envia o Nível de Categoria cadastrada no ERP, para vinculação entre ERP x Plataforma, pode ser utilizado “Envio Por Bloco” nesta operação, caso o processo dê erro na operação, nenhuma operação irá ser executada. Abaixo os campos enviados:

  • Execucao: Tipo de Operação a ser executada, I – Inserir ou A – Alteração.
  • CodigoEcommerce: Código de Referência no site, só é enviado quando o nível de categoria já estiver no site (Execução = A).
  • CodigoCategoriaPai: Código do nível de categoria pai, ao qual o nível atual está vinculado.
  • CodigoCategoria: Código interno da tabela de nível de categoria.
  • Categoria: Descrição do Nível de Categoria cadastrado no ERP.

Marcas: Envia as marcas cadastradas no ERP, para vinculação entre ERP x Plataforma, pode ser utilizado “Envio por Bloco” nesta operação, caso o processo dê erro na operação, nenhuma operação irá ser executada. Abaixo os campos enviados:

  • Execucao: Tipo de Operação a ser executada, I – Inserir ou A – Alteração.
  • CodigoEcommerce: Código de Referência no site, só é enviado se a marca já estiver no site (Execução = A).
  • CodigoMarca: Código interno da tabela de marca (fabricante).
  • DescricaoMarca: Descrição da marca cadastrada no ERP.

Produto: Envia os Produtos cadastrados no ERP liberados para a Loja WEB selecionada, nesta operação só serão enviados Produtos Pai e Produtos acabados para vinculação entre ERP x Plataforma, pode ser utilizado “Envio por Bloco” nesta operação, caso o processo dê erro na operação, mais nenhuma operação será executada. Abaixo os campos enviados:

  • Execucao: Tipo de Operação a ser executada, I – Inserir ou A – Alteração.
  • MetaKeywordsProduto: É enviado o Cód.Prod e o campo MetaKeyWords entre “<–“ e “–>”.
  • CodigoeCommerce: Enviado apenas quando o Produto já estiver no site, é o ID Produto (Site Código) da aba “Ecommerce”. (Execução = A).
  • QtdEstoqueProduto: Enviado a quantidade de Estoque atual do Produto ((Almoxarifados + Est.Segurança) – Reserva), caso o produto tenha Fator de Conversão ele será multiplicado pelo valor, o Est. Segurança pode ser configurado para Envio ou não.
  • QtdEstoqueMinimo: Enviado o estoque mínimo configurado no Produto.
  • VrPreco: Valor de Preço de Venda, enviado da tabela de Preço configurado na Loja WEB.
  • VrPrecoPromocional: Valor de Promoção, enviado da tabela de Preço configurado na Loja Web, caso não tenha valor de promoção é enviado o mesmo valor do campo “VrPreco”.
  • InicioPromocao: Data e Hora de início da promoção, enviado da tabela de Preço configurada na Loja WEB, caso não tenha valor de promoção este campo não é enviado e caso não tenha horário, o valor padrão a ser enviado é “00:00:00”.
  • FimPromocao: Data e Hora do fim da promoção, enviado da tabela de Preço configurada na Loja WEB, caso não tenha valor de promoção este campo não é enviado e caso não tenha horário, o valor padrão a ser enviado é “23:59:59”.
  • CodigoMarca: Código de Referência (SITE) da marca.
  • NomeCategoria: Descrição do Nível de Categoria vinculada ao Produto.
  • CodigoProduto: Código de Referência do Produto na plataforma, pode ser configurado entre: Cód.barras, Cód.Produto, Cód. Auxiliar e Cód. Fabricante.
  • NomeProduto: Descrição (SITE) do produto (Descrição do Produto na aba Integração WEB do Cadastro de Produto).
  • PesoProduto: Peso bruto do Produto no ERP.
  • DescricaoProduto: Descrição Curta do produto (Descrição Curta na aba Integração WEB do Cadastro de Produto).
  • DescricaoLongaProduto: Descrição Longa do produto (Descrição longa na aba Integração WEB no Cadastro de Produto).
  • TextoHtml: Texto em HTML do produto (Aba Integração WEB >> aba Descrição HTML), é enviado a informação dentro da tag <![CDATA[]]>
  • DescricaoHTMLProduto: Este campo é enviado branco.
  • DescricaoURLProduto: Este campo é enviado branco.
  • URLTarget: Enviado como T ou F, é o campo “URL Externa” da aba (Integração WEB > Descrição Produto) no cadastro de Produto.
  • Garantia: Campo “Garantia” no cadastro de produto (Integração Web > Descrição Produto > aba E-Commerce), campo texto de livre digitação.
  • Disponibilidade: Campo “Disponibilidade” no cadastro de produto (Integração WEB > Descrição Produto > aba E-Commerce), campo texto de livre digitação.
  • Disponivel: Informa se o produto está disponível ou não na plataforma, se os campos “Produto Disponível” e “Produto Inativo” estiverem marcados, será enviado “F” caso contrário será enviado “T”.
  • MaxParcelasProduto: Este campo é enviado branco.
  • XMLParcelasProduto: Este campo é enviado branco.
  • Lancamento: Campo “Lançamento” no cadastro de produto (“Integração WEB”), caso marcado será enviado “T”, caso contrário será enviado “F”.
  • EmDestaque: Campo “Destaque” do cadastro de produto (“Integração WEB”), caso marcado será enviado T, caso contrário será enviado “F”.
  • CodigoNivelProduto: Código de Referência (SITE) do nível de categoria do produto.
  • CodigoProdutoPai: Código de Referência (SITE) do Produto Pai, caso o produto for filho é enviado o código de referência (SITE_CODPAI), caso seja Pai ou único é enviado zero.
  • OrdemProduto: Ordem de como será demonstrado o produto na plataforma, campo “ORDEM” do cadastro de produto “Integração WEB”.
  • DtVencimento: Data de Vencimento do Produto.
  • Largura: Largura do Produto.
  • Altura: Altura do Produto.
  • Comprimento: Comprimento do Produto.
  • VolCubico: Volume Cúbico do Produto.
  • Classificacao1: Este campo é enviado branco.
  • Classificacao2: Este campo é enviado branco.
  • Classificacao3: Este campo é enviado branco.
  • ClassificacaoAdicional1: Este campo é enviado branco.
  • ClassificacaoAdicional2: Este campo é enviado branco.
  • ClassificacaoAdicional3: Este campo é enviado branco.
  • CodigoCores: Este campo é enviado branco.
  • MaisProduto: Composição do Produto, será enviado separado por vírgula o código do fabricante, para que o cliente possa formar uma composição (de cereal por exemplo) no site.
  • CodigoCategoria: Este campo é enviado fixo “0”.
  • TemFilhos: Caso o produto enviado tenha filho será enviado como “T”, caso não tenha filho (produto único ou é um filho) será enviado como “F”.
  • Campos Personalizados: Pode-se enviar campos Personalizados na API do E-commerce, para isso, o usuário deverá configurar no produto os campos “C_CAMPOEXTRA1”, “C_CAMPOEXTRA2”, “C_CAMPOEXTRA3”, “C_CAMPOEXTRA4”, “C_CAMPOEXTRA5”.
  • DiasEntrega: Campo “Dias para Entrega” do cadastro de Produto.
  • Complemento: Campo “Complemento” do cadastro do Produto.

Produto x Característica: Envia as Característica do Produto, exemplo de um Produto geladeira temos as características “110v”, “220v” e “Bivolt”, são essas as informações enviadas. Pode ser utilizado “Envio por Bloco” nesta operação. Detalhe que só serão enviados os produtos que foram enviados na operação de “Enviar Produtos”. São enviadas as seguintes informações:

  • Execucao: Irá sempre ser enviado como “I” – Inclusao”.
  • CodigoProduto: Código de Referência do Produto.
  • CodigoCaract: Código da Característica do Produto (Grupo2), código interno.
  • ValorCaracProduto: Valor da Característica do Produto (Descrição).

Tabela de Preço: Tabela de Preço configurada no Cadastro de Lojas WEB, por ela o usuário irá enviar a tabela de preço (Valor do Produto e Promoção) para a plataforma, pode ser utilizado “Envio por Bloco” nesta operação.

  • Execucao: Irá sempre ser enviado como “A” – Alteração.
  • CodigoEcommerce: Código de Referência na plataforma (Site Codigo).
  • NomeTabela: Nome da Tabela dentro da plataforma, utilizado para referência entre Tabela de Preço Plataforma x Tabela de Preço ERP. Campo configurado no cadastro de Loja Web.
  • VrPreco: Preço do produto na tabela de preço que está sendo enviado (PrecoVar).
  • Quantidade: Quantidade de produto para compra na plataforma para que a tabela de preço comece a valer, está enviando fixo 1.
  • InicioPromocao: Data e Hora do início da promoção, da tabela de preço a ser enviada. Caso não tenha será enviado em branco.
  • FimPromocao: Data e Hora do fim da promoção, da tabela de preço a ser enviada. Caso não tenha será enviado em branco.
  • VrPrecoPromocional: Valor de Preço da promoção na tabela de preço que está sendo enviada (PROM_VAREJO), caso não tenha informado nada será enviado o mesmo valor da tag “VrPreco” (PrecoVar).

SKU: Igual o Produto, porém só serão enviados os produtos filhos.

Produto x Característica (SKU): Igual o Envio de Produto x Característica, porém serão enviados apenas os produtos filhos que foram enviados no “Produto x Característica”.

Tabela de Preço (SKU): Igual o envio da “Tabela de Preço”, porém serão enviados apenas os produtos filhos que foram enviados no envio “Tabela de Preço”.

Botão Enviar Estoque: A opção Enviar Estoque enviará somente a quantidade de estoque dos produtos que sofreram alteração em seu estoque, de acordo com o campo DTALTESTOQUE da tabela PRODUTO e com o campo DTRESERVA da tabela PRODUTO_RESERVA.

Caso o produto tenha o estoque negativo, será enviado o estoque negativo.

O cálculo do estoque é: Estoque atual + Estoque de Segurança – reserva de estoque.

Esta opção obedecerá as mesmas informações dos filtros, a diferença é que enviará tanto os produtos pai quanto filho.

O arquivo XML gerado:

Execucao: Enviado fixo como “A”, Alteração.

CodigoEcommerce: Código de Referência do produto no site (Site Codigo).

QtdEstoqueProduto: Estoque Atual do produto (entre os almoxarifados configurados, caso não selecione nenhum Almoxarifado, serão todos os Almoxarifados disponíveis para venda. Caso não exista “Múltiplos Almoxarifados” liberado para a base, será utilizado o valor do estoque da tabela de produto). Pode-se enviar o Est. Segurança ou não, dependendo da configuração.

Botão Enviar Preços: A opção Envio de Preços enviará somente a informação do preço de venda do produto que sofreu alteração, atualizando a informação do preço na tabela de venda, de acordo com o campo DATA da tabela TABELADEPREÇO.

O arquivo XML gerado contém:

Execucao: Irá fixo como “A”, Alteração.

CodigoEcommerce: Código de Referência do produto no site (Site Código).

VrPreco: Valor do Produto na tabela de Preço (Na qual o Produto pertence à primeira tabela que ele achar valor para este produto, valor citado é o registro na tabela de preço).

VrPrecoPromocional: Valor de Promoção da tabela de Preço (Na qual o produto pertence ou a primeira tabela que ele achar valor para este produto, semelhante ao “VrPreco” só que o valor encontrado seria na qual o produto tem registro na tabela de preço), caso não tenha valor de promoção é enviado com as mesmas informações do campo “VrPreco”.

InicioPromocao: Enviado apenas se o produto tem Valor de Promoção, é utilizado o preço da tabela de preço a Data/Hora de início da promoção, caso não tenha hora é enviado “00:00:00”.

FimPromocao: Enviado apenas se o produto tem valor de promoção, é utilizado o preço da tabela de preço Data/Hora de fim da promoção, caso não tenha hora é enviado “23:59:59”.

O envio de produtos, ou atualização de preços ou estoque, gerará um arquivo XML, o qual poderá ser visualizado no sistema Onclick em (Utilitários >> Utilitários >> Visualizar XML Web >> Tela [0968] PESQUISA DE XML >> selecionar o arquivo >> Abrir XML).

Importação de Produtos

O envio de produtos da plataforma (ADMIN) da loja virtual do cliente para o sistema Onclick é realizado através da opção IMPORTAÇÃO DE PRODUTOS do Integrador.

Botão Importar Níveis

Será importado da plataforma todos os Níveis de Categorias para cadastro no ERP. Abaixo as informações presentes da Importação:

Site Codigo: Código de Referência do Nível de Categoria no Site.

CodPai: Código de Referência do Nível de Categoria PAI no Site.

CodFilho: Código de Referência do Nível de Categoria do Filho no site.

Descrição: Descrição do Nível de Categoria.

Botão Importar Característica: O sistema importará da plataforma as características para cadastro no ERP. Abaixo as informações presentes da Importação:

Site Codigo: Código de Referência da Característica no site.

Codigo: Código da Característica para o ERP (Campo não utilizado).

Descrição: Descrição da Característica.

Botão Importar Produtos: O sistema importará da plataforma todos os Produtos para cadastro no ERP (utilizado geralmente quando é cliente que já utiliza uma plataforma ECommerce), nesta importação são considerados o Nível de Categoria e as Característica para importação. Abaixo as informações presentes da Importação:

Execucao: Código de Referência da Característica no site.

Nomecategoria: Código da Característica para o ERP (Campo não utilizado).

Codigocategoria: Descrição da Característica.

Codigoecommerce: Código de Referência do Produto na plataforma (Site código).

Codigoproduto: Código do Fabricante ou Código Auxiliar do Produto (depende da configuração no cadastro de lojas web “Código de Referência”, os códigos de barras e de produtos não foram implementados neste método).

Nomeproduto: Descrição do Produto (e do Site).

Pesoproduto: Peso Bruto do Produto.

Descricaoproduto: Descrição Curta do Produto.

Descricaolongaproduto: Descrição Longa do Produto.

Textohtml: Texto em HTML do Produto (aba Integração Web >> Descrição HTML). Descricaohtmlproduto: Descrição em HTML do produto (aba Integração Web > E-Commerce > Descrição HTML).

Descricaourlproduto: Campo não utilizado.

Metakeywordsproduto: Palavras chave do produto (aba “Integração Web > E-Commerce > Meta KeyWords*” do cadastro de produto).

Urltarget: URL Externa do produto (CheckBox da aba “Integração Web” do cadastro de produto).

Codigonivelproduto: Nível de Categoria do produto.

Qtdestoqueproduto: Estoque atual do Produto (A Informação é salva apenas na tabela de produto).

Qtdestoqueminimo: Estoque Mínimo do produto.

Disponivel: Produto Disponível na Plataforma (ChecBox da aba “Integração Web” do cadastro de produto).

Vrcusto: Custo do Produto (Campos salvos: VrCompraVar, CustoVar, CustoMedio, VrCompra_Medio).

Vrpreco: Valor de Venda (PrecoVar da tabela de Venda do produto)

Vrprecopromocional: Valor de Venda em Promoção (Prom_Varejo).

Iniciopromocao: Data de Início da Promoção

Fimpromocao: Data do Fim da Promoção

Maxparcelasproduto: Max Parc (Informação salva na aba “Integração Web” do cadastro de produto) – Número máximo de parcelas para pedidos que incluam este produto.

Xmlparcelasproduto: XML Parc. (Informação salva na aba “Integração Web” do cadastro de produto) – Identifica o número de parcelas utilizadas para exibir o parcelamento na página que lista os produtos em XML.

Lancamento: Informa se o produto é um Lançamento na plataforma.

Emdestaque: Informa se o produto é para ficar em destaque na plataforma.

Imagemproduto: URL da imagem principal.

Imagemdetalhe: URL da imagem em detalhes.

Imagemampliada: URL da imagem ampliada.

Classificacao1: Não utilizado.

Classificacao2: Não utilizado.

Classificacao3: Não utilizado.

Classificacaoadicional1: Não utilizado.

Classificacaoadicional2: Não utilizado.

Classificacaoadicional3: Não utilizado.

Codigocores: Não utilizado.

Ordemproduto: Campo destinado para o integrador saiba qual a sequência de apresentação do produto no site.

Codigoprodutopai: Código de Referência do produto na plataforma.

Maisproduto: Código de Referência do produto na plataforma separado por vírgula, neste campo informa qual a composição para a montagem deste produto (utilizado para a MyMix, formando um produto tigela com X cereais).

Imagemampliada: URL da imagem ampliada.

Classificacao1: Não utilizado.

Classificacao2: Não utilizado.

Classificacao3: Não utilizado.

Classificacaoadicional1: Não utilizado.

Classificacaoadicional2: Não utilizado.

Classificacaoadicional3: Não utilizado.

Codigocores: Não utilizado.

Ordemproduto: Identifica qual a sequência de apresentação do produto no site.

Codigoprodutopai: Código de Referência do produto na plataforma.

Maisproduto: Código de Referência do produto na plataforma separado por vírgula, neste campo informar qual a composição para a montagem deste produto (utilizado para a MyMix, formando um produto tigela com X cereais diferentes).

Dtvencimento: Data de Vencimento do Produto.

12.1.7 Importação de Pedidos

A importação de Pedidos de Venda da plataforma (ADMIN) da loja virtual do cliente para o sistema Onclick é realizada através da opção IMPORTAÇÃO DE PEDIDOS do Integrador.

A importação é realizada respeitando-se os parâmetros da data início e data fim informados na Tela. Informe a data desejada e clique em IMPORTAÇÃO DE PEDIDOS. Começará a leitura dos pedidos inclusos ou alterados dentro do período informado, após o término da importação, será exibida a mensagem: Leitura dos Pedidos concluída. Caso o parâmetro de data seja deixado em branco, será considerada a data da última atualização até a hora atual.

A importação dos pedidos é realizada importando-se o cabeçalho do pedido de venda, os itens do pedido, e a forma de pagamento, tudo em um único arquivo XML. Quando há mais de um item no pedido, o cabeçalho é duplicado no arquivo XML.

Os pedidos importados serão exibidos na Tela [0013] IMPORTAÇÃO DE PEDIDOS INTERNET do sistema Onclick em (Tela inicial >> Pedidos via web >> Tela [0013] IMPORTAÇÃO DE PEDIDOS INTERNET). Para que sejam importados para a Tela de Pedido de Venda, e consequentemente para a tabela CPED, é necessário clicar em Processar.

  • Se o pedido de venda já estiver no sistema Onclick e for processado o mesmo período, o pedido será importado novamente, sendo realizadas as alterações caso haja, como endereço de entrega, valor do pedido, observação, razão social, frete, etc; porém seus dados serão atualizados somente se o parâmetro Atualizar status ao receber um Pedido Existente estiver marcado em (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba E-commerce >> 1.7 Atualizar status ao receber um Pedido Existente), e o tipo do pedido não for do tipo fixo, em (Vendas >> Tabelas diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE PEDIDO >> Status Web >> aba Integração Web >> campo FIXO marcado);
  • O tipo do pedido verificado será o do cabeçalho;
  • Se o pedido estiver aguardando o processamento na Tela [0013] IMPORTAÇÃO DE PEDIDOS INTERNET, as alterações serão realizadas independente das configurações.

Quando ocorre a importação de pedidos, algumas informações são atualizadas no banco de dados do Onclick, são elas:

Na Tabela SITE_CLIFOR:

Se o cliente já existir, será alterado. Se não existir, será incluso.

A busca pelo cliente será comparando o campo CPF/CNPJ do arquivo XML e o campo CPF/CNPJ da tabela SITE_CLIFOR, ou o campo EMAIL do arquivo XML com o campo EMAIL da tabela EMAILCLIENTE.

Campo na Tabela SITE_CLIFOR Tag no Arquivo XML
RAZSOCIAL Preenchido com a informação do campo EMPRESA ou NOMECLIENTE
CNPJ_CPF Preenchido com a informação do campo CPF/CNPJ
ID Utiliza o generator SITE_CLIFOR
PROCESSAR Passa a ser T fixo.
PESSOAFJ Preenchido com F ou J
CEP Preenchido com a informação do campo CEPCLIENTE
RGIE Preenchido com a informação do campo RG/IE
ENDEREÇO Preenchido com a informação do campo ENDEREÇOCLIENTE
NUMERO Preenchido com a informação do campo NUMEROEND
COMPLEMENTO Preenchido com a informação do campo COMPLEMENTO
BAIRRO Preenchido com a informação do campo BAIRROCLIENTE
CIDADE Preenchido com a informação do campo CIDADECLIENTE
UF Preenchido com a informação do campo ESTADOCLIENTE
TELEFONE Preenchido com a informação do campo TELEFONE CLIENTE
EMAIL Preenchido com a informação do campo EMAILCLIENTE
DATAHORA Preenchido com a informação do campo DTPEDIDO
CONTATO Preenchido com a informação do campo NOMEENTREGA
ENDENT Preenchido com a informação do campo ENDSEREÇOENTRADA
NRENDENT Preenchido com a informação do campo NUMEROENDENTREGA
COMPLENT Preenchido com a informação do campo COMPLEMENTOENTREGA
BAIRROENT Preenchido com a informação do campo BAIRROENTREGA
CIDADEENT Preenchido com a informação do campo CIDADEENTREGA
UFENT Preenchido com a informação do campo ESTADOENTREGA
TELTRAB Preenchido com a informação do campo TELEFONEENTREGA
FAX Preenchido com a informação do campo FAXENTREGA
DTNASCTO Preenchido com a informação do campo DTNASCCLIENTE
EMAIL_CONTATO Preenchido com a informação do campo EMAILENTREGA
PAIS Preenchido com a informação do campo PAISCLIENTE
TIPOCLIENTE É fixo C (consumidor)
OBSERVAÇÃO Preenchido com a informação do campo OBSCLIENTE

Na tabela SITE_CPED:

Os dados do pedido serão inclusos, ou alterados caso já existam.

Campo na Tabela SITE_CPED
NRPEDIDO Preenchido com a informação do campo NUMERO PEDIDO
TIPO_IMPORTACAO Fixo = 5 – corresponde ao e-commerce
ATENDIMENTO Preenchido com a informação do campo WEB_ATENDIMENTO da Tabela WEBLOJAS
EMPRESA Preenchido com a informação do campo CODIGO da tabela CONFIG
CLIENTE Preenchido com a informação do campo ID da tabela SITECLIFOR
CNPJ_CPF Preenchido com a informação do campo CPF/CNPJ do arquivo XML
DATAHORA Preenchido com a informação do campo DTPEDIDO do arquivo XML
DATA Preenchido com a informação do campo DTPEDIDO do arquivo XML
HORA Preenchido com a informação do campo DTPEDIDO do arquivo XML
RAZSOCIAL Preenchido com a informação do campo RAZSOCIAL da tabela SITE_CLIFOR
BAIRRO Preenchido com a informação do campo BAIRROENT da tabela SITE_CLIFOR
CEP Preenchido com a informação do campo CEPENT
CIDADE Preenchido com a informação do campo CIDADEENT
ENDERECO Preenchido com a informação do campo ENDENT
NRENDERECO Preenchido com a informação do campo NRENDENT
COMPLEMENTO Preenchido com a informação do campo COMPLENT
EMAIL Preenchido com a informação do campo NOMEENTREGA
FANTASIA Preenchido com a informação do campo FANTASIA
PESSOAPJ Preenchido com a informação do campo PESSOAFJ
RGIE Preenchido com a informação do campo RGIE
TELEFONE Preenchido com a informação do campo TELEFONE
UF Preenchido com a informação do campo UFENT
TIPOPEDIDO P fixo
FORMAPAGTO Preenchido com a informação do campo PAGAMENTO do arquivo XML
CARTAO Preenchido com a informação do campo CARTAO do arquivo XML
QTDEPARCELAS Preenchido com a informação do campo PARCELAS do arquivo XML
VRFRETE Preenchido com a informação do campo FRETE do arquivo XML
VREMBALAGEM Formado por VALOREMBALGEM + OUTRAS DESPESAS do arquivo XML
VALOR Formado por Soma do total dos itens + valor de frete + valor da embalagem – desconto. O “desconto é composto pelo total dos itens – valor do pedido”.
VRPRODUTOS Formado por Soma dos itens do Pedido
PARCEIRO Preenchido com a informação do campo PARCEIRO do arquivo XML
NRCONHECIMENTO Preenchido com a informação do campo CODSEDEX do arquivo XML
VERSAOAPI Versão exe
USUARIO Preenchido com O código do usuário logado
CONDPAGTO Preenchido com A QUANTIDADE DE DIAS do cartão de crédito
TIPOPEDIDO Preenchido com Código do Tipo. É buscado pela descrição e Web loja. DESCRIÇÃO vem no campo STATUS do XML
STATUS Preenchido com Descrição do tipo de pedido
TRANSPORTADORA Se o campo transportadora do xml estiver preenchido ele busca pelo cadastro da transportadora o campo SITE_NOME, se ele achar o registro ele grava no campo TRANSPORTADORA o código, e o campo frete escolhido será preenchido com o nome da transportadora que vem no XML
PAIS Preenchido com a informação do campo PAIS ENTREGA
DTFATURA Preenchido com a informação do campo DTENTREGA do arquivo XML

Tabela SITE_IPED

Campo na tabela SITE_IPED
CLIENTE Preenchido com a informação do campo CLIENTE da tabela SITE_CPED
EMPRESA Preenchido com a informação do campo CÓDIGO da tabela CONFIG referente à empresa logada
ALMOXARIFADO Preenchido com a informação do campo WEB_ALMOXARIFADO da tabela WEBLOJA
NRPEDIDO Preenchido com a informação do campo NRPEDIDO da tabela SITE_CPED
PRODUTO Preenchido com a informação do campo Preenchido com a informação do campo CODIGOECOMMERCE do arquivo XML
QUANTIDADE Preenchido com a informação do campo QTDITENS do arquivo XML
VRUNITARIO Preenchido com a informação do campo PRECOUNITARIO do arquivo XML
PCDESCONTO Preenchido com a informação do campo DESCONTOTOTALSF do arquivo XML. Valor unitários dos produtos – Valor do pedido (sem frete) = (acha a diferença em reais e calcula a porcentagem para aplicar nesse campo).
NRPEDIDO_CPED Preenchido apenas quando o pedido já foi processado
ATENDIMENTO Preenchido com a informação do campo WEBLOJA da tabela CONFIG

A estrutura do arquivo XML gerado:

NumeroPedido: Número do Pedido na plataforma.

DtPedido: Data do Pedido na Plataforma.

Status: Descrição do Status na Plataforma.

NomeCliente: Nome do Cliente (Do Pedido).

EmailCliente: E-mail do Cliente (Do Pedido).

CPF/CNPJ: CPF ou CNPJ do Cliente (Do Pedido).

DtNascCliente: Data de Nascimento do Cliente (Do Pedido).

Transportadora: Transportadora do Pedido (Campo Site Nome do Cadastro de Transportadora).

TelefoneCliente: Telefone do Cliente (Do Pedido).

EnderecoCliente: Endereço do Cliente (Do Pedido – no Cabeçalho do Pedido).

NumeroEnd: Número do Endereço (Do Pedido – no Cabeçalho do Pedido).

Complemento: Complemento do Endereço (Do Pedido – no Cabeçalho do Pedido).

BairroCliente: Bairro do Endereço (Do Pedido – no Cabeçalho do Pedido).

CidadeCliente: Cidade do Endereço (Do Pedido – no Cabeçalho do Pedido).

EstadoCliente: Estado do Endereço (Do Pedido – no Cabeçalho do Pedido).

CEPCliente: CEP do Endereço (Do Pedido – no Cabeçalho do Pedido).

PaisCliente: Pais do Endereço (Do Pedido – no Cabeçalho do Pedido).

NomeEntrega: Nome Para quem vai entregar o Pedido.

EmailEntrega: E-mail de Entrega do Pedido.

TelefoneEntrega: Telefone de Entrega do Pedido (Informação no Cadastro do Cliente).

EnderecoEntrega: Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

NumeroEndEntrega: Número do Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

ComplementoEntrega: Complemento do Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

BairroEntrega: Bairro do Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

CidadeEntrega: Cidade do Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

EstadoEntrega: Estado do Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

CEPEntrega: CEP do Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

PaisEntrega: Pais do Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

TotalSemFrete: Valor Total do Pedido sem o valor do frete.

ValorTotal: Valor total do Pedido.

PesoTotal: Peso total do Pedido (Bruto).

Frete: Valor de frete do Pedido.

OutrasDespesas: Valor de Outras despesas do Pedido.

DescontoTotalSF: Porcentagem de Desconto do Pedido (Sem o Frete).

Pagamento: Forma de Pagamento do Pedido (Vem descrito Boleto ou Cartao).

Cartao: Cartão utilizado para compra no pedido (Visa, MasterCard, PagSeguro, Etc, pode ser configurado no Cadastro de Cartão do ERP o DEPARA).

Valor: Campo não utilizado.

RefProduto: Código de Referência do Produto (não utilizado).

CodigoEcommerce: Código do Produto (Site Codigo).

PrecoUnitario: Valor Unitário do Produto (Na Plataforma).

QtdItens: Quantidade de Itens Comprados do Produto (caso o Produto tenha Fator de Conversão é multiplicado pelo fator de conversão).

PrecoUnitarioBruto: Campo não utilizado.

12.1.8 Atualização de Status

A opção Atualização de Status envia as informações de status do pedido de venda e da nota fiscal de venda do sistema Onclick para a plataforma ADMIN.

Para atualizar o status, no Integrador, clique em ATUALIZAÇÃO DE STATUS.

Serão enviados os Pedidos não faturados e as Notas Fiscais de Venda.

Pedido de Venda

Serão atualizados os pedidos cuja data de alteração na tabela CPED (campo DTALTERACAO), esteja dentro do período informado no filtro Período de…até, ou caso não haja período informado, dentro do horário da última atualização até a hora atual;

O campo FIXO do tipo do pedido de venda deve estar desmarcado;

O tipo do pedido não pode ser faturado;

Deve existir o número do pedido internet.

 

Nota Fiscal de Venda

Serão atualizados os status das notas fiscais cuja data de inclusão ou data de alteração (campo DATA e DTALTERACAO da tabela CNF) esteja dentro do período informado no filtro Período de…até, ou caso não haja período informado, dentro do horário da última atualização até a hora atual;

O campo Pedido Internet tem que estar preenchido.

O arquivo XML terá a seguinte estrutura:

NumeroPedido: Número do Pedido na plataforma.

ObsCurta: Observação Curta da Nota Fiscal ou do Pedido.

Status: Status do pedido no ERP.

  • Para a Nota Fiscal: Caso tenha código de rastreio envia o código configurado no tipo de pedido para o rastreio, pegando do tipo de pedido a configuração do ERP x Plataforma.
  • Para o Pedido: Enviado a mesma informação que vem do site (Status Internet).

CodSedex: Código de rastreio do objeto (Número de Conhecimento). Para o Pedido é enviado em branco.

Serie: Série da Nota Fiscal processada no ERP. Para o pedido é enviado em branco.

NumeroDaNota: Número da Nota Fiscal processada no ERP. Para o pedido é enviado em branco.

Especie: Espécie da Nota Fiscal processada no ERP (Tipo Caixa / Embalagem / etc..) é um campo em String.

PesoTotal: Peso bruto dos itens da Nota Fiscal processada no ERP. Para o pedido é enviado em branco.

ValorTotal: Valor total da Nota Fiscal processada no ERP. Para o pedido é enviado em branco.

DataDaNota: Data de processamento da Nota Fiscal no ERP. Para o pedido é enviado em branco.

ChaveNFe: Chave de Acesso da Nota Fiscal gerada no ERP. Este campo não é enviado quando é pedido.

No tipo de Pedido Faturado, há a opção ‘com rastreio’ e ‘sem rastreio’, em (Vendas >> Tabelas diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE PEDIDO >> tipo FATURADO >> aba Integração WEB). Se a opção ‘com rastreio’ estiver preenchida, irá considerar também o número de conhecimento (NRCONHECIMENTOFRETE da tabela CNF).

Se os dois campos estiverem preenchidos, será verificado primeiro se não tem número de rastreio na Nota, para enviar o status configurado sem rastreio. Se estiver preenchido o número de rastreio na Nota, irá utilizar o status configurado com rastreio.

Observações

Em todo o processo de atualização de ESTOQUE, PREÇO, PRODUTO, STATUS e PEDIDO é atualizada a data da última atualização de agendamento com o horário atual e, são somados os minutos configurados para a atualização automática segundo o cadastro da Loja Web em (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba e-commerce >> 1.Dados Gerais).

Quando não é informada a data inicial, é utilizada a data da última atualização, e se a data final não é preenchida é utilizada a data e hora atual.

Na configuração de Loja Web existe a configuração: Utiliza envio de produto por bloco em (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba e-commerce >> 1.10 Utiliza envio de produto por bloco). Quando marcada será enviada a quantidade definida no item 1.11 Quantidade de XML enviado por bloco por arquivo XML, se estiver desmarcado é enviado tudo em um arquivo XML apenas (para a mesma operação).

12.2 Integração FAST

12.2.1 Login

Temos os seguintes campos na tela de login do Integrador Fast:

Empresa: Empresa liberada pelo Terminal.

Usuário: Usuário do ERP.

Senha: Senha do ERP.

Filial: Filiais cadastradas/liberadas para esta empresa.

Loja Web: A demonstração das Lojas WEB é feita por filial, como o cadastro é feito por filial então é necessário selecionar uma filial antes de escolher qual loja ele deseja enviar/receber dados.

12.2.2 Agendamento

Atualmente no Integrador FAST é possível configurar rotinas automáticas para Importação de Pedidos, Atualização de Preço, Atualização de Estoque e Atualização de Status.

Tal configuração deve ser realizado no ERP acessando: (Utilitários >> Configurações >> Sistema >> Tela [0030] Configurações do Sistema >> Lojas Web >> Tela [0962] Cadastro de Lojas Web >> Aba FAST >> 1. Dados Gerais).

Como é possível visualizar na imagem acima na grid de agendamento temos informações de quais foram os últimos envios e quais serão os próximos envios. Hoje temos as seguintes informações sobre envios automático e manuais no Integrador FAST:

Exportações: Neste campo são exibidas quais as exportações (envio) que o Integrador FAST realiza (estoque, preços, status do pedido, cadastro de produto).

Importações: Neste campo são demonstrados quais as importações (recebimentos) que o Integrador FAST realiza (pedido).

Intervalo: Horas e Minutos configurável no cadastro de Lojas Web para que possa ser realizada a atualização automática das informações.

Lembrando que a atualização automática ocorre apenas se o Integrador FAST estiver em execução, caso o mesmo estiver fechado a atualização automática não será iniciada conforme configurado na loja web.

Última Atualização: Data e Horário que foi realizado a última ExportaçãoImportação do processo pelo Integrador FAST.

Próxima Atualização: Data e Horário que a próxima ExportaçãoImportação será realizada para receber ou enviar as informações, tal coluna estará preenchida apenas se no ERP estiver configurada a rotina para envio automático.

As seguintes informações são enviadas e recebidas pela API hoje:

Estoque: Apresenta quando foi realizada a última atualização de Estoque e caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima atualização pelo Integrador.

Preços: Apresenta quando foi realizada a última atualização de Preço e caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima atualização pelo Integrador.

Status de Pedido: Apresenta quando foi realizado a última atualização de Status do Pedido pelo Integrador FAST e caso esteja configurada a rotina automática, será exibida quando será enviado a próxima atualização de Status pelo Integrador.

Cadastro de Produtos: Apresenta quando foi realizado o último envio de produtos pelo Integrador Fast, não há configuração para envio automático de produtos por isso nunca irá demonstrar quando será a próxima atualização.

Pedido: Apresenta quando foi realizado a Importação do(s) pedidos e caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima baixa do(s) pedido(s) pelo Integrador.

12.2.3 Exportação de Produtos

Tal função permite o envio de Produtos, Preços e Estoque cadastrados no ERP para a Plataforma.

Hoje temos os seguintes parâmetros para Exportação de Produtos:

Período De..Até: Período em que compreenderá a Data de Cadastro ou Alteração, de Clientes ou Vendedores, para Exportação do sistema Onclick para a plataforma. Caso o campo esteja em branco será utilizada a data e hora do último envio.

Cód Produto/Barra/Fabricante/Auxiliar: Pode ser selecionado no combo o que o usuário deseja que considere no filtro, Código de Produto, Barra, Fabricante ou Auxiliar.

Categoria: Níveis cadastrados no ERP para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro.

Marca: Marcas cadastradas no ERP liberadas para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro.

Grupo: Grupos cadastrados no ERP liberados para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro. Esse filtro será apresentado apenas se a integração não trabalhar com multivalorados definido no cadastro de loja web conforme segue: (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> Aba FAST >> 2.1 Trabalha com multivalorados).

Subgrupo: Subgrupos cadastrados no ERP liberados para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro. Esse filtro será apresentado apenas se a integração não trabalhar com multivalorados definido no cadastro de Loja Web.

Característica: Características cadastradas no ERP liberadas para a loja WEB selecionada. Caso seja selecionado “Todos”, irá trazer todas as características.

Informação: Informações cadastradas no ERP liberadas para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro. Esse filtro será apresentado apenas se a integração não trabalhar com multivalorados definido no cadastro de Loja Web.

Ao clicar em Enviar Produtos, temos os seguintes envios atrelados a ele:

Produto: Envia os Produtos cadastrados no ERP com liberação para a Loja WEB selecionada considerando os filtros inseridos pelo usuário, nesta operação só serão enviados Produtos Pai e Produtos Acabados para vinculação entre ERP x Plataforma. Abaixo os campos enviados:

Comando: Tipo de Operação a ser executada, I – Inserir ou A – Alteração.

MetaKeywordsProd: É enviado o Cód.Prod e o campo MetaKeyWords entre “<–“ e “–>”.

IDProduto: Enviado apenas quando o Produto já tiver no site, é o ID Produto (Site Código).

Estoque: Enviado a quantidade de Estoque atual do Produto ((Almoxarifados + Est.Segurança) – Reserva).

EstoqueMinimo: Enviado o estoque mínimo configurado no Produto.

Preco: Valor de Preço de venda, enviado da tabela de Preço configurado na Loja WEB.

PrecoProm: Valor de Promoção, enviado da tabela de Preço configurado na Loja Web.

PrecoB2B: Valor de Preço de venda, enviado da tabela de preço B2B configurado na Loja WEB.

PrecoB2BProm: Valor de promoção de venda, enviado da tabela de preço B2B configurado na Loja WEB.

DataPromInicio: Data e Hora de início da promoção, enviado da tabela de Preço configurado na Loja WEB, caso não tenha valor de promoção este campo não é enviado e caso não tenha horário, o valor padrão a ser enviado é “00:00:00”.

DataPromFim: Data e Hora do fim da promoção, enviado da tabela de Preço configurado na Loja WEB, caso não tenha valor de promoção este campo não é enviado e caso não tenha horário, o valor padrão a ser enviado é “23:59:59”.

NomeCat: Descrição do Nível de Categoria vinculada ao Produto caso preenchido.

CodProd: Código de Referência do Produto na plataforma, pode ser configurado entre: Cód.barras, Cód.Produto, Cód. Auxiliar e Cód. Fabricante.

NomeProd: Descrição (SITE) do produto (Descrição do Produto na aba Integração WEB do Cadastro de Produto).

Peso: Peso bruto do Produto no ERP.

Descricao: Descrição Curta do produto (Descrição Curta na aba Integração WEB do Cadastro de Produto).

DescrLonga: Descrição Longa do produto (Descrição longa na aba Integração WEB no Cadastro de Produto).

DescrHTM: Indica o nome do arquivo HTML contendo descrição adicional do produto. O conteúdo do arquivo HTM será incluído na posição da tag especial <DescrHTM>, caso esta tag exista no arquivo personalizado de exibição do layout de produtos na loja (EstiloProduto.htm). Será considerado do campo Descrição HTML.

DescrURL: URL para mais detalhes do produto. Será considerado do campo URL de Apoio.

URLTarget: Enviado como True ou False é o campo “URL Externa” da aba “Integração WEB >> Descrição Produto” no cadastro de Produto.

Disponivel: Informa se o produto está disponível ou não na plataforma se os campos “Produto Disponível” e “Produto Inativo” estiverem marcado será enviado “False” caso contrário “True”.

MaxParcelasProd: Número máximo de parcelas para pedidos que incluam este produto.

XMLParcelasProd: Identifica o número de parcelas utilizadas para exibir o parcelamento na página que lista os produtos em XML.

Lancamento: Campo “Lançamento” no cadastro de produto (“Integração WEB”), caso marcado é enviado “True” se não é “False”.

EmDestaque: Campo “Destaque” do cadastro de produto (“Integração WEB”), caso marcado é enviado “True” se não é “False”.

IDProdutoPai: Código de Referência (SITE) do Produto Pai, caso o produto for filho é enviado o código de referência (SITE_CODPAI), caso for produto Pai ou único é enviado zero.

OrdemProd: Ordem de como será demonstrado o produto na plataforma, campo “ORDEM” do cadastro de produto “Integração WEB”.

Adicional1: ID para informação adicional sobre o produto, indicado em Descritor especial 1. Se multivalorado colocar entre vírgulas.

Adicional2: ID para informação adicional sobre o produto, indicado em Descritor especial 2. Se multivalorado colocar entre vírgulas.

Adicional3: ID para informação adicional sobre o produto, indicado em Descritor especial 3. Se multivalorado colocar entre vírgulas.

AdicionalD1: Texto da informação adicional sobre o produto, indicado em Descritor simples 1. Se multivalorado, colocar entre vírgulas.

AdicionalD2: Texto da informação adicional sobre o produto, indicado em Descritor simples 2. Se multivalorado, colocar entre vírgulas.

AdicionalD3: Texto da informação adicional sobre o produto, indicado em Descritor simples 3. Se multivalorado, colocar entre vírgulas.

Cores: ID das cores disponíveis no produto.

MaisProd: Composição do Produto, enviado separado por virgula o código de referência configurado no cadastro de loja web, para que o cliente possa formar uma composição (de cereal por exemplo) no site.

IDCategoria: ID interno da categoria cadastrada.

SKU: Igual o Produto, só que é enviado aqui apenas os produtos filhos que foram enviados no Produto.

Ao clicar em Enviar Preço, o sistema irá considerar os filtros da data da última atualização até o momento, considerando o(s) produto(s) alterado(s) e enviando para a plataforma:

Comando: Irá fixo como “A”, Alteração.

IDProduto: Código de integração do produto, campo ID Produto da aba Integração Web.

Preco: Valor do Produto na tabela de preço.

PrecoProm: Valor de Promoção da tabela de Preço.

DataPromInicio: Enviado apenas se o produto tem Valor de Promoção, é considerado da tabela de preço a Data/Hora de início da promoção, caso não tenha hora é enviado “00:00:00”.

DataPromFim: Enviado apenas se o produto tem valor de promoção, é considerado da tabela de preço Data/Hora de fim da promoção, caso não tenha hora é enviado “23:59:59”.

Ao clicar em Enviar Estoque o sistema irá considerar o filtro de data da última atualização até a hora atual. O XML de envio compõe os seguintes envios:

Comando: Enviado fixo como “A”, Alteração.

IDProduto: Código de integração do produto, campo ID Produto da aba Integração Web.

Estoque: Estoque Atual do produto. Caso for negativo, será enviado fixo 0.

12.2.4 Importação de Produtos

Botão Importar Descritores: O sistema pegará da plataforma todos os cadastros de descritores e salvar no ERP de acordo com a configuração informada de cada propriedade do descritor no cadastro de loja web. Serão importadas as seguintes informações: Categorias, AdicionalD1, AdicionalD2, AdicionalD3 e Cores.

Botão Importar Produtos: O sistema importará da plataforma todos os Produtos para cadastro no ERP (utilizado geralmente quando o cliente já utiliza uma plataforma FAST), nesta importação pode ser considerado o filtro de Categoria e Referencia, Nome ou Descrição para importação. Abaixo as informações presentes da Importação:

COMANDO: Comando de inclusão (I) ou alteração (A).

NOMECAT: Nome da categoria vinculada ao produto.

IDCATEGORIA: ID da categoria vinculada ao produto.

IDPRODUTO: Código de integração do produto na plataforma (Site código).

CODPROD: Código do Fabricante, Código Auxiliar do Produto ou Código de Barras (Depende da configuração no cadastro de lojas web “Código de Referência”).

CODBARRASPROD: Caso o campo estiver em branco, o código de barras será informado o Código do Produto.

NOMEPROD: Nome do produto.

PESO: Peso Bruto do Produto.

DESCRICAO: Descrição Curta do Produto.

DESCRLONGA: Descrição Longa do Produto.

DESCRHTM: Texto em HTML do Produto.

DESCRURL: URL do produto para mais detalhes.

METAKEYWORDSPROD: Palavras chave do produto.

URLTARGET: URL Externa do produto (CheckBox da aba “Integração Web” do cadastro de produto).

ESTOQUE: Estoque atual do Produto (A Informação é salva apenas na tabela de produto).

ESTOQUEMINIMO: Estoque Mínimo do produto.

DISPONIVEL: Produto Disponível na Plataforma (ChecBox da aba “Integração Web” do cadastro de produto).

CUSTO: Custo do Produto (Campos salvos: VrCompraVar, CustoVar, CustoMedio, VrCompra_Medio).

PRECO: Valor de Venda (PrecoVar da tabela de Venda do produto na TAB00001).

PRECOPROM: Valor de Venda em Promoção (Prom_Varejo da tabela de venda do produto na TAB00001).

DATAPROMINICIO: Data de Início da Promoção (Tabela de venda TAB00001).

DATAPROMFIM: Data do Fim da Promoção (Tabela de venda TAB00001).

MAXPARCELASPROD: Max Parc (Informação salva na aba “Integração Web” do cadastro de produto) – Número máximo de parcelas para pedidos que incluam este produto.

XMLPARCELASPROD: XML Parc. (Informação salva na aba “Integração Web” do cadastro de produto) – Identifica o número de parcelas utilizadas para exibir o parcelamento na página que lista os produtos em XML.

LANCAMENTO: Informa se o produto é um Lançamento na plataforma.

EMDESTAQUE: Informa se o produto é para ficar em destaque na plataforma.

IMAGEMPROD: URL da imagem principal.

IMAGEMDET: URL da imagem em detalhes.

IMAGEMAMP: URL da imagem ampliada.

ADICIONAL1: Descritor especial 1.

ADICIONAL2: Descritor especial 2.

ADICIONAL3: Descritor especial 3.

ADICIONALD1: Descritor simples 1.

ADICIONALD2: Descritor simples 2.

ADICIONALD3: Descritor simples 3.

CORES: Cor cadastrada no produto.

ORDEMPROD: Campo destinado para o integrador saiba qual a sequência de apresentação do produto no site.

IDPRODUTOPAI: Código de Referência do produto na plataforma.

MAISPROD: Código de Referência do produto na plataforma separado por vírgula, neste campo informa qual a composição para a montagem deste.

DATAVENCIMENTO: Data de Vencimento do Produto.

12.2.5 Importação de Pedidos

Botão Importação de Pedidos: O Integrador irá considerar o filtro informado, ou caso não tenha filtro informado será considerada a data da última atualização até a hora atual para importar os pedidos inclusos ou alterados na plataforma. Na importação de pedidos da plataforma para a onclick, é feito a baixa do Cabeçalho do Pedido, dos itens dos pedidos e da forma de pagamento, tudo em um único XML. Quando vem mais de um item no pedido o cabeçalho é duplicado (no xml) e na parte que vem os produtos é alterado, então a API grava somente o Item do pedido.

No Integrador OCS FAST só é possível baixar uma forma de pagamento. Caso o Pedido já exista no ERP será atualizado (se o pedido não for do tipo “Fixo”). A Estrutura do XML é a seguinte:

Núm: Número do Pedido na plataforma.

Feito Em: Data do Pedido na Plataforma.

Nome: Nome do comprador.

E-Mail: E-mail do comprador.

Empresa: Empresa do comprador.

Cpf/Cnpj: CPF ou CNPJ do comprador.

Rg/Ie: RG ou IE do comprador.

Logradouro: Endereço do comprador.

Endereço Número: Número do Endereço.

Endereço Complemento: Complemento do Endereço do comprador.

Bairro: Bairro do Endereço do comprador.

Cidade: Cidade do Endereço do comprador.

Estado: Estado do Endereço do comprador.

País: Pais do Endereço do comprador.

Cep: CEP do Endereço comprador.

Telefone: Telefone do Comprador.

Fax: Fax do comprador.

Nascido Em: Data de nascimento do comprador.

Obs Cliente: Alguma observação que o comprador deseja informar.

Nome Pedido: Nome Para quem vai entregar o Pedido.

E-Mail Pedido: E-mail de Entrega do Pedido.

Logradouro Pedido: Endereço de Entrega do Pedido

Endereço Número Pedido: Número do Endereço de Entrega do Pedido.

Endereço Complemento Pedido: Complemento do Endereço de Entrega do Pedido.

Bairro Pedido: Bairro do Endereço de Entrega do Pedido

Cidade Pedido: Cidade do Endereço de Entrega do Pedido

Estado Pedido: Estado do Endereço de Entrega do Pedido

País Pedido: Pais do Endereço de Entrega do Pedido

Cep Pedido: CEP do Endereço de Entrega do Pedido

Telefone Pedido: Telefone do endereço de entrega do pedido.

Fax Pedido: Fax do endereço de entrega do pedido.

Total Sem Frete: Valor Total do Pedido sem o valor do frete.

Frete: Valor de frete do Pedido.

Pagamento: Forma de Pagamento do Pedido (Vem descrito Boleto ou Cartão).

Cartão: Cartão utilizado para compra no pedido (Visa, MasterCard, PagSeguro, etc, pode ser configurado no Cadastro de Cartão do ERP o DE/PARA).

Parcelas: Quantidade de parcelas do pedido.

Status: Status atual do pedido.

Obs Pedido: Observação do pedido.

Entregue Em: Previsão de entrega do pedido.

Obj Sedex: Código de rastreio do pedido.

Ref. Produto: Código de Referência do Produto.

Nome Produto: Nome do produto comprado.

Msg Cliente: Comentários feitos pelo cliente.

Local De Entrega: Local de entrega do pedido.

Parceiro: Quando o pedido foi feito através de um parceiro, informa o nome do parceiro.

Thisftransacao: Código de transação com cartão de crédito recebido da Thisf, se a loja utiliza.

Esp1: Informação adicional sobre o produto, indicado em Descritor especial 1.

Esp2: Informação adicional sobre o produto, indicado em Descritor especial 2.

Esp3: Informação adicional sobre o produto, indicado em Descritor especial 3.

Simp1: Informação adicional sobre o produto, indicado em Descritor simples 1.

Simp2: Informação adicional sobre o produto, indicado em Descritor simples 2.

Simp3: Informação adicional sobre o produto, indicado em Descritor simples 3.

Descontototalsf: Porcentagem de Desconto do Pedido (Sem o Frete).

Presente: Se o produto é para presente.

Valor embalagem: Valor para a embalagem de presente.

Cor: Cor solicitada do produto.

Desconto cupom: Valor em reais do desconto no pedido.

Idproduto: ID interno do produto.

Qtd: Quantidade de itens do produto.

Preço Unit: Preço unitário do produto.

12.2.6 Atualização de Status

Botão Enviar Status do Pedido: O Integrador irá considerar o filtro informado, ou caso não tenha filtro informado será considerada a data da última atualização até a hora atual. A atualização de Status é realizada para pedidos e notas alteradas no período informado no filtro. Para que o status do Pedido seja enviado o Tipo de pedido deve estar devidamente configurado e atrelado a um Status Web nas configurações do ERP: (Vendas >> Tabelas Diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE PEDIDO >> Status Web >>Tela [1109] CADASTRO DE STATUS WEB >> Aba Integração Web).

O XML de envio compõe dos seguintes envios:

NumPedido: Número do Pedido na plataforma.

ObsCurta: Observação Curta da Nota Fiscal ou do Pedido.

Status: Status do pedido no ERP.

Para a Nota Fiscal: Caso tenha código de rastreio envia o código configurado no tipo de pedido para o rastreio, pegando do tipo de pedido a configuração do ERP X Plataforma.

Para o Pedido: Envia a mesma informação que vem do site (Status Internet).

ObjSedex: Código de rastreio do objeto (Número de Conhecimento). Para o Pedido é enviado em branco.

12.3 Tray

12.3.1 Login

Temos os seguintes campos na tela de login do Integrador TRAY:

Empresa: Empresa liberada pelo Terminal.

Usuário: Usuário do ERP.

Senha: Senha do ERP.

Filial: Filiais cadastradas/liberadas para esta empresa.

Caso possua mais de uma loja Web Cadastrada, após logado no Integrador o usuário poderá selecionar a loja Web que deseja.

12.3.2 Agendamento

Atualmente no Integrador TRAY é possível configurar rotinas automáticas para Importação de Pedidos, Atualização de Preço e Estoque, Atualização de Status, Exportação e Importação de Lista de Desejo e Importação de Clientes sem Pedidos.

Tal configuração deve ser realizado no ERP acessando: (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> Aba Parâmetros Comuns de Integração >> 1. Dados Gerais).

Lembrando que a configuração é válida para todas as lojas Web cadastradas. Como é possível visualizar na imagem acima na grid de agendamento temos informações das lojas web carregadas e quais foram seus últimos envios e quais serão os próximos envios. Hoje temos as seguintes informações sobre envios automático e manual no Integrador TRAY:

ID da Loja: Informação do ID da loja disponibilizado pela Plataforma Tray.

Tal informação é cadastrada no ERP acessando: (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> Aba Parâmetros Por Integração >> Aba Geral >> 2.3 ID Loja).

Nome da Loja: Nome da Loja. Tal informação é cadastrada no ERP acessando: Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> Aba Parâmetros Por Integração >> Aba Geral >> 2.2 Nome da Loja.

Exportações: Neste campo são exibidas quais as exportações (envio) que o Integrador Tray realiza.

Importações: Neste campo são exibidas quais as importações (recebimentos) que o Integrador Tray realiza.

Intervalo: Horas e Minutos configurados no cadastro de Lojas Web para que possa ser realizada a atualização automática das informações, caso não esteja configurado no ERP tal coluna ficará em branco.

Lembrando que a atualização automática ocorre apenas se o Integrador Tray estiver em execução, se o mesmo estiver fechado a atualização automática não será iniciada conforme configurado na loja web.

DT. Última Atualização: Data e Horário que foi realizada a última ExportaçãoImportação do Processo.

DT. Próxima Atualização: Data e Horário que a próxima ExportaçãoImportação será realizada para receber ou enviar as informações, tal coluna estará preenchida apenas se no ERP estiver configurada a rotina para envio automático.

As seguintes informações são enviadas e recebidas pelo Integrador Tray:

Preço e Estoque: Apresenta quando foi realizada a última atualização de Preço e Estoque e caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima atualização pelo Integrador Tray.

Promoção: Apresenta quando foi realizada a última atualização de Promoção e caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima atualização pelo Integrador Tray.

Produto: Apresenta quando foi realizado o último envio de produtos pelo Integrador Tray, não há configuração para envio automático de produtos por isso nunca irá demonstrar quando será a próxima atualização.

Lista de Desejos (Exportação): Apresenta quando foi realizada a última atualização de Lista de Desejo na plataforma e caso esteja configurado a rotina automática, será demonstrado quando será realizada a próxima atualização de Lista de desejos alterados no ERP.

Lista de Desejos (Importação): Apresenta quando foi realizada a última importação (baixa) de Lista de Desejos da plataforma, caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima importação de Lista de Desejos.

Status de Pedido: Apresenta quando foi realizado a última atualização de Status do Pedido pelo Integrador Tray e caso esteja configurado a rotina automática, será demonstrado quando será enviado a próxima atualização de Status pelo Integrador.

Pedido: Apresenta quando foi realizado a Importação do(s) pedidos e caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima baixa do(s) pedido(s) pelo Integrador.

Cliente: Apresenta quando foi realizado a Exportação do(s) cliente(s) da plataforma, caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima exportação.

 

12.3.3 Importação de XLS

Tal opção permite a importação de um arquivo em formado XLS (excel) fornecido pela plataforma para inserção de produtos no ERP.

Hoje temos os seguintes parâmetros para Importação de XLS:

Loja Web: Informar para qual loja será a importação do arquivo XLS.

Localização: Pasta onde estão os arquivos para importação, os arquivos a serem importados são:

dados_categoria.xls

dados_marcas.xls

dados_caracteristica.xls

dados_produto.xls

dados_grade.xls

dados_categorias_produtos.xls

dados_varia.xls

produtos_descricao.xls

Botão Importar XLS: ” O sistema irá considerar o filtro informado, e irá realizar a importação de todos os produtos contidos no arquivo XLS, abaixo a listagem da importação realizada:

Nível de Categoria: Importará o nível de categoria contido no arquivo XLS (dados_categoria.xls) para o ERP, campos utilizados do XLS:

Id_Categoria: Id da Categoria na plataforma (Site Código).

Id_CategoriaPai: Id da Categoria PAI na plataforma.

Descricao: Descrição do Nível da Categoria.

Ativo: Informação se a Categoria está Ativa na plataforma (S – Sim / N – Não).

Marcas: Importará todas as marcas contidas no arquivo XLS (dados_marcas.xls) para o ERP, campos utilizados do XLS:

ID_Marca: ID da marca na plataforma (Site Código).

Descricao: Descrição da Marca.

Ativo: Informação se a marca está Ativa na plataforma (S – Sim / N – Não).

Característica: Importará todas as características contidas no arquivo XLS (dados_caracteristica.xls) para o ERP, campos utilizados do XLS:

ID_Caracteristica ID da característica na plataforma (Site Código).

Descrição: Descrição da Característica.

Ativo: Informação se a característica está Ativa na plataforma (S – Sim / N – Não).

Produto: Importará todos os produtos contidos no arquivo XLS (dados_produto.xls) para o ERP, campos utilizados do XLS:

Id_Produto: Código de Referência do Produto na Plataforma (Site Código).

Id_Marca: Código de Referência da marca na plataforma.

Id_Fornecedor: Código de Referência do Fornecedor na plataforma.

Cod_Referencia: Código de Referência do Produto na plataforma (Campo não utilizado, pois enviamos o Cód.barras, Auxiliar, Produto ou Fabricante).

Descricao: Descrição Site do Produto na Plataforma.

Descricao_Curta: Descrição Longa do Produto.

Custo: Valor de Custo do Produto.

Moeda_custo_Aux: Campo não utilizado.

Custo_auxiliar: Campo não utilizado.

Preco: Preço de Venda do Produto.

Peso_cubico: Peso Cubico do Produto (Dividido por 1000 quando importado para o ERP).

Disponivel: Informa se o produto está Disponível ou não na plataforma.

Garantia: Garantia do Produto (Campo de Livre digitação).

Disponibilidade: Disponibilidade do produto (Campo de Livre digitação).

Estoque: Estoque atual do Produto.

Estoque_Minimo: Estoque Mínimo na Plataforma.

Destaque: Informa se o Produto está em “DESTAQUE” na plataforma.

Data_Cadastro: Data de Cadastro do produto na plataforma (Consideramos a mesma data para cadastrado no ERP).

Info_Preco: Campo não utilizado.

Ativo: Informa se o produto está ativo na plataforma (Consideramos este campo para deixar ativo no ERP).

Marca: Campo não utilizado.

Preco_Oferta: Valor de Promoção na plataforma.

Inicio_Oferta: Data de Início da Promoção na plataforma.

Fim_Oferta: Data de Fim da Promoção na plataforma.

Grade (Produto SKU): Importará todas as variações (SKU) contidos no arquivo XLS (dados_grade.xls) para o ERP (Detalhe desta importação, que ele irá considerar o Pai já cadastrado na Importação de Produtos para considerar os campos não presentes deste XLS, então esta importação é uma amarração entre Produto Pai X Filho), campos utilizados no XLS:

Id_Grade: Código de Referência do Produto Filho (SKU) na Plataforma.

ID_Produto: Código de Referência do Produto na Plataforma.

Peso: Peso Bruto e Liquido do produto (Dividido por 1000 para o ERP).

Peso_Cubico: Peso Cubico do Produto (Dividido por 1000 para o ERP).

Custo: Valor de Custo do Produto.

Preco: Valor de Venda do Produto.

Estoque: Estoque atual do produto.

Categoria do Produto: Irá importar todos os Níveis de Categorias por Produto (vinculação de Nível Categoria x Produto), contidos no arquivo XLS (dados_categorias_produtos.xls) para o ERP, campos utilizados no XLS:

ID_Produto: Código de Referência do Produto na plataforma.

ID_Categoria: Código de Referência do Nível de Categoria na plataforma.

Característica de Valor: Irá importar todas as características dos Produtos (vinculação de Característica x Produto), contidos no arquivo XLS (dados_varia.xls) para o ERP, campos utilizados no XLS:

ID_Grade: Código de Referência do Produto (SKU) na plataforma.

ID_Caracteristica: Código de Referência da Característica na Plataforma.

Valor: Valor da Característica (Exemplo 110v).

Ativo: Informação se a marca está Ativa na plataforma (S – Sim / N – Não).

HTML: Irá importar todas as informações em HTML do Produto no arquivo XLS (produtos_descricao.xls) para o ERP, campos utilizados no XLS:

ID_Produto: Código de Referência do Produto na plataforma.

Descricao: Descrição HTML do Produto.

12.3.4 Exportação de Produtos

Tal função permite o envio de Produtos, Preços e Estoque, Promoções e Níveis de Categoria cadastros no ERP para a Plataforma.

Hoje temos os seguintes parâmetros para Exportação de Produtos:

Período De: Data Inicial de Cadastro ou Alteração de produtos para exportação para a plataforma. Caso o campo esteja em branco será considerado a data e hora do último envio.

Até: Data Final de cadastro ou alteração de produtos para exportação para a plataforma. Caso esteja em branco será considerado a data e hora atual do envio.

Cód. Produto/Barra/Fabricante/Auxiliar: Pode ser selecionado no combo o que o usuário deseja que considere no filtro. Quando informado um valor no campo nenhum outro filtro é considerado, todos os outros campos de filtro desabilitam e limpam as informações (caso tenha).

Categoria: Níveis cadastrados no ERP para a Loja WEB selecionada. Caso selecionado “Todos” não irá considerar o filtro.

Marca: Marcas cadastradas no ERP liberadas para a Loja WEB selecionada. Caso selecionado “Todos” não irá considerar o filtro.

Característica: Características cadastradas no ERP liberadas para a loja WEB selecionada. Caso selecionado “Todos” não irá considerar o filtro.

Loja Web: Irá demonstrar todas as Lojas WEB carregadas pela API. Caso selecionado “<NENHUM>” a API não irá buscar nenhuma informação.

Botão Enviar Produtos temos os seguintes envios atrelados a ele:

Marcas: Envia as marcas cadastradas no ERP, para vinculação entre ERP x Plataforma. A marca é enviada através do método “fWSCadastraMarca”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

Id_Marca: Código de Referência da marca na plataforma (Site Codigo), caso for enviado 0 será cadastrado na plataforma e retornado neste campo o ID de referência.

Descricao: Descrição da Marca.

Ativo: Informação se a marca está Ativa na plataforma (S – Sim / N – Não).

Característica: Envia as características cadastradas no ERP, para vinculação entre ERP x Plataforma. A característica é enviada através do método “fWSCadastraCaracteristica”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

ID_Caracteristica: Código de Referência da característica na plataforma (Site Codigo).

Descricao: Descrição da característica.

Ativo: Informação se a característica está Ativa na plataforma (S – Sim / N – Não).

Status: Status da operação – pode ser: “ok” ou “no”, enviamos em branco.

ID_Caracteristica (out): Código de Referência da característica na plataforma (Site Codigo) caso for enviado 0 será cadastrado na plataforma e retornado neste campo o ID de referência.

Perfil: Envia os perfis cadastrados no ERP para vinculação entre ERP x Plataforma. O Perfil é enviado através do método “fWSCadastraPerfil”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

ID_Perfil: Código de referência do perfil na plataforma (Site Codigo), caso for enviado 0 será cadastrado na plataforma e retornado neste campo o ID de referência.

Descricao: Descrição do Perfil.

Ativo: Informação se o perfil está ativo na plataforma (S – Sim / N – Não), sempre enviamos como “S”.

Perfil X Característica: Envia as características de perfis relacionadas no ERP para vinculação entre ERP x Plataforma. A vinculação de Característica de Perfil é feita através do método “fWSRelacionaCaractPerfil”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

ID_Perfil: Código de referência do Perfil na plataforma.

ID_Caracteristica: Código de referência da característica na plataforma.

Status (Out): Retorno do processo executado, caso dê erro, neste campo irá retornar “NO” (da Tray) e entendemos que não conseguiu processar essa solicitação.

Chaves (Out): Retorno dos ID´s de perfil e característica separados por ‘pipe’ – ex: “123|456” (Enviamos em branco o campo e não consideramos nada do retorno).

Nível Categoria X Perfil: Envia o relacionamento de Nível de Categoria por perfis do ERP para vinculação entre ERP x Plataforma. A vinculação de nível de categoria por Perfil é feita através do método “fWSRelacionaCategPerfil”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

ID_Perfil: Código de Referência do Perfil na plataforma (Site Código).

ID_Caracteristica: Código de Referência do Nível de Característica na Plataforma (Site Código).

Status (Out): Retorno do processo executado, caso dê erro, neste campo irá retornar “NO” (da Tray) e entendemos que não conseguiu processar essa solicitação.

Chaves (Out): Retorno dos ID´s de perfil e categoria separados por ‘pipe’ – ex: “123|456” (Enviamos em branco o campo e não consideramos nada do retorno).

Produto: Envia os Produtos cadastrado no ERP com liberação para a Loja WEB selecionada, considerando os filtros inseridos pelo usuário, nesta operação só serão enviados Produtos Pai e Produtos acabados para vinculação entre ERP x Plataforma. O produto é enviado através do método “fWSCadastraProduto”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

id_produto: Código de Referência do Produto na plataforma (Caso seja enviado “0” será retornado o código cadastrado na plataforma).

id_marca: Código de Referência da Marca na plataforma (Site Código).

id_fornecedor: Código de Referência do Marca na plataforma (Site Código), é a mesma informação do campo “ID_MARCA”.

cod_referencia: Código de Referência utilizado no ERP para envio para a plataforma (Pode-se utilizar o Código do Fabricante, Auxiliar ou de Barras).

Descricao: Descrição Site do produto na plataforma, caso o campo estiver em branco será enviado o campo “DESCRICAO” + “OBSERVAÇÃO” do cadastro de produto.

descricao_curta: Descrição Curta do Site do produto.

custo: Valor do custo do produto em Real – formato: “0.00” (Enviamos em branco o campo).

moeda_custo_aux: Formato de moeda auxiliar – ex: “US$” (Enviamos em branco o campo).

custo_auxiliar: Valor do custo do produto da moeda auxiliar – formato: “0.00” (Enviamos em branco o campo).

preco: Valor unitário do Produto (PrecoVar da tabela de preço padrão).

peso_cubico: Peso Cubico do produto.

peso: Peso Bruto ou Peso Liquido do produto, depende da configuração do cadastro de lojas Web (Tipo de Peso).

disponivel: Informa se o produto está disponível ou não na plataforma (N – Não / S – Sim).

informacao: Array com informações para geração da descrição longa nas abas corretas (Enviamos o Texto em HTML neste objeto).

garantia: Informa a Garantia do Produto (É um campo de livre digitação).

disponibilidade: Informação sobre Disponibilidade do produto (É um campo de livre digitação).

estoque: Estoque Atual do Produto (Considerando os Almoxarifados liberados ou caso não tenha o módulo de Múltiplos Almoxarifados é enviado da tabela de produto).

estoque_minimo: Estoque Mínimo do produto.

prazo_entrega: Prazo de Entrega do produto (enviamos 0).

frete_desconto: Valor de desconto para frete – (campo não utilizado, tanto pela Tray como pela ONCLICK).

destaque: Flag para setar produto em destaque – pode ser “S” ou “N”

data_cadastro: Data de cadastro do produto padrão japonês sem hífen – ex: “20091116”

info_preco: Informação de parcelamento do valor do produto – (campo não utilizado, tanto pela Tray como pela ONCLICK).

ativo: Liberação do produto – pode ser: “S” ou “N” – caso “N” com ID: exclui registro do produto.

  • Caso tenha mais de uma Loja WEB e entre elas uma é secundária da loja que acabou de enviar o produto, o sistema irá informar o mesmo Site Código para o produto enviado pela loja principal.

Produto (Lançamento): Se o produto enviado estiver com a flag “LANÇAMENTO” marcada, o sistema irá verificar se existe alguma característica cadastrada como “TRAY” e irá enviar pelo método “fWSCadastraDadosProduto” que o produto é um lançamento. Detalhe importante a ser notado é que na Tray é obrigatório que exista uma característica chamada “TRAY” e o valor de envio na tag “valor” tem que ser lançamento. Abaixo os campos enviados através do método “fWSCadastraDadosProduto”:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

ID_Produto: Código de Referência do Produto na plataforma (Site Código).

ID_Caracteristica: Código de Referência da Característica na plataforma (Site Código).

Valor: Valor da característica de produto (Será enviado fixo “LANCAMENTO”.

Status (Out): Status da operação – pode ser: “ok” ou “no”

Chaves (Out): Retorno dos ID´s de caracteristica e produto separados por ‘pipe’ – ex: “123|456”

Produtos (Altura/Largura/Comprimento): Este processo irá chamar o webservice para cada operação de envio de informações adicionais (Altura, Largura ou Comprimento), o método a ser utilizado é o “fWSDadosRecursosExtras”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

ID_Registro: Código de Referência do produto no site (Site Código), pode ser o produto ou uma variação.

Entidade: Nome do alvo para alteração – pode ser: “produtos” ou “grade”, enviamos sempre “produtos” neste caso.

Campo: Nome do campo que será realizado a alteração (dimensao:largura, dimensao:altura ou imensao:comprimento).

Valor: Valor do campo para alteração.

Promoção: Irá enviar o valor de Preço e Promoção do produto atual sendo processado, o método de envio é o “fWSAtualizaPrecoProduto”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

is_grade: Flag para identificação de variação – pode ser: “S” ou “N” (“S” = ID da variação e “N” = ID do produto)

id_produto: Código de Referência do Produto no site (Site Código), conforme a flag “is_grade”.

preco: Preço do produto em Real – formato: “0.00”

precopromo: Preço em promoção do produto em Real – formato: “0.00”.

data_inicio: Data inicial de promoção em padrão japonês – ex: “2009-11-16”.

data_termino: Data final de promoção em padrão japonês – ex: “2009-11-16”.

Produto (SKU/Variação): O Envio de SKU (Variação) é semelhante ao de produto, é realizado pelo método “fWSCadastraGradeProduto” e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

id_grade: Código de Referência do produto no site (Site Código), caso enviado 0 será cadastrado na plataforma e retornado neste campo o código do cadastro.

id_produto: Código de Referência do produto no site (Site Código Pai).

cod_referencia: Código de referência do produto – campo não utilizado.

peso: Peso da variação em Kg (Pode ser o Peso Bruto ou Liquido, o cliente configura qual deseja enviar no cadastro de loja web).

peso_cubico: Peso cúbico da variação em Kg.

custo: Valor do custo da variação em Real – formato: “0.00”.

preco: Preço da variação em Real – formato: “0.00”.

estoque: Estoque da variação.

ativo: Liberação da variação – pode ser: “S” ou “N” – Caso “N” com ID da grade: exclui variação.

SKU/Variação (Altura/Largura/Comprimento): Este processo irá chamar o webservice para cada operação de envio de informações adicionais (Altura, Largura ou Comprimento), o método a ser utilizado é o “fWSDadosRecursosExtras”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

ID_Registro: Código de Referência do produto no site (Site Código), pode ser o produto ou uma variação.

Entidade: Nome do alvo para alteração – pode ser: “produtos” ou “grade”, enviamos sempre “grade” neste caso.

Campo: Nome do campo que será realizado a alteração (dimensao:largura, dimensao:altura ou imensao:comprimento).

Valor: Valor do campo para alteração.

Promoção da SKU: Irá enviar o valor de Preço e Promoção do produto atual sendo processado, o método de envio é o “fWSAtualizaPrecoProduto”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

is_grade: Flag para identificação de variação – pode ser: “S” ou “N” (“S” = ID da variação e “N” = ID do produto).

id_produto: Código de Referência do Produto no site (Site Código), conforme a flag “is_grade”.

preco: Preço do produto em Real – formato: “0.00”.

precopromo: Preço em promoção do produto em Real – formato: “0.00”.

data_inicio: Data inicial de promoção em padrão japonês – ex: “2009-11-16”.

data_termino: Data final de promoção em padrão japonês – ex: “2009-11-16”.

Valor na Característica do Produto: Responsável pela atribuição de um valor para a característica. É obrigatório que o produto esteja configurado em uma Categoria onde o Perfil possua a característica configurada. É enviado pelo método “fWSCadastraDadosProduto”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

id_produto: Código de Referência do produto na plataforma (Site Código).

id_caracteristica: ID da característica de produto.

valor: Valor da característica de produto.

status: Status da operação – pode ser: “ok” ou “no”.

chaves: Retorno dos ID´s de característica e produto separados por ‘pipe’ – ex: “123|456”.

Botão Enviar Preço e Estoque: O Integrador irá considerar os filtros informados, caso nenhum filtro seja informado será considerada a data da última atualização até o momento, considerando o(s) produto(s) alterado(s) e enviando para a plataforma.

O Primeiro a ser enviado é o Estoque seguido pelo Preço, tanto de produtos acabados como de SKU (Variação).

Envio de Estoque: O Envio de estoque é feito pelo método “fWSAtualizaEstoqueProduto”, não enviamos estoque negativo, então caso um produto esteja com estoque negativo é enviado 0 de estoque. O método “fWSAtualizaEstoqueProduto” é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

is_grade: Flag para identificação de variação – pode ser: “S” ou “N” (“S” = ID da variação e “N” = ID do produto).

id_produto: Código de Referência do Produto (Site Código), pode ser uma variação ou um produto único.

estoque: Quantidade de estoque do produto.

estoque_minimo: Quantidade mínima de estoque do produto.

Produto Disponível: Responsável por alterar a disponibilidade (disponível ou não disponível) de produto específico. Logo após enviar o Estoque verificamos a quantidade de estoque do produto e se for maior que zero (0) tentamos ativar ele na plataforma, o método responsável por isso é o “fwsAtualizaProdutoDisponivel”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

id_produto: Código de Referência do produto na plataforma (Site Código).

disponivel: Flag de disponibilidade – pode ser: “0” para não disponível ou “1” para disponível.

Envio de Preço: O Envio de preço é feito pelo método “fWsAtualizaPrecoProduto”, irá ser realizado a atualização de preço na plataforma, o método é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

is_grade: Flag para identificação de variação – pode ser: “S” ou “N” (“S” = ID da variação e “N” = ID do produto).

id_produto: Código de Referência no produto na plataforma (Site Código).

preco: Preço do produto em Real – formato: “0.00”.

precopromo: Preço em promoção do produto em Real – formato: “0.00”.

data_inicio: Data inicial de promoção em padrão japonês – ex: “2009-11-16”.

data_termino: Data final de promoção em padrão japonês – ex: “2009-11-16”.

Botão Enviar Promoção: O sistema irá considerar os filtros informados, caso nenhum filtro seja informado será considerada a data da última atualização até o momento considerando o(s) produto(s) alterado(s) e enviando para a plataforma.

Este método irá enviar o valor de Preço e Promoção dos produtos, o método de envio é o “fWSAtualizaPrecoProduto”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

is_grade: Flag para identificação de variação – pode ser: “S” ou “N” (“S” = ID da variação e “N” = ID do produto).

id_produto: Código de Referência do Produto no site (Site Código), conforme a flag “is_grade”.

preco: Preço do produto em Real – formato: “0.00”.

precopromo: Preço em promoção do produto em Real – formato: “0.00”.

data_inicio: Data inicial de promoção em padrão japonês – ex: “2009-11-16”.

data_termino: Data final de promoção em padrão japonês – ex: “2009-11-16”.

Botão Enviar Níveis: O sistema considerará todos os níveis de categorias cadastrado no ERP para envio. O método de enviar Nível de Categoria é o “fWSCadastraCategoria”, e é constituído dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

id_categoria: Código de Referência da Categoria na plataforma (Caso seja enviado 0 será cadastrado o novo nível de categoria na plataforma).

id_categoriapai: Código de Referência do Nível de Categoria Pai (Caso seja enviado 0, entende-se que é o principal nível, ou o pai).

descricao: Nome da categoria.

ativo: Liberação da categoria – pode ser: “S” ou “N”. Enviamos sempre como “S”.

12.3.5 Importação de Pedidos

Sumário

Glossário 4

1 INTRODUÇÃO 6

2 CONFIGURAÇÕES 7

2.1 Habilitação do Módulo 7

2.2 Configurações Lojas WEB 8

3 CADASTROS 21

3.1 Cadastros vinculados ao Produto 21

3.1.1Cadastro de Perfil 21

3.1.2 Cadastro Nível de Produto 22

3.1.3 Cadastro de Marca 27

3.1.4 Cadastro de Características 29

3.1.5 Cadastro de Produtos 31

3.2 Vinculação Produto Pai e Filho 42

3.3 Cadastro Automático de SKUs 44

4 LISTA DE PRESENTES OU LISTA DE DESEJOS 49

5 TIPOS DE PEDIDO 52

6 STATUS WEB 54

6.1 Configurações 54

6.2 Processos 59

7 FORMA DE PAGAMENTO 64

8 VISUALIZAR XML 66

9 PROCESSAR PEDIDO WEB 68

10 ATUALIZAR STATUS WEB 70

11 PERMISSÕES DE ACESSO 72

12 INTEGRAÇÕES 74

12.1 Integração E-COMMERCE ou BIS2BIS 74

12.2 Integração FAST 108

12.3 Tray 122

12.4 Integração VTEX 152

12.5 Integração IKEDA/RAKUTEN 167

12.5.4 Importação de Pedidos 178

13 SIGEP WEB 184

Glossário

SKU: O termo Stock Keeping Unit (SKU), em português Unidade de Manutenção de Estoque está ligado à logística de armazém e designa os diferentes itens do estoque, estando normalmente associado a um código identificador. Um posto de gasolina, por exemplo, pode trabalhar com quatro SKUs (gasolina sem chumbo, com chumbo, aditivada e diesel) e um hipermercado pode trabalhar com 60 mil SKUs, pois qualquer diferença na mercadoria (tamanho, cor, sabor, etc), mesmo sendo de uma mesma marca, representa um SKU diferente. (Extraído de http://pt.wikipedia.org/wiki/Stock_Keeping_Unit).

Produto Pai: Produto principal que aparece no site (como uma vitrine), porém não contêm estoque, já que o produto pai nunca é vendido, são vendidos os seus filhos.

Ele obrigatoriamente deve conter variações (de tamanho, cor, etc), estas variações são seus filhos. Por exemplo, uma camiseta seria o produto principal (produto pai). A camiseta P, a camiseta M e a camiseta G, os produtos filhos. O estoque do produto pai exibido no site corresponde a soma de todos os produtos filhos deste item.

Produto Filho: Variação de um produto que está vinculada a um produto pai. Por exemplo, os tamanhos de um calçado (37 ,38, 39, etc), são todos produtos filhos.

Outro exemplo de produto pai e filho:

Camiseta Feminina – produto pai

Camiseta Feminina P – produto filho do pai Camiseta Feminina

Camiseta Feminina M – produto filho do pai Camiseta Feminina

Camiseta Feminina G – produto filho do pai Camiseta Feminina

Camiseta Feminina GG – produto filho do pai Camiseta Feminina

Market Place: Loja virtual onde se vendem bens e serviços. Este modelo de negócios é conhecido por conectar diretamente clientes e fornecedor sem a participação de intermediários. Exemplo: Mercado Livre.

Nível de Produto: Ordem de disposição de um produto no site, as categorias de um site. Por exemplo, um telefone celular está dentro da categoria Telefones.

Plataforma de e-commerce: Sistema responsável pelo gerenciamento e visualização da loja virtual na internet.

API: Aplicativo de Integração entre ERP e plataformas, é o integrador e comunicador de dados.

1 INTRODUÇÃO

Destinado a clientes que possuem lojas virtuais, o produto ONECM (e-commerce) possibilita um controle fácil e eficiente da loja virtual. Com ele, há a sincronização dos cadastros de produtos, categorias, características, vendas, estoque, etc.

Este manual destina-se a apresentar os conceitos da integração e-commerce no sistema Onclick.

Atualmente integramos com as seguintes plataformas de e-commerce:

  • TRAY
  • BIZCOMMERCE
  • BIS2BIS
  • RAKUTEN/IKEDA
  • VTEX
  • FBITS

Possuímos também nossa própria plataforma (E-COMMERCE).

2 CONFIGURAÇÕES

2.1 Habilitação do Módulo

(Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Alterar >> Tela [0444] CONFIGURAÇÕES DO SISTEMA >> 17.Módulos Habilitados)

Para habilitar a integração WEB no ERP, a opção 24. ONCLICK PEDIDOS/PEDIDOS INTERNET deve estar marcada, assim as Telas pertinentes à integração e-commerce serão habilitadas.

2.2 Configurações Lojas WEB

(Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB)

Esse cadastro é responsável pelos dados de configuração de todas as lojas WEB integradas.

Agrupamento 1 Integração: Selecione com qual parceiro e-commerce a loja será hospedada. De acordo com a escolha, uma nova aba com configurações específicas de cada integração será apresentada.

1.20 Habilitar Integração Linx: Campo responsável por criar triggers e views para leituras do integrador Linx.

1.21 Habilitar Monitoramento Online: Ao marcar essa opção, serão criadas tabelas de produtos, preços e estoque para integração. O integrador passará a ler os registros dessas tabelas e importar os produtos para o ERP.

2.1 URL Loja: Utilizado para integrações que necessitam informar uma URL específica por loja. Este campo é utilizado nas seguintes integrações: 1.2 Tray, 1.3 E-commerce, 1.5 Ikeda, 1.6 VTEX, 1.7 Chleba e 1.8 Rakuten.

2.2 Nome Loja: Responsável pela identificação da loja dentro do ERP. Campo obrigatório em todas integrações.

2.3 ID Loja: Utilizado para acesso ao parceiro, onde cada loja possui um código. Este campo é utilizado nas seguintes integrações: 1.1 Fast, 1.2 Tray, 1.7 Chleba e 1.3 E-commerce.

2.4 Login: Utilizado para acesso ao parceiro, onde cada loja possui um login de acesso ao backoffice da plataforma. Este campo é utilizado nas seguintes integrações: 1.1 Fast, 1.2 Tray, 1.6 Vtex, 1.7 Chleba (Opcional) e 1.3 E-commerce (Opcional).

2.5 Senha: Utilizado para acesso ao parceiro, onde cada loja possui uma senha de acesso ao backoffice da plataforma. Este campo é utilizado nas seguintes integrações: 1.1 Fast, 1.2 Tray, 1.6 Vtex, 1.7 Chleba (Opcional) e 1.3 E-commerce (Opcional).

2.6 Endereço de Faturamento Igual ao Endereço de Entrega: Com esta opção marcada, ao processar o pedido, os dados de Faturamento no Cadastro do Cliente serão exatamente iguais aos dados do endereço de Entrega.

2.8 Bloquear Pedidos com Itens Sem Lote Disponível: Ao processar pedidos que contenham itens que trabalham com lote e o mesmo não possuir estoque disponível no lote, o pedido ficará bloqueado no ERP.

2.9 Enviar Estoque de Segurança para Loja Web: Com essa opção marcada, será somado o estoque de segurança do produto ao estoque disponível. Este campo é utilizado nas seguintes integrações: 1.2 Tray, 1.3 E-commerce, 1.5 Ikeda, 1.6 Vtex, 1.7 Chleba.

3.1 Enviar Para o Site: Ao marcar uma das opções de código, este será enviado ao site no momento da exportação do produto. Este código será o código de referência do item no site.

4.1 Almoxarifado Padrão: Ao importar o pedido pelo integrador, o mesmo irá dar baixa no almoxarifado informado nesse campo.

4.2 Almoxarifados para estoque: Este campo possibilita no momento de enviar o produto, somar o estoque de almoxarifados distintos e enviar o total deles.

5.1 Atendimento Site: Responsável pela identificação das lojas WEB dentro do ERP. Campo obrigatório para todas integrações.

6. Tabela de Preço: Ao selecionar uma tabela de preço específica, no momento de enviar produto e preço no integrador, será exportado o valor correspondente a essa tabela.

7.1 Habilitar Integração SISFRETE para Pedidos Internet: Ao marcar esta opção, serão desbloqueados campos e botões referentes à integração SISFRETE no ERP.

7.2 Token: Token informado pela SISFRETE para realizar cotação de preços dos pedidos específicos da WEB.

8. Forma de Desconto no Pedido: Permite a distribuição de desconto nos pedidos WEB, inserindo o desconto nos itens ou no total do pedido.

Aba Parâmetros Comuns de Integração

Essa aba foi criada para utilização de todas as integrações, mas atualmente apenas o integrador TRAY a considera. Para campos referentes ao agendamento automático, cada integração possui a funcionalidade em sua respectiva aba.

Agrupamento 1.Dados Gerais

1.1 Minutos para Importar Pedido: Minutos para disparo do agendamento automático no integrador para importação de pedidos.

1.2 Minutos para Atualizar Preço e Estoque: Minutos para disparo do agendamento automático no integrador para atualização do preço e do estoque.

1.3 Minutos para Atualizar Status do Site: Minutos para disparo do agendamento automático no integrador para atualizar o status do pedido.

1.4 Minutos para Exportar Lista de Desejo: Minutos para disparo do agendamento automático no integrador para atualizar a lista de presente. Esta opção está disponível somente para a integração TRAY.

1.5 Minutos para Importar Lista de Desejo: Minutos para disparo do agendamento automático no integrador para importar lista de presente. Esta opção está disponível somente para a integração TRAY.

1.6 Minutos para Importar Clientes sem Pedido: Minutos para disparo do agendamento automático no integrador para importar clientes sem pedidos. Esta opção está disponível somente para a integração TRAY.

1.7 Dias p/ Mostrar Pedidos na Importa Internet: Quantidade de dias retroativos a partir do dia atual, para carregar pedidos pendentes a serem processados na tela PEDIDO WEB. Esta opção está disponível somente para a integração TRAY.

1.8 Minutos para Processamento Automático na Importa Internet: Minutos para disparo do agendamento automático para processar os pedidos importados que se encontram disponíveis na tela de PEDIDOS WEB. Esta opção está disponível somente para a integração TRAY.

1.9 Mostrar e Processar Pedidos Apenas da Empresa Logada: Ao marcar essa opção, os pedidos apresentados na tela de PEDIDOS WEB serão os da empresa logada no ERP.

Agrupamento 2. Módulos Habilitados

São campos criados para utilização do integrador E-commerce.

A seguir serão apresentadas as abas específicas de cada integração:

Aba FAST

Essa aba foi criada para complementar informações de loja com o parceiro FAST Commerce. A aba será habilitada somente se o campo 1.1 FAST do parâmetro 1. Integração da aba Parâmetros por Integração estiver habilitado.

3

1.1 Trabalha com Sub Produtos (Produto / SKU): Opção responsável pela forma de envio dos produtos no integrador FAST. Ao marca-lo, é possível enviar produtos e SKUS. Opção disponível nas integrações FAST e E-commerce.

1.6 Minutos Para Verificar E-mail: Minutos para disparo do agendamento automático no integrador para verificar pedidos realizados através do e-mail configurado.

1.7 Servidor E-mail: Campo para configurar o servidor de e-mail.

1.8 Conta de E-mail: Campo para configurar conta de e-mail.

1.9 Senha de E-mail: Campo para configurar senha de e-mail.

1.10 Porta: Campo para configurar porta de e-mail.

1.11 Servidor Requer uma Conexão Segura: Configuração do integrador para link de integração segura.

1.12 Atualizar Status ao Receber um Pedido Existente: Ao marcar essa opção, o integrador passa a atualizar algumas informações de um pedido já processado no ERP caso o pedido seja importado novamente (se o tipo do pedido permitir). Essa opção está disponível para as integrações: 1.1 Fast, 1.3 E-commerce e 1.5 Ikeda.

1.13 Trabalha com Níveis de Categorias de Produtos: Habilita a árvore de níveis no arquivo XML para cadastro e vinculação ao produto no ERP.

1.14 Ao Importar Pedidos Considerar o Código: Campo que define como será pesquisado o produto ao importar os itens do pedido, pelo campo código internet ou campo de referência (Código de Barras, Código Fabricante ou Código Auxiliar).

1.15 Utiliza Envio de Produto por Bloco: Com a opção desmarcada, o aplicativo irá montar um único arquivo XML para cada processo e nele todos os registros de envio. Caso marcado, serão enviados vários arquivos XML (quantidade definida no campo abaixo) com os registros de envio.

1.16 Quantidade de XML Enviado por Bloco: Quantidade de registros que irão compor cada arquivo XML gerado pelo integrador.

Agrupamento 2. Campos Descritores

2.1 Trabalha com Multivalorados (multivalor): Opção que libera a utilização de mais de um valor dos descritores no envio de produtos. Também é alterado o layout e cadastro de produtos no ERP.

Marca: Define em qual campo no XML de produtos será enviado a marca.

Grupo: Define em qual campo no XML de produtos será enviado o grupo.

Subgrupo: Define em qual campo no XML de produtos será enviado o subgrupo.

Categoria: Define em qual campo no XML de produtos será enviado a categoria.

Grupo2: Define em qual campo no XML de produtos será enviado o grupo 2.

Grupo3: Define em qual campo no XML de produtos será enviado o grupo 3.

Grupo4: Define em qual campo no XML de produtos será enviado a marca. Apenas se trabalhar com multivalorados.

Tabela de Preço B2B: Define qual tabela de preço será enviada no campo referente a “Business to Business” no XML de produto.

Aba TRAY

Essa aba foi criada para complementar informações de loja com o parceiro Tray Commerce. A aba será habilitada somente se a opção 1.2 TRAY do campo 1.Integração da aba Parâmetros por Integração estiver habilitada.

4

1.1 Máximo de Níveis Exibidos na Tela de Produtos: Define a quantidade máxima de níveis no cadastro de produto para visualização.

1.2 Tipo do Peso Para o Site: Define se o peso que será enviado com o produto será o líquido ou bruto.

1.3 Imprime na Nota Fiscal as Observações do Cliente: Define se na Nota Fiscal serão apresentadas as observações preenchidas no site pelo cliente.

1.4 Utiliza Editor HTML do Site como Principal: Define se a utilização do editor HTML será o da TRAY, neste caso, o integrador não envia o texto cadastrado no ERP (cadastro do produto >> aba Integração Web).

1.5 Fórmula Peso Cúbico para o Site: Cálculo definido pelos correios para envio de mercadorias. (A x L x C) / x (valor que a plataforma informa, influencia no valor do frete).

1.6 Filial Padrão para Lista de Desejo: Ao importar lista de desejos da TRAY, uma filial padrão pode ser definida de acordo com essa configuração.

1.7 Vendedor Padrão para Lista de Desejo: Ao importar lista de desejos da TRAY, um vendedor padrão pode ser definido de acordo com essa configuração.

1.8 Permitir Alteração no Vendedor da Lista de Desejo: No cadastro de Lista de Presente, é possível ou não alterar o vendedor.

1.9 Tipo de Medida para Altura/Largura/Comprimento: Tipo de metragem informada no cadastro de produto (m ou cm). Assim será realizada a conversão automaticamente para o padrão TRAY.

1.10 Utiliza TrayCheckout: Define se a loja irá trabalhar com TrayCheckout.

Agrupamento 2. Cópia entre loja principal e secundária

2.1 Tornar Essa Loja Principal: Ao marcar essa opção, essa loja se torna principal e possibilita a cópia de lojas secundárias a partir dela.

2.2 Copiar da Loja: Essa loja passa a copiar códigos de integração da loja principal informada nesse campo.

Aba E-commerce

Essa aba foi criada para complementar informações de loja com parceiros que utilizam nosso integrador E-COMMERCE. Será habilitada somente se a opção 1.3 E-COMMERCE do campo 1. Integração da aba Parâmetros por Integração estiver marcada.

5

1.6 Utiliza Certificado de Segurança (SSL): Define se a conexão com o parceiro será segura (por exemplo HTTPS).

1.8 Tipo de Leitura: Define se a integração com o parceiro será por meio de um WebService ou Arquivo XML.

1.9 Diretório Padrão Para Exportação do XML: Caso trabalhar com tipo de leitura por arquivo XML, é necessário informar a pasta que será exportado os arquivos gerados pelo integrador.

1.10 Utiliza Envio de Produto por Bloco: Com a opção desmarcada, a Onclick irá montar um único arquivo XML para cada processo com todos os registros de envio. Caso marcado, serão enviados vários arquivos XML (quantidade definida no campo abaixo) com os registros de envio.

1.11 Quantidade de XML Enviado por Bloco: Quantidade de registros que irão compor cada arquivo XML gerado pelo integrador.

1.12 Segundos de espera para próximo XML: Define o tempo para processamento do arquivo XML de envio.

1.13 Envia Marcas: Define se o integrador irá exportar as marcas cadastradas no ERP ao enviar produtos.

2. Tabela de Preço a Enviar: Grid onde serão preenchidas as tabelas de preço que serão exportadas pelo integrador ao enviar produtos (será utilizado o preço dessa tabela). Para informar a tabela de preço, utilizar o INSERT do teclado. O campo NOME DE INTEGRAÇÃO será responsável por vincular o ERP ao Parceiro.

Aba IKEDA

Essa aba foi criada para configurar informações de loja com o parceiro RAKUTEN EC SERVICE/IKEDA. A aba será habilitada somente se o campo 1.5 IKEDA do parâmetro 1. Integração da aba Parâmetros por Integração estiver habilitado.

6

1.6 Versão: Define qual versão do parceiro Ikeda será integrado. Atualmente deverá ser preenchida com os valores 2.1 ou 2.2 pois existem apenas essas duas versões liberadas por eles.

1.7 Status para Pedidos com Vale Presente: Tipo do Pedido padrão que será vinculado a pedidos utilizando o vale presente.

2.1 Status para Compra de Lista de Presentes (Primário): Ao importar um pedido de uma lista de presente que será entregue futuramente ao presenteado, o tipo de pedido ficará com o configurado nesse campo. Opção disponível apenas para as integrações 1.5 Ikeda e 1.6 Vtex.

2.2 Status para Compra de Lista de Presentes (Secundário): Ao importar um pedido de uma lista de presente que será entregue futuramente ao presenteado, ao fatura-lo será gerado um segundo pedido que deverá ser despachado com o produto para o presenteado. O tipo de pedido, desse segundo pedido espelho será o que está configurado nesse campo. Opção disponível apenas para as integrações 1.5 Ikeda e 1.6 Vtex.

3. Código de Barras para Itens da Lista de Presente: Ao importar pedidos de uma lista do tipo crédito, será substituído o produto original pelo item configurado nesse campo. Opção disponível apenas para as integrações 1.5 Ikeda e 1.6 Vtex.

  • Lista do tipo crédito: quando os itens de uma lista são apenas simbólicos. Ao comprar o item, o valor do produto é convertido em créditos, podendo ser usado para a compra de outros produtos.

Aba VTEX

Essa aba foi criada para configurar informações de loja com o parceiro VTEX. A aba será habilitada somente se o campo 1.6 VTEX do parâmetro 1. Integração da aba Parâmetros por Integração estiver habilitado.

7

4. Versão: Esse campo é responsável por informar como a integração irá trabalhar, com o modelo antigo Checkout V1 ou o novo, chamado de Smart CheckOut.

5. Código de Integração do Almoxarifado Padrão: Caso o cliente trabalhe com mais de um almoxarifado na VTEX e deseja que o estoque dos produtos alimente um específico, deverá ser informado nesse campo o código de integração deste almoxarifado. Caso esse campo fique em branco, o estoque será replicado para todos almoxarifados cadastrados no site.

6. Tipo de Pedido para Bonificação: Inclui uma CFOP de bonificação para este tipo de pedido.

  • Copiar Produtos: Na Tela [0962] CADASTRO DE LOJAS WEB, há o botão COPIAR PRODUTOS, este botão copia todos os registros (produtos, marcas e etc…) liberados de uma loja de origem para uma nova loja.

Loja Origem a Ser Copiada: Ao informar a loja nesse campo, serão copiados todos registros liberados nela para a nova loja selecionada na tela anterior. As seguintes informações serão liberadas: Produto, Fabricante, Departamento, Categoria, Seção, Característica, Vinculação Entre Produto e Característica, Informação, Vinculação Entre Produto e Informação, Perfil, Cor, Nível De Produto.

Copiar Site Código da Loja de Origem: Ao marcar essa opção, serão copiados os códigos de integração (das propriedades informadas acima) da loja origem para a nova loja.

3 CADASTROS

3.1 Cadastros vinculados ao Produto

3.1.1Cadastro de Perfil

(Cadastros >> Produtos >> Tabelas diversas >> Perfil >> Tela [0959] CADASTRO DE PERFIL)

A Tela [0959] CADASTRO DE PERFIL é responsável pela criação de um novo perfil com determinadas características selecionadas.

Descrição: Campo destinado ao nome do perfil que será criado no site.

Características Cadastradas: Apresenta as características disponíveis para vinculação com o perfil.

Característica Selecionadas: Apresenta as características já vinculadas ao perfil.

3.1.2 Cadastro Nível de Produto

(Cadastros >> Produtos >> Nível >> Tela [0889] CADASTRO DE NÍVEL PRODUTO)

Essa tela é responsável pela categorização dos produtos no site, conhecido também como departamentos de um site. Está disponível para as integrações:

  • Fast (caso a opção “Trabalha com Níveis de Categorias de Produto” da tela Cadastro de Loja Web estiver marcada);
  • Tray;
  • E-commerce;
  • Ikeda; e
  • VTEX

Loja Selecionada: Se houver mais de uma loja WEB cadastrada no ERP, essa opção será mostrada para que defina qual nível de categoria deseja trabalhar atualmente. Caso não houver mais de uma loja, o campo será automaticamente carregado com a loja atual.

Botão “Cadastrar Nível”: Abrirá a Tela [0892] CADASTRO DE NÍVEIS. Ela é responsável por gerenciar os níveis de categorias que serão exportadas para o site.

Código: Código interno no ERP do nível de categoria.

Descrição: Nome do nível que será enviado para o site.

Código Internet: Código de integração com o parceiro (deixar zerado caso for um nível novo).

Perfil: Perfil que o nível ficará vinculado. Opção disponível para Integração TRAY.

Nível Loja Principal: Esse campo é responsável pela amarração entre a loja principal e secundária. Ao criar um nível na loja secundária, deverá ser informado qual nível da principal é equivalente a ela, assim ao atualizar o código de integração da principal o sistema saberá qual nível da secundária deverá ser replicado. (Caso as opções “Loja principal” e “Loja Secundária” na Tela CADASTRO DE LOJA WEB estiverem preenchidas). Opção disponível para Integração TRAY.

De volta à Tela [0889] CADASTRO DE NÍVEL PRODUTO:

Botão “Carregar”: Esse botão é responsável por carregar o cadastro de árvore de níveis. Será mostrada toda a estrutura que será apresentada no site.

Após cadastrados os níveis desejados, será necessário clicar no Botão CARREGAR para que inicie uma nova estrutura de árvore de níveis.

8

  • O ícone C:Usersmarcus.viniciusDesktopimg10.JPG na frente da descrição do nível de categoria, significa que ele é a “base” da árvore de níveis ou que ele não está vinculado a ninguém.

Para adicionar um subnível ao exemplo “Casa”, deverá clicar no botão “Adicionar Nível”.

Botão “Adicionar Nível”: Esse botão é responsável por adicionar subníveis a uma árvore de níveis. Ao clicar nesse botão, será aberta a Tela [0890] ADICIONAR NÍVEL.

Código: Campo responsável por pesquisar o código interno no ERP do nível. Ao informar e sair do campo, a descrição será carregada.

Botão “Cadastrar Nível”: Abrirá a Tela [0892] CADASTRO DE NÍVEIS.

Botão “Pesquisar Nível”: Esse botão é responsável por uma melhor pesquisa dos níveis cadastrados. Será aberta a Tela [0891] PESQUISAR NÍVEL.

Após pesquisar e encontrar o nível desejado a ser adicionado a árvore de níveis da primeira tela, dar um duplo clique que será carregado na tela anterior.

Após clicar em gravar. O nível pesquisado será adicionado como um subnível do principal.

Fazer o mesmo processo até montar toda a árvore de níveis.

9

Botão “Remover Nível”: Esse botão é responsável por remover um subnível de uma árvore de níveis.

Ao clicar nesse botão, será apresentada uma mensagem de confirmação.

Esse botão desvincula o nível selecionado na àrvore junto com os níveis abaixo dele. No exemplo do “Anel”, serão removidos também os níveis “Ouro” e “Rhodium”.

  • Os níveis “Ouro” e “Rhodium” continuam vinculados ao nível “Anel”. Esse botão apenas remove o nível selecionado do nível acima, porém os níveis abaixo dele continuam amarrados.

Botão “Remover Nível Completo”: Esse botão é responsável por desvincular todos os níveis e subníveis de uma árvore.

Esse botão desvincula todos os níveis na arvore de níveis de categoria. No exemplo acima o “Anel”, “Ouro” e “Rhodium” serão desvinculados entre eles.

  • A diferença entre os botões “Remover Nível” e “Remover Nível Completo” é que o segundo botão desvincula por completo todos os níveis da árvore, já o primeiro apenas remove o nível selecionado mantendo os subníveis vinculados a ele.

3.1.3 Cadastro de Marca

(Cadastros >> Produtos >> Tabelas Diversas >> Marca >> Tela [0308] CADASTRO DE MARCA)

Essa tela é responsável pela criação de marcas para posteriormente vincular ao produto no site.

Descrição: Descrição que será apresentado no site do parceiro.

Esse mesmo recurso existe nas seguintes telas: Marca, Grupo, SubGrupo, Categoria, Característica e Evento.

Aba Integração WEB

Local onde apresenta em quais lojas estão liberadas essa marca. Nela é possível informar o código de integração manualmente, caso não souber, deixar em branco para que o integrador preencha automaticamente no momento da integração.

Esse mesmo recurso existe nas seguintes telas: Marca, Grupo, SubGrupo, Categoria, Característica e Evento.

Botão “Gravar”: Ao clicar em gravar e não ter liberado para nenhuma loja, o ERP apresenta uma mensagem perguntando se deseja liberar para todas as lojas automaticamente. Caso clicar em “SIM”, libera com o código de integração zerado.

Para lojas Web que apresentem vinculação entre loja principal e secundária, caso libere manualmente para a loja principal, será forçada a liberação para a secundária, para que os códigos de integração fiquem sincronizadas entre elas.

3.1.4 Cadastro de Características

(Cadastros >> Produtos >> Tabelas Diversas >> Características >> [0749] CADASTRO DE CARACTERÍSTICAS).

Tela responsável pelo cadastro de características para uma posterior vinculação aos produtos ou SKUs.

  • Características são atributos que diferenciam um mesmo produto, por exemplo Cor, Tamanho, Voltagem e etc.

Botão “Valores”: Ao clicar nesse botão, será aberta a Tela [0899] CADASTRO DE VALORES para cadastrar os valores da característica. No exemplo abaixo, foram cadastrados valores para a característica COR.

Descrição: A descrição do valor que será amarrado a característica.

Código Internet: Código de integração com o parceiro, caso não souber, deixar zerado para que o integrador preencha automaticamente.

3.1.5 Cadastro de Produtos

(Cadastros >> Produtos >> Tela [0293] CADASTRO DE PRODUTOS >> Alterar >> Tela [0324] ALTERAÇÃO DE PRODUTOS)

Nessa tela, além dos dados básicos para o ERP, será necessário preencher informações voltadas para Integrações Web.

Aba DADOS GERAIS

Nessa aba algumas informações que são preenchidas para uso interno no ERP também serão consideradas para enviar ao site.

Tipo: Tipo do produto, normalmente utilizado “PRODUTO ACABADO” ou “KIT DE PRODUTOS”.

Estoque De Segurança: Dependendo da configuração na loja Web, ele será somado ou não ao estoque do produto.

Peso Bruto: Peso bruto do produto.

Peso Líquido: Peso líquido do produto.

Altura: Altura do produto.

Largura: Largura do produto.

Comprimento: Comprimento do produto.

Volume Cúbico: Volume cúbico do produto.

Dias para Entrega: Quantidade de dias necessários para o manuseio e entrega do produto. Opção disponível para as integrações Ikeda e E-commerce.

Aba INTEGRAÇÃO WEB

Caso haja mais de uma loja web, será necessário informar qual loja deseja liberar para esse produto. Assim serão apresentados campos dinâmicos para cada tipo de integração diferente.

Se houver apenas uma única loja, automaticamente ela será carregada.

ID Produto: Campo correspondente ao código de integração do produto junto ao site do parceiro. Esse código deverá ser único por loja.

ID Produto Pai: Campo correspondente ao código de integração do produto pai junto ao site do parceiro. Esse código deverá ser único por loja.

Referência: De acordo com a opção “3.1 Enviar Para o Site” na Tela de Cadastro de Loja Web, esse campo será preenchido automaticamente com Código de Barras, Auxiliar ou Fabricante. É possível altera-lo manualmente diretamente nesse campo.

Marca: Campo destinado a marca do produto. Serão apresentadas apenas marcas que estão liberadas para essa loja.

Descrição: Nome ou título do produto que será apresentado no site.

Descrição Longa: Descrição detalhada do produto, normalmente será apresentado como corpo do anuncio no site.

Enviar Produto Para o Site: Opção responsável pela liberação ou não do produto para o site.

Destaque: Opção que informa se o produto deverá ficar como destaque no site.

Lançamento: Opção informa se o produto deverá ficar como lançamento no site.

Produto Disponível: Opção que informa se o produto deverá ficar como disponível para venda ou não no site.

URL Externa: Opção que indica se o produto possui uma URL externa para redirecionamento. Disponível para as integrações E-commerce e FAST.

Frete Grátis: Indica que o produto pode ficar com frete grátis no carrinho de compra. Disponível para a integração Rakuten.

SKU Padrão: Campo responsável por informar que esse produto é o principal a ser apresentado na vitrine da loja. Disponível para a integração Rakuten.

Est. Mínimo: Estoque mínimo desse produto no site.

Estoque: Campo não habilitado para edição. Para alterar, deverá ser acessado pelas telas de manutenção do estoque.

Campos dinâmicos integração TRAY

Campos que serão habilitados caso a opção TRAY esteja marcada no cadastro de Lojas Web.

C:Usersmarcus.viniciusDesktopimg12.JPG

Cod. Auxiliar / ML: Recebe a mesma informação do campo “Auxiliar” da aba Dados Gerais.

Garantia: Campo que define quanto tempo de garantia o produto possui.

Disponibilidade: Campo que informa a disponibilidade do produto no site.

Texto Personalizado: Campo para identificar o texto personalizado no pedido, normalmente usados em camisetas onde será preenchido um nome. Ex: ‘Digite seu Nome aqui’.

Informações: Tabela para cadastrar mais informações do produto, como vídeo, especificação e etc. O campo informação da tabela deverá ser texto pré-definido no manual de integração TRAY. O campo descrição é o valor.

C:Usersmarcus.viniciusAppDataLocalMicrosoftWindowsINetCacheContent.Word15.jpg

Campos dinâmicos integração E-COMMERCE, FAST e IKEDA

Campos que serão habilitados caso a opção E-COMMERCE, FAST ou IKEDA esteja marcada no cadastro de Lojas Web.

C:Usersmarcus.viniciusAppDataLocalMicrosoftWindowsINetCacheContent.Word14.jpg

Descrição Curta: Descrição resumida que será apresentada na loja. Disponível para todas as integrações.

Descrição HTML: Caso o produto tenha uma descrição HTML e deseja carrega-la na página do site. Disponível para a integração FAST.

URL Apoio: URL para redirecionamento de mais detalhes do produto. Disponível para as integrações FAST e VTEX.

Imagem Principal: URL da imagem principal do produto. Disponível para a integração FAST.

Imagem de Detalhe: URL da imagem em detalhe. Disponível para a integração FAST

Imagem Ampliada: URL da imagem ampliada. Disponível para a integração FAST.

Data Vencimento: Data de Vencimento do produto. Disponível para as integrações E-commerce, FAST, e VTEX.

Categoria: Campo que será enviado no XML de produto de acordo com a configuração de descritores no Cadastro de Loja WEB. Disponível para a integração FAST.

Grupo: Campo que será enviado no XML de produto de acordo com a configuração de descritores no cadastro de loja web. Disponível para a integração FAST.

SubGrupo: Campo que será enviado no XML de produto de acordo com a configuração de descritores no cadastro de loja web. Disponível para a integração FAST.

Característica: Campo que será enviado no XML de produto de acordo com a configuração de descritores no cadastro de loja web. Disponível para a integração FAST.

Informação: Campo que será enviado no XML de produto de acordo com a configuração de descritores no cadastro de loja web. Disponível para a integração FAST.

Cor: Campo que informa a cor do produto. Disponível para a integração FAST.

Ordem: Campo destinado para que o integrador saiba qual a sequência de apresentação do produto no site. Disponível para as integrações E-commerce e FAST.

Máx Parc: Número máximo de parcelas para pedidos que incluam este produto. Disponível para a integração FAST.

XML Parc: Identifica o número de parcelas utilizadas para exibir o parcelamento na página que lista os produtos em XML. A lista de produtos em XML é utilizada pelos portais de comparação de preços e shopping virtuais, para capturar os produtos da loja. Disponível para a integração FAST.

Máx Venda: Quantidade máxima desse produto por venda. Disponível para a integração IKEDA.

Fator Conv: Fator de conversão utilizada ao importar um pedido com esse produto. Disponível para a integração E-commerce.

Min. Venda: Quantidade mínima do produto no site (igual ao campo Est. Mínimo). Disponível para a integração IKEDA.

Aba DESCRIÇÃO HTML

Essa aba contém um editor simples de HTML para enviar um texto já formatado com a descrição do produto para o parceiro web. Disponível para as integrações E-comnerce, IKEDA e TRAY (Desmarcar a opção “Utiliza Editor HTML do Site como Principal” no cadastro de Loja Web).

Aba CARACTERÍSTICAS

Essa aba é responsável pelos atributos e diferenciação de um mesmo produto, por exemplo uma Geladeira 220v ou 110v é a mesma geladeira, o que muda entre elas é sua voltagem. Disponível para as integrações E-commerce, IKEDA, FAST (marcar a opção “Trabalha com Multivalorados” no cadastro de Loja Web), VTEX e TRAY (para produtos SKUs).

Característica: Campo para seleção de qual característica deseja acessar.

Valores: Na tabela Valores, serão carregados todos os valores cadastrados para aquela característica selecionada.

Valores Selecionados: Essa tabela é apenas para visualização dos valores selecionados daquela característica.

Características Escolhidas: Uma árvore de todas as características e valores que foram cadastrados para aquele produto.

Aba Níveis de Categorias

Essa aba é responsável pela categorização do produto dentro do site. Por exemplo uma Geladeira normalmente se encontra na categoria “Eletrodomésticos” junto com outras geladeiras.

Essa aba é apresentada apenas para produtos únicos ou pais (menos E-commerce), pois os SKUs sempre serão herdados do produto principal.

Disponível para as integrações: TRAY, E-commerce, FAST (marcar a opção “Trabalha com Níveis de Categorias de Produtos” no cadastro de loja Web), VTEX e IKEDA.

17

Descrição: Ao dar duplo clique no nível de categoria desejado, ele irá expandir seus subníveis. Repetindo o processo, chegará até o final da árvore de níveis. Para amarrar o produto ao nível desejado, apenas deixe selecionado e clique em gravar.

Enviar Níveis Adicionais: Essa opção é apresentada apenas para lojas TRAY. Ao marcar a opção, será aberta uma tabela na lateral para ser adicionado mais de um nível no produto.

Os níveis adicionais serão considerados apenas se tiver mais de um nível na tabela “Níveis Adicionais”. O primeiro nível será considerado o principal do produto e o restante como adicional. Assim deverá ser desconsiderado a árvore de níveis do lado esquerdo.

18

Aba CUSTOS E PREÇOS

Na aba Custos e Preços encontram-se alguns campos que serão utilizados para a integração com todos os parceiros web.

Preço de Venda: Campo responsável pelo valor do produto no site. Caso o usuário trabalhe com mais de uma tabela de preço e esta estiver configurada no Cadastro de Lojas Web, poderá ir o valor desta tabela e não o que foi cadastrado nesse campo.

Promoção/Valor em R$: Campo responsável pelo valor de promoção no site. Caso o usuário trabalhar com mais de uma tabela de preço, poderá ir o valor da tabela e não do qual foi cadastrado nesse campo.

Promoção/Início: Data de início da promoção desse produto.

Promoção/Fim: Data do fim da promoção desse produto.

3.2 Vinculação Produto Pai e Filho

(Cadastros >> Produtos >> Tela [0293] CADASTRO DE PRODUTOS >> Funções >> Vincular Produto Pai X Filho >> Tela [0853] VINCULAR PRODUTO PAI X FILHO)

Nessa tela é possível realizar a vinculação manual de vários produtos únicos transformando-os em pai e filhos.

Um produto pai é o que é mostrado na listagem de exportação dos produtos nos integradores e também é o que será apresentado na vitrine da loja.

Exemplo de produto pai no site:

Ao acessar um produto pai que está na vitrine, serão mostradas as opções do produto, nesse caso as variações de tamanhos (no ERP são chamadas de características):

Ao acessar a Tela [0853], serão apresentados todos os produtos que são possíveis vincular ao novo pai. Ao marcar ou desmarcar os produtos filhos, clique no botão PROCESSAR e a vinculação estará realizada.

3.3 Cadastro Automático de SKUs

(Cadastros >> Produtos >> Tela [0293] CADASTRO DE PRODUTOS >> Funções >> Cadastro Automático de SKUs >> Tela [0980] CADASTRO AUTOMÁTICO DE SKUS).

Nessa tela é possível atribuir SKUs a um produto (atribuir FILHOS a um produto PAI), porém é necessário que produto PAI esteja com uma loja WEB vinculada a ele e que tenha um almoxarifado inicializado.

Para inicializar o almoxarifado, no cadastro do produto que será o “PAI”, clique em LOCAL DE ARMAZENAGEM E INICIALIZAÇÃO DE ESTOQUE POR ALMOXARIFADO, e depois em INICIALIZAR ESTOQUE; já para configurar a loja WEB, na aba Integração WEB, selecione a loja no campo LOJA SELECIONADA.

De volta à Tela [0980] CADASTRO AUTOMÁTICO DE SKUS:

Selecione a característica e seus respectivos valores, por exemplo, na inclusão de SKUs para o produto CAMISETA, foram selecionadas as características GÊNERO, COR e TAMANHO, e os valores FEMININO, MASCULINO, AZUL, BRANCA, PRETA, GG, G, M, P e PP.

Ao simular a criação dos produtos, foram criadas todas as combinações possíveis entre os valores selecionados a partir da primeira característica citada (GÊNERO). Os valores poderão ser ordenados da forma que o usuário preferir, por exemplo, para a característica TAMANHO, a ordenação que está como G, GG, M, P e PP; pode ser alterada através das setas para cima e para baixo para PP, P, M, G e GG.

Após selecionar todas as características e valores desejados, clique em SIMULAR, serão exibidos na mesma Tela todos os produtos criados. Os produtos “FILHOS” serão criados seguindo o nível (ordem) definido pelo usuário na seleção das características e de seus valores. Utilizando o produto CAMISETA como exemplo, foi definido como primeiro nível a característica GÊNERO, como segundo nível a característica COR e como terceiro nível a característica TAMANHO, sendo assim, o produto será criado partindo do primeiro valor do primeiro nível (FEMININO), criando-se todas as combinações a partir deste valor e posteriormente a partir do segundo valor do primeiro nível (MASCULINO), e assim sucessivamente, caso haja outros valores. Sendo assim, deve-se atentar a criação dos níveis, já que a sequência do cadastro dos produtos filhos criados deverá respeitar a ordenação realizada no quadro Valores Selecionados.

Características: Serão carregadas as características cadastradas no ERP. Ao selecionar, será carregado automaticamente a tabela VALORES com os valores vinculados a ele.

Tabela Valores Selecionados: Ao dar duplo clique no valor, ele será transferido para os valores selecionados. Poderá informar quantos valores desejar para montar as combinações de SKUs.

Adicionar Valores das Características na Descrição do Produto: Ao ser marcado, irá atribuir aos campos DESCRIÇÃO e DESCRIÇÃO SITE os valores das características, facilitando posteriormente a localização deste produto. Marque a opção e clique em SIMULAR para as descrições serem alteradas.

Gerar Cód. Barras Automaticamente: Ao ser marcado, será gerado para os SKUs exibidos na Tela (produtos filho), um código de barras no padrão EAN13 ou EAN18 de acordo com o configurado no sistema em (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Alterar >> Tela [0444] CONFIGURAÇÕES DO SISTEMA >> 5. Produtos/Preços >> agrupamento 2.Cadastro de Produtos >> 2.3 CÓDIGO DE BARRAS PADRÃO). Marque a opção e clique em SIMULAR para o código ser gerado. Se desmarcado, o campo código de barras será preenchido com o código produto.

Ao clicar em GRAVAR, os produtos exibidos na Tela [0980] serão inclusos no Cadastro de Produtos (tabela PRODUTO). Após este procedimento, os produtos ‘filho’ automaticamente estarão vinculados ao produto ‘pai’, não sendo permitida a exclusão do produto ‘pai’. O almoxarifado do produto FILHO será o mesmo do produto PAI.

4 LISTA DE PRESENTES OU LISTA DE DESEJOS

(Vendas >> Pedidos e Orçamentos >> Lista >> Tela [0922] LISTA DE PRESENTES)

Com a tela lista de presente, é possível criar uma lista no ERP e usá-la internamente ou exportá-la para integração TRAY.

Ao incluir no botão incluir, será aberta a Tela [0923] LISTA DE PRESENTES.

Enviar Lista Para o Site: Define se a lista será destinada ao site ou não. Existe a possibilidade de não ser somente para loja física.

Loja Web: Caso o campo acima seja marcado, deverá informar para qual loja será exportada. Os produtos a serem informados na lista também serão carregados de acordo com a loja definida.

Cliente: Campo destinado para informar o nome do dono da lista.

E-mail: E-mail de contato do dono da lista.

Endereço: Endereço do dono da lista.

Telefone: Telefone do dono da lista.

Participante 2: Nome do segundo participante (nome do noivo ou noiva por exemplo).

Email: E-mail de contato do participante.

Telefone: Telefone do participante.

Tabela de Preço: Tabela de preço cujo os valores dos produtos serão apresentados na lista.

Evento: Tipo do evento da lista de presente (casamento, chá de cozinha por exemplo).

Data Evento: Dia que o evento será realizado.

Horário: Horário que o evento será realizado.

Local: Local do evento que será realizado.

URL: Caso o evento possuía algum link de divulgação.

Descrição: Pequena descrição do evento.

Mensagem: Mensagem de agradecimento.

Status: Status do evento.

Envia Cartão: Envia cartão de agradecimento para os convidados.

Recebimento: Quando os produtos serão recebidos.

Envia E-mail: Envia e-mail automático para o dono da lista para cada compra.

Vendedor: As vendas serão vinculadas a algum vendedor.

Filial: Qual filial a lista será vinculada.

Valido até: Data que a lista ficará disponível.

Digitar: Campo de escolha para pesquisar e adicionar o produto na lista.

Item: Qual o número do item na lista.

Código: Código de identificação do produto para adicionar à lista.

Qtde: Quantidade desejada para o produto.

Coletor de Dados – Arquivo Texto: Campo para carregar uma lista de presente diretamente por arquivo.

Botão “Estorno”: Botão destinado para devolução de itens. O botão Estorno ficará habilitado apenas para os itens que já foram faturados – ou seja, para os produtos em que já houve a emissão da nota ou cupom fiscal.

5 TIPOS DE PEDIDO

(Vendas >> Tabelas Diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE PEDIDO)

Essa tela é responsável pela integração dos tipos de pedidos entre o ERP e o Parceiro Web.

Ao incluir um novo tipo de pedido, será necessário informar na aba INTEGRAÇÃO WEB a descrição e o código de integração.

No tipo de Pedido FATURADO, existe um campo destinado a pedidos sem código de rastreio e com rastreio, assim pode-se ter dois status diferentes para a mesma Nota Fiscal mas em situações que tem ou não rastreio.

Com Rastreio: Após faturar o pedido e ser adicionado um código de rastreio, o integrador enviará a descrição e código do parceiro configurado nesse campo.

Sem Rastreio: Após faturar o pedido e não conter código de rastreio, o integrador enviará a descrição e código do parceiro configurado nesse campo.

Fixo: Esse campo define que caso o tipo de pedido está atrelado ao pedido, o integrador não poderá alterar por meio da integração caso o tipo de pedido no site estiver diferente. Se esse campo não está marcado, o integrador irá alterar o tipo de pedido do site e sobrepondo o do ERP atualmente. Disponível para as integrações e-commerce, FAST, VTEX, IKEDA.

6 STATUS WEB

Disponível somente para TRAY.

Será possível vincular ao TIPO DE PEDIDO de Venda, vários STATUS referente as mercadorias e ao próprio Pedido de Venda, como A ENVIAR, AGUARDANDO DISPONIBILIDADE, etc. Estes STATUS, serão denominados de STATUS WEB e permitirão o acompanhamento das operações, sem a necessidade de alteração no tipo do PEDIDO DE VENDA.

O cadastro de Status Web é utilizado atualmente apenas para integração TRAY. É um formato mais flexível de controlar o Status Web do pedido, podendo criar e alterar o status mesmo após o pedido ser faturado.

6.1 Configurações

(Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba Parâmetros por Integração >> aba Geral >> 5. Atendimento Site).

Para que o STATUS WEB seja exibido na inclusão do Pedido de Venda; a loja WEB deve possuir um Tipo de Atendimento vinculado a ela. Tipos de Atendimento são cadastrados em (Vendas >> Tabelas Diversas >> Tipos de Atendimento >> Tela [0038] TIPOS DE ATENDIMENTO).

6

(Vendas >> Tabelas Diversas >> Tabelas Diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE PEDIDO >> Status WEB >> Tela [1109] CADASTRO DE STATUS WEB).

O atalho Status WEB abrirá a Tela [1109] CADASTRO DE STATUS WEB.

1

2

Na Tela [1109] CADASTRO DE STATUS WEB, poderão ser inclusos STATUS para o TIPO DE PEDIDO selecionado anteriormente, por exemplo, aguardando pagamento, pedido aprovado, aguardando disponibilidade, etc.

Poderão ser inclusos mais de um STATUS para o mesmo TIPO DE PEDIDO, porém não será permitida a inclusão de mais de um STATUS com a mesma descrição, por exemplo, dois STATUS com a descrição A ENVIAR, mesmo que este STATUS esteja vinculado a outro TIPO DE PEDIDO. Será obrigatório também, marcar um STATUS como STATUS PADRÃO.

Ainda na Tela [1109] CADASTRO DE STATUS WEB, na aba INTEGRAÇÃO WEB, deverá ser selecionada a(s) Loja(s) Web que utilizará(ão) o STATUS criado.

8

Os STATUS WEB do tipo de pedido FATURADO, terão a opção de configurar o PADRÃO COM RASTREIO:

11

Com esta opção marcada, ao gerar uma Etiqueta de Postagem a partir de uma Nota Fiscal de Venda, o STATUS WEB do PEDIDO DE VENDA que gerou a NOTA FISCAL DE VENDA será alterado para o STATUS WEB que possui a opção PADRÃO COM RASTREIO marcada.

6.2 Processos

(Vendas >> Pedidos e Orçamentos >> Pedido >> Tela [0418] ORÇAMENTO / PEDIDO DE VENDA >> Incluir >> Tela [0574] INCLUSÃO DE PEDIDOS/ORÇAMENTOS >> aba INTERNET >> campo STATUS WEB).

Na Tela [0574] INCLUSÃO DE PEDIDOS/ORÇAMENTOS e na Tela [0574] ALTERAÇÃO DE PEDIDOS/ORÇAMENTOS, será exibido o campo STATUS WEB, que trará os STATUS cadastrados na Tela [1109] CADASTRO DE STATUS WEB, porém os status exibidos neste campo serão de acordo com o TIPO DE PEDIDO e TIPO DE ATENDIMENTO selecionados no PEDIDO DE VENDA.

7

Na inclusão de um Pedido de Venda, ao ser selecionado um TIPO DE PEDIDO, no campo STATUS WEB serão exibidos somente os STATUS cadastrados para aquele TIPO DE PEDIDO.

Se o TIPO DE PEDIDO for alterado, a informação do campo STATUS WEB será alterada para o STATUS definido como padrão no cadastro do novo TIPO DE PEDIDO informado.

Caso a loja WEB utilize o TrayCheckout, o botão ALTERAR da Tela [0574] ALTERAÇÃO DE PEDIDOS/ORÇAMENTOS ficará desabilitado. A utilização do TrayCheckout é definida em (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba Parâmetros por Integração >> aba TRAY >> 7.16 UTILIZA TRAYCHECKOUT), com o parâmetro 7.16 marcado, o botão ALTERAR ficará desabilitado.

Já o parâmetro 7.16 UTILIZA TRAYCHECKOUT, ficará habilitado apenas se a empresa utilizar o Faturamento direto de Pedidos, configurado em (Utilitários>> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Alterar >> Tela [0444] CONFIGURAÇÕES DO SISTEMA >> 7. Vendas >> aba Nota Fiscal >> Agrupamento 6. Importação do Pedido de Venda >> 6.10 Utiliza Faturamento Direto de Pedidos).

A loja WEB é definida através do TIPO DE ATENDIMENTO selecionado na Tela [0574] ALTERAÇÃO DE PEDIDOS/ORÇAMENTOS, onde cada TIPO DE ATENDIMENTO está vinculado a uma LOJA WEB, como definido no Cadastro de Lojas WEB (Tela [0962] CADASTRO DE LOJAS WEB).

(Vendas >> Pedidos e Orçamentos >> Pedido >> Tela [0418] ORÇAMENTO / PEDIDO DE VENDA >> Funções >> Atualização de Status Web >> Tela [1110] ATUALIZAÇÃO DE STATUS WEB)

Na Tela [1110] ATUALIZAÇÃO DE STATUS WEB, poderá ser realizada uma alteração em massa do campo STATUS WEB dos PEDIDOS DE VENDA selecionados.

9

Nesta Tela, os filtros WEBLOJA e TIPO DE PEDIDO serão obrigatórios, onde o botão Pesquisar só ficará habilitado após o preenchimento destes dois campos.

Poderá ser alterado o STATUS WEB de qualquer pedido de venda, inclusive os que estão com o tipo FATURADO.

Para a opção Atualização de Status Web ser exibida no menu Funções da Tela [0418] ORÇAMENTO / PEDIDO DE VENDA, o usuário deverá possuir permissão de acesso habilitada para alteração de Pedidos de Venda em (Utilitários >> Perfil e Usuários >> Perfil >> Tela [0984] CADASTRO DE PERFIL >> Permissões >> Tela [0645] PERFIL – PERMISSÃO DE ACESSO >> 3.Vendas >> aba Pedido >> Agrupamento 2.Pedido de Venda >> 2.1 Cadastro >> opção Alterar).

(Expedição >> Etiquetas de Expedição >> Etiquetas de Postagem nos Correios >> Tela [0711] ETIQUETAS DE POSTAGEM)

Ao gerar etiquetas de postagem, o STATUS WEB do PEDIDO DE VENDA Faturado será alterado para o STATUS WEB configurado na Tela [1109] CADASTRO DE STATUS WEB, caso algum dos STATUS do Tipo de Pedido Faturado esteja com o PADRÃO RASTREIO marcado.

Por exemplo: considerar um Pedido de Venda com o tipo PEDIDO e STATUS WEB Aguardando Disponibilidade. Este Pedido de Venda é faturado, alterando assim seu tipo para FATURADO e STATUS WEB para Enviado a Transportadora (STATUS WEB cadastrado para o tipo de pedido FATURADO). É gerada uma etiqueta de postagem a partir da Nota Fiscal de Venda que importou este Pedido, o STATUS WEB do Pedido de Venda é alterado para FINALIZADO (STATUS WEB do TIPO DE PEDIDO FATURADO, que possui a opção PADRÃO RASTREIO marcada).

10

7 FORMA DE PAGAMENTO

(Financeiro >> Tabelas Financeiras >> Cartões de Crédito >> Tela [0130] OPERADORAS DE CARTÕES DE CRÉDITO E FINANCEIRA)

Configuração das formas de pagamento utilizadas atualmente pelas Integrações Web.

Utiliza TrayCheckout: Recurso exclusivo para formas de pagamento Tray Checkout, ao marcar essa opção na tela CARTÃO DE CRÉDITO no ERP, define que cálculos como desconto e data de pagamento ao lojista serão informados pelo parceiro TRAY.

Dias para Crédito: Preencher o campo com os dias para crédito separados por “/”. Por exemplo um cartão Visa 3x pode ser cadastrado como 30/60/90.

Site Código: Campo que define o código de integração para cartões de crédito fornecida pelos parceiros. Disponível para as integrações VTEX e IKEDA.

Descrição Site: Campo que define a descrição de integração para cartões de crédito fornecida pelos parceiros. Disponível para as integrações TRAY, FAST e E-commerce.

8 VISUALIZAR XML

(Utilitários >> Utilitários >> Visualizar XML Web >> Tela [0968] PESQUISA DE XML)

Para cada troca de informação entre o integrador e o parceiro, normalmente é enviado um arquivo XML e espera-se resposta de outro arquivo XML. Com isso é salvo no banco de dados do ERP e tem validade por 7 dias. Na Tela [0968] PESQUISA DE XML é possível uma fácil visualização.

Pesquisar Palavra: Campo destinado a pesquisar uma palavra em específico dentro do XML.

Período de: Data inicial para pesquisa do XML. Ele se baseia na data de criação do arquivo.

Período até: Data final para pesquisa do XML.

Loja: Busca o XML apenas em uma determinada loja de integração.

Ao selecionar um ou mais XML, o mesmo poderá ser salvo no computador para ser compartilhado posteriormente.

Caso desejar visualizar, de um duplo clique no arquivo e será apresentado o corpo do XML.

9 PROCESSAR PEDIDO WEB

(Vendas >> Pedidos e Orçamentos >> Pedidos via WEB >> Tela [0013] IMPORTAÇÃO PEDIDOS INTERNET) ou Tela inicial do Onclick >> Pedidos via WEB >> Tela [0013] IMPORTAÇÃO PEDIDOS INTERNET)

Ao importar pedidos da internet pelo integrador, eles serão apresentados na Tela [0013] IMPORTAÇÃO DE PEDIDOS WEB, para que confirme se o pedido é válido e o processe para efetivá-lo.

Filtro de período – De e até: Filtro de datas para demonstração do pedido. Por padrão ele preenche sempre um dia, mas pode ser configurado em UTILITÁRIOS >> SISTEMA >> [0030] CONFIGURAÇÕES DO SISTEMA >> LOJAS WEB >> ABA PARÂMETROS COMUNS DE INTEGRAÇÃO >> 1.7 DIAS P/ MOSTRAR PEDIDOS NA IMPORTA INTERNET.

Botão lateral PEDIDOS: Nessa tela serão carregados os pedidos de acordo com o filtro de datas. Para cada pedido selecionado, na tabela abaixo serão apresentados os itens desse pedido. Selecione os pedidos desejados e clique no botão “PROCESSAR”.

O ERP irá iniciar uma série de validações e cálculos de impostos, ao finalizar o processo dos pedidos, será apresentada uma mensagem avisando o usuário.

Os pedidos via web se encontrarão na tela de PEDIDOS e a partir de então, eles serão trabalhados normalmente sem diferenciações entre pedidos web ou não.

Botão lateral CLIENTES: Ao clicar nesse botão, serão apresentados os clientes que tem ou não pedidos vinculados. É recomendado que sempre seja processado o pedido pois o sistema automaticamente irá processar o cliente atrelado a ele. Caso houver cliente sem pedidos, será necessário marcá-lo e processá-lo para que seu cadastro fique válido no ERP.

Botão lateral LISTA DE DESEJOS: O mesmo processo ocorre para lista de presente (ou desejo) importadas pelo integrador Tray. Ao clicar no botão “Lista de Desejos”, serão apresentadas todas as listas pendentes para validação. Ao selecionar a lista escolhida, serão apresentados os produtos vinculados a ela. Clique em processar e o ERP deixará ela como uma lista de desejo válida e disponível. Integração disponível somente para integração Tray.

Botão ATUALIZAR PEDIDOS: Processo que realiza uma atualização nos registros pendentes para processar da tela.

Botão VISUALIZAR XML: Será apresentado a tela para pesquisar XML trocados entre o ERP e o parceiro web.

Botão SISFRETE: Será aberto uma tela que automaticamente percorrerá os pedidos pendentes e indicará uma melhor transportadora de acordo com o parceiro SisFrete.

Como regra, o sistema irá definir uma transportadora que entregue até o mesmo período da transportadora original do pedido por um custo melhor ao lojista.

Ao selecionar os pedidos, clique em Trocar Transportadora para que os dados de transporte sejam atualizados.

10 ATUALIZAR STATUS WEB

Vendas >> Pedidos e Orçamentos >> PEDIDO >>Tela [0418] ORÇAMENTO/PEDIDO DE VENDA >> Funções >> Atualização de Status Web > Tela [1110] ATUALIZAÇÃO DE STATUS WEB.

Além da possibilidade de atualizar o status web alterando diretamente um pedido, há a Tela [1110] ATUALIZAÇÃO DE STATUS WEB que possibilita uma atualização em massa dos pedidos.

Loja Web: É obrigatório informar a loja web que deseja atualizar o status dos pedidos.

Tipo Pedido: O tipo de pedido é obrigatório para que o campo Status Web carregue apenas status vinculados a aquele tipo.

Cliente (F2): Campo para pesquisa do cliente por código.

Nome: Campo para pesquisa do cliente por nome.

Pedido Internet: Campo para pesquisa de um pedido em específico.

Tipo: Se é um tipo ORÇAMENTO ou PEDIDO.

Período De: Data inicial para pesquisar um pedido importado nesse dia informado.

Até: Data final para pesquisar um pedido importado nesse dia informado.

Após carregar os pedidos de acordo com o filtro definido, selecione um ou mais pedidos que deseja atualizar o status web.

Atualizar Para: Campo onde deve informar para qual status web deseja vincular aos pedidos selecionados.

Clique no botão “PROCESSAR” e o ERP irá atualizar todos pedidos com o status desejado e apresentar uma mensagem que o processo foi realizado com sucesso.

11 PERMISSÕES DE ACESSO

Atualmente nas integrações com a Tray é possível definir algumas permissões de acesso ao usuário logado no integrador, para configurar tais permissões acesse: Utilitários >> Perfil e Usuários >> Perfil >>Tela [0984] CADASTRO DE PERFIL >> Permissões >> Tela [0645] PEFIL – PERMISSÃO DE ACESSO >> 15. INTEGRAÇÃO WEB.

1.1 PERMITE ENVIAR PRODUTOS: Desmarcando tal opção o botão ENVIAR PRODUTOS no integrador será desabilitado para o usuário vinculado ao perfil.

1.2 PERMITE ENVIAR PREÇO/PROMOÇOES DE PRODUTOS: Desmarcando tal opção o botão ENVIAR PROMOÇÃO no integrador será desabilitado para o usuário vinculado ao perfil.

1.3 PERMITE ENVIAR ESTOQUE DE PRODUTOS: Desmarcando tal opção o botão ENVIAR PREÇOS E ESTOQUE no integrador será desabilitado para o usuário vinculado ao perfil.

1.4 PERMITE ENVIAR NÍVEIS DE CATEGORIAS: Desmarcando tal opção o botão ENVIAR NÍVEIS no integrador será desabilitado para o usuário vinculado ao perfil.

1.5 PERMITE ENVIAR STATUS DE PEDIDOS: Desmarcando tal opção o botão ENVIAR STATUS DOS PEDIDOS no integrador será desabilitado para o usuário vinculado ao perfil.

1.6 PERMITE ENVIAR LISTA DE DESEJOS: Desmarcando tal opção o botão ENVIAR LISTA DE DESEJOS no integrador será desabilitado para o usuário vinculado ao perfil.

2.1 PERMITE IMPORTAR PEDIDOS: Desmarcando tal opção o botão IMPORTAÇÃO DE PEDIDOS no integrador será desabilitado para o usuário vinculado ao perfil.

2.2 PERMITE IMPORTAR CLIENTES: Desmarcando tal opção o botão IMPORTAR CLIENTES SEM PEDIDO no integrador será desabilitado para o usuário vinculado ao perfil.

2.3 PERMITE IMPORTAR LISTA DE DESEJOS: Desmarcando tal opção o botão IMPORTAÇÃO DE LISTAS DE DESEJOS no integrador será desabilitado para o usuário vinculado ao perfil.

2.4 PERMITE IMPORTAR ARQUIVOS: Desmarcando tal opção o botão IMPORTAR XLS no integrador será desabilitado para o usuário vinculado ao perfil.

3. EXPORTAÇÃO DE DADOS AUTOMÁTICO: Desmarcando as opções disponíveis, que são as mesmas descritas acima, a rotina automática de exportação não será iniciada no integrador cujo o usuário vinculado ao perfil estiver logado.

4. IMPORTAÇÃO DE DADOS AUTOMÁTICO: Desmarcando as opções disponíveis, que são as mesmas descritas acima, a rotina automática de importação não será iniciada no integrador cujo o usuário vinculado ao perfil estiver logado.

5. SUGESTÕES DE LOJAS AO INICIAR O INTEGRADOR: Tal opção permite selecionar qual loja web deseja que já venha selecionada no integrador para realizar as importações e exportações. Lembrando tal opção é uma sugestão, o usuário poderá selecionar outras lojas no integrador. Opção disponível somente para o integrador Tray.

12 INTEGRAÇÕES

A seguir serão apresentadas plataformas de e-commerce utilizadas por clientes que comercializam seus produtos através de lojas virtuais. O integrador (API), faz a conexão entre o sistema Onclick e a plataforma da loja virtual utilizada pelo cliente (ADMIN), levando e trazendo (exportando e importando) informações sobre produtos, clientes e pedidos do sistema Onclick para a plataforma e vice-versa.

12.1 Integração E-COMMERCE ou BIS2BIS

12.1.1 Login

Temos os seguintes campos na tela de login da API:

Empresa: Empresa liberada no terminal.

Usuário: Usuário do ERP.

Senha: Senha do usuário do ERP.

Filial: Filiais cadastradas/liberadas para esta empresa.

Loja Web: A demonstração das Lojas WEB é feita por filial, como o cadastro é feito por filial então o usuário precisa selecionar uma filial antes de escolher qual loja ele deseja enviar/receber dados.

 

12.1.2 Agendamento

O menu Agendamento exibe informações sobre os horários das importações/exportações efetuadas.

Exportações: Nesta coluna são demonstradas quais as exportações (envio) que a API realiza. Exporta informações de Estoque, Preços, Status do pedido e Cadastro de produto do sistema Onclick para a plataforma (ADMIN) da loja virtual do cliente.

Importações: Nesta coluna são demonstradas quais as importações (recebimentos) que a API realiza. Importa informações de Pedido e Clientes da plataforma para o sistema Onclick.

Intervalo: Exibe as Horas e Minutos, configuradas no cadastro de lojas web para que possa ser feita a atualização automática das informações. A configuração é realizada em (Onclick >> Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba Parâmetros Comuns de Integração >> 1. Dados Gerais).

Última Atualização: Exibe a Data e o Horário em que foi realizada a última ExportaçãoImportação de informação pela API.

Próxima Atualização: Exibe a Data e o Horário em que será a realizada a próxima ExportaçãoImportação de informações pela API.

As seguintes informações são enviadas e recebidas pela API:

Estoque: Apresenta a data em que foi realizada a última atualização de estoque, e caso esteja configurado o tempo de agendamento, será exibido quando será realizada a próxima atualização de estoque pela API.

Preços: Apresenta a data em que foi realizada a última atualização de preço, e caso esteja configurado o tempo de agendamento, será exibido quando será realizada a próxima atualização de preço pela API.

Status de Pedido: Apresenta a data em que foi realizada a última atualização de Status do Pedido pela API, e caso esteja configurado o tempo de agendamento, será exibido quando será a próxima atualização de Status pela API.

Cadastro de Produtos: Apresenta a data em que foi realizado o último envio de produtos pela API, não há configuração para envio automático de produtos, por isso nunca exibirá quando será a próxima atualização.

Pedido: Apresenta a data em foi realizada a atualização dos pedidos e caso esteja configurado o tempo de agendamento, será exibido quando será a próxima atualização pela API.

Cliente: Apresenta a data em que foi realizada a atualização dos clientes, e caso esteja configurado o tempo de agendamento, será exibido quando será realizada a próxima atualização.

12.1.3 Exportação de Clientes

O envio dos dados de clientes e vendedores do sistema Onclick para a plataforma (ADMIN) da loja virtual do cliente é realizado através da opção EXPORTAÇÃO DE CLIENTES do Integrador.

Período De..Até: Período em que compreenderá a Data de Cadastro ou Alteração, de Clientes ou Vendedores, para Exportação do sistema Onclick para a plataforma. Caso o campo esteja em branco será utilizada a data e hora do último envio.

 

Botão Exportar Clientes: O sistema considerará o filtro informado, ou caso não tenha filtro informado considerará a data da última atualização. Neste processo irá enviar os clientes cadastrados no ERP Onclick para a plataforma. Caso seja um cliente novo, esse cliente será cadastrado na plataforma e será retornado um arquivo XML contendo o Código de Referência do Cliente na plataforma (Site Codigo). O Envio de Clientes não permite a configuração “Enviar Por Bloco”. Segue abaixo os campos enviados:

Execucao: Tipo de Operação a ser executada, onde I = Inserir ou A = Alteração.

CodigoEcommerce: Código de Referência do Cliente na plataforma (Site Codigo).

CodigoCliente: Código do cliente no ERP.

DtCadastro: Data de Cadastro no ERP.

TipoCliente: Tipo de Pessoa, onde F = Física ou J = Jurídica.

Empresa: Razão Social do ERP.

ContatoCliente: Descrição (Nome) do Contato que o Cliente tem (Cadastro).

SexoCliente: Sexo do Cliente no ERP.

DtNascCliente: Data de Nascimento no ERP.

EmailCliente: E-Mail do cliente no ERP.

CNPJ/CPF: CNPJ ou CPF do cliente.

IE/RG: Inscrição Estadual ou RG do cliente.

RamoCliente: Ramo de Atividade do Cliente.

PercentualDesc: Porcentagem de Desconto C.R.

EnderecoCliente: Endereço de Faturamento.

NumeroEnd: Número do Endereço de Faturamento.

Complemento: Complemento do Endereço de Faturamento.

BairroCliente: Bairro do Endereço de Faturamento.

CidadeCliente: Cidade do Endereço de Faturamento.

EstadoCliente: Estado do Endereço de Faturamento.

PaisCliente: Pais do Endereço de Faturamento.

CEPCliente: CEP do endereço de Faturamento.

TelefoneCliente: Telefone do Cliente (Enviado apenas se estiver preenchido).

CelularCliente: Celular do Cliente (Enviado apenas se estiver preenchido).

FAXCliente: Fax do cliente (Enviado apenas se estiver preenchido).

ObsCurta: Observação Curta sobre o cliente

Newsletter: Campo se Permite o Envio de E-mail promocional para o cliente.

Comissionado: Caso o campo “% COMISSÃO – A VISTA” esteja com valor maior que 0 é enviado como “T” (True), caso contrário é enviado “F” (False).

Porcentagem: Campo enviado apenas se o “% COMISSÃO – A VISTA” estiver preenchido, é enviada a porcentagem da comissão à vista.

Observação: Observação sobre o cliente.

Vendedor: Enviado o Código do Vendedor do ERP.

Botão Exportar Vendedores: O sistema considerará o filtro informado, ou caso não tenha filtro informado considerará a data da última atualização. Neste processo irá enviar os vendedores cadastrados no ERP Onclick para a plataforma. O Envio de Vendedores não permite a configuração “Enviar Por Bloco”. Segue abaixo os campos enviados:

Execução: Tipo de Operação a ser executada, onde I = Inserir ou A = Alteração.

CodigoEcommerce: Código de Referência do Vendedor na plataforma (Site Codigo), este campo só é enviado caso a Execução seja “A”.

Vendedor:Código do Vendedor no ERP.

Nome: Nome do Vendedor.

Email: E-mail do vendedor.

12.1.4 Importação de Clientes

O envio dos dados de clientes da plataforma (ADMIN) da loja virtual do cliente para o ERP Onclick é realizado através da opção IMPORTAÇÃO DE CLIENTES do Integrador.

Período De…Até: Período em que compreenderá a Data de Cadastro ou Alteração de clientes, para importação da plataforma para o sistema Onclick. Caso o campo esteja em branco será considerada a data e hora do último envio.

Botão Importar Clientes: O sistema considerará o filtro informado, ou caso não tenha filtro informado considerará a data da última atualização. Caso o cliente já exista no ERP Onclick, seus dados serão apenas atualizados, caso não exista, seus dados serão gravados na tabela SITE_CLIFOR para posterior processamento. Quando informado o parâmetro da Data Inicial e Final de cadastro dos clientes, será gerado o seguinte arquivo XML:

Codigoecommerce: Código de Referência do Cliente na Plataforma (SITE CODIGO da tabela CLIFOR).

Dtcadastro: Data de Cadastro do Cliente na Plataforma.

Tipocliente: Tipo de Pessoa do Cliente, onde F = Física, e J = Jurídica.

Empresa: Razão Social do Cliente ou Empresa.

Contatocliente: Descrição de Contatos do Cliente.

Sexocliente: Sexo do Cliente (Feminino ou Masculino).

Dtnasccliente: Data de Nascimento do Cliente (informado na Plataforma).

Emailcliente: E-mail de cadastro do Cliente.

CNPJ/CPF: CPF ou CNPJ do Cliente.

IE/RG: Inscrição Estadual ou RG do cliente/empresa.

Ramocliente: Campo não utilizado.

Percentualdesc: Desconto que o cliente pode ter no ERP (Desconto C.R.), valor em percentual.

Enderecocliente: Endereço de Cobrança e de Faturamento do cliente.

Numeroend: Número do Endereço de Cobrança e de Faturamento do cliente.

Complemento: Complemento do Endereço de Cobrança e do Faturamento do cliente.

Bairrocliente: Bairro do Endereço de Cobrança e do Faturamento do cliente.

Cidadecliente: Cidade do Endereço de Cobrança e do Faturamento do cliente.

Estadocliente: Estado do Endereço de Cobrança e do Faturamento do cliente.

Paiscliente: Pais do Endereço de Cobrança e do Faturamento do cliente.

Cepcliente: CEP do Endereço de Cobrança e do Faturamento do cliente.

Telefonecliente: Telefone de Cobrança e de Faturamento do cliente.

Celularcliente: Celular de Cobrança e de Faturamento do cliente.

Faxcliente: FAX do cliente.

Obscurta: Observação curta do cliente e do vendedor.

Formapagamento: Campo Não utilizado.

Newsletter: Campo se Permite o Envio de E-mail promocional para o cliente.

Comissionado: Campo não utilizado.

Porcentagem: Porcentagem de desconto/comissão a Vista.

Observação: Campo Observação do cadastro de cliente.

Vendedor: Campo “Vendedores” do cadastro de cliente.

12.1.5 Exportação de Produtos

O envio de produtos do sistema Onclick para a plataforma (ADMIN) da loja virtual do cliente é realizado através da opção EXPORTAÇÃO DE PRODUTOS do Integrador.

Neste menu são apresentadas 3 opções, onde cada uma refere-se à informação que será enviada:

Enviar Produtos: Enviará informações sobre o cadastro de produto, como descrição, código, marca, peso, categoria, quantidade do estoque, preço, estoque mínimo, garantia e complemento. Só será exibido o produto pai, mas caso este tenha filho, enviará o produto filho também.

Enviar Estoque: Enviará somente o estoque atual dos produtos que sofreram alteração no estoque, independente deste ser pai ou filho.

Enviar Preços: Enviará somente o preço da tabela de preço dos produtos que sofreram alteração em seu preço, independente deste ser pai ou filho.

Período De…Até: Período em que compreenderá a Data de Cadastro ou Alteração de produtos, para exportação do sistema Onclick para a plataforma. Caso o campo esteja em branco será considerada a data e hora do último envio.

Cód Produto/Barra/Fabricante/Auxiliar: Selecionar a opção que deseja considerar no filtro, entre Código de Produto, Barra, Fabricante ou Auxiliar. Quando informado um valor neste campo, nenhum outro filtro é considerado, todos os outros campos são desabilitados.

Categoria: Níveis de cadastros no ERP liberados para a Loja WEB selecionada.

Marca: Marcas cadastradas no ERP liberadas para a Loja WEB selecionada.

Característica: Características cadastradas no ERP liberadas para a loja WEB selecionada

Enviar Níveis de Categorias ao exportar produtos: Quando selecionado no Envio de Produtos, irá enviar todos os níveis de categoria cadastrados no ERP para a plataforma.

Enviar marcas ao exportar produtos: Quando selecionado no Envio de Produtos, serão enviadas todas as marcas cadastradas no ERP para a plataforma.

Botão Enviar Produtos

Para exportar os produtos, informe no filtro PERÍODO DE…ATÉ, a data desejada de cadastro ou alteração do produto e/ou informe os dados do(s) produto(s) a serem exportados através dos filtros código do produto, categoria, marca e característica. Clique então em ENVIAR PRODUTOS. Será aberta a Tela EXPORTAÇÃO DE PRODUTOS que listará os produtos pesquisados de acordo com os filtros informados.

Os produtos listados nesta Tela, obedecerão as seguintes regras:

  • Só serão exibidos produtos pai ou produtos únicos;
  • Caso seja informado o filtro de data/hora (PERÍODO DE…ATÉ), serão exibidos os itens cadastrados ou alterados no período informado; caso não seja informado o filtro, serão exibidos os itens cadastrados ou alterados desde o último envio até o momento presente, de acordo com o campo DTCAD da tabela PRODUTO; ou
  • Os itens que sofreram alteração na tabela de preço, de acordo com o campo DATA da tabela referente à tabela de preço utilizada para a loja web; ou
  • Os itens que sofreram alteração em seu estoque atual, de acordo com o campo DTALTESTOQUE da tabela PRODUTO; ou
  • Os itens que foram reservados neste período (inclusos em um pedido de venda), de acordo com o campo DTRESERVA da tabela PRODUTO_RESERVA.
  • A tabela de preço utilizada na loja WEB é a informada no parâmetro 2. TABELA DE PREÇO A ENVIAR em (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba e-commerce). Caso não haja tabela de preço configurada nesta opção, será utilizada a informada no parâmetro 6.TABELA DE PREÇO em (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba Geral >> 6.Tabela de Preço). Caso também não haja tabela de preço informada neste campo, será utilizada a tabela de preço padrão do sistema.

Na Tela EXPORTAÇÃO DE PRODUTOS, selecione os produtos que serão exportados e clique em CONFIRMAR.

O envio começará e será exibido na parte inferior da Tela:

O envio de produtos é realizado considerando-se as seguintes informações:

  • Serão considerados tanto os campos de data (filtro período de..até), quanto os campos de produto (filtros código do produto, categoria, marca e característica).
  • Serão enviados somente os produtos cujo cadastro no sistema Onclick esteja com o tipo de produto configurado como ACABADO ou KIT DE PRODUTOS em (Onclick >> Cadastros >> Produtos >> Produtos >> Tela [0293] CADASTRO DE PRODUTOS >> Alterar >> Tela [0324] ALTERAÇÃO DE PRODUTOS >> aba Dados Gerais >> campo Tipo).
  • Serão enviados somente os produtos cujos os parâmetros ENVIAR PRODUTO PARA O SITE e PRODUTO DISPONÍVEL do cadastro do produto estiverem marcados em (Onclick >> Cadastros >> Produtos >> Produtos >> Tela [0293] CADASTRO DE PRODUTOS >> Alterar >> Tela [0324] ALTERAÇÃO DE PRODUTOS >> aba Integração Web).
  • Os almoxarifados deverão estar inicializados e o produto deve possuir estoque.
  • O produto deve ser pai, ou ser um produto único.
  • O produto deve possuir as informações de peso bruto, peso líquido, largura, altura, comprimento e volume cúbico preenchidos.
  • Em produtos do tipo kit, quando houver alteração de algum produto que compõe o kit, será enviado o kit também.

O arquivo XML gerado conterá:

Característica: Envia as características cadastradas no ERP, para vinculação entre ERP x Plataforma, pode ser utilizado “Envio Por Bloco” nesta operação, caso o processo dê erro na operação, nenhuma operação irá ser executada. Abaixo os campos enviados:

  • Execucao: Tipo de Operação a ser executada, I – Inserir ou A – Alteração.
  • CodigoEcommerce: Código de Referência no site, só é enviado quando a característica estiver no site (Execução = A).
  • CodigoCaract: Código Interno da Característica (Codigo).
  • DescricaoCaract: Descrição da Característica cadastrada no ERP.

Nível de Categoria: Envia o Nível de Categoria cadastrada no ERP, para vinculação entre ERP x Plataforma, pode ser utilizado “Envio Por Bloco” nesta operação, caso o processo dê erro na operação, nenhuma operação irá ser executada. Abaixo os campos enviados:

  • Execucao: Tipo de Operação a ser executada, I – Inserir ou A – Alteração.
  • CodigoEcommerce: Código de Referência no site, só é enviado quando o nível de categoria já estiver no site (Execução = A).
  • CodigoCategoriaPai: Código do nível de categoria pai, ao qual o nível atual está vinculado.
  • CodigoCategoria: Código interno da tabela de nível de categoria.
  • Categoria: Descrição do Nível de Categoria cadastrado no ERP.

Marcas: Envia as marcas cadastradas no ERP, para vinculação entre ERP x Plataforma, pode ser utilizado “Envio por Bloco” nesta operação, caso o processo dê erro na operação, nenhuma operação irá ser executada. Abaixo os campos enviados:

  • Execucao: Tipo de Operação a ser executada, I – Inserir ou A – Alteração.
  • CodigoEcommerce: Código de Referência no site, só é enviado se a marca já estiver no site (Execução = A).
  • CodigoMarca: Código interno da tabela de marca (fabricante).
  • DescricaoMarca: Descrição da marca cadastrada no ERP.

Produto: Envia os Produtos cadastrados no ERP liberados para a Loja WEB selecionada, nesta operação só serão enviados Produtos Pai e Produtos acabados para vinculação entre ERP x Plataforma, pode ser utilizado “Envio por Bloco” nesta operação, caso o processo dê erro na operação, mais nenhuma operação será executada. Abaixo os campos enviados:

  • Execucao: Tipo de Operação a ser executada, I – Inserir ou A – Alteração.
  • MetaKeywordsProduto: É enviado o Cód.Prod e o campo MetaKeyWords entre “<–“ e “–>”.
  • CodigoeCommerce: Enviado apenas quando o Produto já estiver no site, é o ID Produto (Site Código) da aba “Ecommerce”. (Execução = A).
  • QtdEstoqueProduto: Enviado a quantidade de Estoque atual do Produto ((Almoxarifados + Est.Segurança) – Reserva), caso o produto tenha Fator de Conversão ele será multiplicado pelo valor, o Est. Segurança pode ser configurado para Envio ou não.
  • QtdEstoqueMinimo: Enviado o estoque mínimo configurado no Produto.
  • VrPreco: Valor de Preço de Venda, enviado da tabela de Preço configurado na Loja WEB.
  • VrPrecoPromocional: Valor de Promoção, enviado da tabela de Preço configurado na Loja Web, caso não tenha valor de promoção é enviado o mesmo valor do campo “VrPreco”.
  • InicioPromocao: Data e Hora de início da promoção, enviado da tabela de Preço configurada na Loja WEB, caso não tenha valor de promoção este campo não é enviado e caso não tenha horário, o valor padrão a ser enviado é “00:00:00”.
  • FimPromocao: Data e Hora do fim da promoção, enviado da tabela de Preço configurada na Loja WEB, caso não tenha valor de promoção este campo não é enviado e caso não tenha horário, o valor padrão a ser enviado é “23:59:59”.
  • CodigoMarca: Código de Referência (SITE) da marca.
  • NomeCategoria: Descrição do Nível de Categoria vinculada ao Produto.
  • CodigoProduto: Código de Referência do Produto na plataforma, pode ser configurado entre: Cód.barras, Cód.Produto, Cód. Auxiliar e Cód. Fabricante.
  • NomeProduto: Descrição (SITE) do produto (Descrição do Produto na aba Integração WEB do Cadastro de Produto).
  • PesoProduto: Peso bruto do Produto no ERP.
  • DescricaoProduto: Descrição Curta do produto (Descrição Curta na aba Integração WEB do Cadastro de Produto).
  • DescricaoLongaProduto: Descrição Longa do produto (Descrição longa na aba Integração WEB no Cadastro de Produto).
  • TextoHtml: Texto em HTML do produto (Aba Integração WEB >> aba Descrição HTML), é enviado a informação dentro da tag <![CDATA[]]>
  • DescricaoHTMLProduto: Este campo é enviado branco.
  • DescricaoURLProduto: Este campo é enviado branco.
  • URLTarget: Enviado como T ou F, é o campo “URL Externa” da aba (Integração WEB > Descrição Produto) no cadastro de Produto.
  • Garantia: Campo “Garantia” no cadastro de produto (Integração Web > Descrição Produto > aba E-Commerce), campo texto de livre digitação.
  • Disponibilidade: Campo “Disponibilidade” no cadastro de produto (Integração WEB > Descrição Produto > aba E-Commerce), campo texto de livre digitação.
  • Disponivel: Informa se o produto está disponível ou não na plataforma, se os campos “Produto Disponível” e “Produto Inativo” estiverem marcados, será enviado “F” caso contrário será enviado “T”.
  • MaxParcelasProduto: Este campo é enviado branco.
  • XMLParcelasProduto: Este campo é enviado branco.
  • Lancamento: Campo “Lançamento” no cadastro de produto (“Integração WEB”), caso marcado será enviado “T”, caso contrário será enviado “F”.
  • EmDestaque: Campo “Destaque” do cadastro de produto (“Integração WEB”), caso marcado será enviado T, caso contrário será enviado “F”.
  • CodigoNivelProduto: Código de Referência (SITE) do nível de categoria do produto.
  • CodigoProdutoPai: Código de Referência (SITE) do Produto Pai, caso o produto for filho é enviado o código de referência (SITE_CODPAI), caso seja Pai ou único é enviado zero.
  • OrdemProduto: Ordem de como será demonstrado o produto na plataforma, campo “ORDEM” do cadastro de produto “Integração WEB”.
  • DtVencimento: Data de Vencimento do Produto.
  • Largura: Largura do Produto.
  • Altura: Altura do Produto.
  • Comprimento: Comprimento do Produto.
  • VolCubico: Volume Cúbico do Produto.
  • Classificacao1: Este campo é enviado branco.
  • Classificacao2: Este campo é enviado branco.
  • Classificacao3: Este campo é enviado branco.
  • ClassificacaoAdicional1: Este campo é enviado branco.
  • ClassificacaoAdicional2: Este campo é enviado branco.
  • ClassificacaoAdicional3: Este campo é enviado branco.
  • CodigoCores: Este campo é enviado branco.
  • MaisProduto: Composição do Produto, será enviado separado por vírgula o código do fabricante, para que o cliente possa formar uma composição (de cereal por exemplo) no site.
  • CodigoCategoria: Este campo é enviado fixo “0”.
  • TemFilhos: Caso o produto enviado tenha filho será enviado como “T”, caso não tenha filho (produto único ou é um filho) será enviado como “F”.
  • Campos Personalizados: Pode-se enviar campos Personalizados na API do E-commerce, para isso, o usuário deverá configurar no produto os campos “C_CAMPOEXTRA1”, “C_CAMPOEXTRA2”, “C_CAMPOEXTRA3”, “C_CAMPOEXTRA4”, “C_CAMPOEXTRA5”.
  • DiasEntrega: Campo “Dias para Entrega” do cadastro de Produto.
  • Complemento: Campo “Complemento” do cadastro do Produto.

Produto x Característica: Envia as Característica do Produto, exemplo de um Produto geladeira temos as características “110v”, “220v” e “Bivolt”, são essas as informações enviadas. Pode ser utilizado “Envio por Bloco” nesta operação. Detalhe que só serão enviados os produtos que foram enviados na operação de “Enviar Produtos”. São enviadas as seguintes informações:

  • Execucao: Irá sempre ser enviado como “I” – Inclusao”.
  • CodigoProduto: Código de Referência do Produto.
  • CodigoCaract: Código da Característica do Produto (Grupo2), código interno.
  • ValorCaracProduto: Valor da Característica do Produto (Descrição).

Tabela de Preço: Tabela de Preço configurada no Cadastro de Lojas WEB, por ela o usuário irá enviar a tabela de preço (Valor do Produto e Promoção) para a plataforma, pode ser utilizado “Envio por Bloco” nesta operação.

  • Execucao: Irá sempre ser enviado como “A” – Alteração.
  • CodigoEcommerce: Código de Referência na plataforma (Site Codigo).
  • NomeTabela: Nome da Tabela dentro da plataforma, utilizado para referência entre Tabela de Preço Plataforma x Tabela de Preço ERP. Campo configurado no cadastro de Loja Web.
  • VrPreco: Preço do produto na tabela de preço que está sendo enviado (PrecoVar).
  • Quantidade: Quantidade de produto para compra na plataforma para que a tabela de preço comece a valer, está enviando fixo 1.
  • InicioPromocao: Data e Hora do início da promoção, da tabela de preço a ser enviada. Caso não tenha será enviado em branco.
  • FimPromocao: Data e Hora do fim da promoção, da tabela de preço a ser enviada. Caso não tenha será enviado em branco.
  • VrPrecoPromocional: Valor de Preço da promoção na tabela de preço que está sendo enviada (PROM_VAREJO), caso não tenha informado nada será enviado o mesmo valor da tag “VrPreco” (PrecoVar).

SKU: Igual o Produto, porém só serão enviados os produtos filhos.

Produto x Característica (SKU): Igual o Envio de Produto x Característica, porém serão enviados apenas os produtos filhos que foram enviados no “Produto x Característica”.

Tabela de Preço (SKU): Igual o envio da “Tabela de Preço”, porém serão enviados apenas os produtos filhos que foram enviados no envio “Tabela de Preço”.

Botão Enviar Estoque: A opção Enviar Estoque enviará somente a quantidade de estoque dos produtos que sofreram alteração em seu estoque, de acordo com o campo DTALTESTOQUE da tabela PRODUTO e com o campo DTRESERVA da tabela PRODUTO_RESERVA.

Caso o produto tenha o estoque negativo, será enviado o estoque negativo.

O cálculo do estoque é: Estoque atual + Estoque de Segurança – reserva de estoque.

Esta opção obedecerá as mesmas informações dos filtros, a diferença é que enviará tanto os produtos pai quanto filho.

O arquivo XML gerado:

Execucao: Enviado fixo como “A”, Alteração.

CodigoEcommerce: Código de Referência do produto no site (Site Codigo).

QtdEstoqueProduto: Estoque Atual do produto (entre os almoxarifados configurados, caso não selecione nenhum Almoxarifado, serão todos os Almoxarifados disponíveis para venda. Caso não exista “Múltiplos Almoxarifados” liberado para a base, será utilizado o valor do estoque da tabela de produto). Pode-se enviar o Est. Segurança ou não, dependendo da configuração.

Botão Enviar Preços: A opção Envio de Preços enviará somente a informação do preço de venda do produto que sofreu alteração, atualizando a informação do preço na tabela de venda, de acordo com o campo DATA da tabela TABELADEPREÇO.

O arquivo XML gerado contém:

Execucao: Irá fixo como “A”, Alteração.

CodigoEcommerce: Código de Referência do produto no site (Site Código).

VrPreco: Valor do Produto na tabela de Preço (Na qual o Produto pertence à primeira tabela que ele achar valor para este produto, valor citado é o registro na tabela de preço).

VrPrecoPromocional: Valor de Promoção da tabela de Preço (Na qual o produto pertence ou a primeira tabela que ele achar valor para este produto, semelhante ao “VrPreco” só que o valor encontrado seria na qual o produto tem registro na tabela de preço), caso não tenha valor de promoção é enviado com as mesmas informações do campo “VrPreco”.

InicioPromocao: Enviado apenas se o produto tem Valor de Promoção, é utilizado o preço da tabela de preço a Data/Hora de início da promoção, caso não tenha hora é enviado “00:00:00”.

FimPromocao: Enviado apenas se o produto tem valor de promoção, é utilizado o preço da tabela de preço Data/Hora de fim da promoção, caso não tenha hora é enviado “23:59:59”.

O envio de produtos, ou atualização de preços ou estoque, gerará um arquivo XML, o qual poderá ser visualizado no sistema Onclick em (Utilitários >> Utilitários >> Visualizar XML Web >> Tela [0968] PESQUISA DE XML >> selecionar o arquivo >> Abrir XML).

 

12.1.6 Importação de Produtos

O envio de produtos da plataforma (ADMIN) da loja virtual do cliente para o sistema Onclick é realizado através da opção IMPORTAÇÃO DE PRODUTOS do Integrador.

Botão Importar Níveis

Será importado da plataforma todos os Níveis de Categorias para cadastro no ERP. Abaixo as informações presentes da Importação:

Site Codigo: Código de Referência do Nível de Categoria no Site.

CodPai: Código de Referência do Nível de Categoria PAI no Site.

CodFilho: Código de Referência do Nível de Categoria do Filho no site.

Descrição: Descrição do Nível de Categoria.

Botão Importar Característica: O sistema importará da plataforma as características para cadastro no ERP. Abaixo as informações presentes da Importação:

Site Codigo: Código de Referência da Característica no site.

Codigo: Código da Característica para o ERP (Campo não utilizado).

Descrição: Descrição da Característica.

Botão Importar Produtos: O sistema importará da plataforma todos os Produtos para cadastro no ERP (utilizado geralmente quando é cliente que já utiliza uma plataforma ECommerce), nesta importação são considerados o Nível de Categoria e as Característica para importação. Abaixo as informações presentes da Importação:

Execucao: Código de Referência da Característica no site.

Nomecategoria: Código da Característica para o ERP (Campo não utilizado).

Codigocategoria: Descrição da Característica.

Codigoecommerce: Código de Referência do Produto na plataforma (Site código).

Codigoproduto: Código do Fabricante ou Código Auxiliar do Produto (depende da configuração no cadastro de lojas web “Código de Referência”, os códigos de barras e de produtos não foram implementados neste método).

Nomeproduto: Descrição do Produto (e do Site).

Pesoproduto: Peso Bruto do Produto.

Descricaoproduto: Descrição Curta do Produto.

Descricaolongaproduto: Descrição Longa do Produto.

Textohtml: Texto em HTML do Produto (aba Integração Web >> Descrição HTML). Descricaohtmlproduto: Descrição em HTML do produto (aba Integração Web > E-Commerce > Descrição HTML).

Descricaourlproduto: Campo não utilizado.

Metakeywordsproduto: Palavras chave do produto (aba “Integração Web > E-Commerce > Meta KeyWords*” do cadastro de produto).

Urltarget: URL Externa do produto (CheckBox da aba “Integração Web” do cadastro de produto).

Codigonivelproduto: Nível de Categoria do produto.

Qtdestoqueproduto: Estoque atual do Produto (A Informação é salva apenas na tabela de produto).

Qtdestoqueminimo: Estoque Mínimo do produto.

Disponivel: Produto Disponível na Plataforma (ChecBox da aba “Integração Web” do cadastro de produto).

Vrcusto: Custo do Produto (Campos salvos: VrCompraVar, CustoVar, CustoMedio, VrCompra_Medio).

Vrpreco: Valor de Venda (PrecoVar da tabela de Venda do produto)

Vrprecopromocional: Valor de Venda em Promoção (Prom_Varejo).

Iniciopromocao: Data de Início da Promoção

Fimpromocao: Data do Fim da Promoção

Maxparcelasproduto: Max Parc (Informação salva na aba “Integração Web” do cadastro de produto) – Número máximo de parcelas para pedidos que incluam este produto.

Xmlparcelasproduto: XML Parc. (Informação salva na aba “Integração Web” do cadastro de produto) – Identifica o número de parcelas utilizadas para exibir o parcelamento na página que lista os produtos em XML.

Lancamento: Informa se o produto é um Lançamento na plataforma.

Emdestaque: Informa se o produto é para ficar em destaque na plataforma.

Imagemproduto: URL da imagem principal.

Imagemdetalhe: URL da imagem em detalhes.

Imagemampliada: URL da imagem ampliada.

Classificacao1: Não utilizado.

Classificacao2: Não utilizado.

Classificacao3: Não utilizado.

Classificacaoadicional1: Não utilizado.

Classificacaoadicional2: Não utilizado.

Classificacaoadicional3: Não utilizado.

Codigocores: Não utilizado.

Ordemproduto: Campo destinado para o integrador saiba qual a sequência de apresentação do produto no site.

Codigoprodutopai: Código de Referência do produto na plataforma.

Maisproduto: Código de Referência do produto na plataforma separado por vírgula, neste campo informa qual a composição para a montagem deste produto (utilizado para a MyMix, formando um produto tigela com X cereais).

Imagemampliada: URL da imagem ampliada.

Classificacao1: Não utilizado.

Classificacao2: Não utilizado.

Classificacao3: Não utilizado.

Classificacaoadicional1: Não utilizado.

Classificacaoadicional2: Não utilizado.

Classificacaoadicional3: Não utilizado.

Codigocores: Não utilizado.

Ordemproduto: Identifica qual a sequência de apresentação do produto no site.

Codigoprodutopai: Código de Referência do produto na plataforma.

Maisproduto: Código de Referência do produto na plataforma separado por vírgula, neste campo informar qual a composição para a montagem deste produto (utilizado para a MyMix, formando um produto tigela com X cereais diferentes).

Dtvencimento: Data de Vencimento do Produto.

12.1.7 Importação de Pedidos

A importação de Pedidos de Venda da plataforma (ADMIN) da loja virtual do cliente para o sistema Onclick é realizada através da opção IMPORTAÇÃO DE PEDIDOS do Integrador.

A importação é realizada respeitando-se os parâmetros da data início e data fim informados na Tela. Informe a data desejada e clique em IMPORTAÇÃO DE PEDIDOS. Começará a leitura dos pedidos inclusos ou alterados dentro do período informado, após o término da importação, será exibida a mensagem: Leitura dos Pedidos concluída. Caso o parâmetro de data seja deixado em branco, será considerada a data da última atualização até a hora atual.

A importação dos pedidos é realizada importando-se o cabeçalho do pedido de venda, os itens do pedido, e a forma de pagamento, tudo em um único arquivo XML. Quando há mais de um item no pedido, o cabeçalho é duplicado no arquivo XML.

Os pedidos importados serão exibidos na Tela [0013] IMPORTAÇÃO DE PEDIDOS INTERNET do sistema Onclick em (Tela inicial >> Pedidos via web >> Tela [0013] IMPORTAÇÃO DE PEDIDOS INTERNET). Para que sejam importados para a Tela de Pedido de Venda, e consequentemente para a tabela CPED, é necessário clicar em Processar.

  • Se o pedido de venda já estiver no sistema Onclick e for processado o mesmo período, o pedido será importado novamente, sendo realizadas as alterações caso haja, como endereço de entrega, valor do pedido, observação, razão social, frete, etc; porém seus dados serão atualizados somente se o parâmetro Atualizar status ao receber um Pedido Existente estiver marcado em (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba E-commerce >> 1.7 Atualizar status ao receber um Pedido Existente), e o tipo do pedido não for do tipo fixo, em (Vendas >> Tabelas diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE PEDIDO >> Status Web >> aba Integração Web >> campo FIXO marcado);
  • O tipo do pedido verificado será o do cabeçalho;
  • Se o pedido estiver aguardando o processamento na Tela [0013] IMPORTAÇÃO DE PEDIDOS INTERNET, as alterações serão realizadas independente das configurações.

Quando ocorre a importação de pedidos, algumas informações são atualizadas no banco de dados do Onclick, são elas:

Na Tabela SITE_CLIFOR:

Se o cliente já existir, será alterado. Se não existir, será incluso.

A busca pelo cliente será comparando o campo CPF/CNPJ do arquivo XML e o campo CPF/CNPJ da tabela SITE_CLIFOR, ou o campo EMAIL do arquivo XML com o campo EMAIL da tabela EMAILCLIENTE.

Campo na Tabela SITE_CLIFOR Tag no Arquivo XML
RAZSOCIAL Preenchido com a informação do campo EMPRESA ou NOMECLIENTE
CNPJ_CPF Preenchido com a informação do campo CPF/CNPJ
ID Utiliza o generator SITE_CLIFOR
PROCESSAR Passa a ser T fixo.
PESSOAFJ Preenchido com F ou J
CEP Preenchido com a informação do campo CEPCLIENTE
RGIE Preenchido com a informação do campo RG/IE
ENDEREÇO Preenchido com a informação do campo ENDEREÇOCLIENTE
NUMERO Preenchido com a informação do campo NUMEROEND
COMPLEMENTO Preenchido com a informação do campo COMPLEMENTO
BAIRRO Preenchido com a informação do campo BAIRROCLIENTE
CIDADE Preenchido com a informação do campo CIDADECLIENTE
UF Preenchido com a informação do campo ESTADOCLIENTE
TELEFONE Preenchido com a informação do campo TELEFONE CLIENTE
EMAIL Preenchido com a informação do campo EMAILCLIENTE
DATAHORA Preenchido com a informação do campo DTPEDIDO
CONTATO Preenchido com a informação do campo NOMEENTREGA
ENDENT Preenchido com a informação do campo ENDSEREÇOENTRADA
NRENDENT Preenchido com a informação do campo NUMEROENDENTREGA
COMPLENT Preenchido com a informação do campo COMPLEMENTOENTREGA
BAIRROENT Preenchido com a informação do campo BAIRROENTREGA
CIDADEENT Preenchido com a informação do campo CIDADEENTREGA
UFENT Preenchido com a informação do campo ESTADOENTREGA
TELTRAB Preenchido com a informação do campo TELEFONEENTREGA
FAX Preenchido com a informação do campo FAXENTREGA
DTNASCTO Preenchido com a informação do campo DTNASCCLIENTE
EMAIL_CONTATO Preenchido com a informação do campo EMAILENTREGA
PAIS Preenchido com a informação do campo PAISCLIENTE
TIPOCLIENTE É fixo C (consumidor)
OBSERVAÇÃO Preenchido com a informação do campo OBSCLIENTE

Na tabela SITE_CPED:

Os dados do pedido serão inclusos, ou alterados caso já existam.

Campo na Tabela SITE_CPED
NRPEDIDO Preenchido com a informação do campo NUMERO PEDIDO
TIPO_IMPORTACAO Fixo = 5 – corresponde ao e-commerce
ATENDIMENTO Preenchido com a informação do campo WEB_ATENDIMENTO da Tabela WEBLOJAS
EMPRESA Preenchido com a informação do campo CODIGO da tabela CONFIG
CLIENTE Preenchido com a informação do campo ID da tabela SITECLIFOR
CNPJ_CPF Preenchido com a informação do campo CPF/CNPJ do arquivo XML
DATAHORA Preenchido com a informação do campo DTPEDIDO do arquivo XML
DATA Preenchido com a informação do campo DTPEDIDO do arquivo XML
HORA Preenchido com a informação do campo DTPEDIDO do arquivo XML
RAZSOCIAL Preenchido com a informação do campo RAZSOCIAL da tabela SITE_CLIFOR
BAIRRO Preenchido com a informação do campo BAIRROENT da tabela SITE_CLIFOR
CEP Preenchido com a informação do campo CEPENT
CIDADE Preenchido com a informação do campo CIDADEENT
ENDERECO Preenchido com a informação do campo ENDENT
NRENDERECO Preenchido com a informação do campo NRENDENT
COMPLEMENTO Preenchido com a informação do campo COMPLENT
EMAIL Preenchido com a informação do campo NOMEENTREGA
FANTASIA Preenchido com a informação do campo FANTASIA
PESSOAPJ Preenchido com a informação do campo PESSOAFJ
RGIE Preenchido com a informação do campo RGIE
TELEFONE Preenchido com a informação do campo TELEFONE
UF Preenchido com a informação do campo UFENT
TIPOPEDIDO P fixo
FORMAPAGTO Preenchido com a informação do campo PAGAMENTO do arquivo XML
CARTAO Preenchido com a informação do campo CARTAO do arquivo XML
QTDEPARCELAS Preenchido com a informação do campo PARCELAS do arquivo XML
VRFRETE Preenchido com a informação do campo FRETE do arquivo XML
VREMBALAGEM Formado por VALOREMBALGEM + OUTRAS DESPESAS do arquivo XML
VALOR Formado por Soma do total dos itens + valor de frete + valor da embalagem – desconto. O “desconto é composto pelo total dos itens – valor do pedido”.
VRPRODUTOS Formado por Soma dos itens do Pedido
PARCEIRO Preenchido com a informação do campo PARCEIRO do arquivo XML
NRCONHECIMENTO Preenchido com a informação do campo CODSEDEX do arquivo XML
VERSAOAPI Versão exe
USUARIO Preenchido com O código do usuário logado
CONDPAGTO Preenchido com A QUANTIDADE DE DIAS do cartão de crédito
TIPOPEDIDO Preenchido com Código do Tipo. É buscado pela descrição e Web loja. DESCRIÇÃO vem no campo STATUS do XML
STATUS Preenchido com Descrição do tipo de pedido
TRANSPORTADORA Se o campo transportadora do xml estiver preenchido ele busca pelo cadastro da transportadora o campo SITE_NOME, se ele achar o registro ele grava no campo TRANSPORTADORA o código, e o campo frete escolhido será preenchido com o nome da transportadora que vem no XML
PAIS Preenchido com a informação do campo PAIS ENTREGA
DTFATURA Preenchido com a informação do campo DTENTREGA do arquivo XML

Tabela SITE_IPED

Campo na tabela SITE_IPED
CLIENTE Preenchido com a informação do campo CLIENTE da tabela SITE_CPED
EMPRESA Preenchido com a informação do campo CÓDIGO da tabela CONFIG referente à empresa logada
ALMOXARIFADO Preenchido com a informação do campo WEB_ALMOXARIFADO da tabela WEBLOJA
NRPEDIDO Preenchido com a informação do campo NRPEDIDO da tabela SITE_CPED
PRODUTO Preenchido com a informação do campo Preenchido com a informação do campo CODIGOECOMMERCE do arquivo XML
QUANTIDADE Preenchido com a informação do campo QTDITENS do arquivo XML
VRUNITARIO Preenchido com a informação do campo PRECOUNITARIO do arquivo XML
PCDESCONTO Preenchido com a informação do campo DESCONTOTOTALSF do arquivo XML. Valor unitários dos produtos – Valor do pedido (sem frete) = (acha a diferença em reais e calcula a porcentagem para aplicar nesse campo).
NRPEDIDO_CPED Preenchido apenas quando o pedido já foi processado
ATENDIMENTO Preenchido com a informação do campo WEBLOJA da tabela CONFIG

A estrutura do arquivo XML gerado:

NumeroPedido: Número do Pedido na plataforma.

DtPedido: Data do Pedido na Plataforma.

Status: Descrição do Status na Plataforma.

NomeCliente: Nome do Cliente (Do Pedido).

EmailCliente: E-mail do Cliente (Do Pedido).

CPF/CNPJ: CPF ou CNPJ do Cliente (Do Pedido).

DtNascCliente: Data de Nascimento do Cliente (Do Pedido).

Transportadora: Transportadora do Pedido (Campo Site Nome do Cadastro de Transportadora).

TelefoneCliente: Telefone do Cliente (Do Pedido).

EnderecoCliente: Endereço do Cliente (Do Pedido – no Cabeçalho do Pedido).

NumeroEnd: Número do Endereço (Do Pedido – no Cabeçalho do Pedido).

Complemento: Complemento do Endereço (Do Pedido – no Cabeçalho do Pedido).

BairroCliente: Bairro do Endereço (Do Pedido – no Cabeçalho do Pedido).

CidadeCliente: Cidade do Endereço (Do Pedido – no Cabeçalho do Pedido).

EstadoCliente: Estado do Endereço (Do Pedido – no Cabeçalho do Pedido).

CEPCliente: CEP do Endereço (Do Pedido – no Cabeçalho do Pedido).

PaisCliente: Pais do Endereço (Do Pedido – no Cabeçalho do Pedido).

NomeEntrega: Nome Para quem vai entregar o Pedido.

EmailEntrega: E-mail de Entrega do Pedido.

TelefoneEntrega: Telefone de Entrega do Pedido (Informação no Cadastro do Cliente).

EnderecoEntrega: Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

NumeroEndEntrega: Número do Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

ComplementoEntrega: Complemento do Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

BairroEntrega: Bairro do Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

CidadeEntrega: Cidade do Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

EstadoEntrega: Estado do Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

CEPEntrega: CEP do Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

PaisEntrega: Pais do Endereço de Entrega do Pedido (Informação no Cadastro do Cliente).

TotalSemFrete: Valor Total do Pedido sem o valor do frete.

ValorTotal: Valor total do Pedido.

PesoTotal: Peso total do Pedido (Bruto).

Frete: Valor de frete do Pedido.

OutrasDespesas: Valor de Outras despesas do Pedido.

DescontoTotalSF: Porcentagem de Desconto do Pedido (Sem o Frete).

Pagamento: Forma de Pagamento do Pedido (Vem descrito Boleto ou Cartao).

Cartao: Cartão utilizado para compra no pedido (Visa, MasterCard, PagSeguro, Etc, pode ser configurado no Cadastro de Cartão do ERP o DEPARA).

Valor: Campo não utilizado.

RefProduto: Código de Referência do Produto (não utilizado).

CodigoEcommerce: Código do Produto (Site Codigo).

PrecoUnitario: Valor Unitário do Produto (Na Plataforma).

QtdItens: Quantidade de Itens Comprados do Produto (caso o Produto tenha Fator de Conversão é multiplicado pelo fator de conversão).

PrecoUnitarioBruto: Campo não utilizado.

12.1.8 Atualização de Status

A opção Atualização de Status envia as informações de status do pedido de venda e da nota fiscal de venda do sistema Onclick para a plataforma ADMIN.

Para atualizar o status, no Integrador, clique em ATUALIZAÇÃO DE STATUS.

Serão enviados os Pedidos não faturados e as Notas Fiscais de Venda.

Pedido de Venda

Serão atualizados os pedidos cuja data de alteração na tabela CPED (campo DTALTERACAO), esteja dentro do período informado no filtro Período de…até, ou caso não haja período informado, dentro do horário da última atualização até a hora atual;

O campo FIXO do tipo do pedido de venda deve estar desmarcado;

O tipo do pedido não pode ser faturado;

Deve existir o número do pedido internet.

 

Nota Fiscal de Venda

Serão atualizados os status das notas fiscais cuja data de inclusão ou data de alteração (campo DATA e DTALTERACAO da tabela CNF) esteja dentro do período informado no filtro Período de…até, ou caso não haja período informado, dentro do horário da última atualização até a hora atual;

O campo Pedido Internet tem que estar preenchido.

O arquivo XML terá a seguinte estrutura:

NumeroPedido: Número do Pedido na plataforma.

ObsCurta: Observação Curta da Nota Fiscal ou do Pedido.

Status: Status do pedido no ERP.

  • Para a Nota Fiscal: Caso tenha código de rastreio envia o código configurado no tipo de pedido para o rastreio, pegando do tipo de pedido a configuração do ERP x Plataforma.
  • Para o Pedido: Enviado a mesma informação que vem do site (Status Internet).

CodSedex: Código de rastreio do objeto (Número de Conhecimento). Para o Pedido é enviado em branco.

Serie: Série da Nota Fiscal processada no ERP. Para o pedido é enviado em branco.

NumeroDaNota: Número da Nota Fiscal processada no ERP. Para o pedido é enviado em branco.

Especie: Espécie da Nota Fiscal processada no ERP (Tipo Caixa / Embalagem / etc..) é um campo em String.

PesoTotal: Peso bruto dos itens da Nota Fiscal processada no ERP. Para o pedido é enviado em branco.

ValorTotal: Valor total da Nota Fiscal processada no ERP. Para o pedido é enviado em branco.

DataDaNota: Data de processamento da Nota Fiscal no ERP. Para o pedido é enviado em branco.

ChaveNFe: Chave de Acesso da Nota Fiscal gerada no ERP. Este campo não é enviado quando é pedido.

No tipo de Pedido Faturado, há a opção ‘com rastreio’ e ‘sem rastreio’, em (Vendas >> Tabelas diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE PEDIDO >> tipo FATURADO >> aba Integração WEB). Se a opção ‘com rastreio’ estiver preenchida, irá considerar também o número de conhecimento (NRCONHECIMENTOFRETE da tabela CNF).

Se os dois campos estiverem preenchidos, será verificado primeiro se não tem número de rastreio na Nota, para enviar o status configurado sem rastreio. Se estiver preenchido o número de rastreio na Nota, irá utilizar o status configurado com rastreio.

Observações

Em todo o processo de atualização de ESTOQUE, PREÇO, PRODUTO, STATUS e PEDIDO é atualizada a data da última atualização de agendamento com o horário atual e, são somados os minutos configurados para a atualização automática segundo o cadastro da Loja Web em (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba e-commerce >> 1.Dados Gerais).

Quando não é informada a data inicial, é utilizada a data da última atualização, e se a data final não é preenchida é utilizada a data e hora atual.

Na configuração de Loja Web existe a configuração: Utiliza envio de produto por bloco em (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> aba e-commerce >> 1.10 Utiliza envio de produto por bloco). Quando marcada será enviada a quantidade definida no item 1.11 Quantidade de XML enviado por bloco por arquivo XML, se estiver desmarcado é enviado tudo em um arquivo XML apenas (para a mesma operação).

12.2 Integração FAST

12.2.1 Login

Temos os seguintes campos na tela de login do Integrador Fast:

Empresa: Empresa liberada pelo Terminal.

Usuário: Usuário do ERP.

Senha: Senha do ERP.

Filial: Filiais cadastradas/liberadas para esta empresa.

Loja Web: A demonstração das Lojas WEB é feita por filial, como o cadastro é feito por filial então é necessário selecionar uma filial antes de escolher qual loja ele deseja enviar/receber dados.

12.2.2 Agendamento

Atualmente no Integrador FAST é possível configurar rotinas automáticas para Importação de Pedidos, Atualização de Preço, Atualização de Estoque e Atualização de Status.

Tal configuração deve ser realizado no ERP acessando: (Utilitários >> Configurações >> Sistema >> Tela [0030] Configurações do Sistema >> Lojas Web >> Tela [0962] Cadastro de Lojas Web >> Aba FAST >> 1. Dados Gerais).

Como é possível visualizar na imagem acima na grid de agendamento temos informações de quais foram os últimos envios e quais serão os próximos envios. Hoje temos as seguintes informações sobre envios automático e manuais no Integrador FAST:

Exportações: Neste campo são exibidas quais as exportações (envio) que o Integrador FAST realiza (estoque, preços, status do pedido, cadastro de produto).

Importações: Neste campo são demonstrados quais as importações (recebimentos) que o Integrador FAST realiza (pedido).

Intervalo: Horas e Minutos configurável no cadastro de Lojas Web para que possa ser realizada a atualização automática das informações.

Lembrando que a atualização automática ocorre apenas se o Integrador FAST estiver em execução, caso o mesmo estiver fechado a atualização automática não será iniciada conforme configurado na loja web.

Última Atualização: Data e Horário que foi realizado a última ExportaçãoImportação do processo pelo Integrador FAST.

Próxima Atualização: Data e Horário que a próxima ExportaçãoImportação será realizada para receber ou enviar as informações, tal coluna estará preenchida apenas se no ERP estiver configurada a rotina para envio automático.

As seguintes informações são enviadas e recebidas pela API hoje:

Estoque: Apresenta quando foi realizada a última atualização de Estoque e caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima atualização pelo Integrador.

Preços: Apresenta quando foi realizada a última atualização de Preço e caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima atualização pelo Integrador.

Status de Pedido: Apresenta quando foi realizado a última atualização de Status do Pedido pelo Integrador FAST e caso esteja configurada a rotina automática, será exibida quando será enviado a próxima atualização de Status pelo Integrador.

Cadastro de Produtos: Apresenta quando foi realizado o último envio de produtos pelo Integrador Fast, não há configuração para envio automático de produtos por isso nunca irá demonstrar quando será a próxima atualização.

Pedido: Apresenta quando foi realizado a Importação do(s) pedidos e caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima baixa do(s) pedido(s) pelo Integrador.

12.2.3 Exportação de Produtos

Tal função permite o envio de Produtos, Preços e Estoque cadastrados no ERP para a Plataforma.

Hoje temos os seguintes parâmetros para Exportação de Produtos:

Período De..Até: Período em que compreenderá a Data de Cadastro ou Alteração, de Clientes ou Vendedores, para Exportação do sistema Onclick para a plataforma. Caso o campo esteja em branco será utilizada a data e hora do último envio.

Cód Produto/Barra/Fabricante/Auxiliar: Pode ser selecionado no combo o que o usuário deseja que considere no filtro, Código de Produto, Barra, Fabricante ou Auxiliar.

Categoria: Níveis cadastrados no ERP para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro.

Marca: Marcas cadastradas no ERP liberadas para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro.

Grupo: Grupos cadastrados no ERP liberados para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro. Esse filtro será apresentado apenas se a integração não trabalhar com multivalorados definido no cadastro de loja web conforme segue: (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> Aba FAST >> 2.1 Trabalha com multivalorados).

Subgrupo: Subgrupos cadastrados no ERP liberados para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro. Esse filtro será apresentado apenas se a integração não trabalhar com multivalorados definido no cadastro de Loja Web.

Característica: Características cadastradas no ERP liberadas para a loja WEB selecionada. Caso seja selecionado “Todos”, irá trazer todas as características.

Informação: Informações cadastradas no ERP liberadas para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro. Esse filtro será apresentado apenas se a integração não trabalhar com multivalorados definido no cadastro de Loja Web.

Ao clicar em Enviar Produtos, temos os seguintes envios atrelados a ele:

Produto: Envia os Produtos cadastrados no ERP com liberação para a Loja WEB selecionada considerando os filtros inseridos pelo usuário, nesta operação só serão enviados Produtos Pai e Produtos Acabados para vinculação entre ERP x Plataforma. Abaixo os campos enviados:

Comando: Tipo de Operação a ser executada, I – Inserir ou A – Alteração.

MetaKeywordsProd: É enviado o Cód.Prod e o campo MetaKeyWords entre “<–“ e “–>”.

IDProduto: Enviado apenas quando o Produto já tiver no site, é o ID Produto (Site Código).

Estoque: Enviado a quantidade de Estoque atual do Produto ((Almoxarifados + Est.Segurança) – Reserva).

EstoqueMinimo: Enviado o estoque mínimo configurado no Produto.

Preco: Valor de Preço de venda, enviado da tabela de Preço configurado na Loja WEB.

PrecoProm: Valor de Promoção, enviado da tabela de Preço configurado na Loja Web.

PrecoB2B: Valor de Preço de venda, enviado da tabela de preço B2B configurado na Loja WEB.

PrecoB2BProm: Valor de promoção de venda, enviado da tabela de preço B2B configurado na Loja WEB.

DataPromInicio: Data e Hora de início da promoção, enviado da tabela de Preço configurado na Loja WEB, caso não tenha valor de promoção este campo não é enviado e caso não tenha horário, o valor padrão a ser enviado é “00:00:00”.

DataPromFim: Data e Hora do fim da promoção, enviado da tabela de Preço configurado na Loja WEB, caso não tenha valor de promoção este campo não é enviado e caso não tenha horário, o valor padrão a ser enviado é “23:59:59”.

NomeCat: Descrição do Nível de Categoria vinculada ao Produto caso preenchido.

CodProd: Código de Referência do Produto na plataforma, pode ser configurado entre: Cód.barras, Cód.Produto, Cód. Auxiliar e Cód. Fabricante.

NomeProd: Descrição (SITE) do produto (Descrição do Produto na aba Integração WEB do Cadastro de Produto).

Peso: Peso bruto do Produto no ERP.

Descricao: Descrição Curta do produto (Descrição Curta na aba Integração WEB do Cadastro de Produto).

DescrLonga: Descrição Longa do produto (Descrição longa na aba Integração WEB no Cadastro de Produto).

DescrHTM: Indica o nome do arquivo HTML contendo descrição adicional do produto. O conteúdo do arquivo HTM será incluído na posição da tag especial <DescrHTM>, caso esta tag exista no arquivo personalizado de exibição do layout de produtos na loja (EstiloProduto.htm). Será considerado do campo Descrição HTML.

DescrURL: URL para mais detalhes do produto. Será considerado do campo URL de Apoio.

URLTarget: Enviado como True ou False é o campo “URL Externa” da aba “Integração WEB >> Descrição Produto” no cadastro de Produto.

Disponivel: Informa se o produto está disponível ou não na plataforma se os campos “Produto Disponível” e “Produto Inativo” estiverem marcado será enviado “False” caso contrário “True”.

MaxParcelasProd: Número máximo de parcelas para pedidos que incluam este produto.

XMLParcelasProd: Identifica o número de parcelas utilizadas para exibir o parcelamento na página que lista os produtos em XML.

Lancamento: Campo “Lançamento” no cadastro de produto (“Integração WEB”), caso marcado é enviado “True” se não é “False”.

EmDestaque: Campo “Destaque” do cadastro de produto (“Integração WEB”), caso marcado é enviado “True” se não é “False”.

IDProdutoPai: Código de Referência (SITE) do Produto Pai, caso o produto for filho é enviado o código de referência (SITE_CODPAI), caso for produto Pai ou único é enviado zero.

OrdemProd: Ordem de como será demonstrado o produto na plataforma, campo “ORDEM” do cadastro de produto “Integração WEB”.

Adicional1: ID para informação adicional sobre o produto, indicado em Descritor especial 1. Se multivalorado colocar entre vírgulas.

Adicional2: ID para informação adicional sobre o produto, indicado em Descritor especial 2. Se multivalorado colocar entre vírgulas.

Adicional3: ID para informação adicional sobre o produto, indicado em Descritor especial 3. Se multivalorado colocar entre vírgulas.

AdicionalD1: Texto da informação adicional sobre o produto, indicado em Descritor simples 1. Se multivalorado, colocar entre vírgulas.

AdicionalD2: Texto da informação adicional sobre o produto, indicado em Descritor simples 2. Se multivalorado, colocar entre vírgulas.

AdicionalD3: Texto da informação adicional sobre o produto, indicado em Descritor simples 3. Se multivalorado, colocar entre vírgulas.

Cores: ID das cores disponíveis no produto.

MaisProd: Composição do Produto, enviado separado por virgula o código de referência configurado no cadastro de loja web, para que o cliente possa formar uma composição (de cereal por exemplo) no site.

IDCategoria: ID interno da categoria cadastrada.

SKU: Igual o Produto, só que é enviado aqui apenas os produtos filhos que foram enviados no Produto.

Ao clicar em Enviar Preço, o sistema irá considerar os filtros da data da última atualização até o momento, considerando o(s) produto(s) alterado(s) e enviando para a plataforma:

Comando: Irá fixo como “A”, Alteração.

IDProduto: Código de integração do produto, campo ID Produto da aba Integração Web.

Preco: Valor do Produto na tabela de preço.

PrecoProm: Valor de Promoção da tabela de Preço.

DataPromInicio: Enviado apenas se o produto tem Valor de Promoção, é considerado da tabela de preço a Data/Hora de início da promoção, caso não tenha hora é enviado “00:00:00”.

DataPromFim: Enviado apenas se o produto tem valor de promoção, é considerado da tabela de preço Data/Hora de fim da promoção, caso não tenha hora é enviado “23:59:59”.

Ao clicar em Enviar Estoque o sistema irá considerar o filtro de data da última atualização até a hora atual. O XML de envio compõe os seguintes envios:

Comando: Enviado fixo como “A”, Alteração.

IDProduto: Código de integração do produto, campo ID Produto da aba Integração Web.

Estoque: Estoque Atual do produto. Caso for negativo, será enviado fixo 0.

12.2.4 Importação de Produtos

Botão Importar Descritores: O sistema pegará da plataforma todos os cadastros de descritores e salvar no ERP de acordo com a configuração informada de cada propriedade do descritor no cadastro de loja web. Serão importadas as seguintes informações: Categorias, AdicionalD1, AdicionalD2, AdicionalD3 e Cores.

Botão Importar Produtos: O sistema importará da plataforma todos os Produtos para cadastro no ERP (utilizado geralmente quando o cliente já utiliza uma plataforma FAST), nesta importação pode ser considerado o filtro de Categoria e Referencia, Nome ou Descrição para importação. Abaixo as informações presentes da Importação:

COMANDO: Comando de inclusão (I) ou alteração (A).

NOMECAT: Nome da categoria vinculada ao produto.

IDCATEGORIA: ID da categoria vinculada ao produto.

IDPRODUTO: Código de integração do produto na plataforma (Site código).

CODPROD: Código do Fabricante, Código Auxiliar do Produto ou Código de Barras (Depende da configuração no cadastro de lojas web “Código de Referência”).

CODBARRASPROD: Caso o campo estiver em branco, o código de barras será informado o Código do Produto.

NOMEPROD: Nome do produto.

PESO: Peso Bruto do Produto.

DESCRICAO: Descrição Curta do Produto.

DESCRLONGA: Descrição Longa do Produto.

DESCRHTM: Texto em HTML do Produto.

DESCRURL: URL do produto para mais detalhes.

METAKEYWORDSPROD: Palavras chave do produto.

URLTARGET: URL Externa do produto (CheckBox da aba “Integração Web” do cadastro de produto).

ESTOQUE: Estoque atual do Produto (A Informação é salva apenas na tabela de produto).

ESTOQUEMINIMO: Estoque Mínimo do produto.

DISPONIVEL: Produto Disponível na Plataforma (ChecBox da aba “Integração Web” do cadastro de produto).

CUSTO: Custo do Produto (Campos salvos: VrCompraVar, CustoVar, CustoMedio, VrCompra_Medio).

PRECO: Valor de Venda (PrecoVar da tabela de Venda do produto na TAB00001).

PRECOPROM: Valor de Venda em Promoção (Prom_Varejo da tabela de venda do produto na TAB00001).

DATAPROMINICIO: Data de Início da Promoção (Tabela de venda TAB00001).

DATAPROMFIM: Data do Fim da Promoção (Tabela de venda TAB00001).

MAXPARCELASPROD: Max Parc (Informação salva na aba “Integração Web” do cadastro de produto) – Número máximo de parcelas para pedidos que incluam este produto.

XMLPARCELASPROD: XML Parc. (Informação salva na aba “Integração Web” do cadastro de produto) – Identifica o número de parcelas utilizadas para exibir o parcelamento na página que lista os produtos em XML.

LANCAMENTO: Informa se o produto é um Lançamento na plataforma.

EMDESTAQUE: Informa se o produto é para ficar em destaque na plataforma.

IMAGEMPROD: URL da imagem principal.

IMAGEMDET: URL da imagem em detalhes.

IMAGEMAMP: URL da imagem ampliada.

ADICIONAL1: Descritor especial 1.

ADICIONAL2: Descritor especial 2.

ADICIONAL3: Descritor especial 3.

ADICIONALD1: Descritor simples 1.

ADICIONALD2: Descritor simples 2.

ADICIONALD3: Descritor simples 3.

CORES: Cor cadastrada no produto.

ORDEMPROD: Campo destinado para o integrador saiba qual a sequência de apresentação do produto no site.

IDPRODUTOPAI: Código de Referência do produto na plataforma.

MAISPROD: Código de Referência do produto na plataforma separado por vírgula, neste campo informa qual a composição para a montagem deste.

DATAVENCIMENTO: Data de Vencimento do Produto.

12.2.5 Importação de Pedidos

Botão Importação de Pedidos: O Integrador irá considerar o filtro informado, ou caso não tenha filtro informado será considerada a data da última atualização até a hora atual para importar os pedidos inclusos ou alterados na plataforma. Na importação de pedidos da plataforma para a onclick, é feito a baixa do Cabeçalho do Pedido, dos itens dos pedidos e da forma de pagamento, tudo em um único XML. Quando vem mais de um item no pedido o cabeçalho é duplicado (no xml) e na parte que vem os produtos é alterado, então a API grava somente o Item do pedido.

No Integrador OCS FAST só é possível baixar uma forma de pagamento. Caso o Pedido já exista no ERP será atualizado (se o pedido não for do tipo “Fixo”). A Estrutura do XML é a seguinte:

Núm: Número do Pedido na plataforma.

Feito Em: Data do Pedido na Plataforma.

Nome: Nome do comprador.

E-Mail: E-mail do comprador.

Empresa: Empresa do comprador.

Cpf/Cnpj: CPF ou CNPJ do comprador.

Rg/Ie: RG ou IE do comprador.

Logradouro: Endereço do comprador.

Endereço Número: Número do Endereço.

Endereço Complemento: Complemento do Endereço do comprador.

Bairro: Bairro do Endereço do comprador.

Cidade: Cidade do Endereço do comprador.

Estado: Estado do Endereço do comprador.

País: Pais do Endereço do comprador.

Cep: CEP do Endereço comprador.

Telefone: Telefone do Comprador.

Fax: Fax do comprador.

Nascido Em: Data de nascimento do comprador.

Obs Cliente: Alguma observação que o comprador deseja informar.

Nome Pedido: Nome Para quem vai entregar o Pedido.

E-Mail Pedido: E-mail de Entrega do Pedido.

Logradouro Pedido: Endereço de Entrega do Pedido

Endereço Número Pedido: Número do Endereço de Entrega do Pedido.

Endereço Complemento Pedido: Complemento do Endereço de Entrega do Pedido.

Bairro Pedido: Bairro do Endereço de Entrega do Pedido

Cidade Pedido: Cidade do Endereço de Entrega do Pedido

Estado Pedido: Estado do Endereço de Entrega do Pedido

País Pedido: Pais do Endereço de Entrega do Pedido

Cep Pedido: CEP do Endereço de Entrega do Pedido

Telefone Pedido: Telefone do endereço de entrega do pedido.

Fax Pedido: Fax do endereço de entrega do pedido.

Total Sem Frete: Valor Total do Pedido sem o valor do frete.

Frete: Valor de frete do Pedido.

Pagamento: Forma de Pagamento do Pedido (Vem descrito Boleto ou Cartão).

Cartão: Cartão utilizado para compra no pedido (Visa, MasterCard, PagSeguro, etc, pode ser configurado no Cadastro de Cartão do ERP o DE/PARA).

Parcelas: Quantidade de parcelas do pedido.

Status: Status atual do pedido.

Obs Pedido: Observação do pedido.

Entregue Em: Previsão de entrega do pedido.

Obj Sedex: Código de rastreio do pedido.

Ref. Produto: Código de Referência do Produto.

Nome Produto: Nome do produto comprado.

Msg Cliente: Comentários feitos pelo cliente.

Local De Entrega: Local de entrega do pedido.

Parceiro: Quando o pedido foi feito através de um parceiro, informa o nome do parceiro.

Thisftransacao: Código de transação com cartão de crédito recebido da Thisf, se a loja utiliza.

Esp1: Informação adicional sobre o produto, indicado em Descritor especial 1.

Esp2: Informação adicional sobre o produto, indicado em Descritor especial 2.

Esp3: Informação adicional sobre o produto, indicado em Descritor especial 3.

Simp1: Informação adicional sobre o produto, indicado em Descritor simples 1.

Simp2: Informação adicional sobre o produto, indicado em Descritor simples 2.

Simp3: Informação adicional sobre o produto, indicado em Descritor simples 3.

Descontototalsf: Porcentagem de Desconto do Pedido (Sem o Frete).

Presente: Se o produto é para presente.

Valor embalagem: Valor para a embalagem de presente.

Cor: Cor solicitada do produto.

Desconto cupom: Valor em reais do desconto no pedido.

Idproduto: ID interno do produto.

Qtd: Quantidade de itens do produto.

Preço Unit: Preço unitário do produto.

12.2.6 Atualização de Status

Botão Enviar Status do Pedido: O Integrador irá considerar o filtro informado, ou caso não tenha filtro informado será considerada a data da última atualização até a hora atual. A atualização de Status é realizada para pedidos e notas alteradas no período informado no filtro. Para que o status do Pedido seja enviado o Tipo de pedido deve estar devidamente configurado e atrelado a um Status Web nas configurações do ERP: (Vendas >> Tabelas Diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE PEDIDO >> Status Web >>Tela [1109] CADASTRO DE STATUS WEB >> Aba Integração Web).

O XML de envio compõe dos seguintes envios:

NumPedido: Número do Pedido na plataforma.

ObsCurta: Observação Curta da Nota Fiscal ou do Pedido.

Status: Status do pedido no ERP.

Para a Nota Fiscal: Caso tenha código de rastreio envia o código configurado no tipo de pedido para o rastreio, pegando do tipo de pedido a configuração do ERP X Plataforma.

Para o Pedido: Envia a mesma informação que vem do site (Status Internet).

ObjSedex: Código de rastreio do objeto (Número de Conhecimento). Para o Pedido é enviado em branco.

12.3 Tray

12.3.1 Login

Temos os seguintes campos na tela de login do Integrador TRAY:

Empresa: Empresa liberada pelo Terminal.

Usuário: Usuário do ERP.

Senha: Senha do ERP.

Filial: Filiais cadastradas/liberadas para esta empresa.

Caso possua mais de uma loja Web Cadastrada, após logado no Integrador o usuário poderá selecionar a loja Web que deseja.

12.3.2 Agendamento

Atualmente no Integrador TRAY é possível configurar rotinas automáticas para Importação de Pedidos, Atualização de Preço e Estoque, Atualização de Status, Exportação e Importação de Lista de Desejo e Importação de Clientes sem Pedidos.

Tal configuração deve ser realizado no ERP acessando: (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> Aba Parâmetros Comuns de Integração >> 1. Dados Gerais).

Lembrando que a configuração é válida para todas as lojas Web cadastradas. Como é possível visualizar na imagem acima na grid de agendamento temos informações das lojas web carregadas e quais foram seus últimos envios e quais serão os próximos envios. Hoje temos as seguintes informações sobre envios automático e manual no Integrador TRAY:

ID da Loja: Informação do ID da loja disponibilizado pela Plataforma Tray.

Tal informação é cadastrada no ERP acessando: (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> Aba Parâmetros Por Integração >> Aba Geral >> 2.3 ID Loja).

Nome da Loja: Nome da Loja. Tal informação é cadastrada no ERP acessando: Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> Aba Parâmetros Por Integração >> Aba Geral >> 2.2 Nome da Loja.

Exportações: Neste campo são exibidas quais as exportações (envio) que o Integrador Tray realiza.

Importações: Neste campo são exibidas quais as importações (recebimentos) que o Integrador Tray realiza.

Intervalo: Horas e Minutos configurados no cadastro de Lojas Web para que possa ser realizada a atualização automática das informações, caso não esteja configurado no ERP tal coluna ficará em branco.

Lembrando que a atualização automática ocorre apenas se o Integrador Tray estiver em execução, se o mesmo estiver fechado a atualização automática não será iniciada conforme configurado na loja web.

DT. Última Atualização: Data e Horário que foi realizada a última ExportaçãoImportação do Processo.

DT. Próxima Atualização: Data e Horário que a próxima ExportaçãoImportação será realizada para receber ou enviar as informações, tal coluna estará preenchida apenas se no ERP estiver configurada a rotina para envio automático.

As seguintes informações são enviadas e recebidas pelo Integrador Tray:

Preço e Estoque: Apresenta quando foi realizada a última atualização de Preço e Estoque e caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima atualização pelo Integrador Tray.

Promoção: Apresenta quando foi realizada a última atualização de Promoção e caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima atualização pelo Integrador Tray.

Produto: Apresenta quando foi realizado o último envio de produtos pelo Integrador Tray, não há configuração para envio automático de produtos por isso nunca irá demonstrar quando será a próxima atualização.

Lista de Desejos (Exportação): Apresenta quando foi realizada a última atualização de Lista de Desejo na plataforma e caso esteja configurado a rotina automática, será demonstrado quando será realizada a próxima atualização de Lista de desejos alterados no ERP.

Lista de Desejos (Importação): Apresenta quando foi realizada a última importação (baixa) de Lista de Desejos da plataforma, caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima importação de Lista de Desejos.

Status de Pedido: Apresenta quando foi realizado a última atualização de Status do Pedido pelo Integrador Tray e caso esteja configurado a rotina automática, será demonstrado quando será enviado a próxima atualização de Status pelo Integrador.

Pedido: Apresenta quando foi realizado a Importação do(s) pedidos e caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima baixa do(s) pedido(s) pelo Integrador.

Cliente: Apresenta quando foi realizado a Exportação do(s) cliente(s) da plataforma, caso esteja configurado a rotina automática, será demonstrado quando será realizado a próxima exportação.

 

12.3.3 Importação de XLS

Tal opção permite a importação de um arquivo em formado XLS (excel) fornecido pela plataforma para inserção de produtos no ERP.

Hoje temos os seguintes parâmetros para Importação de XLS:

Loja Web: Informar para qual loja será a importação do arquivo XLS.

Localização: Pasta onde estão os arquivos para importação, os arquivos a serem importados são:

dados_categoria.xls

dados_marcas.xls

dados_caracteristica.xls

dados_produto.xls

dados_grade.xls

dados_categorias_produtos.xls

dados_varia.xls

produtos_descricao.xls

Botão Importar XLS: ” O sistema irá considerar o filtro informado, e irá realizar a importação de todos os produtos contidos no arquivo XLS, abaixo a listagem da importação realizada:

Nível de Categoria: Importará o nível de categoria contido no arquivo XLS (dados_categoria.xls) para o ERP, campos utilizados do XLS:

Id_Categoria: Id da Categoria na plataforma (Site Código).

Id_CategoriaPai: Id da Categoria PAI na plataforma.

Descricao: Descrição do Nível da Categoria.

Ativo: Informação se a Categoria está Ativa na plataforma (S – Sim / N – Não).

Marcas: Importará todas as marcas contidas no arquivo XLS (dados_marcas.xls) para o ERP, campos utilizados do XLS:

ID_Marca: ID da marca na plataforma (Site Código).

Descricao: Descrição da Marca.

Ativo: Informação se a marca está Ativa na plataforma (S – Sim / N – Não).

Característica: Importará todas as características contidas no arquivo XLS (dados_caracteristica.xls) para o ERP, campos utilizados do XLS:

ID_Caracteristica ID da característica na plataforma (Site Código).

Descrição: Descrição da Característica.

Ativo: Informação se a característica está Ativa na plataforma (S – Sim / N – Não).

Produto: Importará todos os produtos contidos no arquivo XLS (dados_produto.xls) para o ERP, campos utilizados do XLS:

Id_Produto: Código de Referência do Produto na Plataforma (Site Código).

Id_Marca: Código de Referência da marca na plataforma.

Id_Fornecedor: Código de Referência do Fornecedor na plataforma.

Cod_Referencia: Código de Referência do Produto na plataforma (Campo não utilizado, pois enviamos o Cód.barras, Auxiliar, Produto ou Fabricante).

Descricao: Descrição Site do Produto na Plataforma.

Descricao_Curta: Descrição Longa do Produto.

Custo: Valor de Custo do Produto.

Moeda_custo_Aux: Campo não utilizado.

Custo_auxiliar: Campo não utilizado.

Preco: Preço de Venda do Produto.

Peso_cubico: Peso Cubico do Produto (Dividido por 1000 quando importado para o ERP).

Disponivel: Informa se o produto está Disponível ou não na plataforma.

Garantia: Garantia do Produto (Campo de Livre digitação).

Disponibilidade: Disponibilidade do produto (Campo de Livre digitação).

Estoque: Estoque atual do Produto.

Estoque_Minimo: Estoque Mínimo na Plataforma.

Destaque: Informa se o Produto está em “DESTAQUE” na plataforma.

Data_Cadastro: Data de Cadastro do produto na plataforma (Consideramos a mesma data para cadastrado no ERP).

Info_Preco: Campo não utilizado.

Ativo: Informa se o produto está ativo na plataforma (Consideramos este campo para deixar ativo no ERP).

Marca: Campo não utilizado.

Preco_Oferta: Valor de Promoção na plataforma.

Inicio_Oferta: Data de Início da Promoção na plataforma.

Fim_Oferta: Data de Fim da Promoção na plataforma.

Grade (Produto SKU): Importará todas as variações (SKU) contidos no arquivo XLS (dados_grade.xls) para o ERP (Detalhe desta importação, que ele irá considerar o Pai já cadastrado na Importação de Produtos para considerar os campos não presentes deste XLS, então esta importação é uma amarração entre Produto Pai X Filho), campos utilizados no XLS:

Id_Grade: Código de Referência do Produto Filho (SKU) na Plataforma.

ID_Produto: Código de Referência do Produto na Plataforma.

Peso: Peso Bruto e Liquido do produto (Dividido por 1000 para o ERP).

Peso_Cubico: Peso Cubico do Produto (Dividido por 1000 para o ERP).

Custo: Valor de Custo do Produto.

Preco: Valor de Venda do Produto.

Estoque: Estoque atual do produto.

Categoria do Produto: Irá importar todos os Níveis de Categorias por Produto (vinculação de Nível Categoria x Produto), contidos no arquivo XLS (dados_categorias_produtos.xls) para o ERP, campos utilizados no XLS:

ID_Produto: Código de Referência do Produto na plataforma.

ID_Categoria: Código de Referência do Nível de Categoria na plataforma.

Característica de Valor: Irá importar todas as características dos Produtos (vinculação de Característica x Produto), contidos no arquivo XLS (dados_varia.xls) para o ERP, campos utilizados no XLS:

ID_Grade: Código de Referência do Produto (SKU) na plataforma.

ID_Caracteristica: Código de Referência da Característica na Plataforma.

Valor: Valor da Característica (Exemplo 110v).

Ativo: Informação se a marca está Ativa na plataforma (S – Sim / N – Não).

HTML: Irá importar todas as informações em HTML do Produto no arquivo XLS (produtos_descricao.xls) para o ERP, campos utilizados no XLS:

ID_Produto: Código de Referência do Produto na plataforma.

Descricao: Descrição HTML do Produto.

12.3.4 Exportação de Produtos

Tal função permite o envio de Produtos, Preços e Estoque, Promoções e Níveis de Categoria cadastros no ERP para a Plataforma.

Hoje temos os seguintes parâmetros para Exportação de Produtos:

Período De: Data Inicial de Cadastro ou Alteração de produtos para exportação para a plataforma. Caso o campo esteja em branco será considerado a data e hora do último envio.

Até: Data Final de cadastro ou alteração de produtos para exportação para a plataforma. Caso esteja em branco será considerado a data e hora atual do envio.

Cód. Produto/Barra/Fabricante/Auxiliar: Pode ser selecionado no combo o que o usuário deseja que considere no filtro. Quando informado um valor no campo nenhum outro filtro é considerado, todos os outros campos de filtro desabilitam e limpam as informações (caso tenha).

Categoria: Níveis cadastrados no ERP para a Loja WEB selecionada. Caso selecionado “Todos” não irá considerar o filtro.

Marca: Marcas cadastradas no ERP liberadas para a Loja WEB selecionada. Caso selecionado “Todos” não irá considerar o filtro.

Característica: Características cadastradas no ERP liberadas para a loja WEB selecionada. Caso selecionado “Todos” não irá considerar o filtro.

Loja Web: Irá demonstrar todas as Lojas WEB carregadas pela API. Caso selecionado “<NENHUM>” a API não irá buscar nenhuma informação.

Botão Enviar Produtos temos os seguintes envios atrelados a ele:

Marcas: Envia as marcas cadastradas no ERP, para vinculação entre ERP x Plataforma. A marca é enviada através do método “fWSCadastraMarca”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

Id_Marca: Código de Referência da marca na plataforma (Site Codigo), caso for enviado 0 será cadastrado na plataforma e retornado neste campo o ID de referência.

Descricao: Descrição da Marca.

Ativo: Informação se a marca está Ativa na plataforma (S – Sim / N – Não).

Característica: Envia as características cadastradas no ERP, para vinculação entre ERP x Plataforma. A característica é enviada através do método “fWSCadastraCaracteristica”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

ID_Caracteristica: Código de Referência da característica na plataforma (Site Codigo).

Descricao: Descrição da característica.

Ativo: Informação se a característica está Ativa na plataforma (S – Sim / N – Não).

Status: Status da operação – pode ser: “ok” ou “no”, enviamos em branco.

ID_Caracteristica (out): Código de Referência da característica na plataforma (Site Codigo) caso for enviado 0 será cadastrado na plataforma e retornado neste campo o ID de referência.

Perfil: Envia os perfis cadastrados no ERP para vinculação entre ERP x Plataforma. O Perfil é enviado através do método “fWSCadastraPerfil”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

ID_Perfil: Código de referência do perfil na plataforma (Site Codigo), caso for enviado 0 será cadastrado na plataforma e retornado neste campo o ID de referência.

Descricao: Descrição do Perfil.

Ativo: Informação se o perfil está ativo na plataforma (S – Sim / N – Não), sempre enviamos como “S”.

Perfil X Característica: Envia as características de perfis relacionadas no ERP para vinculação entre ERP x Plataforma. A vinculação de Característica de Perfil é feita através do método “fWSRelacionaCaractPerfil”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

ID_Perfil: Código de referência do Perfil na plataforma.

ID_Caracteristica: Código de referência da característica na plataforma.

Status (Out): Retorno do processo executado, caso dê erro, neste campo irá retornar “NO” (da Tray) e entendemos que não conseguiu processar essa solicitação.

Chaves (Out): Retorno dos ID´s de perfil e característica separados por ‘pipe’ – ex: “123|456” (Enviamos em branco o campo e não consideramos nada do retorno).

Nível Categoria X Perfil: Envia o relacionamento de Nível de Categoria por perfis do ERP para vinculação entre ERP x Plataforma. A vinculação de nível de categoria por Perfil é feita através do método “fWSRelacionaCategPerfil”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

ID_Perfil: Código de Referência do Perfil na plataforma (Site Código).

ID_Caracteristica: Código de Referência do Nível de Característica na Plataforma (Site Código).

Status (Out): Retorno do processo executado, caso dê erro, neste campo irá retornar “NO” (da Tray) e entendemos que não conseguiu processar essa solicitação.

Chaves (Out): Retorno dos ID´s de perfil e categoria separados por ‘pipe’ – ex: “123|456” (Enviamos em branco o campo e não consideramos nada do retorno).

Produto: Envia os Produtos cadastrado no ERP com liberação para a Loja WEB selecionada, considerando os filtros inseridos pelo usuário, nesta operação só serão enviados Produtos Pai e Produtos acabados para vinculação entre ERP x Plataforma. O produto é enviado através do método “fWSCadastraProduto”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

id_produto: Código de Referência do Produto na plataforma (Caso seja enviado “0” será retornado o código cadastrado na plataforma).

id_marca: Código de Referência da Marca na plataforma (Site Código).

id_fornecedor: Código de Referência do Marca na plataforma (Site Código), é a mesma informação do campo “ID_MARCA”.

cod_referencia: Código de Referência utilizado no ERP para envio para a plataforma (Pode-se utilizar o Código do Fabricante, Auxiliar ou de Barras).

Descricao: Descrição Site do produto na plataforma, caso o campo estiver em branco será enviado o campo “DESCRICAO” + “OBSERVAÇÃO” do cadastro de produto.

descricao_curta: Descrição Curta do Site do produto.

custo: Valor do custo do produto em Real – formato: “0.00” (Enviamos em branco o campo).

moeda_custo_aux: Formato de moeda auxiliar – ex: “US$” (Enviamos em branco o campo).

custo_auxiliar: Valor do custo do produto da moeda auxiliar – formato: “0.00” (Enviamos em branco o campo).

preco: Valor unitário do Produto (PrecoVar da tabela de preço padrão).

peso_cubico: Peso Cubico do produto.

peso: Peso Bruto ou Peso Liquido do produto, depende da configuração do cadastro de lojas Web (Tipo de Peso).

disponivel: Informa se o produto está disponível ou não na plataforma (N – Não / S – Sim).

informacao: Array com informações para geração da descrição longa nas abas corretas (Enviamos o Texto em HTML neste objeto).

garantia: Informa a Garantia do Produto (É um campo de livre digitação).

disponibilidade: Informação sobre Disponibilidade do produto (É um campo de livre digitação).

estoque: Estoque Atual do Produto (Considerando os Almoxarifados liberados ou caso não tenha o módulo de Múltiplos Almoxarifados é enviado da tabela de produto).

estoque_minimo: Estoque Mínimo do produto.

prazo_entrega: Prazo de Entrega do produto (enviamos 0).

frete_desconto: Valor de desconto para frete – (campo não utilizado, tanto pela Tray como pela ONCLICK).

destaque: Flag para setar produto em destaque – pode ser “S” ou “N”

data_cadastro: Data de cadastro do produto padrão japonês sem hífen – ex: “20091116”

info_preco: Informação de parcelamento do valor do produto – (campo não utilizado, tanto pela Tray como pela ONCLICK).

ativo: Liberação do produto – pode ser: “S” ou “N” – caso “N” com ID: exclui registro do produto.

  • Caso tenha mais de uma Loja WEB e entre elas uma é secundária da loja que acabou de enviar o produto, o sistema irá informar o mesmo Site Código para o produto enviado pela loja principal.

Produto (Lançamento): Se o produto enviado estiver com a flag “LANÇAMENTO” marcada, o sistema irá verificar se existe alguma característica cadastrada como “TRAY” e irá enviar pelo método “fWSCadastraDadosProduto” que o produto é um lançamento. Detalhe importante a ser notado é que na Tray é obrigatório que exista uma característica chamada “TRAY” e o valor de envio na tag “valor” tem que ser lançamento. Abaixo os campos enviados através do método “fWSCadastraDadosProduto”:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

ID_Produto: Código de Referência do Produto na plataforma (Site Código).

ID_Caracteristica: Código de Referência da Característica na plataforma (Site Código).

Valor: Valor da característica de produto (Será enviado fixo “LANCAMENTO”.

Status (Out): Status da operação – pode ser: “ok” ou “no”

Chaves (Out): Retorno dos ID´s de caracteristica e produto separados por ‘pipe’ – ex: “123|456”

Produtos (Altura/Largura/Comprimento): Este processo irá chamar o webservice para cada operação de envio de informações adicionais (Altura, Largura ou Comprimento), o método a ser utilizado é o “fWSDadosRecursosExtras”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

ID_Registro: Código de Referência do produto no site (Site Código), pode ser o produto ou uma variação.

Entidade: Nome do alvo para alteração – pode ser: “produtos” ou “grade”, enviamos sempre “produtos” neste caso.

Campo: Nome do campo que será realizado a alteração (dimensao:largura, dimensao:altura ou imensao:comprimento).

Valor: Valor do campo para alteração.

Promoção: Irá enviar o valor de Preço e Promoção do produto atual sendo processado, o método de envio é o “fWSAtualizaPrecoProduto”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

is_grade: Flag para identificação de variação – pode ser: “S” ou “N” (“S” = ID da variação e “N” = ID do produto)

id_produto: Código de Referência do Produto no site (Site Código), conforme a flag “is_grade”.

preco: Preço do produto em Real – formato: “0.00”

precopromo: Preço em promoção do produto em Real – formato: “0.00”.

data_inicio: Data inicial de promoção em padrão japonês – ex: “2009-11-16”.

data_termino: Data final de promoção em padrão japonês – ex: “2009-11-16”.

Produto (SKU/Variação): O Envio de SKU (Variação) é semelhante ao de produto, é realizado pelo método “fWSCadastraGradeProduto” e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

id_grade: Código de Referência do produto no site (Site Código), caso enviado 0 será cadastrado na plataforma e retornado neste campo o código do cadastro.

id_produto: Código de Referência do produto no site (Site Código Pai).

cod_referencia: Código de referência do produto – campo não utilizado.

peso: Peso da variação em Kg (Pode ser o Peso Bruto ou Liquido, o cliente configura qual deseja enviar no cadastro de loja web).

peso_cubico: Peso cúbico da variação em Kg.

custo: Valor do custo da variação em Real – formato: “0.00”.

preco: Preço da variação em Real – formato: “0.00”.

estoque: Estoque da variação.

ativo: Liberação da variação – pode ser: “S” ou “N” – Caso “N” com ID da grade: exclui variação.

SKU/Variação (Altura/Largura/Comprimento): Este processo irá chamar o webservice para cada operação de envio de informações adicionais (Altura, Largura ou Comprimento), o método a ser utilizado é o “fWSDadosRecursosExtras”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

ID_Registro: Código de Referência do produto no site (Site Código), pode ser o produto ou uma variação.

Entidade: Nome do alvo para alteração – pode ser: “produtos” ou “grade”, enviamos sempre “grade” neste caso.

Campo: Nome do campo que será realizado a alteração (dimensao:largura, dimensao:altura ou imensao:comprimento).

Valor: Valor do campo para alteração.

Promoção da SKU: Irá enviar o valor de Preço e Promoção do produto atual sendo processado, o método de envio é o “fWSAtualizaPrecoProduto”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

is_grade: Flag para identificação de variação – pode ser: “S” ou “N” (“S” = ID da variação e “N” = ID do produto).

id_produto: Código de Referência do Produto no site (Site Código), conforme a flag “is_grade”.

preco: Preço do produto em Real – formato: “0.00”.

precopromo: Preço em promoção do produto em Real – formato: “0.00”.

data_inicio: Data inicial de promoção em padrão japonês – ex: “2009-11-16”.

data_termino: Data final de promoção em padrão japonês – ex: “2009-11-16”.

Valor na Característica do Produto: Responsável pela atribuição de um valor para a característica. É obrigatório que o produto esteja configurado em uma Categoria onde o Perfil possua a característica configurada. É enviado pelo método “fWSCadastraDadosProduto”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

id_produto: Código de Referência do produto na plataforma (Site Código).

id_caracteristica: ID da característica de produto.

valor: Valor da característica de produto.

status: Status da operação – pode ser: “ok” ou “no”.

chaves: Retorno dos ID´s de característica e produto separados por ‘pipe’ – ex: “123|456”.

Botão Enviar Preço e Estoque: O Integrador irá considerar os filtros informados, caso nenhum filtro seja informado será considerada a data da última atualização até o momento, considerando o(s) produto(s) alterado(s) e enviando para a plataforma.

O Primeiro a ser enviado é o Estoque seguido pelo Preço, tanto de produtos acabados como de SKU (Variação).

Envio de Estoque: O Envio de estoque é feito pelo método “fWSAtualizaEstoqueProduto”, não enviamos estoque negativo, então caso um produto esteja com estoque negativo é enviado 0 de estoque. O método “fWSAtualizaEstoqueProduto” é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

is_grade: Flag para identificação de variação – pode ser: “S” ou “N” (“S” = ID da variação e “N” = ID do produto).

id_produto: Código de Referência do Produto (Site Código), pode ser uma variação ou um produto único.

estoque: Quantidade de estoque do produto.

estoque_minimo: Quantidade mínima de estoque do produto.

Produto Disponível: Responsável por alterar a disponibilidade (disponível ou não disponível) de produto específico. Logo após enviar o Estoque verificamos a quantidade de estoque do produto e se for maior que zero (0) tentamos ativar ele na plataforma, o método responsável por isso é o “fwsAtualizaProdutoDisponivel”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

id_produto: Código de Referência do produto na plataforma (Site Código).

disponivel: Flag de disponibilidade – pode ser: “0” para não disponível ou “1” para disponível.

Envio de Preço: O Envio de preço é feito pelo método “fWsAtualizaPrecoProduto”, irá ser realizado a atualização de preço na plataforma, o método é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

is_grade: Flag para identificação de variação – pode ser: “S” ou “N” (“S” = ID da variação e “N” = ID do produto).

id_produto: Código de Referência no produto na plataforma (Site Código).

preco: Preço do produto em Real – formato: “0.00”.

precopromo: Preço em promoção do produto em Real – formato: “0.00”.

data_inicio: Data inicial de promoção em padrão japonês – ex: “2009-11-16”.

data_termino: Data final de promoção em padrão japonês – ex: “2009-11-16”.

Botão Enviar Promoção: O sistema irá considerar os filtros informados, caso nenhum filtro seja informado será considerada a data da última atualização até o momento considerando o(s) produto(s) alterado(s) e enviando para a plataforma.

Este método irá enviar o valor de Preço e Promoção dos produtos, o método de envio é o “fWSAtualizaPrecoProduto”, e é composto dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

is_grade: Flag para identificação de variação – pode ser: “S” ou “N” (“S” = ID da variação e “N” = ID do produto).

id_produto: Código de Referência do Produto no site (Site Código), conforme a flag “is_grade”.

preco: Preço do produto em Real – formato: “0.00”.

precopromo: Preço em promoção do produto em Real – formato: “0.00”.

data_inicio: Data inicial de promoção em padrão japonês – ex: “2009-11-16”.

data_termino: Data final de promoção em padrão japonês – ex: “2009-11-16”.

Botão Enviar Níveis: O sistema considerará todos os níveis de categorias cadastrado no ERP para envio. O método de enviar Nível de Categoria é o “fWSCadastraCategoria”, e é constituído dos seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

id_categoria: Código de Referência da Categoria na plataforma (Caso seja enviado 0 será cadastrado o novo nível de categoria na plataforma).

id_categoriapai: Código de Referência do Nível de Categoria Pai (Caso seja enviado 0, entende-se que é o principal nível, ou o pai).

descricao: Nome da categoria.

ativo: Liberação da categoria – pode ser: “S” ou “N”. Enviamos sempre como “S”.

12.3.5 Importação de Pedidos

Botão Importação de Pedidos: O Integrador irá considerar o filtro Loja Web e Status. O campo Status é responsável por buscar pedidos de status específicos em lojas definidas no campo Loja Web.

Será realizado uma requisição pelo método “fWSImportaPedidos” passando as seguintes informações:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

data_inicial: enviado em branco.

data_final: enviado em branco.

hora_inicial: enviado em branco.

hora_final: enviado em branco.

Status_Atual: Status definido no filtro.

O retorno dessa requisição haverá os seguintes campos:

Id_Pedido: Número do pedido no site.

Pedido_Nfin: Campo não utilizado.

Frete: Descrição da transportadora no site. Esse campo deverá estar exatamente igual no ERP para que encontre a transportadora cadastrada.

Id_Cliente: Código de integração do cliente.

Id_Orcamento: Campo não utilizado.

Id_Site_Parceiro: Campo não utilizado.

Id_Local_Venda: Campo não utilizado.

Id_Usuario: Campo não utilizado.

Data_Pedido: Data da realização do pedido.

Hora_Pedido: Hora da realização do pedido.

Data_Envio: Campo não utilizado.

Hora_Envio: Campo não utilizado.

Ip_Origem: Campo não utilizado.

Total: Total do pedido.

Desconto: Desconto total do pedido.

Valor_Cupom: Valor do cupom de desconto caso utilizado.

Comissao: Campo não utilizado.

Valor_Frete: Valor do frete cobrado.

Frete_Pago: Campo não utilizado.

Cod_Rastreamento: Campo não utilizado.

Obs_Loja: Observação da loja em relação ao pedido.

Obs_Cliente: Observação do cliente em relação ao pedido.

Obs_Pagamento: Campo não utilizado.

Obs_Frete: Campo não utilizado.

Valor_Imposto: Valor do imposto a ser apresentado no pedido dentro do ERP.

Valor_Embalagem: Valor da embalagem a ser apresentada no pedido dentro do ERP.

Local_Venda: Local que foi realizada a venda.

Nro_Cupom: Número do cupom.

Parceiro: Parceiro que foi realizado o pedido.

Status: Status atual do pedido.

Será realizado uma requisição dos itens do pedido pelo método

“fWSImportaItensPedidoPorId” passando os seguintes campos.

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

Id_Pedido: Código do pedido no site.

No retorno dos itens haverá os seguintes campos:

Id_Pedido: Código do pedido no site.

Id_Produto: Código do produto pai no site.

Id_Grade: Código do Sku no site.

Id_Kit: Campo não utilizado.

Nome_Produto: Nome do produto no site.

Referencia: Campo não utilizado.

Id_Embalagem: Campo não utilizado.

Preco: Preço do produto vendido no site.

Custo: Custo do produto no site.

Comissao: Campo não utilizado.

Quantidade: Quantidade comprada daquele item.

Brinde: Campo não utilizado.

Status: Campo não utilizado.

Id_Lista: Código da lista de presente referente aquele item.

Será realizado uma requisição da forma de pagamento do pedido pelo método “fWSImportaParcelasPedidoPorId” passando os seguintes campos.

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

Id_Pedido: Código do pedido no site.

No retorno dos itens haverá os seguintes campos:

Id_Parcela: Código da parcela no site.

Id_Pedido: Código do pedido no site.

Forma_Pagamento: Descrição da forma de pagamento utilizada no site.

Data_Vencimento: Data de vencimento do pagamento.

Valor: Valor do pedido no site.

Data_Pagamento: Data do pagamento no site.

Data_Confirmacao: Data da confirmação do pagamento.

Valor_Pago: Valor pago do pedido.

Local_Pagamento: Local que o pagamento foi realizado.

Observacao: Observação da forma de pagamento.

Id_Forma_Pagamento: Código da forma de pagamento utilizada.

Qt_Parcelas: Quantidade de parcelas da forma de pagamento.

Status: Status da forma de pagamento.

Será realizado uma requisição de cliente do pedido pelo método “fWSImportaClientePorId” passando os seguintes campos.

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

Id_Cliente: Código do cliente no site.

No XML de retorno do cliente, haverá os seguintes campos:

Id_Pedido: Código de integração do pedido. Não utilizado para importação de clientes sem pedido.

Id_Cliente: Código de integração do cliente.

Pais: País do cliente.

Revenda: Razão social do cliente caso for do tipo física.

Tipo_Pessoa: Tipo de pessoa física ou jurídica.

Bloqueado: Define se o cliente está bloqueado ou não no site.

Cliente: Será preenchido como nome do cliente caso ele for pessoa física.

Cnpj_Cpf: CNPJ ou CPF do cliente.

Ie_Rg: Inscrição estadual da empresa ou RG do cliente.

Data_Nasc: Data de nascimento do cliente.

Data_Cadastro: Data de cadastro do cliente.

Email: E-mail de cadastro do cliente.

Observacao: Observação do cliente para o lojista.

Logradouro: Endereço do cliente.

Numero: Número do endereço do cliente.

Bairro: Bairro do cliente.

Complemento: Complemento do cliente.

Cep: CEP de endereço do cliente.

Cidade: Cidade do cliente.

Uf: Estado do cliente.

Telefone: Telefone residencial do cliente.

Fax: Fax do cliente.

Celular: Celular do cliente.

Sexo: Sexo do cliente.

Status: Status do cadastro do cliente.

Apelido: Apelido do cliente.

12.3.6 Atualização de Status

Botão Enviar Status do Pedido: O Integrador irá considerar o filtro informado, ou caso não tenha filtro informado será considerada a data da última atualização até a hora atual.

A atualização de Status é realizada para pedidos e notas alteradas no período informado no filtro. Para que o status do Pedido seja enviado o Tipo de pedido deve estar devidamente configurado e atrelado a um Status web nas configurações do ERP conforme segue: Vendas >> Tabelas Diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE Pedido >> Status Web >> Tela [1109] CADASTRO DE STATUS WEB >> Aba Integração Web.

O XML de envio será informado no método “fWSAtualizaStatusPedidos” e haverá os seguintes campos:

Pedido: Número do pedido no site.

Id_Status: Código de integração do status de pedido fornecido pela Tray.

Data: Data de criação da nota fiscal.

Hora: Hora de criação da nota fiscal.

Serienota: Número de série da nota fiscal.

Numeronota: Número da nota fiscal.

Dataemissaonota: Data de criação da nota fiscal.

Horaemissaonota: Hora de criação da nota fiscal.

Objeto: Número de rastreio da encomenda.

Volume: Quantidade de itens para entrega

12.3.7 Exportação de Listas

Botão Enviar Lista de Desejos: o sistema irá considerar o filtro informado, caso não tenha filtro informado será considerado a data da última atualização até a hora atual. Também é possível enviar de uma loja web em específico informando a loja web no filtro.

O cabeçalho da lista será enviado pelo método “fWSCadastraListaDesejos” e os seguintes campos serão informados.

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

Dados_Lista: Array de Lista de presente.

Os itens da lista de presente serão enviados pelo método “fWSCadastraListaProdutos” e será preenchido os seguintes campos.

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

dados_lista: Array de itens da lista.

Cabeçalho da Lista de Pedidos:

ID: Código de integração da lista no site.

ID_Cliente: Código de integração do cliente no site.

ID_Eventos: Código de integração do evento no site.

Data: Data do evento que será realizado.

Data_Cadastro: Data de criação da lista no ERP.

Nome: Descrição da lista de desejo.

Data_Finalizado: Data de finalização do evento.

Validade: Data de finalização do evento.

URL: URL da lista de presente para mais detalhes.

Recebimento: Recebimento VPV ou após o fechamento.

Mensagem: Mensagem a ser exibida na lista.

Envia_Email: Envia e-mail de agradecimento pela compra.

Status: Status da lista de presente.

Cartao: Envia cartão de agradecimento.

 

Itens da Lista de Pedidos:

ID: Código de integração do item da lista de presente.

ID_Lista: Código de integração da lista de presente.

ID_Produto: Código de integração do produto.

Quantidade: Quantidade desejada para aquele produto.

ID_Grade: Código de integração do produto filho.

Quantidade_Comprada: Quantidade já adquirida.

12.3.8 Importação de Listas

Botão Importação de Listas de Desejos: O sistema irá considerar o filtro de lojas web para buscar listas de desejo pendentes na lista de importação da plataforma.

O cabeçalho da lista de presente pendente para importação, é recebido pelo método “fWSImportaListasDesejo” e será preenchido os seguintes campos do método:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

id_lista: Enviado 0 para buscar todas as listas.

id_cliente: Código de integração do cliente, enviado 0 atualmente.

data_inicial: Data inicial do cadastro da lista. Enviado atualmente em branco.

data_final: Data final do cadastro da lista. Enviado atualmente em branco.

Os itens da lista de presente serão recebidos pelo método “fWSBuscaVendaListas” e será preenchido os seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

id_lista: Código de integração da lista de presente.

idCliente: Código de integração do cliente (não utilizado).

Cabeçalho da Lista de Pedidos:

Revenda: Nome da empresa ou revenda.

Cliente: Nome do cliente. Será considerado apenas se a revenda estiver em branco.

Cnpj_Cpf: CNPJ ou CPF do cliente.

ID_Eventos: Código de integração do evento. Caso não estiver cadastrado no ERP, será abortado a importação.

Ie_Rg: Inscrição estadual ou RG do cliente.

Cep: CEP do cliente.

Email: E-mail do cliente.

UF: Estado do cliente.

Data_Nasc: Data de nascimento do cliente.

Data_Cadastro: Data de cadastro do cliente.

Data: Data do evento.

Validade: Validade do evento.

Pais: País do cliente.

Observação: Observação do cliente.

Logradouro: Endereço do cliente.

Numero: Numero de endereço do cliente.

Bairro: Bairro do cliente.

Complemento: Complemento do cliente.

CEP: Cep do cliente.

Cidade: Cidade do cliente.

Celular: Celular do cliente.

Tipo_Pessoa: Pessoa do tipo física ou jurídica.

ID_Cliente: Código de integração do cliente.

Sexo: Sexo do cliente.

Email: E-mail do cliente.

ID: Código de integração da lista de presente.

Nome: Nome do cliente que será vinculado a lista de presente.

Status: Status da lista de presente.

Cartao: Envia cartão de agradecimento ou não.

URL: URL da lista de presente para mais detalhes.

Recebimento: Recebimento VPV ou após o fechamento.

Envia_Email: Envia e-mail para cada compra.

Mensagem: Mensagem da lista de presente.

Itens da Lista de Pedidos:

ID_Produto: Código de integração do produto pai.

ID_Grade: Código de integração do produto filho.

Id_Lista: Código de integração da lista de presente.

ID_Produto_Lista: Código de integração do produto na lista de presente.

Quantidade: Quantidade do item.

Quantidade_Comprada: Quantidade do item já adquirido.

12.3.9 Importação de Clientes

Botão Importar Clientes Sem Pedido: O sistema irá considerar o filtro de lojas web para buscar clientes que fizeram cadastro na loja, porém não finalizaram o pedido.

A importação do cliente será recebida pelo método “fWSImportaClientesSemDadosPedido” e será preenchido os seguintes campos do método:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

data_inicial: enviado em branco.

data_final: enviado em branco.

hora_inicial: enviado em branco.

hora_final: enviado em branco.

No XML de retorno do cliente, haverá os seguintes campos:

Id_Pedido: Código de integração do pedido. Não utilizado para importação de clientes sem pedido.

Id_Cliente: Código de integração do cliente.

Pais: País do cliente.

Revenda: Razão social do cliente caso for do tipo física.

Tipo_Pessoa: Tipo de pessoa física ou jurídica.

Bloqueado: Define se o cliente está bloqueado ou não no site.

Cliente: Será preenchido como nome do cliente caso ele for pessoa física.

Cnpj_Cpf: CNPJ ou CPF do cliente.

Ie_Rg: Inscrição estadual da empresa ou RG do cliente.

Data_Nasc: Data de nascimento do cliente.

Data_Cadastro: Data de cadastro do cliente.

Email: E-mail de cadastro do cliente.

Observacao: Observação do cliente para o lojista.

Logradouro: Endereço do cliente.

Numero: Número do endereço do cliente.

Bairro: Bairro do cliente.

Complemento: Complemento do cliente.

Cep: CEP de endereço do cliente.

Cidade: Cidade do cliente.

Uf: Estado do cliente.

Telefone: Telefone residencial do cliente.

Fax: Fax do cliente.

Celular: Celular do cliente.

Sexo: Sexo do cliente.

Status: Status do cadastro do cliente.

Apelido: Apelido do cliente.

12.4 Integração VTEX

12.4.1 Login

Temos os seguintes campos na tela de login do Integrador Vtex:

Empresa: Empresa liberada pelo Terminal.

Usuario: Usuário do ERP.

Senha: Senha do ERP.

Filial: Filiais cadastradas/liberadas para esta empresa.

Loja Web: A demonstração das Lojas WEB é feita por filial, como o cadastro é feito por filial então o usuário precisa selecionar uma filial antes de escolher qual loja ele deseja enviar/receber dados.

12.4.2 Agendamento

Atualmente no Integrador VTEX é possível configurar rotinas automáticas para Importação de Pedidos, Atualização de Preço, Atualização de Estoque e Atualização de Status.

Tal configuração deve ser realizada no ERP acessando: (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> Aba Vtex)

Como é possível visualizar na imagem acima, temos informações das lojas web carregadas e quais foram seus últimos envios e quais serão os próximos envios. Hoje temos as seguintes informações sobre envios automático e manual no Integrador Vtex:

Exportações: São exibidas quais as exportações (envio) que o Integrador realiza.

Importações: São exibidas quais as importações (recebimentos) que o Integrador realiza.

Intervalo: Horas e Minutos configurados no cadastro de Lojas Web para que possa ser realizada a atualização automática das informações, caso não esteja configurada no ERP tal coluna ficará em branco.

Lembrando que a atualização automática ocorre apenas se o Integrador Vtex estiver em execução, se o mesmo estiver fechado, a atualização automática não será iniciada.

Última Atualização: Data e Horário que foi realizada a última ExportaçãoImportação do Processo.

Próxima Atualização: Data e Horário que a próxima ExportaçãoImportação será realizada, tal coluna estará preenchida apenas se no ERP estiver configurado a rotina para envio automático.

As seguintes informações são enviadas e recebidas pelo Integrador Vtex:

Estoque: Apresenta quando foi realizada a última atualização de estoque e caso esteja configurado a rotina automática, será exibida quando será realizada a próxima atualização de estoque pelo Integrador.

Preços: Apresenta quando foi realizada a última atualização de preço e caso esteja configurada a rotina automática, será exibida quando será realizada a próxima atualização de preço pelo Integrador.

Status de Pedido: Apresenta quando foi realizada a última atualização de Status do Pedido pelo Integrador e caso esteja configurado a rotina automática, será demonstrado quando será enviada a próxima atualização de Status pela Integrador.

Cadastro de Produtos: Apresenta quando foi realizado o último envio de produtos pelo Integrador, não há configuração para envio automático de produtos por isso não irá demonstrar quando a próxima atualização.

Pedido: Apresenta quando foi realizada a Importação do(s) pedidos e caso esteja configurada a rotina automática, será demonstrado quando será realizada a próxima baixa do(s) pedido(s) pelo Integrador.

12.4.3 Exportação de Produtos

Tal função permite o envio de Produtos, Preços, Estoque, e Níveis de Categoria cadastros no ERP para a Plataforma.

Hoje temos os seguintes parâmetros para Exportação de Produtos:

Período De..Até: Período em que compreenderá a Data de Cadastro ou Alteração, de Clientes ou Vendedores, para Exportação do sistema Onclick para a plataforma. Caso o campo esteja em branco será utilizada a data e hora do último envio.

Cód Produto/Barra/Fabricante/Auxiliar: Pode ser selecionado no combo o que o usuário deseja que considere no filtro, Código de Produto, Barra, Fabricante ou Auxiliar, quando informado um valor no campo, nenhum outro filtro é considerado, todos os outros campos de filtro desabilitam e limpam as informações (caso tenha).

Categoria: Níveis cadastrados no ERP para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro.

Marca: Marcas cadastradas no ERP liberadas para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro.

Característica: Características cadastradas no ERP liberadas para a loja WEB selecionada. Cas seja selecionado “Todos” não irá considerar o filtro.

Botão Enviar Produtos:

Categoria: Envia todos os níveis de categorias cadastrados no ERP para a plataforma, neste processo montamos a arvore de nível de categoria para envio de todos. Caso no envio da categoria dê algum erro, nenhum outro processo é executado. Buscamos pelo método “CategoryGet” se a categoria já está cadastrada na plataforma, caso já esteja buscamos alguns dados que não enviamos como: “Description, Keywords e IsActive”, que o usuário pode informar na plataforma. Para enviar uma nova categoria ou atualização desta categoria é feito pelo método “CategoryInsertUpdate”, enviamos as seguintes informações:

ID: Código da categoria (ERP).

Name: Descrição da Categoria (Cabeçalho).

FatherCategoryId: Código da categoria PAI.

Marca: Envia a(s) marca(s) do(s) produto(s), caso a marca já exista na plataforma, não enviamos novamente. O método de envio é o “BrandInsertUpdate”, enviamos as seguintes informações:

Id: Código da Marca (Fabricante) no ERP.

Name_: Descrição da Marca.

IsActive: Envia “True” sempre (dizendo que a marca está ativa).

Produto: Envia os Produtos cadastrados no ERP com liberação para a Loja WEB selecionada, considerando os filtros inseridos pelo usuário, nesta operação só serão enviados Produtos Pai e Produtos Acabados para vinculação entre ERP x Plataforma. Primeiro buscamos informações se o produto já existe na plataforma, o método de envio é o “ProductInsertUpdate”, enviamos as seguintes informações:

Id: Código de Referência do Produto (Site Codigo), caso não tenha Site Codigo é enviado o CODPROD (para caso de cadastro de produto).

Name_: Descrição do Produto no site (aba “Integração Web” do cadastro de produto).

DepartmentId: Código do Nível de Categoria do Produto (Código do Nível Pai).

CategoryId: Código do Nível de Categoria do Produto (Código do Nível Filho).

BrandId: Código da Marca do Produto (caso não tenha Site Código o Fabricante, é enviado o código do ERP do fabricante).

LinkId: Há duas informações que podem ser enviadas neste campo, se a informação “Site Desc. URL” estiver preenchida é enviada ela, se não estiver preenchida é a informação “Site Descricao” (a mesma enviada na tag “Name_”).

RefId: Código de Referência do Produto no ERP (Código do Produto ou Fabricante ou Barras ou Auxiliar).

ReleaseDate: Data de Lançamento do Produto (Data de validade, só é enviado o campo caso tenha informado).

IsVisible: Campo para definir se o produto é visível ou não, enviamos sempre “Verdadeiro” (True).

Description: Descrição Longa do produto.

DescriptionShort: Descrição Curta do produto.

Keywords: Palavras-Chaves do Produto (MetaKeyWord, na aba “Integração Web” do cadastro de produto).

MetaTagDescription: Descrição Longa do Produto, só é enviado uma vez, se já estiver na plataforma, é utilizada a mesma informação da plataforma.

Title: Descrição do Produto, só é enviado uma vez, se já estiver na plataforma o produto, é utilizada a mesma informação da plataforma.

IsActive: Se o produto está ativo ou não, consideramos se o produto está inativo ou com venda suspensa no ERP.

SKU: Envia o(s) produto(s) filhos para a plataforma, como na VTEX é obrigatório ter um SKU, se o produto que estivermos enviando for um produto único então criamos uma SKU a partir dele, o SKU é o envio completo do produto no caso, pois enviamos Preço, Estoque, Característica do(s) produto(s), inclusive o envio da característica é feito por uma DLL feita em C# (VtexProdCaract.dll). Para o envio de estoque temos um delay que aguardamos o produto ser cadastrado na plataforma, esse delay varia de 1s a 3 minutos e 20s (tempo máximo que aguardamos). Como no envio do produto, verificamos se o SKU está cadastrado na plataforma pelo método “StockKeepingUnitGet”, se o produto estiver com o Site Código preenchido no ERP, mais por algum motivo não existir mais na plataforma, não enviamos este produto. O método de envio é “StockKeepingUnitInsertUpdate”, enviamos as seguintes informações:

ProductId: Código de Referência do Produto Pai (Site Código ou CodProd, pois se for primeiro envio não estará preenchido ainda o Site Código. Detalhe: apenas se for produto(s) filho(s) que este campo será enviado).

Id: Código de Referência do Produto (Site Código ou CodProd).

IsKit: Informa se a SKU é do tipo KIT, na plataforma da VTEX não trabalhaamos com produto do tipo KIT (na plataforma, dentro do ERP trabalhamos), então é sempre enviado como “Falso” (False).

Name_: Descrição do Produto no site (Aba “Integração Web” do cadastro de Produto).

RefId: Código de Referência do Produto (Código do Produto, Barras, Fabricante ou Auxiliar).

StockKeepingUnitEans: Lista de Código de barras (EAN13) do ERP, enviamos apenas o Código de barras do produto (pode-se cadastrar mais de um na plataforma).

ListPrice: Valor do Produto na tabela de preço.

Price: Valor de Promoção do Produto na tabela de preço, caso a Data Inicial e Final tenha sido ultrapassada da data atual, enviamos o Valor unitário do Produto (Mesma informação do campo ListPrice).

Height: Altura do Produto cadastrado no ERP.

Length: Comprimento do Produto cadastrado no ERP.

Width: Largura do Produto cadastrado no ERP.

WeightKg: Peso Bruto do produto cadastrado no ERP (Em Gramas, não calculamos nada).

CubicWeight: Peso Cúbico do Produto.

IsAvaiable: Produto Disponível na plataforma (Enviamos sempre como “Ativo” (True).

IsActive: Produto Ativo na plataforma (Verificamos se o produto está inativo ou com venda suspensa no ERP para desativar na plataforma).

ModalId: Modalidade de Frete, enviamos fixo “1”. (1-Leve, 2-Pesado, 3-Refrigerado, 4-Químico).

Botão Enviar Preço: O Integrador considerará os filtros informados, caso nenhum filtro seja informado será considerado a data da última atualização até o momento considerando o(s) produto(s) alterado(s).

O preço a ser enviado é o configurado na tabela de preço do Cadastro de Lojas Web, conforme segue:

(Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> Aba Geral >> 6.Tabela de Preço)

Caso não tenha configurado no cadastro da loja web é enviado da tabela padrão do sistema. O método de envio é “StockKeepingUnitPriceUpdate”, enviamos as seguintes informações:

stockKeepintUnitId: Código de Referência do produto no site (Site Código).

listPrice: Valor do Produto na tabela de Preço.

price: Valor de Promoção da tabela de Preço.

costPrice: Valor do Produto na tabela de Preço (Caso o produto não tenha valor de custo é enviado o valor de “1”).

Botão Enviar Estoque: O Integrador considerará os filtros informados, caso nenhum filtro seja informado será considerada a data da última atualização até o momento considerando o(s) produto(s) alterado(s) e enviando-os para a plataforma.

No envio do estoque o Integrador irá buscar a qual estoque o produto está liberado na VTEX e para todos estes estoques irá enviar a mesma informação. O método de envio é o “WareHouseIStockableUpdateV3”, enviamos as seguintes informações:

wareHouseId: ID do estoque na VTEX.

itemId: Código de Referência do produto no site (Site Codigo).

availableQuantity: Estoque Atual do produto (entre os almoxarifados configurados, caso não selecione nenhum Almoxarifado é considerado todos os Almoxarifados disponíveis para venda. Caso não exista “Múltiplos-Almoxarifados” liberados para a base, é considerado o valor do estoque da tabela de produto. Pode-se enviar o Est. Segurança ou não, existe uma configuração para isso, conforme segue:

(Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> 2.9 Enviar Estoque de Segurança para Loja Web)

dateOfAvailability: Data de quando o estoque enviado terá efeito, enviamos a DataHora atual.

Botão Enviar Categorias: Serão enviados todos os níveis de categorias cadastrados no ERP para a plataforma, neste processo montamos a arvore de nível de categoria para envio de todos. Buscamos pelo método “CategoryGet” se a categoria já está cadastrada na plataforma, caso já esteja buscamos alguns dados que não enviamos como: “Description, Keywords e IsActive”, que o usuário pode informar na plataforma. Para enviar uma nova categoria ou atualização desta categoria utiliza-se o método “CategoryInsertUpdate”, enviamos as seguintes informações:

ID: Código da categoria (ERP).

Name_: Descrição da Categoria (Cabeçalho).

FatherCategoryId: Código da categoria PAI

12.4.4 Importação de Pedidos

 

Botão Importação de Pedidos: O Integrador considerará primeiramente o filtro informado “Pedido” na qual o usuário pode baixar individualmente um pedido específico da VTEX, caso esteja informado 0 o sistema irá baixar todos os pedidos com status “CAP” (Pagamento Aprovado [Checkout v1] ou Pronto para Manuseio [SmartCheckout]). Na baixa de pedidos da plataforma da VTEX não é atualizado o cabeçalho do pedido (caso ele já tenha sido processado pelo ERP, pelo fato de baixarmos apenas pedidos já aprovados da plataforma). Fazemos a baixa dos pedidos por dois métodos o “OrderGet” (Baixamos um pedido especifico, nos retornando um OrderDTO então transformamos para um ArrayOfOrderDTO) ou pelo método “OrderGetByStatus” (Baixando todos os status “CAP”, que nos retorna um ArrayOfOrderDTO), logo após isso iremos processar o ArrayOfOrderDTO. Um ArrayOfOrderDTO são vários pedidos agrupados em um array, cada posição é um OrderDTO que representa um pedido, abaixo uma listagem dos campos presentes:

ID: Número do Pedido na plataforma.

ClientId: ID do Cliente na Plataforma (Este campo não vem na SmartCheckout).

IsGiftList: Pedido é uma Lista de Presente.

GiftListStockKeepingUnits: Skus de uma lista de presente.

PurchaseDate: Data da Compra.

Client: Um ClientDTO (abaixo do pedido estará a listagem do ClientDTO).

Address: Um AddressDTO (abaixo do pedido estará a listagem do AddressDTO).

OrderDeliveries: Uma lista de OrderDeliveryDTO (abaixo do pedido estará a listagem do OrderDeliveryDTO). Um pedido pode ser divido em uma ou mais entregas dependendo do tipo do produto (pesado, leve, refrigerado, químico) Ex.: Um pedido é composto de uma adega e um vinho. A adega pode ser enviada por uma transportadora diferente da do vinho e também com prazos diferentes.

AffiliateId: Id do afiliado (MarketPlaces, é um De/Para da VTEX, por exemplo, quando a compra é realizada pelo Extra vem a descrição no campo “NVP” que é a Nova Ponto Com, quando vem do Submarino vem “B2W”), utilizamos este campo como forma de pagamento dentro do ERP, pois não vem do MarketPlaces a forma de pagamento do usuário.

OrderPayments: Uma lista de OrderPaymentDTO (abaixo do pedido estará a listagem do OrderPaymentDTO). É uma lista das formas de pagamento.

Na listagem de clientes (ClientDTO) existem os seguintes campos sendo utilizados:

DateBirth: Data de Nascimento.

CreateDate: Data de cadastro na plataforma.

FirstName: Primeiro Nome.

LastName: Último Nome.

NickName: Apelido.

Email: E-mail.

Password: Senha de Acesso (Plataforma).

CpfCnpj: CPF ou CNPJ.

Phone: Telefone Residencial.

CelPhone: Telefone Celular.

OfficePhone: Telefone Comercial.

IsActive: Cliente Ativo.

CompanyName: Razão Social.

Gender: Sexo.

IsNewsReceiver: Recebe newsletter.

IsSMSNewsReceiver: Recebe SMS News.

StateInscription: Inscrição estadual.

Na listagem de Endereços (AddressDTO) existem os seguintes campos sendo utilizados:

Id: Id do endereço da compra.

ReceiverName: Nome do Destinatário.

Street: Rua (Endereço).

Country: País.

State: Estado.

City: Cidade.

NumberV3: Número do endereço (utilizado apenas no SmartCheckout por se tratar de um tipo string).

Number: Número do endereço (utilizado apenas no checkout v1 por se tratar de um tipo inteiro).

More: Complemento.

ReferencePoint: Ponto de Referênia.

Neighborhood: Bairro.

ZipCode: CEP.

OfficePhone: Telefone Comercial.

Na listagem de Endereços de Entrega dos Itens (OrderDeliveryDTO), existem os seguintes campos sendo utilizados:

ScheduledDate: Data de Agendamento da Entrega.

ScheduledShift: Horário de Entrega (Manhã, Tarde, Noite).

DateExpectedDelivery: Data Prevista para Entrega.

DeliveryDate: Data de Entrega.

Id: ID da compra de Entrega.

OrderId: ID do Pedido na Plataforma.

FreightId: ID do Frete (Integer), caso esteja vazio consideramos o FreightIDv3.

FreightIdV3: Id do Frete (String).

OrderStatus: É uma OrderStatusDTO, situação (STATUS) do pedido, aqui só utilizamos a informação “Description” que é a descrição do status na plataforma (Crédito Aprovado).

OrderItems: Uma lista de OrderItemDTO (abaixo dos endereços de entrega estará a listagem do OrderItemDTO), são os itens do pedido (para entrega separada, como no ERP não trabalhamos dessa forma, colocamos todos os itens em um único pedido).

Na listagem de Itens dos Pedidos (OrderItemDTO) existem os seguintes campos sendo utilizados:

ShippingCostOff: Valor de Frete com Desconto.

Cost: Preço do Produto na plataforma.

CupomValue: Valor do cupom para o produto.

CupomValueOff: Valor do Produto subtraído do cupom com desconto.

IsGift: Informa se o produto é um Brinde ou não.

IsKit: Informa se o SKU é um kit na plataforma (caso for, não processamos ele pois já vem os itens no pedido).

ItemId: Id do sku vendido. Não existe campo relativo à quantidade, cada item pode ter serviços específicos. Código de Referência do Produto (Site Codigo).

Id: ID do item do pedido.

OrderItemServices: Serviços do item (SKU), uma listagem de OrderItemServiceDTO, que será descrito abaixo dos itens dos pedidos.

Detalhe a ser notado no “OrderItemDTO” é o campo “ItemID”, caso o pedido for de uma lista de presente que o dono da lista configurou que deseja receber como crédito essa lista, o produto a ser baixado/faturado na nota será o configurado no Cadastro de Lojas WEB

(Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> Aba Vtex >> 3.Código de Barras para Itens da Lista de Presentes).

Na listagem de Serviços dos Produtos (OrderItemServiceDTO) existem os seguintes campos sendo utilizados:

StockKeepingUnitService: Obter as informações sobre um determinado serviço de um sku. (Abaixo de Serviços dos Produtos terá a listagem). Como um produto pode ter vários serviços então ele é “desmembrado” em um novo array.

GiftCardMessage: Mensagem que irá no Presente (embalagem).

Na listagem de Serviço do Produto (StockKeepingUnitService) existem os seguintes campos sendo utilizados:

ServicePrice: Preço do Serviço, é uma listagem de ServicePriceDTO (abaixo de Serviço do produto terá a listagem).

Na listagem de Preço do Serviço (ServicePriceDTO) existem os seguintes campos sendo utilizados:

Service: Detalhes do Serviço, é uma listagem do ServiceDTO (abaixo de Preço do Serviço terá a listagem).

Price: Valor do Serviço (irá para o valor da Embalagem).

Na listagem de Detalhes do Serviço (ServiceDTO) existem os seguintes campos sendo utilizados:

Name: Nome do serviço, verificamos se há algo descrito como “Presente” para considerar.

Na listagem de Formas de Pagamentos (OrderPaymentDTO) existem os seguintes campos sendo utilizados:

PaymentId: ID da forma de pagamento (Campo Código Internet do Cartão, caso não encontre informaremos no campo “FORMAPAGTO” do cabeçalho do pedido a informação que veio na VTEX).

OrderId: ID do Pedido (Na Plataforma).

Plots: Quantidade de Parcelas.

CostWithInterest: Valor da Parcela com Juros.

GiftCardId: ID do Vale Presente.

Quando é feito a baixa do pedido, e o pedido conseguiu ser processado pelo Integrador para envia-lo para o ERP, atualizamos o status do pedido para “ERP” dessa forma o Integrador não irá baixar novamente este pedido e conseguirá seguir novamente o fluxo de status de pedido na VTEX, pois na VTEX é necessário seguir este fluxo (mais informações sobre o fluxo de pedido em: http://vtex.com.br/help/fluxo-do-pedido/ ).

12.4.5 Atualização de Status

Botão Enviar Status do Pedido: O Integrador considerará o filtro informado, ou caso não tenha filtro informado será considerada a data da última atualização até a hora atual. A atualização de Status é realizada para pedidos e notas alteradas dentro do período informado nos filtros de datas. Para que o status do Pedido seja enviado, o Tipo de pedido deve estar devidamente configurado e atrelado a um Status Web nas configurações do ERP conforme segue: (Vendas >> Tabelas Diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE PEDIDO >> Status Web >> Tela[1109] CADASTRO DE STATUS WEB >> Aba Integração Web).

Háos seguintes campos sendo utilizados para a atualização de status:

Courier: Transportadora (Enviamos o nome Fantasia da Transportadora da Nota).

InvoiceNumber: Número da Nota Fiscal.

TrackingNumber: Código de Rastreio.

InvoiceValue: Valor da Nota Fiscal.

IssuanceDate: Data de Emissão da Nota.

OrderId: Número do pedido na plataforma (Pedido Internet).

StockKeepingUnits: SKUs da nota Fiscal.

Na listagem de Itens Faturados na Nota Fiscal existem os seguintes campos sendo utilizados:

StockKeepingUnitId: ID do SKU (Código de Referência do Produto, Site Código).

Quantity: Quantidade do Produto faturado na Nota.

Price: Preço do Produto na nota Fiscal (VRTOTITEM).

Para a atualização de status quando o Pedido ainda não está faturado, consideramos o Tipo do Pedido e pegamos da aba “Integração Web” do tipo de pedido a descrição internet informada para a loja que está sendo enviada. Existem os seguintes campos sendo utilizados:

idOrder: ID do pedido na plataforma.

statusOrder: Descrição do tipo do pedido na plataforma, é enviado do tipo “string”, por exemplo “CAP” que é quando o pedido é baixado para a plataforma. (Mais informações dos Status http://vtex.com.br/help/status-do-pedido/ ).

12.5 Integração IKEDA/RAKUTEN

12.5.1 Login

Temos os seguintes campos na tela de login do Integrador:

Empresa: Empresa liberada pelo Terminal.

Usuario: Usuário do ERP.

Senha: Senha do ERP.

Filial: Filiais cadastradas/liberadas para esta empresa.

Loja Web: A demonstração das Lojas WEB é feita por filial, como o cadastro é feito por filial então o usuário precisa selecionar uma filial antes de escolher qual loja ele deseja enviar/receber dados.

12.5.2 Agendamento

Atualmente no Integrador Ikeda é possível configurar rotinas automáticas para Importação de Pedidos, Atualização de Preço, Atualização de Estoque e Atualização de Status.

Tal configuração deve ser realizado no ERP acessando: (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS Web >> Aba Parâmetros Comuns de Integração >> Aba Ikeda >> 1. Dados Gerais).

Como é possível visualizar na imagem acima, na grid de agendamento temos informações das lojas web carregadas e quais foram seus últimos envios e quais serão os próximos envios.

Exportações: Neste campo são exibidas quais as exportações (envio) que o Integrador realiza.

Importações: Neste campo são exibidas quais as importações (recebimentos) que o Integrador realiza.

Intervalo: Horas e Minutos configurados no cadastro de lojas web para que possa ser realizado a atualização automática das informações, caso não esteja configurado no ERP tal coluna ficará em branco.

Lembrando que a atualização automática ocorre apenas se o Integrador Ikeda estiver em execução, se o mesmo estiver fechado a atualização automática não será iniciada.

Última Atualização: Data e Horário que foi realizado a última Exportação/Importação do Processo pelo Integrador.

Próxima Atualização: Data e Horário que a próxima Exportação/Importação será realizada, tal coluna estará preenchida apenas se no ERP estiver configurada a rotina para envio automático.

As seguintes informações são enviadas e recebidas pela Integrador Ikeda:

Estoque: Apresenta quando foi realizada a última atualização de Estoque e caso esteja configurada a rotina automática, será exibido quando será realizada a próxima atualização pelo Integrador Ikeda.

Preços: Apresenta quando foi realizada a última atualização de Preço e caso esteja configurada a rotina automática, será exibido quando será realizada a próxima atualização pelo Integrador Ikeda.

Status de Pedido: Apresenta quando foi realizada a última atualização de Status do Pedido pelo Integrador Ikeda e caso esteja configurada a rotina automática, será exibida quando será enviada a próxima atualização de Status pelo Integrador.

Cadastro de Produtos: Apresenta quando foi realizado o último envio de produtos pelo Integrador Ikeda, não há configuração para envio automático de produtos, por isso não irá demonstrar quando será a próxima atualização.

Pedido: Apresenta quando foi realizada a Importação do(s) pedidos e caso esteja configurada a rotina automática, será demonstrado quando será realizado a próxima baixa do(s) pedido(s) pelo Integrador.

12.5.3 Exportação de Produtos

Tal função permite o envio de Produtos, Estoque, Preço e Níveis de Categoria cadastrados no ERP para a Plataforma.

Hoje temos os seguintes parâmetros para Exportação de Produtos:

Período De: Data Inicial de Cadastro ou Alteração de produtos para exportação para a plataforma. Caso o campo esteja em branco será considerada a data e hora do último envio.

Até: Data Final de Cadastro ou Alteração de produtos para exportação para a plataforma. Caso esteja em branco será considerado a data e hora atual do envio.

Cód Produto/Barra/Fabricante/Auxiliar: Pode ser selecionado no combo o que o usuário deseja que considere no filtro, Código de Produto, Barra, Fabricante ou Auxiliar, quando informado um valor no campo nenhum outro filtro é considerando, todos os outros campos de filtro desabilitam e limpam as informações (caso tenha).

Categoria: Níveis cadastrados no ERP para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro.

Marca: Marcas cadastradas no ERP liberadas para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro.

Característica: Características cadastradas no ERP liberadas para a loja WEB selecionada. Caso selecionado “Todos” não irá considerar o filtro.

Botão Enviar Produtos

Nível de Categoria: Envia o Nível de Categoria cadastradas no ERP para vinculação entre ERP x Plataforma:

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInternoCategoria: Código interno do nível de categoria no ERP.

NomeCategoria: Descrição do Nível de Categoria cadastrado no ERP.

CategoriaStatus: Status atual do nível de categoria, atualmente enviado 1 (ativo).

CategoriaPai: Código do nível de categoria pai.

 

Filtros: Para enviar filtros para a plataforma Ikeda, é necessário que a característica esteja vinculada pelo menos a um Produto Pai, e então no momento do envio ele será amarrado ao nível em que o produto pertence automaticamente:

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInternoFiltro: Código interno da característica.

CategoriasCodigoInterno: Array de string que é preenchida toda a árvore de níveis que aquele filtro está atrelado.

NomeFiltro: Nome utilizado no filtro.

DescricaoFiltro: Descrição detalhada do filtro, hoje enviado o mesmo valor do campo NomeFiltro.

Obrigatorio: Representa se o tipo de filtro sempre exige algum valor no produto. Atualmente enviamos fixo 2 (Não).

StatusFiltro: Representa o status da característica. Atualmente enviamos fixo 1 (Ativo).

Fabricante: Envia os fabricantes cadastrados no ERP, liberados para a loja web e que estão atrelados a algum produto.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInterno: É o código único no sistema (ERP) que representa o fabricante.

Nome: É o nome que representa o fabricante e o valor deve ser único entre todos fabricantes.

FabricanteStatus: É o status do fabricante, sendo que para Ativo (1), o fabricante é visível na loja e Inativo (2) visível somente no administrativo. Atualmente enviamos fixo 1 (Ativo).

Produto: Envia os Produtos cadastrados no ERP com liberação para a Loja WEB selecionada considerando os filtros inseridos pelo usuário, nesta operação só serão enviados Produtos Pai e Produtos Acabados para vinculação entre ERP x Plataforma. Abaixo os campos enviados.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInternoProduto: É o código único no sistema que representa o produto. É enviado o Código de Referencia configurado no cadastro de loja web.

CodigoInternoFornecedor: É preenchido o código interno do fabricante.

NomeProduto: É o nome que representa o produto. Descrição do produto (campo Descrição na aba Integração WEB no Cadastro de Produto).

TituloProduto: Aplicado em livrarias, representa o título dos livros. Caso o produto for novo, será enviado em branco.

SubtituloProduto: Aplicado em livrarias, representa o subtítulo dos livros. Caso o produto for novo, será enviado em branco.

DescricaoProduto: É um texto para realizar o detalhamento do produto (campo Descrição Longa na aba Integração WEB no Cadastro de Produto).

Texto1Produto: É um dos 10 campos disponíveis para serem utilizados para armazenar os valores customizados especificamente nos projetos. Nesse campo é enviado o campo Descrição HTML.

Texto2Produto até Texto10Produto: É um dos 10 campos disponíveis para serem utilizados para armazenar os valores customizados especificamente nos projetos.

Numero1Produto até Numero10Produto: É um dos 10 campos disponíveis para serem utilizados para armazenar os valores customizados especificamente nos projetos.

CodigoInternoEnquadramento: Valor alfanumérico que representa o código interno do enquadramento no ERP.

ModeloProduto: Valor alfanumérico que representa o modelo do produto. É enviado o código do fabricante.

PesoProduto: Valor decimal com duas casas decimais. Representa o peso do produto em kg. O separador deve ser um ponto (“.”). Caso o campo Peso Bruto no ERP não estiver preenchido, será enviado o Peso Liquido.

PesoEmbalagemProduto: Valor decimal, com duas casas decimais. Representa o peso do produto somado com o da embalagem em kg. O separador deve ser um ponto (“.”). Este é o peso considerado para cálculo de frete. Caso o campo Peso Bruto no ERP não estiver preenchido, será enviado o Peso Liquido.

AlturaProduto: Valor decimal, com duas casas decimais. Representa a altura do produto em cm. O separador deve ser um ponto (“.”). O campo Altura no cadastro de produto será considerado.

AlturaEmbalagemProduto: Valor decimal, com duas casas decimais. Representa a altura do produto embalado em cm. O separador deve ser um ponto (“.”). O campo Altura no cadastro de produto será considerado.

LarguraProduto: Valor decimal, com duas casas decimais. Representa a largura do produto em cm. O separador deve ser um ponto (“.”). O campo Largura no cadastro de produto será considerado.

LarguraEmbalagemProduto: Valor decimal, com duas casas decimais. Representa a largura do produto embalado em cm. O separador deve ser um ponto (“.”). O campo Largura no cadastro de produto será considerado.

ProfundidadeProduto: Valor decimal, com duas casas decimais. Representa a profundidade do produto em cm. O separador deve ser um ponto (“.”). O campo Comprimento no cadastro de produto será considerado.

ProfundidadeEmbalagemProduto: Valor decimal, com duas casas decimais a profundidade do produto embalado em cm. O separador deve ser um ponto (“.”). O campo Comprimento no cadastro de produto será considerado.

EntregaProduto: Valor inteiro. Representa o prazo adicional de entrega além do prazo do serviço de entrega. Será considerado o campo Dias para Entrega na aba Dados Gerais do cadastro de produto.

QuantidadeMaximaPorVenda: Valor numérico. É o número que representa a quantidade máxima que um consumidor pode comprar por pedido. O valor mínimo deve ser 1. Quando não há restrição, enviar número grande. Ex: 999. Será considerado o campo Máx Venda na aba Integração Web no cadastro de produto.

StatusProduto: Valor Numérico. É o status do produto, sendo que para 1, a categoria é visível na loja e 2 visível somente no administrativo. Será considerado o campo Produto Disponível na aba Integração Web no cadastro de produto.

TipoProduto: Valor Numérico. É o tipo do produto, sendo que os produtos comuns devem receber 1, 2 para Brinde e 3 para Produto Grátis. Brinde e Produto Grátis não são comercializados individualmente. Eles são possíveis de ser associados a uma promoção. A diferença entre o Brinde e Produto Grátis é somente o texto que aparece no carrinho de compras. Será considerado o campo GRUPO3 na aba Dados Gerais no cadastro de produto, caso ficar em branco, será enviado como produto comum.

Presente: Valor Numérico. É o valor que representa se o produto pode ser embalado para presente ou não. 1 para sim e 2 para quando não pode ser embalado. Atualmente enviado fixo 1 (Sim).

PrecoCheioProduto: Valor decimal que representa o preço cheio do produto. Será considerado o campo Preço de Venda na aba Custos e Preços no cadastro de produto.

PrecoPor: Valor decimal que representa o preço comercializado na loja. As promoções por exemplo, são aplicadas sobre este preço. Este preço deve ser sempre igual ou menor que o Preço Cheio. Será considerado o campo valor de promoção na aba Custos e Preços no cadastro de produto. Caso estiver em branco ou a promoção não estiver com data, será enviado o campo Preço de Venda.

PersonalizacaoExtra: Valor Numérico. Indica se o produto possui personalização. Atualmente enviado fixo 1 (Sim).

PersonalizacaoLabel: Valor alfanumérico. Representa o nome da personalização. Atualmente enviado fixo 1 (Sim).

ISBN: Valor alfanumérico. Aplicado mais para livrarias, representa o ISBN 10 ou ISBN 13 dos livros, sem traços. Será considerado o campo Código ISBN na aba Integração Web no cadastro de produto.

EAN13: Valor alfanumérico. Representa do EAN 13 das mercadorias, sem traços. Será considerado o campo Código de Barras do produto.

YouTubeCode: Valor alfanumérico. É o código que representa o vídeo no Youtube. Atualmente enviado fixo em branco.

Produto X Categoria: Rotina que vincula o produto com a categoria cadastrada anteriormente.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInternoProduto: Valor alfanumérico. É o código único no sistema que representa o produto. É enviado o Código de Referencia configurado no cadastro de loja web.

CodigoInternoCategoria: Valor alfanumérico. É o código único no sistema que representa a categoria. Será enviado o código interno do nível de categoria. Caso o produto está vinculado ao nível de categoria menor, será enviado do menor para o maior, ou seja “subindo” os níveis até chegar no pai.

SKU: Caso o produto possua SKUs, será enviado logo em seguida os produtos vinculados a ele.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInternoProdutoPai: Valor alfanumérico. É o código único no sistema que representa o produto pai vinculado ao produto filho a ser cadastrado. É enviado o Código de Referencia configurado no cadastro de loja web.

PartNumber: Valor alfanumérico. É o código único no sistema que representa o produto filho no sistema. Não deve conter caracteres especiais. É enviado o Código de Referencia configurado no cadastro de loja web.

PrecoPor: Valor decimal. É o valor que representa o preço do produto filho. Deve ser necessariamente um preço igual ou menor ao produto pai. Será considerado o campo valor de promoção na aba Custos e Preços no cadastro de produto. Caso estiver em branco ou a promoção não estiver com data, será enviado o campo Preço de Venda.

sku1 até sku5: Campo destinado as características do produto. No máximo é possível vincular 5 por Sku. Caso ultrapassar esse limite, o integrador preencherá com os cinco primeiros.

StatusSKU: Valor numérico. É o valor que representa se o produto está ativou ou inativo no sistema. Quando está inativo, não é visível na loja virtual, mas é visível no administrativo. Será considerado o campo Produto Disponível na aba Integração Web.

Envio de Estoque: Caso um produto não possua Skus, o estoque será enviado com o código do produto único. Caso possuir SKUs, será enviado o estoque de cada filho.

Estes mesmos campos serão enviados ao clicar no botão ATUALIZAR ESTOQUE no integrador.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoProdutoInterno: Valor alfanumérico. É o código único no sistema (ERP) que representa o produto.

PartNumber: Valor alfanumérico. Será preenchido apenas se for um produto filho, que será enviado o código de referência.

QtdEstoque: Valor alfanumérico. Quantidade do produto em estoque.

QtdMinima: Quantidade mínima do produto em estoque (é bloqueada a compra do item cujo estoque tenha atingido a quantidade mínima especificada). Será considerado o campo Est. Mínimo na aba Integração Web.

TipoAlteracao: Tipo da Alteração do Estoque. Hoje é enviado fixo 3.

Vincular Produto X Filtro: Responsável pela vinculação do produto pai com filtros criados anteriormente.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInternoFiltro: Valor alfanumérico. Representa o código do filtro no ERP. Será enviado Código interno da característica.

CodigoInternoProduto: Valor alfanumérico. Representa o código do produto no ERP. Será enviado o código de referência configurado no cadastro de loja web.

ValorFiltroProduto: Valor alfanumérico. Representa o valor do filtro. Será enviado o valor vinculado a característica.

StatusFiltroProduto: Valor numérico. Representa o status da característica. Atualmente será enviado fixo 1 (Ativo).

Botão Enviar Preço e Estoque: O Integrador considerará os filtros informados, caso nenhum filtro seja informado será considerada a data da última atualização até o momento, considerando o(s) produto(s) alterado(s) e enviando para a plataforma.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInternoProduto: Valor alfanumérico. Representa o código do produto no ERP. Será enviado o código de referência configurado no cadastro de loja web.

PrecoCheio: Valor decimal que representa o preço cheio do produto. Será considerado o campo Preço de Venda na aba Custos e Preços no cadastro de produto. Esse campo será preenchido apenas para produtos pais ou únicos.

PrecoPor: Valor decimal. É o valor que representa o preço do produto filho. Deve ser necessariamente um preço igual ou menor ao produto pai. Será considerado o campo valor de promoção na aba Custos e Preços no cadastro de produto. Caso estiver em branco ou a promoção não estiver com data, será enviado o campo Preço de Venda.

12.5.4 Importação de Pedidos

Botão Importação de Pedidos: O Integrador considerará qualquer tipo de pedido que não foi integrado para o ERP. No Integrador Ikeda só é possível baixar uma forma de pagamento. Caso o Pedido já exista no ERP será atualizado (se o pedido não for do tipo “Fixo”). A Estrutura do arquivo XML é a seguinte:

Cabeçalho do Pedido:

PedidoCodigo: Valor numérico. Código do pedido no e-Commerce, somente o lojista tem acesso.

PedidoStatus: Valor numérico que representa o status do pedido.

C:Usersmarcus.viniciusDesktopimg22.JPG

ListaTipoEntrega: Define como a lista será tratada dentro do ERP. Caso a lista for do tipo 1,2 ou 3 será gerado um pedido cópia automaticamente ao faturar o pedido original. A primeira nota gerada será enviada para o comprador do produto originário de uma lista. Esse segundo pedido também deverá ser faturado para que a nota fiscal vá para o dono da lista. Caso o pedido for de uma lista do tipo 4, não será criado um segundo pedido cópia pois os créditos serão usados futuramente pelo dono da lista.

Tipo da Entrega da Lista

CadaCompra = 1,

Semanalmente = 2,

Única = 3,

Creditos = 4

Pessoa: Enumerador que representa o tipo da conta.Pessoa Física (1) ou Pessoa Jurídica (2).

CPF: Valor alfanumérico que representa o CPF da pessoa física sem pontuação. Aplicável para Pessoa Física.

RG: Valor alfanumérico que representa o RG da pessoa física. Aplicável para Pessoa Física.

Nome: Valor alfanumérico que representa o nome do comprador. Aplicável para Pessoa Física.

SobreNome: Valor alfanumérico que representa o sobrenome do comprador. Aplicável para Pessoa Física.

CNPJ: Valor alfanumérico que representa o CNPJ da pessoa física sem pontuação. Aplicável para Pessoa Jurídica.

IE: Valor alfanumérico que representa a IE da pessoa jurídica. Aplicável para Pessoa Jurídica.

RazaoSocial: Valor alfanumérico que representa a razão social do cliente. Aplicável para Pessoa Jurídica.

Email: Valor alfanumérico que representa o e-mail do comprador.

Data: Valor alfanumérico que representa data do pedido, formato AAAA-MM-DD.

DataNascimento: Valor alfanumérico que representa a data de nascimento no formato AAAA-MM-DD, aplicável para Pessoa Física.

NomeDestinatario: Valor alfanumérico que representa o nome do destinatário do pedido.

Logradouro: Valor alfanumérico que representa o logradoudo do endereço de entrega.

Bairro: Valor alfanumérico que representa o Bairro do endereço de entrega.

Numero: Valor alfanumérico que representa o número do endereço de entrega.

Cidade: Valor alfanumérico que representa a Cidade do endereço de entrega.

CEP: Valor alfanumérico que representa o CEP do endereço de entrega sem o traço.

Complemento: Valor alfanumérico que representa o complemento do endereço de entrega.

Estado: Valor alfanumérico que representa o Estado do endereço de entrega.

DDD1: Valor alfanumérico que representa o DDD1 do endereço de entrega.

Telefone1: Valor alfanumérico que representa o Telefone1 do endereço de entrega.

DDD2: Valor alfanumérico que representa o DDD2 do endereço de entrega.

Telefone2: Valor alfanumérico que representa o Telefone2 do endereço de entrega.

DDDCelular: Valor alfanumérico que representa o DDD do celular do endereço de entrega.

Celular: Valor alfanumérico que representa o Celular do endereço de entrega.

DDDFax: Valor alfanumérico que representa o DDD do fax do endereço de entrega.

Fax: Valor alfanumérico que representa o Fax do endereço de entrega.

ServicoEntregaCodigo: Código do serviço de entrega no Ikeda. Esse código é responsável por buscar a transportadora no ERP.

ValorTotal: Valor decimal, com duas casas decimais. Representa o valor Total do Pedido.

(ValorSubTotal + ValorJuros + ValorFrete + ValorPresente – ValorDesconto).

ValorFreteCobrado: Valor decimal, com duas casas decimais. Representa o valor de frete que efetivamente foi cobrado.

ValorJuros: Valor decimal, com duas casas decimais. Representa o valor de juros do pedido.

ValorPresente: Valor decimal, com duas casas decimais. Representa o valor cobrado para embalagem de presente.

ValorVale: Valor decimal, com duas casas decimais. Representa o valor do vale utilizado no pedido.

ListaCodigo: Valor numérico. Representa do código da lista.

ParceiroCodigo: Código do parceiro. Esse código é responsável por buscar o funcionário ou indicador no ERP.

Observacao: Valor alfanumérico. Representa a observação do pedido.

FormaPgto: Valor numérico. Representa o código da forma de pagamento no e-Commerce.

C:Usersmarcus.viniciusDesktopimg23.JPG

CarOperadoraRetornoMensagem: Mensagem de retorno da operadora. Criptografado por padrão, caso precise do Vetor e da Chave para descriptografar, entrar em contato com o líder do produto.

CarAutorizacaoCodigo: Código de autorização da operadora, quando a transação é aprovada. Criptografado por padrão, caso precise do Vetor e da Chave para descriptografar, entrar em contato com o líder do produto.

Operadora: Valor numérico. Representa o código da operadora no e-Commerce.

Itens do Pedido (Array de Itens):

ItemValorFinal: Valor final do item. Valor Final do produto com Desconto aplicado.

ItemQtde: Quantidade comprada do item.

ItemPartNumber: Chave utilizada para descrever um produto e suas características. Será informada a referência configurada no cadastro de loja web.

CodigoInterno: Código Interno do Produto no ERP. Caso o campo ItemPartNumber estiver em branco, será considerado esse campo.

Presente: Indicador se o produto é para presente. Caso for presente, na tela de pedido será marcado na tabela de itens como presente.

ItemMsgPresente: Mensagem do presente.

ItemTipo: Identifica se o item está sendo pago com Vale Presente.

Tipo do Item

Produto = 1,

Brinde = 2,

ProdutoGratis = 3,

ValePresente = 4,

Personalizado = 5.

13.5.5 Atualização de Status

Botão Atualizar Status: o Integrador considerará o filtro informado, ou caso não tenha filtro informado será considerada a data da última atualização até a hora atual.

A atualização de Status é realizada para Pedidos e Notas alteradas no período informado no filtro. Para que o status do Pedido seja enviado, o Tipo de pedido deve estar devidamente configurado e atrelado a um Status Web nas configurações do ERP conforme segue: Vendas >> Tabelas Diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE PEDIDO >>Status Web >> Tela [1109] CADASTRO DE STATUS WEB >> Aba Integração Web.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoPedido: Valor numérico que representa o código do pedido no e-Commerce.

CodigoInternoPedido: Valor alfanumérico. Representa o código do pedido no ERP.

PedidoStatus: Valor numérico que representa o status do pedido. Será enviado o código de integração no cadastro de Tipo de Pedido.

StatusInternoPedido: Valor alfanumérico. Representa o código do status do pedido no ERP. Será enviada a descrição de integração no cadastro do Tipo de Pedido.

ObjetoSedex: Valor alfanumérico que representa o código do objeto sedex para rastreamento. Preenchido apenas após o pedido faturado.

NotaFiscal: Valor numérico. Representa o número da nota fiscal.

Serie: Valor alfanumérico. Representa a série da nota fiscal.

13 SIGEP WEB

O SIGEP WEB é um módulo do sistema com o propósito de preparar e gerenciar as postagens de Clientes dos Correios. Esse serviço engloba um conjunto de métodos que permitem automatizar a prestação de serviços dos Correios, como: SEDEX, Encomenda PAC, e-SEDEX entre outros.

13.1 MÓDULO E CONFIGURAÇÕES DO SISTEMA

(Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Alterar >> Tela [0444] CONFIGURAÇÕES DO SISTEMA)

Na opção 17. Módulos Habilitados, a opção 45. Integração SIGEP WEB deve estar marcada.

Ao habilitar o módulo, no parâmetro 24.Integração, será habilitada a aba SIGEP WEB.

URL Padrão: Responsável por acessar os principais serviços dos Correios, como consulta de CEP, pré lista de postagem, entre outros. URL disponibilizada pelos Correios.

URL Custos e Preços: Esta URL permite utilizar o serviço de cotação de frete dos Correios.

1.3 e 1.4 Usuário e Senha: Criados no correio pelo usuário.

  • A DLL ONSIGEPWEB.dll deve estar presente na pasta onde encontra-se o executável do ONCLICK.

13.2 PERMISSÕES DE USUÁRIO

(Utilitários >> Perfil e Usuários >> Perfil >> Tela [0984] CADASTRO DE PERFIL >> Permissões >> Tela [0645] PERFIL – PERMISSÃO DE ACESSO)

No parâmetro 13.Expedição :

4.1: A permissão 4.1 define se o usuário pode vincular um serviço do SIGEP na transportadora e acessar o cadastro de faixas de etiquetas.

4.2: A permissão 4.2 define se o usuário tem permissão para acessar o cadastro de pré lista de postagem.

13.3 TRANSPORTADORA

(Cadastros >> Transportadoras >> Tela [0122] CADASTRO DE TRANSPORTADORAS)

Nesta tela, será necessário cadastrar as transportadoras, utilizando as modalidades de frete dos Correios, vincular o serviço do correio com o cadastro do ONCLICK, e posteriormente cadastrar faixas na transportadora.

1 – Cadastro Transportadora:

Na Tela [0122] CADASTRO DE TRANSPORTADORAS, cadastre uma transportadora para cada modalidade de envio dos Correios, por exemplo, um registro para Sedex, outro para PAC, outro para Sedex 10, etc.

 

2– Vincular os serviços dos Correios com o cadastro do ONCLICK:

O objetivo é buscar os serviços contratados e relacionar a transportadora com um dos serviços dos correios.

(Cadastros >> Transportadoras >> Tela [0122] CADASTRO DE TRANSPORTADORAS >> Alterar >> Tela [0161] ALTERAÇÃO DE TRANSPORTADORAS >> aba Etiquetas de Expedição)

Tipo Serviço: Define se a transportadora em questão será uma modalidade de entrega dos Correios, caso seja, neste campo deve estar selecionado um serviço dos Correios (SEDEX, SEDEX 10, PAC, SEDEX A COBRAR, etc). O campo de BUSCA ao final da Tela, só ficará habilitado se o tipo de serviço for relacionado aos Correios.

Agência: Agência / unidade dos Correios. Campo não obrigatório.

Código Cartão: Número do cartão do cliente associado à PLP. Deve possuir 10 dígitos, caso não possua, completar com zeros (0) à esquerda.

Código Adm: Código administrativo do contrato do cliente.

Diretoria Regional: Diretoria Regional do contrato do cliente. Será utilizado no fechamento da pré lista de postagem (PLP). Este campo é obrigatório.

Grupo SERVIÇO CONTRATADO (SIGEP): Contém os campos ID SERVIÇO, CÓDIGO SERVIÇO e DESCRIÇÃO. Junto a estes campos há o botão BUSCAR, que busca os serviços contratados pelo cliente para que seja feita a vinculação. Caso o usuário queira desfazer a vinculação poderá clicar no botão LIMPAR. O botão BUSCAR só ficará habilitado se no campo TIPO SERVIÇO estiver selecionado um tipo de serviço dos Correios.

Faixa Etiquetas de Postagem: Há uma barra de percentual de uso que considera a média de uso da faixa vigente com as demais que estejam pendentes considerando o total de números e o total já utilizado da faixa vigente.

(Cadastros >> Transportadoras >> Tela [0122] CADASTRO DE TRANSPORTADORAS >> Faixa Etiquetas >> Tela [1131] FAIXA DE ETIQUETAS DE POSTAGEM)

Esta tela guardará o número inicial, número final, último número utilizado, sigla e a transportadora que pertence aquela faixa. Esta tela muda se o cliente utilizar SIGEP ou não, se não usar será um cadastro básico onde será incluso de forma manual os campos de Nr Inicio, Nr Fim e Sigla, o campo último número utilizado será atualizado conforme o uso dos números na rotina de impressão de etiquetas. A alteração ou exclusão só será permitida se a faixa estiver com o STATUS como PENDENTE.

Com o módulo do SIGEP habilitado, a inclusão será de forma automática, ficará visível o botão SOLICITA ETIQUETA, nele será solicitado o número de etiquetas que terá a faixa, colocando o valor e confirmando é feita a inserção ficando como PENDENTE, já com o botão FINALIZAR FAIXA, se uma determinada faixa ainda não estiver finalizada esse botão forçará que ela fique com esse status e a mesma passará a não ser mais utilizada.

Entende-se como uma faixa finalizada o último número ser igual ao último número utilizado.

A faixa de etiqueta possui 3 status e as seguintes regras:

PENDENTE – quando o campo ULTIMO UTILIZADO está em branco ou igual a 0.

VIGENTE – campo ULTIMO UTILIZADO maior que zero e menor que campo NUMERO FINAL;

FINALIZADO – campo ULTIMO UTILIZADO maior que zero e igual ao campo NUMERO FINAL.

13.4 CADASTRO DE PRODUTOS

(Cadastros >> Produtos >> Produtos >> Tela [0293] CADASTRO DE PRODUTOS >> Incluir >> Tela [0324] INCLUSÃO DE PRODUTOS)

Para fazer a cotação e a impressão de etiquetas, é necessário escolher a embalagem, sendo assim, é preciso que um produto do tipo EMBALAGEM esteja cadastrado e, dependendo da opção selecionada no campo TIPO EMB SIGEP, os campos abaixo deverão ser preenchidos:

O campo TIPO EMB SIGEP tem os seguintes valores: ENVELOPE, PACOTE/CAIXA, ROLO/CILINDRO. Se selecionar ENVELOPE, os campos LARGURA E COMPRIMETO são obrigatórios. Se selecionar PACOTE, os campos ALTURA, LARGURA e COMPRIMENTO são obrigatórios. Se selecionar CILINDRO, os campos COMPRIMENTO e DIÂMETRO são obrigatórios.

Para qualquer opção selecionada, o campo PESO BRUTO é obrigatório.

Estas informações serão utilizadas na Tela de Cotação e na impressão de etiquetas.

Valores no cadastro de produto:

1 – Envelope (largura e comprimento);

2 – pacote/caixa (altura, largura e comprimento);

3 – cilindro (comprimento e diâmetro);

13.5 COTAÇÃO DE PREÇOS E PRAZOS DOS SERVIÇOS DOS CORREIOS

(Vendas >> Notas Fiscais >> Nota Fiscal >> Tela [0565] NOTA FISCAL >> Incluir/Alterar >> Tela [0566] MANUTENÇÃO DA NOTA FISCAL)

Através do botão SIGEP, será feita a cotação de frete do SIGEP. Essa tela será acessada pelo Pedido de Venda e Nota Fiscal de Venda.

Ao clicar neste botão, será aberta a Tela [1127] COTAÇÃO SIGEP, ao abrir a tela será carregado o CEP do cliente, onde a regra será primeiramente o CEP dos dados de entrega, depois dados do consumidor e por fim dados de faturamento. Deverá ser informada a EMBALAGEM que carregará todos os produtos que sejam do tipo EMBALAGEM e tenham valor no campo TIPO EMB SIGEP.

Após selecionar a embalagem e clicar no botão Pesquisar o sistema irá pegar todas as transportadoras que tenha vínculo com o serviço contratado do SIGEP, será pesquisado de acordo com o CEP Origem, CEP Destino, tipo de embalagem e medidas.

Os serviços que retornarem, seus valores e prazos serão apresentados na grid, os que derem algum erro, será apresentada uma mensagem na tela com descrição do serviço e motivo retornado pelos correios.

Após fazer a cotação e escolher uma transportadora, o sistema perguntará se deseja alterar a transportadora no Pedido ou Nota, se clicar em NÃO nada será alterado, se clicar em SIM será alterado o campo transportadora e o valor do frete será gravado no campo FRETE NEGOCIADO. Após responder SIM para a primeira pergunta será perguntado se deseja adicionar o valor ao frete do pedido ou nota, respondendo SIM será alterado o valor do frete recebendo o que foi retornado da cotação.

13.6 IMPRESSÃO DE ETIQUETAS

(Expedição >> Etiquetas de Expedição >> Etiqueta de Postagem nos Correios >> Tela [0711] ETIQUETAS DE POSTAGEM)

 

Nesta tela serão impressas as etiquetas de postagem. Há um modelo de etiqueta padrão para o SIGEP WEB, conforme descrito no manual do SIGEP.

Selecione a nota através dos filtros de pesquisa e a mova para a parte debaixo da Tela clicando na seta para baixo.

Campo Embalagem Padrão: Este campo tem o objetivo de facilitar a seleção em massa do tipo de embalagem. Ao selecionar este campo, todas as notas receberão a opção selecionada, porém o usuário poderá trocar o mesmo na grid.  Esse campo só ficará habilitado caso o módulo SIGEP esteja habilitado.

Coluna Embalagem na grid: Poderá vir carregado caso o campo EMBALAGEM PADRÃO esteja preenchido, esse campo poderá ser alterado diretamente na grid, o mesmo é obrigatório quando se usa SIGEP, caso não tenha o módulo o mesmo não ficará visível.

Serão exibidos os volumes da nota fiscal selecionada, selecione o volume e clique em Imprimir >> Etiquetas para Postagem (SIGEP).

Após a impressão, será preenchida a coluna NR CONHECIMENTO.

Após relacionar o tipo de embalagem para as notas e gerar o número de conhecimento, será possível gerar a PLP clicando no botão GERAR PLP.

Há tipos de impressão para o SIGEP, foi criado 3 opções de menu para impressão de etiqueta, Etiquetas para postagem – SIGEP, Etiquetas para postagem – SIGEP (térmica) e etiquetas para aviso de recebimento (AR Modelo Sigep). Essas opções só ficarão visíveis ao utilizar o módulo do SIGEP.

Gerar PLP: Esse botão só fica visível se o módulo SIGEP estiver habilitado e o botão só fica habilitado se tiver volumes selecionados.

Ao clicar no botão o sistema faz algumas validações, como: a transportadora destino deve ter vínculo com serviço do SIGEP, se não tiver, será apresentada a mensagem “TRANSPORTADORA INFORMADA NÃO POSSUI VÍNCULO COM O SIGEP. PROCESSO ABORTADO!”

Depois das validações serão gravados o cabeçalho e os itens da PLP. No cabeçalho serão gravados os campos:

ID – sequencial

Data Cadastro – Data atual

Status – Pendente

Descrição – Será gravada uma descrição padrão onde a mesma poderá ser alterada dentro da tela da PLP. A descrição ficará “PLP Nº 123 GERADA PELA ETIQUETA DE POSTAGEM”

Cartão Postagem – cartão cadastrado na transportadora.

Nos itens serão gravados os campos:

ID – mesmo do cabeçalho

Serie – da nota

NrNota – número da nota

Volume – número do volume

NrConhecimento – número do rastreio

Campos: peso, altura, largura, comprimento, diâmetro, recuperados do cadastro da embalagem selecionada em cada volume.

Status – NÃO POSTADO

Após feito o cadastro, será aberta a tela da PLP com o novo registro posicionado onde o usuário poderá Fechar a PLP ou realizar outro procedimento.

13.7 PRÉ LISTA DE POSTAGEM (PLP)

(Expedição >> Integração Sigep >> Pré Lista Postagem >> Tela [1128] PRÉ LISTA DE POSTAGEM – SIGEP)

A PLP, ou pré-lista de postagem, é um controle para indicar que o vendedor realizou a postagem da mercadoria numa agência dos Correios e que os Correios receberam o (s) pacote (s). É um arquivo com todas as encomendas enviadas para o Correio.

Ao criar uma PLP, a mesma é criada com o status PENDENTE. Quando a PLP é fechada, é gerado um ID e o status fica como INTEGRADO. Ao clicar no botão INATIVO, fica com o status INATIVO.

Quando uma PLP é atualizada, o status fica ATUALIZADO. A PLP é atualizada quando os Correios alteram alguma informação após a sua geração, assim os campos COD UNID POSTAGEM, NOME UNID POSTAGEM, VALOR GLOBAL são preenchidos.

Ao clicar em Incluir, deverá ser informada a descrição da PLP, e selecionado o código do cartão. As notas podem ser inclusas manualmente informando a série e o número da nota, ou clicar no botão Volumes, onde será aberta a Tela [1129] PROCURA VOLUMES, e poderão ser pesquisados todos os volumes por nota fiscal, período, cliente, etc. No momento de lançar é validado se a nota/volume existe e se o volume já não se encontra em outra PLP.

Pelo menos 1 volume deve ser informado. Após a gravação da PLP será habilitado o botão Fechar e seu status ficará como pendente

Após selecionar as notas/volumes, clique em Gravar, este botão grava a PLP, mas não a transmite. Para transmiti-la, deve-se clicar no botão FECHAR PLP.

Gravar: Grava a PLP atual. Após gravar a PLP a mesma pode ser alterada ou excluída enquanto não for fechada.

Inativar: Uma vez integrada, a PLP pode ser inativada, esse recurso deixa os itens da PLP disponíveis para serem lançados em outra PLP se for o caso, no correio não será feita nenhuma atualização. Quando uma PLP é inativada, a mesma fica inativa somente para o sistema ONCLICK. Já para correios, valerá a PLP que tiver o voucher acompanhando os volumes e caso não receba o voucher da PLP inativada, a mesma será expirada com o tempo.

Fechar PLP: Transmite a PLP para os Correios. Se clicar em Fechar PLP a mesma será transmitida aos correios enviando um XML contendo informações do remetente, destinatário, objetos de rastreio, etc, essa rotina retorna o ID gerado no correio, o mesmo é apresentado na grid. Após o processo é perguntado se deseja imprimir o voucher, se clicar em SIM será impresso, se não imprimir nesse momento, poderá ser feito depois através do botão Imprimir Voucher.   O status ficará como integrado e será habilitada a opção de atualizar PLP e Imprimir Voucher.

Atualizar PLP: Esse botão ficará habilitado quando a PLP estiver fechada, ao clicar nele será feita a comunicação com o Correio enviando o número da PLP, o retorno serão informações atualizadas tanto no cabeçalho, quanto nos itens:

Campos que sofrerão alteração após a atualização:

CABEÇALHO, CODIGOUNIDADEPOSTAGEM, NOMEUNIDADEPOSTAGEM, VALORGLOBAL, ITENS, CUBAGEM, PESO, ALTURA, LARGURA, COMPRIMENTO, DIAMETRO, DATAPOSTAGEM, STATUSPROCESSAMENTO, NUMEROCOMPROVANTEPOSTAGEM, VALORCOBRADO.

Imprimir Voucher: O voucher (lista de postagem) é um relatório que agrupa o quantitativo dos objetos da PLP transmitida aos Correios, devendo uma via acompanhar a carga física. Esse botão imprimirá a etiqueta com 2 vias onde uma fica com o cliente e a outra com os correios, essa etiqueta deve acompanhar a carga, ela contém um código de barra com o número da PLP e a quantidade de objetos por serviço também são listados.

Imprimir PLP: Imprime uma listagem com os volumes da PLP, e seus dados, como peso, nr rastreio, nota, transportadora, etc.

Fluxograma do módulo SIGEP WEB:

Botão Importação de Pedidos: O Integrador irá considerar o filtro Loja Web e Status. O campo Status é responsável por buscar pedidos de status específicos em lojas definidas no campo Loja Web.

Será realizado uma requisição pelo método “fWSImportaPedidos” passando as seguintes informações:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

data_inicial: enviado em branco.

data_final: enviado em branco.

hora_inicial: enviado em branco.

hora_final: enviado em branco.

Status_Atual: Status definido no filtro.

O retorno dessa requisição haverá os seguintes campos:

Id_Pedido: Número do pedido no site.

Pedido_Nfin: Campo não utilizado.

Frete: Descrição da transportadora no site. Esse campo deverá estar exatamente igual no ERP para que encontre a transportadora cadastrada.

Id_Cliente: Código de integração do cliente.

Id_Orcamento: Campo não utilizado.

Id_Site_Parceiro: Campo não utilizado.

Id_Local_Venda: Campo não utilizado.

Id_Usuario: Campo não utilizado.

Data_Pedido: Data da realização do pedido.

Hora_Pedido: Hora da realização do pedido.

Data_Envio: Campo não utilizado.

Hora_Envio: Campo não utilizado.

Ip_Origem: Campo não utilizado.

Total: Total do pedido.

Desconto: Desconto total do pedido.

Valor_Cupom: Valor do cupom de desconto caso utilizado.

Comissao: Campo não utilizado.

Valor_Frete: Valor do frete cobrado.

Frete_Pago: Campo não utilizado.

Cod_Rastreamento: Campo não utilizado.

Obs_Loja: Observação da loja em relação ao pedido.

Obs_Cliente: Observação do cliente em relação ao pedido.

Obs_Pagamento: Campo não utilizado.

Obs_Frete: Campo não utilizado.

Valor_Imposto: Valor do imposto a ser apresentado no pedido dentro do ERP.

Valor_Embalagem: Valor da embalagem a ser apresentada no pedido dentro do ERP.

Local_Venda: Local que foi realizada a venda.

Nro_Cupom: Número do cupom.

Parceiro: Parceiro que foi realizado o pedido.

Status: Status atual do pedido.

Será realizado uma requisição dos itens do pedido pelo método

“fWSImportaItensPedidoPorId” passando os seguintes campos.

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

Id_Pedido: Código do pedido no site.

No retorno dos itens haverá os seguintes campos:

Id_Pedido: Código do pedido no site.

Id_Produto: Código do produto pai no site.

Id_Grade: Código do Sku no site.

Id_Kit: Campo não utilizado.

Nome_Produto: Nome do produto no site.

Referencia: Campo não utilizado.

Id_Embalagem: Campo não utilizado.

Preco: Preço do produto vendido no site.

Custo: Custo do produto no site.

Comissao: Campo não utilizado.

Quantidade: Quantidade comprada daquele item.

Brinde: Campo não utilizado.

Status: Campo não utilizado.

Id_Lista: Código da lista de presente referente aquele item.

Será realizado uma requisição da forma de pagamento do pedido pelo método “fWSImportaParcelasPedidoPorId” passando os seguintes campos.

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

Id_Pedido: Código do pedido no site.

No retorno dos itens haverá os seguintes campos:

Id_Parcela: Código da parcela no site.

Id_Pedido: Código do pedido no site.

Forma_Pagamento: Descrição da forma de pagamento utilizada no site.

Data_Vencimento: Data de vencimento do pagamento.

Valor: Valor do pedido no site.

Data_Pagamento: Data do pagamento no site.

Data_Confirmacao: Data da confirmação do pagamento.

Valor_Pago: Valor pago do pedido.

Local_Pagamento: Local que o pagamento foi realizado.

Observacao: Observação da forma de pagamento.

Id_Forma_Pagamento: Código da forma de pagamento utilizada.

Qt_Parcelas: Quantidade de parcelas da forma de pagamento.

Status: Status da forma de pagamento.

Será realizado uma requisição de cliente do pedido pelo método “fWSImportaClientePorId” passando os seguintes campos.

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

Id_Cliente: Código do cliente no site.

No XML de retorno do cliente, haverá os seguintes campos:

Id_Pedido: Código de integração do pedido. Não utilizado para importação de clientes sem pedido.

Id_Cliente: Código de integração do cliente.

Pais: País do cliente.

Revenda: Razão social do cliente caso for do tipo física.

Tipo_Pessoa: Tipo de pessoa física ou jurídica.

Bloqueado: Define se o cliente está bloqueado ou não no site.

Cliente: Será preenchido como nome do cliente caso ele for pessoa física.

Cnpj_Cpf: CNPJ ou CPF do cliente.

Ie_Rg: Inscrição estadual da empresa ou RG do cliente.

Data_Nasc: Data de nascimento do cliente.

Data_Cadastro: Data de cadastro do cliente.

Email: E-mail de cadastro do cliente.

Observacao: Observação do cliente para o lojista.

Logradouro: Endereço do cliente.

Numero: Número do endereço do cliente.

Bairro: Bairro do cliente.

Complemento: Complemento do cliente.

Cep: CEP de endereço do cliente.

Cidade: Cidade do cliente.

Uf: Estado do cliente.

Telefone: Telefone residencial do cliente.

Fax: Fax do cliente.

Celular: Celular do cliente.

Sexo: Sexo do cliente.

Status: Status do cadastro do cliente.

Apelido: Apelido do cliente.

12.3.6 Atualização de Status

Botão Enviar Status do Pedido: O Integrador irá considerar o filtro informado, ou caso não tenha filtro informado será considerada a data da última atualização até a hora atual.

A atualização de Status é realizada para pedidos e notas alteradas no período informado no filtro. Para que o status do Pedido seja enviado o Tipo de pedido deve estar devidamente configurado e atrelado a um Status web nas configurações do ERP conforme segue: Vendas >> Tabelas Diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE Pedido >> Status Web >> Tela [1109] CADASTRO DE STATUS WEB >> Aba Integração Web.

O XML de envio será informado no método “fWSAtualizaStatusPedidos” e haverá os seguintes campos:

Pedido: Número do pedido no site.

Id_Status: Código de integração do status de pedido fornecido pela Tray.

Data: Data de criação da nota fiscal.

Hora: Hora de criação da nota fiscal.

Serienota: Número de série da nota fiscal.

Numeronota: Número da nota fiscal.

Dataemissaonota: Data de criação da nota fiscal.

Horaemissaonota: Hora de criação da nota fiscal.

Objeto: Número de rastreio da encomenda.

Volume: Quantidade de itens para entrega

12.3.7 Exportação de Listas

Botão Enviar Lista de Desejos: o sistema irá considerar o filtro informado, caso não tenha filtro informado será considerado a data da última atualização até a hora atual. Também é possível enviar de uma loja web em específico informando a loja web no filtro.

O cabeçalho da lista será enviado pelo método “fWSCadastraListaDesejos” e os seguintes campos serão informados.

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

Dados_Lista: Array de Lista de presente.

Os itens da lista de presente serão enviados pelo método “fWSCadastraListaProdutos” e será preenchido os seguintes campos.

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

dados_lista: Array de itens da lista.

Cabeçalho da Lista de Pedidos:

ID: Código de integração da lista no site.

ID_Cliente: Código de integração do cliente no site.

ID_Eventos: Código de integração do evento no site.

Data: Data do evento que será realizado.

Data_Cadastro: Data de criação da lista no ERP.

Nome: Descrição da lista de desejo.

Data_Finalizado: Data de finalização do evento.

Validade: Data de finalização do evento.

URL: URL da lista de presente para mais detalhes.

Recebimento: Recebimento VPV ou após o fechamento.

Mensagem: Mensagem a ser exibida na lista.

Envia_Email: Envia e-mail de agradecimento pela compra.

Status: Status da lista de presente.

Cartao: Envia cartão de agradecimento.

 

Itens da Lista de Pedidos:

ID: Código de integração do item da lista de presente.

ID_Lista: Código de integração da lista de presente.

ID_Produto: Código de integração do produto.

Quantidade: Quantidade desejada para aquele produto.

ID_Grade: Código de integração do produto filho.

Quantidade_Comprada: Quantidade já adquirida.

12.3.8 Importação de Listas

Botão Importação de Listas de Desejos: O sistema irá considerar o filtro de lojas web para buscar listas de desejo pendentes na lista de importação da plataforma.

O cabeçalho da lista de presente pendente para importação, é recebido pelo método “fWSImportaListasDesejo” e será preenchido os seguintes campos do método:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

id_lista: Enviado 0 para buscar todas as listas.

id_cliente: Código de integração do cliente, enviado 0 atualmente.

data_inicial: Data inicial do cadastro da lista. Enviado atualmente em branco.

data_final: Data final do cadastro da lista. Enviado atualmente em branco.

Os itens da lista de presente serão recebidos pelo método “fWSBuscaVendaListas” e será preenchido os seguintes campos:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

id_lista: Código de integração da lista de presente.

idCliente: Código de integração do cliente (não utilizado).

Cabeçalho da Lista de Pedidos:

Revenda: Nome da empresa ou revenda.

Cliente: Nome do cliente. Será considerado apenas se a revenda estiver em branco.

Cnpj_Cpf: CNPJ ou CPF do cliente.

ID_Eventos: Código de integração do evento. Caso não estiver cadastrado no ERP, será abortado a importação.

Ie_Rg: Inscrição estadual ou RG do cliente.

Cep: CEP do cliente.

Email: E-mail do cliente.

UF: Estado do cliente.

Data_Nasc: Data de nascimento do cliente.

Data_Cadastro: Data de cadastro do cliente.

Data: Data do evento.

Validade: Validade do evento.

Pais: País do cliente.

Observação: Observação do cliente.

Logradouro: Endereço do cliente.

Numero: Numero de endereço do cliente.

Bairro: Bairro do cliente.

Complemento: Complemento do cliente.

CEP: Cep do cliente.

Cidade: Cidade do cliente.

Celular: Celular do cliente.

Tipo_Pessoa: Pessoa do tipo física ou jurídica.

ID_Cliente: Código de integração do cliente.

Sexo: Sexo do cliente.

Email: E-mail do cliente.

ID: Código de integração da lista de presente.

Nome: Nome do cliente que será vinculado a lista de presente.

Status: Status da lista de presente.

Cartao: Envia cartão de agradecimento ou não.

URL: URL da lista de presente para mais detalhes.

Recebimento: Recebimento VPV ou após o fechamento.

Envia_Email: Envia e-mail para cada compra.

Mensagem: Mensagem da lista de presente.

Itens da Lista de Pedidos:

ID_Produto: Código de integração do produto pai.

ID_Grade: Código de integração do produto filho.

Id_Lista: Código de integração da lista de presente.

ID_Produto_Lista: Código de integração do produto na lista de presente.

Quantidade: Quantidade do item.

Quantidade_Comprada: Quantidade do item já adquirido.

12.3.9 Importação de Clientes

Botão Importar Clientes Sem Pedido: O sistema irá considerar o filtro de lojas web para buscar clientes que fizeram cadastro na loja, porém não finalizaram o pedido.

A importação do cliente será recebida pelo método “fWSImportaClientesSemDadosPedido” e será preenchido os seguintes campos do método:

pId_loja: ID da Loja (Tray).

pLogin: Login de Acesso ao WebService (Tray).

pSenha: Senha de acesso ao WebService (Tray).

data_inicial: enviado em branco.

data_final: enviado em branco.

hora_inicial: enviado em branco.

hora_final: enviado em branco.

No XML de retorno do cliente, haverá os seguintes campos:

Id_Pedido: Código de integração do pedido. Não utilizado para importação de clientes sem pedido.

Id_Cliente: Código de integração do cliente.

Pais: País do cliente.

Revenda: Razão social do cliente caso for do tipo física.

Tipo_Pessoa: Tipo de pessoa física ou jurídica.

Bloqueado: Define se o cliente está bloqueado ou não no site.

Cliente: Será preenchido como nome do cliente caso ele for pessoa física.

Cnpj_Cpf: CNPJ ou CPF do cliente.

Ie_Rg: Inscrição estadual da empresa ou RG do cliente.

Data_Nasc: Data de nascimento do cliente.

Data_Cadastro: Data de cadastro do cliente.

Email: E-mail de cadastro do cliente.

Observacao: Observação do cliente para o lojista.

Logradouro: Endereço do cliente.

Numero: Número do endereço do cliente.

Bairro: Bairro do cliente.

Complemento: Complemento do cliente.

Cep: CEP de endereço do cliente.

Cidade: Cidade do cliente.

Uf: Estado do cliente.

Telefone: Telefone residencial do cliente.

Fax: Fax do cliente.

Celular: Celular do cliente.

Sexo: Sexo do cliente.

Status: Status do cadastro do cliente.

Apelido: Apelido do cliente.

12.4 Integração VTEX

12.4.1 Login

Temos os seguintes campos na tela de login do Integrador Vtex:

Empresa: Empresa liberada pelo Terminal.

Usuario: Usuário do ERP.

Senha: Senha do ERP.

Filial: Filiais cadastradas/liberadas para esta empresa.

Loja Web: A demonstração das Lojas WEB é feita por filial, como o cadastro é feito por filial então o usuário precisa selecionar uma filial antes de escolher qual loja ele deseja enviar/receber dados.

12.4.2 Agendamento

Atualmente no Integrador VTEX é possível configurar rotinas automáticas para Importação de Pedidos, Atualização de Preço, Atualização de Estoque e Atualização de Status.

Tal configuração deve ser realizada no ERP acessando: (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> Aba Vtex)

Como é possível visualizar na imagem acima, temos informações das lojas web carregadas e quais foram seus últimos envios e quais serão os próximos envios. Hoje temos as seguintes informações sobre envios automático e manual no Integrador Vtex:

Exportações: São exibidas quais as exportações (envio) que o Integrador realiza.

Importações: São exibidas quais as importações (recebimentos) que o Integrador realiza.

Intervalo: Horas e Minutos configurados no cadastro de Lojas Web para que possa ser realizada a atualização automática das informações, caso não esteja configurada no ERP tal coluna ficará em branco.

Lembrando que a atualização automática ocorre apenas se o Integrador Vtex estiver em execução, se o mesmo estiver fechado, a atualização automática não será iniciada.

Última Atualização: Data e Horário que foi realizada a última ExportaçãoImportação do Processo.

Próxima Atualização: Data e Horário que a próxima ExportaçãoImportação será realizada, tal coluna estará preenchida apenas se no ERP estiver configurado a rotina para envio automático.

As seguintes informações são enviadas e recebidas pelo Integrador Vtex:

Estoque: Apresenta quando foi realizada a última atualização de estoque e caso esteja configurado a rotina automática, será exibida quando será realizada a próxima atualização de estoque pelo Integrador.

Preços: Apresenta quando foi realizada a última atualização de preço e caso esteja configurada a rotina automática, será exibida quando será realizada a próxima atualização de preço pelo Integrador.

Status de Pedido: Apresenta quando foi realizada a última atualização de Status do Pedido pelo Integrador e caso esteja configurado a rotina automática, será demonstrado quando será enviada a próxima atualização de Status pela Integrador.

Cadastro de Produtos: Apresenta quando foi realizado o último envio de produtos pelo Integrador, não há configuração para envio automático de produtos por isso não irá demonstrar quando a próxima atualização.

Pedido: Apresenta quando foi realizada a Importação do(s) pedidos e caso esteja configurada a rotina automática, será demonstrado quando será realizada a próxima baixa do(s) pedido(s) pelo Integrador.

12.4.3 Exportação de Produtos

Tal função permite o envio de Produtos, Preços, Estoque, e Níveis de Categoria cadastros no ERP para a Plataforma.

Hoje temos os seguintes parâmetros para Exportação de Produtos:

Período De..Até: Período em que compreenderá a Data de Cadastro ou Alteração, de Clientes ou Vendedores, para Exportação do sistema Onclick para a plataforma. Caso o campo esteja em branco será utilizada a data e hora do último envio.

Cód Produto/Barra/Fabricante/Auxiliar: Pode ser selecionado no combo o que o usuário deseja que considere no filtro, Código de Produto, Barra, Fabricante ou Auxiliar, quando informado um valor no campo, nenhum outro filtro é considerado, todos os outros campos de filtro desabilitam e limpam as informações (caso tenha).

Categoria: Níveis cadastrados no ERP para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro.

Marca: Marcas cadastradas no ERP liberadas para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro.

Característica: Características cadastradas no ERP liberadas para a loja WEB selecionada. Cas seja selecionado “Todos” não irá considerar o filtro.

Botão Enviar Produtos:

Categoria: Envia todos os níveis de categorias cadastrados no ERP para a plataforma, neste processo montamos a arvore de nível de categoria para envio de todos. Caso no envio da categoria dê algum erro, nenhum outro processo é executado. Buscamos pelo método “CategoryGet” se a categoria já está cadastrada na plataforma, caso já esteja buscamos alguns dados que não enviamos como: “Description, Keywords e IsActive”, que o usuário pode informar na plataforma. Para enviar uma nova categoria ou atualização desta categoria é feito pelo método “CategoryInsertUpdate”, enviamos as seguintes informações:

ID: Código da categoria (ERP).

Name: Descrição da Categoria (Cabeçalho).

FatherCategoryId: Código da categoria PAI.

Marca: Envia a(s) marca(s) do(s) produto(s), caso a marca já exista na plataforma, não enviamos novamente. O método de envio é o “BrandInsertUpdate”, enviamos as seguintes informações:

Id: Código da Marca (Fabricante) no ERP.

Name_: Descrição da Marca.

IsActive: Envia “True” sempre (dizendo que a marca está ativa).

Produto: Envia os Produtos cadastrados no ERP com liberação para a Loja WEB selecionada, considerando os filtros inseridos pelo usuário, nesta operação só serão enviados Produtos Pai e Produtos Acabados para vinculação entre ERP x Plataforma. Primeiro buscamos informações se o produto já existe na plataforma, o método de envio é o “ProductInsertUpdate”, enviamos as seguintes informações:

Id: Código de Referência do Produto (Site Codigo), caso não tenha Site Codigo é enviado o CODPROD (para caso de cadastro de produto).

Name_: Descrição do Produto no site (aba “Integração Web” do cadastro de produto).

DepartmentId: Código do Nível de Categoria do Produto (Código do Nível Pai).

CategoryId: Código do Nível de Categoria do Produto (Código do Nível Filho).

BrandId: Código da Marca do Produto (caso não tenha Site Código o Fabricante, é enviado o código do ERP do fabricante).

LinkId: Há duas informações que podem ser enviadas neste campo, se a informação “Site Desc. URL” estiver preenchida é enviada ela, se não estiver preenchida é a informação “Site Descricao” (a mesma enviada na tag “Name_”).

RefId: Código de Referência do Produto no ERP (Código do Produto ou Fabricante ou Barras ou Auxiliar).

ReleaseDate: Data de Lançamento do Produto (Data de validade, só é enviado o campo caso tenha informado).

IsVisible: Campo para definir se o produto é visível ou não, enviamos sempre “Verdadeiro” (True).

Description: Descrição Longa do produto.

DescriptionShort: Descrição Curta do produto.

Keywords: Palavras-Chaves do Produto (MetaKeyWord, na aba “Integração Web” do cadastro de produto).

MetaTagDescription: Descrição Longa do Produto, só é enviado uma vez, se já estiver na plataforma, é utilizada a mesma informação da plataforma.

Title: Descrição do Produto, só é enviado uma vez, se já estiver na plataforma o produto, é utilizada a mesma informação da plataforma.

IsActive: Se o produto está ativo ou não, consideramos se o produto está inativo ou com venda suspensa no ERP.

SKU: Envia o(s) produto(s) filhos para a plataforma, como na VTEX é obrigatório ter um SKU, se o produto que estivermos enviando for um produto único então criamos uma SKU a partir dele, o SKU é o envio completo do produto no caso, pois enviamos Preço, Estoque, Característica do(s) produto(s), inclusive o envio da característica é feito por uma DLL feita em C# (VtexProdCaract.dll). Para o envio de estoque temos um delay que aguardamos o produto ser cadastrado na plataforma, esse delay varia de 1s a 3 minutos e 20s (tempo máximo que aguardamos). Como no envio do produto, verificamos se o SKU está cadastrado na plataforma pelo método “StockKeepingUnitGet”, se o produto estiver com o Site Código preenchido no ERP, mais por algum motivo não existir mais na plataforma, não enviamos este produto. O método de envio é “StockKeepingUnitInsertUpdate”, enviamos as seguintes informações:

ProductId: Código de Referência do Produto Pai (Site Código ou CodProd, pois se for primeiro envio não estará preenchido ainda o Site Código. Detalhe: apenas se for produto(s) filho(s) que este campo será enviado).

Id: Código de Referência do Produto (Site Código ou CodProd).

IsKit: Informa se a SKU é do tipo KIT, na plataforma da VTEX não trabalhaamos com produto do tipo KIT (na plataforma, dentro do ERP trabalhamos), então é sempre enviado como “Falso” (False).

Name_: Descrição do Produto no site (Aba “Integração Web” do cadastro de Produto).

RefId: Código de Referência do Produto (Código do Produto, Barras, Fabricante ou Auxiliar).

StockKeepingUnitEans: Lista de Código de barras (EAN13) do ERP, enviamos apenas o Código de barras do produto (pode-se cadastrar mais de um na plataforma).

ListPrice: Valor do Produto na tabela de preço.

Price: Valor de Promoção do Produto na tabela de preço, caso a Data Inicial e Final tenha sido ultrapassada da data atual, enviamos o Valor unitário do Produto (Mesma informação do campo ListPrice).

Height: Altura do Produto cadastrado no ERP.

Length: Comprimento do Produto cadastrado no ERP.

Width: Largura do Produto cadastrado no ERP.

WeightKg: Peso Bruto do produto cadastrado no ERP (Em Gramas, não calculamos nada).

CubicWeight: Peso Cúbico do Produto.

IsAvaiable: Produto Disponível na plataforma (Enviamos sempre como “Ativo” (True).

IsActive: Produto Ativo na plataforma (Verificamos se o produto está inativo ou com venda suspensa no ERP para desativar na plataforma).

ModalId: Modalidade de Frete, enviamos fixo “1”. (1-Leve, 2-Pesado, 3-Refrigerado, 4-Químico).

Botão Enviar Preço: O Integrador considerará os filtros informados, caso nenhum filtro seja informado será considerado a data da última atualização até o momento considerando o(s) produto(s) alterado(s).

O preço a ser enviado é o configurado na tabela de preço do Cadastro de Lojas Web, conforme segue:

(Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> Aba Geral >> 6.Tabela de Preço)

Caso não tenha configurado no cadastro da loja web é enviado da tabela padrão do sistema. O método de envio é “StockKeepingUnitPriceUpdate”, enviamos as seguintes informações:

stockKeepintUnitId: Código de Referência do produto no site (Site Código).

listPrice: Valor do Produto na tabela de Preço.

price: Valor de Promoção da tabela de Preço.

costPrice: Valor do Produto na tabela de Preço (Caso o produto não tenha valor de custo é enviado o valor de “1”).

Botão Enviar Estoque: O Integrador considerará os filtros informados, caso nenhum filtro seja informado será considerada a data da última atualização até o momento considerando o(s) produto(s) alterado(s) e enviando-os para a plataforma.

No envio do estoque o Integrador irá buscar a qual estoque o produto está liberado na VTEX e para todos estes estoques irá enviar a mesma informação. O método de envio é o “WareHouseIStockableUpdateV3”, enviamos as seguintes informações:

wareHouseId: ID do estoque na VTEX.

itemId: Código de Referência do produto no site (Site Codigo).

availableQuantity: Estoque Atual do produto (entre os almoxarifados configurados, caso não selecione nenhum Almoxarifado é considerado todos os Almoxarifados disponíveis para venda. Caso não exista “Múltiplos-Almoxarifados” liberados para a base, é considerado o valor do estoque da tabela de produto. Pode-se enviar o Est. Segurança ou não, existe uma configuração para isso, conforme segue:

(Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> 2.9 Enviar Estoque de Segurança para Loja Web)

dateOfAvailability: Data de quando o estoque enviado terá efeito, enviamos a DataHora atual.

Botão Enviar Categorias: Serão enviados todos os níveis de categorias cadastrados no ERP para a plataforma, neste processo montamos a arvore de nível de categoria para envio de todos. Buscamos pelo método “CategoryGet” se a categoria já está cadastrada na plataforma, caso já esteja buscamos alguns dados que não enviamos como: “Description, Keywords e IsActive”, que o usuário pode informar na plataforma. Para enviar uma nova categoria ou atualização desta categoria utiliza-se o método “CategoryInsertUpdate”, enviamos as seguintes informações:

ID: Código da categoria (ERP).

Name_: Descrição da Categoria (Cabeçalho).

FatherCategoryId: Código da categoria PAI

12.4.4 Importação de Pedidos

 

Botão Importação de Pedidos: O Integrador considerará primeiramente o filtro informado “Pedido” na qual o usuário pode baixar individualmente um pedido específico da VTEX, caso esteja informado 0 o sistema irá baixar todos os pedidos com status “CAP” (Pagamento Aprovado [Checkout v1] ou Pronto para Manuseio [SmartCheckout]). Na baixa de pedidos da plataforma da VTEX não é atualizado o cabeçalho do pedido (caso ele já tenha sido processado pelo ERP, pelo fato de baixarmos apenas pedidos já aprovados da plataforma). Fazemos a baixa dos pedidos por dois métodos o “OrderGet” (Baixamos um pedido especifico, nos retornando um OrderDTO então transformamos para um ArrayOfOrderDTO) ou pelo método “OrderGetByStatus” (Baixando todos os status “CAP”, que nos retorna um ArrayOfOrderDTO), logo após isso iremos processar o ArrayOfOrderDTO. Um ArrayOfOrderDTO são vários pedidos agrupados em um array, cada posição é um OrderDTO que representa um pedido, abaixo uma listagem dos campos presentes:

ID: Número do Pedido na plataforma.

ClientId: ID do Cliente na Plataforma (Este campo não vem na SmartCheckout).

IsGiftList: Pedido é uma Lista de Presente.

GiftListStockKeepingUnits: Skus de uma lista de presente.

PurchaseDate: Data da Compra.

Client: Um ClientDTO (abaixo do pedido estará a listagem do ClientDTO).

Address: Um AddressDTO (abaixo do pedido estará a listagem do AddressDTO).

OrderDeliveries: Uma lista de OrderDeliveryDTO (abaixo do pedido estará a listagem do OrderDeliveryDTO). Um pedido pode ser divido em uma ou mais entregas dependendo do tipo do produto (pesado, leve, refrigerado, químico) Ex.: Um pedido é composto de uma adega e um vinho. A adega pode ser enviada por uma transportadora diferente da do vinho e também com prazos diferentes.

AffiliateId: Id do afiliado (MarketPlaces, é um De/Para da VTEX, por exemplo, quando a compra é realizada pelo Extra vem a descrição no campo “NVP” que é a Nova Ponto Com, quando vem do Submarino vem “B2W”), utilizamos este campo como forma de pagamento dentro do ERP, pois não vem do MarketPlaces a forma de pagamento do usuário.

OrderPayments: Uma lista de OrderPaymentDTO (abaixo do pedido estará a listagem do OrderPaymentDTO). É uma lista das formas de pagamento.

Na listagem de clientes (ClientDTO) existem os seguintes campos sendo utilizados:

DateBirth: Data de Nascimento.

CreateDate: Data de cadastro na plataforma.

FirstName: Primeiro Nome.

LastName: Último Nome.

NickName: Apelido.

Email: E-mail.

Password: Senha de Acesso (Plataforma).

CpfCnpj: CPF ou CNPJ.

Phone: Telefone Residencial.

CelPhone: Telefone Celular.

OfficePhone: Telefone Comercial.

IsActive: Cliente Ativo.

CompanyName: Razão Social.

Gender: Sexo.

IsNewsReceiver: Recebe newsletter.

IsSMSNewsReceiver: Recebe SMS News.

StateInscription: Inscrição estadual.

Na listagem de Endereços (AddressDTO) existem os seguintes campos sendo utilizados:

Id: Id do endereço da compra.

ReceiverName: Nome do Destinatário.

Street: Rua (Endereço).

Country: País.

State: Estado.

City: Cidade.

NumberV3: Número do endereço (utilizado apenas no SmartCheckout por se tratar de um tipo string).

Number: Número do endereço (utilizado apenas no checkout v1 por se tratar de um tipo inteiro).

More: Complemento.

ReferencePoint: Ponto de Referênia.

Neighborhood: Bairro.

ZipCode: CEP.

OfficePhone: Telefone Comercial.

Na listagem de Endereços de Entrega dos Itens (OrderDeliveryDTO), existem os seguintes campos sendo utilizados:

ScheduledDate: Data de Agendamento da Entrega.

ScheduledShift: Horário de Entrega (Manhã, Tarde, Noite).

DateExpectedDelivery: Data Prevista para Entrega.

DeliveryDate: Data de Entrega.

Id: ID da compra de Entrega.

OrderId: ID do Pedido na Plataforma.

FreightId: ID do Frete (Integer), caso esteja vazio consideramos o FreightIDv3.

FreightIdV3: Id do Frete (String).

OrderStatus: É uma OrderStatusDTO, situação (STATUS) do pedido, aqui só utilizamos a informação “Description” que é a descrição do status na plataforma (Crédito Aprovado).

OrderItems: Uma lista de OrderItemDTO (abaixo dos endereços de entrega estará a listagem do OrderItemDTO), são os itens do pedido (para entrega separada, como no ERP não trabalhamos dessa forma, colocamos todos os itens em um único pedido).

Na listagem de Itens dos Pedidos (OrderItemDTO) existem os seguintes campos sendo utilizados:

ShippingCostOff: Valor de Frete com Desconto.

Cost: Preço do Produto na plataforma.

CupomValue: Valor do cupom para o produto.

CupomValueOff: Valor do Produto subtraído do cupom com desconto.

IsGift: Informa se o produto é um Brinde ou não.

IsKit: Informa se o SKU é um kit na plataforma (caso for, não processamos ele pois já vem os itens no pedido).

ItemId: Id do sku vendido. Não existe campo relativo à quantidade, cada item pode ter serviços específicos. Código de Referência do Produto (Site Codigo).

Id: ID do item do pedido.

OrderItemServices: Serviços do item (SKU), uma listagem de OrderItemServiceDTO, que será descrito abaixo dos itens dos pedidos.

Detalhe a ser notado no “OrderItemDTO” é o campo “ItemID”, caso o pedido for de uma lista de presente que o dono da lista configurou que deseja receber como crédito essa lista, o produto a ser baixado/faturado na nota será o configurado no Cadastro de Lojas WEB

(Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS WEB >> Aba Vtex >> 3.Código de Barras para Itens da Lista de Presentes).

Na listagem de Serviços dos Produtos (OrderItemServiceDTO) existem os seguintes campos sendo utilizados:

StockKeepingUnitService: Obter as informações sobre um determinado serviço de um sku. (Abaixo de Serviços dos Produtos terá a listagem). Como um produto pode ter vários serviços então ele é “desmembrado” em um novo array.

GiftCardMessage: Mensagem que irá no Presente (embalagem).

Na listagem de Serviço do Produto (StockKeepingUnitService) existem os seguintes campos sendo utilizados:

ServicePrice: Preço do Serviço, é uma listagem de ServicePriceDTO (abaixo de Serviço do produto terá a listagem).

Na listagem de Preço do Serviço (ServicePriceDTO) existem os seguintes campos sendo utilizados:

Service: Detalhes do Serviço, é uma listagem do ServiceDTO (abaixo de Preço do Serviço terá a listagem).

Price: Valor do Serviço (irá para o valor da Embalagem).

Na listagem de Detalhes do Serviço (ServiceDTO) existem os seguintes campos sendo utilizados:

Name: Nome do serviço, verificamos se há algo descrito como “Presente” para considerar.

Na listagem de Formas de Pagamentos (OrderPaymentDTO) existem os seguintes campos sendo utilizados:

PaymentId: ID da forma de pagamento (Campo Código Internet do Cartão, caso não encontre informaremos no campo “FORMAPAGTO” do cabeçalho do pedido a informação que veio na VTEX).

OrderId: ID do Pedido (Na Plataforma).

Plots: Quantidade de Parcelas.

CostWithInterest: Valor da Parcela com Juros.

GiftCardId: ID do Vale Presente.

Quando é feito a baixa do pedido, e o pedido conseguiu ser processado pelo Integrador para envia-lo para o ERP, atualizamos o status do pedido para “ERP” dessa forma o Integrador não irá baixar novamente este pedido e conseguirá seguir novamente o fluxo de status de pedido na VTEX, pois na VTEX é necessário seguir este fluxo (mais informações sobre o fluxo de pedido em: http://vtex.com.br/help/fluxo-do-pedido/ ).

12.4.5 Atualização de Status

Botão Enviar Status do Pedido: O Integrador considerará o filtro informado, ou caso não tenha filtro informado será considerada a data da última atualização até a hora atual. A atualização de Status é realizada para pedidos e notas alteradas dentro do período informado nos filtros de datas. Para que o status do Pedido seja enviado, o Tipo de pedido deve estar devidamente configurado e atrelado a um Status Web nas configurações do ERP conforme segue: (Vendas >> Tabelas Diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE PEDIDO >> Status Web >> Tela[1109] CADASTRO DE STATUS WEB >> Aba Integração Web).

Háos seguintes campos sendo utilizados para a atualização de status:

Courier: Transportadora (Enviamos o nome Fantasia da Transportadora da Nota).

InvoiceNumber: Número da Nota Fiscal.

TrackingNumber: Código de Rastreio.

InvoiceValue: Valor da Nota Fiscal.

IssuanceDate: Data de Emissão da Nota.

OrderId: Número do pedido na plataforma (Pedido Internet).

StockKeepingUnits: SKUs da nota Fiscal.

Na listagem de Itens Faturados na Nota Fiscal existem os seguintes campos sendo utilizados:

StockKeepingUnitId: ID do SKU (Código de Referência do Produto, Site Código).

Quantity: Quantidade do Produto faturado na Nota.

Price: Preço do Produto na nota Fiscal (VRTOTITEM).

Para a atualização de status quando o Pedido ainda não está faturado, consideramos o Tipo do Pedido e pegamos da aba “Integração Web” do tipo de pedido a descrição internet informada para a loja que está sendo enviada. Existem os seguintes campos sendo utilizados:

idOrder: ID do pedido na plataforma.

statusOrder: Descrição do tipo do pedido na plataforma, é enviado do tipo “string”, por exemplo “CAP” que é quando o pedido é baixado para a plataforma. (Mais informações dos Status http://vtex.com.br/help/status-do-pedido/ ).

12.5 Integração IKEDA/RAKUTEN

12.5.1 Login

Temos os seguintes campos na tela de login do Integrador:

Empresa: Empresa liberada pelo Terminal.

Usuario: Usuário do ERP.

Senha: Senha do ERP.

Filial: Filiais cadastradas/liberadas para esta empresa.

Loja Web: A demonstração das Lojas WEB é feita por filial, como o cadastro é feito por filial então o usuário precisa selecionar uma filial antes de escolher qual loja ele deseja enviar/receber dados.

12.5.2 Agendamento

Atualmente no Integrador Ikeda é possível configurar rotinas automáticas para Importação de Pedidos, Atualização de Preço, Atualização de Estoque e Atualização de Status.

Tal configuração deve ser realizado no ERP acessando: (Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA >> Lojas Web >> Tela [0962] CADASTRO DE LOJAS Web >> Aba Parâmetros Comuns de Integração >> Aba Ikeda >> 1. Dados Gerais).

Como é possível visualizar na imagem acima, na grid de agendamento temos informações das lojas web carregadas e quais foram seus últimos envios e quais serão os próximos envios.

Exportações: Neste campo são exibidas quais as exportações (envio) que o Integrador realiza.

Importações: Neste campo são exibidas quais as importações (recebimentos) que o Integrador realiza.

Intervalo: Horas e Minutos configurados no cadastro de lojas web para que possa ser realizado a atualização automática das informações, caso não esteja configurado no ERP tal coluna ficará em branco.

Lembrando que a atualização automática ocorre apenas se o Integrador Ikeda estiver em execução, se o mesmo estiver fechado a atualização automática não será iniciada.

Última Atualização: Data e Horário que foi realizado a última Exportação/Importação do Processo pelo Integrador.

Próxima Atualização: Data e Horário que a próxima Exportação/Importação será realizada, tal coluna estará preenchida apenas se no ERP estiver configurada a rotina para envio automático.

As seguintes informações são enviadas e recebidas pela Integrador Ikeda:

Estoque: Apresenta quando foi realizada a última atualização de Estoque e caso esteja configurada a rotina automática, será exibido quando será realizada a próxima atualização pelo Integrador Ikeda.

Preços: Apresenta quando foi realizada a última atualização de Preço e caso esteja configurada a rotina automática, será exibido quando será realizada a próxima atualização pelo Integrador Ikeda.

Status de Pedido: Apresenta quando foi realizada a última atualização de Status do Pedido pelo Integrador Ikeda e caso esteja configurada a rotina automática, será exibida quando será enviada a próxima atualização de Status pelo Integrador.

Cadastro de Produtos: Apresenta quando foi realizado o último envio de produtos pelo Integrador Ikeda, não há configuração para envio automático de produtos, por isso não irá demonstrar quando será a próxima atualização.

Pedido: Apresenta quando foi realizada a Importação do(s) pedidos e caso esteja configurada a rotina automática, será demonstrado quando será realizado a próxima baixa do(s) pedido(s) pelo Integrador.

12.5.3 Exportação de Produtos

Tal função permite o envio de Produtos, Estoque, Preço e Níveis de Categoria cadastrados no ERP para a Plataforma.

Hoje temos os seguintes parâmetros para Exportação de Produtos:

Período De: Data Inicial de Cadastro ou Alteração de produtos para exportação para a plataforma. Caso o campo esteja em branco será considerada a data e hora do último envio.

Até: Data Final de Cadastro ou Alteração de produtos para exportação para a plataforma. Caso esteja em branco será considerado a data e hora atual do envio.

Cód Produto/Barra/Fabricante/Auxiliar: Pode ser selecionado no combo o que o usuário deseja que considere no filtro, Código de Produto, Barra, Fabricante ou Auxiliar, quando informado um valor no campo nenhum outro filtro é considerando, todos os outros campos de filtro desabilitam e limpam as informações (caso tenha).

Categoria: Níveis cadastrados no ERP para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro.

Marca: Marcas cadastradas no ERP liberadas para a Loja WEB selecionada. Caso seja selecionado “Todos” não irá considerar o filtro.

Característica: Características cadastradas no ERP liberadas para a loja WEB selecionada. Caso selecionado “Todos” não irá considerar o filtro.

Botão Enviar Produtos

Nível de Categoria: Envia o Nível de Categoria cadastradas no ERP para vinculação entre ERP x Plataforma:

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInternoCategoria: Código interno do nível de categoria no ERP.

NomeCategoria: Descrição do Nível de Categoria cadastrado no ERP.

CategoriaStatus: Status atual do nível de categoria, atualmente enviado 1 (ativo).

CategoriaPai: Código do nível de categoria pai.

 

Filtros: Para enviar filtros para a plataforma Ikeda, é necessário que a característica esteja vinculada pelo menos a um Produto Pai, e então no momento do envio ele será amarrado ao nível em que o produto pertence automaticamente:

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInternoFiltro: Código interno da característica.

CategoriasCodigoInterno: Array de string que é preenchida toda a árvore de níveis que aquele filtro está atrelado.

NomeFiltro: Nome utilizado no filtro.

DescricaoFiltro: Descrição detalhada do filtro, hoje enviado o mesmo valor do campo NomeFiltro.

Obrigatorio: Representa se o tipo de filtro sempre exige algum valor no produto. Atualmente enviamos fixo 2 (Não).

StatusFiltro: Representa o status da característica. Atualmente enviamos fixo 1 (Ativo).

Fabricante: Envia os fabricantes cadastrados no ERP, liberados para a loja web e que estão atrelados a algum produto.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInterno: É o código único no sistema (ERP) que representa o fabricante.

Nome: É o nome que representa o fabricante e o valor deve ser único entre todos fabricantes.

FabricanteStatus: É o status do fabricante, sendo que para Ativo (1), o fabricante é visível na loja e Inativo (2) visível somente no administrativo. Atualmente enviamos fixo 1 (Ativo).

Produto: Envia os Produtos cadastrados no ERP com liberação para a Loja WEB selecionada considerando os filtros inseridos pelo usuário, nesta operação só serão enviados Produtos Pai e Produtos Acabados para vinculação entre ERP x Plataforma. Abaixo os campos enviados.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInternoProduto: É o código único no sistema que representa o produto. É enviado o Código de Referencia configurado no cadastro de loja web.

CodigoInternoFornecedor: É preenchido o código interno do fabricante.

NomeProduto: É o nome que representa o produto. Descrição do produto (campo Descrição na aba Integração WEB no Cadastro de Produto).

TituloProduto: Aplicado em livrarias, representa o título dos livros. Caso o produto for novo, será enviado em branco.

SubtituloProduto: Aplicado em livrarias, representa o subtítulo dos livros. Caso o produto for novo, será enviado em branco.

DescricaoProduto: É um texto para realizar o detalhamento do produto (campo Descrição Longa na aba Integração WEB no Cadastro de Produto).

Texto1Produto: É um dos 10 campos disponíveis para serem utilizados para armazenar os valores customizados especificamente nos projetos. Nesse campo é enviado o campo Descrição HTML.

Texto2Produto até Texto10Produto: É um dos 10 campos disponíveis para serem utilizados para armazenar os valores customizados especificamente nos projetos.

Numero1Produto até Numero10Produto: É um dos 10 campos disponíveis para serem utilizados para armazenar os valores customizados especificamente nos projetos.

CodigoInternoEnquadramento: Valor alfanumérico que representa o código interno do enquadramento no ERP.

ModeloProduto: Valor alfanumérico que representa o modelo do produto. É enviado o código do fabricante.

PesoProduto: Valor decimal com duas casas decimais. Representa o peso do produto em kg. O separador deve ser um ponto (“.”). Caso o campo Peso Bruto no ERP não estiver preenchido, será enviado o Peso Liquido.

PesoEmbalagemProduto: Valor decimal, com duas casas decimais. Representa o peso do produto somado com o da embalagem em kg. O separador deve ser um ponto (“.”). Este é o peso considerado para cálculo de frete. Caso o campo Peso Bruto no ERP não estiver preenchido, será enviado o Peso Liquido.

AlturaProduto: Valor decimal, com duas casas decimais. Representa a altura do produto em cm. O separador deve ser um ponto (“.”). O campo Altura no cadastro de produto será considerado.

AlturaEmbalagemProduto: Valor decimal, com duas casas decimais. Representa a altura do produto embalado em cm. O separador deve ser um ponto (“.”). O campo Altura no cadastro de produto será considerado.

LarguraProduto: Valor decimal, com duas casas decimais. Representa a largura do produto em cm. O separador deve ser um ponto (“.”). O campo Largura no cadastro de produto será considerado.

LarguraEmbalagemProduto: Valor decimal, com duas casas decimais. Representa a largura do produto embalado em cm. O separador deve ser um ponto (“.”). O campo Largura no cadastro de produto será considerado.

ProfundidadeProduto: Valor decimal, com duas casas decimais. Representa a profundidade do produto em cm. O separador deve ser um ponto (“.”). O campo Comprimento no cadastro de produto será considerado.

ProfundidadeEmbalagemProduto: Valor decimal, com duas casas decimais a profundidade do produto embalado em cm. O separador deve ser um ponto (“.”). O campo Comprimento no cadastro de produto será considerado.

EntregaProduto: Valor inteiro. Representa o prazo adicional de entrega além do prazo do serviço de entrega. Será considerado o campo Dias para Entrega na aba Dados Gerais do cadastro de produto.

QuantidadeMaximaPorVenda: Valor numérico. É o número que representa a quantidade máxima que um consumidor pode comprar por pedido. O valor mínimo deve ser 1. Quando não há restrição, enviar número grande. Ex: 999. Será considerado o campo Máx Venda na aba Integração Web no cadastro de produto.

StatusProduto: Valor Numérico. É o status do produto, sendo que para 1, a categoria é visível na loja e 2 visível somente no administrativo. Será considerado o campo Produto Disponível na aba Integração Web no cadastro de produto.

TipoProduto: Valor Numérico. É o tipo do produto, sendo que os produtos comuns devem receber 1, 2 para Brinde e 3 para Produto Grátis. Brinde e Produto Grátis não são comercializados individualmente. Eles são possíveis de ser associados a uma promoção. A diferença entre o Brinde e Produto Grátis é somente o texto que aparece no carrinho de compras. Será considerado o campo GRUPO3 na aba Dados Gerais no cadastro de produto, caso ficar em branco, será enviado como produto comum.

Presente: Valor Numérico. É o valor que representa se o produto pode ser embalado para presente ou não. 1 para sim e 2 para quando não pode ser embalado. Atualmente enviado fixo 1 (Sim).

PrecoCheioProduto: Valor decimal que representa o preço cheio do produto. Será considerado o campo Preço de Venda na aba Custos e Preços no cadastro de produto.

PrecoPor: Valor decimal que representa o preço comercializado na loja. As promoções por exemplo, são aplicadas sobre este preço. Este preço deve ser sempre igual ou menor que o Preço Cheio. Será considerado o campo valor de promoção na aba Custos e Preços no cadastro de produto. Caso estiver em branco ou a promoção não estiver com data, será enviado o campo Preço de Venda.

PersonalizacaoExtra: Valor Numérico. Indica se o produto possui personalização. Atualmente enviado fixo 1 (Sim).

PersonalizacaoLabel: Valor alfanumérico. Representa o nome da personalização. Atualmente enviado fixo 1 (Sim).

ISBN: Valor alfanumérico. Aplicado mais para livrarias, representa o ISBN 10 ou ISBN 13 dos livros, sem traços. Será considerado o campo Código ISBN na aba Integração Web no cadastro de produto.

EAN13: Valor alfanumérico. Representa do EAN 13 das mercadorias, sem traços. Será considerado o campo Código de Barras do produto.

YouTubeCode: Valor alfanumérico. É o código que representa o vídeo no Youtube. Atualmente enviado fixo em branco.

Produto X Categoria: Rotina que vincula o produto com a categoria cadastrada anteriormente.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInternoProduto: Valor alfanumérico. É o código único no sistema que representa o produto. É enviado o Código de Referencia configurado no cadastro de loja web.

CodigoInternoCategoria: Valor alfanumérico. É o código único no sistema que representa a categoria. Será enviado o código interno do nível de categoria. Caso o produto está vinculado ao nível de categoria menor, será enviado do menor para o maior, ou seja “subindo” os níveis até chegar no pai.

SKU: Caso o produto possua SKUs, será enviado logo em seguida os produtos vinculados a ele.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInternoProdutoPai: Valor alfanumérico. É o código único no sistema que representa o produto pai vinculado ao produto filho a ser cadastrado. É enviado o Código de Referencia configurado no cadastro de loja web.

PartNumber: Valor alfanumérico. É o código único no sistema que representa o produto filho no sistema. Não deve conter caracteres especiais. É enviado o Código de Referencia configurado no cadastro de loja web.

PrecoPor: Valor decimal. É o valor que representa o preço do produto filho. Deve ser necessariamente um preço igual ou menor ao produto pai. Será considerado o campo valor de promoção na aba Custos e Preços no cadastro de produto. Caso estiver em branco ou a promoção não estiver com data, será enviado o campo Preço de Venda.

sku1 até sku5: Campo destinado as características do produto. No máximo é possível vincular 5 por Sku. Caso ultrapassar esse limite, o integrador preencherá com os cinco primeiros.

StatusSKU: Valor numérico. É o valor que representa se o produto está ativou ou inativo no sistema. Quando está inativo, não é visível na loja virtual, mas é visível no administrativo. Será considerado o campo Produto Disponível na aba Integração Web.

Envio de Estoque: Caso um produto não possua Skus, o estoque será enviado com o código do produto único. Caso possuir SKUs, será enviado o estoque de cada filho.

Estes mesmos campos serão enviados ao clicar no botão ATUALIZAR ESTOQUE no integrador.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoProdutoInterno: Valor alfanumérico. É o código único no sistema (ERP) que representa o produto.

PartNumber: Valor alfanumérico. Será preenchido apenas se for um produto filho, que será enviado o código de referência.

QtdEstoque: Valor alfanumérico. Quantidade do produto em estoque.

QtdMinima: Quantidade mínima do produto em estoque (é bloqueada a compra do item cujo estoque tenha atingido a quantidade mínima especificada). Será considerado o campo Est. Mínimo na aba Integração Web.

TipoAlteracao: Tipo da Alteração do Estoque. Hoje é enviado fixo 3.

Vincular Produto X Filtro: Responsável pela vinculação do produto pai com filtros criados anteriormente.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInternoFiltro: Valor alfanumérico. Representa o código do filtro no ERP. Será enviado Código interno da característica.

CodigoInternoProduto: Valor alfanumérico. Representa o código do produto no ERP. Será enviado o código de referência configurado no cadastro de loja web.

ValorFiltroProduto: Valor alfanumérico. Representa o valor do filtro. Será enviado o valor vinculado a característica.

StatusFiltroProduto: Valor numérico. Representa o status da característica. Atualmente será enviado fixo 1 (Ativo).

Botão Enviar Preço e Estoque: O Integrador considerará os filtros informados, caso nenhum filtro seja informado será considerada a data da última atualização até o momento, considerando o(s) produto(s) alterado(s) e enviando para a plataforma.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoInternoProduto: Valor alfanumérico. Representa o código do produto no ERP. Será enviado o código de referência configurado no cadastro de loja web.

PrecoCheio: Valor decimal que representa o preço cheio do produto. Será considerado o campo Preço de Venda na aba Custos e Preços no cadastro de produto. Esse campo será preenchido apenas para produtos pais ou únicos.

PrecoPor: Valor decimal. É o valor que representa o preço do produto filho. Deve ser necessariamente um preço igual ou menor ao produto pai. Será considerado o campo valor de promoção na aba Custos e Preços no cadastro de produto. Caso estiver em branco ou a promoção não estiver com data, será enviado o campo Preço de Venda.

12.5.4 Importação de Pedidos

Botão Importação de Pedidos: O Integrador considerará qualquer tipo de pedido que não foi integrado para o ERP. No Integrador Ikeda só é possível baixar uma forma de pagamento. Caso o Pedido já exista no ERP será atualizado (se o pedido não for do tipo “Fixo”). A Estrutura do arquivo XML é a seguinte:

Cabeçalho do Pedido:

PedidoCodigo: Valor numérico. Código do pedido no e-Commerce, somente o lojista tem acesso.

PedidoStatus: Valor numérico que representa o status do pedido.

C:Usersmarcus.viniciusDesktopimg22.JPG

ListaTipoEntrega: Define como a lista será tratada dentro do ERP. Caso a lista for do tipo 1,2 ou 3 será gerado um pedido cópia automaticamente ao faturar o pedido original. A primeira nota gerada será enviada para o comprador do produto originário de uma lista. Esse segundo pedido também deverá ser faturado para que a nota fiscal vá para o dono da lista. Caso o pedido for de uma lista do tipo 4, não será criado um segundo pedido cópia pois os créditos serão usados futuramente pelo dono da lista.

Tipo da Entrega da Lista

CadaCompra = 1,

Semanalmente = 2,

Única = 3,

Creditos = 4

Pessoa: Enumerador que representa o tipo da conta.Pessoa Física (1) ou Pessoa Jurídica (2).

CPF: Valor alfanumérico que representa o CPF da pessoa física sem pontuação. Aplicável para Pessoa Física.

RG: Valor alfanumérico que representa o RG da pessoa física. Aplicável para Pessoa Física.

Nome: Valor alfanumérico que representa o nome do comprador. Aplicável para Pessoa Física.

SobreNome: Valor alfanumérico que representa o sobrenome do comprador. Aplicável para Pessoa Física.

CNPJ: Valor alfanumérico que representa o CNPJ da pessoa física sem pontuação. Aplicável para Pessoa Jurídica.

IE: Valor alfanumérico que representa a IE da pessoa jurídica. Aplicável para Pessoa Jurídica.

RazaoSocial: Valor alfanumérico que representa a razão social do cliente. Aplicável para Pessoa Jurídica.

Email: Valor alfanumérico que representa o e-mail do comprador.

Data: Valor alfanumérico que representa data do pedido, formato AAAA-MM-DD.

DataNascimento: Valor alfanumérico que representa a data de nascimento no formato AAAA-MM-DD, aplicável para Pessoa Física.

NomeDestinatario: Valor alfanumérico que representa o nome do destinatário do pedido.

Logradouro: Valor alfanumérico que representa o logradoudo do endereço de entrega.

Bairro: Valor alfanumérico que representa o Bairro do endereço de entrega.

Numero: Valor alfanumérico que representa o número do endereço de entrega.

Cidade: Valor alfanumérico que representa a Cidade do endereço de entrega.

CEP: Valor alfanumérico que representa o CEP do endereço de entrega sem o traço.

Complemento: Valor alfanumérico que representa o complemento do endereço de entrega.

Estado: Valor alfanumérico que representa o Estado do endereço de entrega.

DDD1: Valor alfanumérico que representa o DDD1 do endereço de entrega.

Telefone1: Valor alfanumérico que representa o Telefone1 do endereço de entrega.

DDD2: Valor alfanumérico que representa o DDD2 do endereço de entrega.

Telefone2: Valor alfanumérico que representa o Telefone2 do endereço de entrega.

DDDCelular: Valor alfanumérico que representa o DDD do celular do endereço de entrega.

Celular: Valor alfanumérico que representa o Celular do endereço de entrega.

DDDFax: Valor alfanumérico que representa o DDD do fax do endereço de entrega.

Fax: Valor alfanumérico que representa o Fax do endereço de entrega.

ServicoEntregaCodigo: Código do serviço de entrega no Ikeda. Esse código é responsável por buscar a transportadora no ERP.

ValorTotal: Valor decimal, com duas casas decimais. Representa o valor Total do Pedido.

(ValorSubTotal + ValorJuros + ValorFrete + ValorPresente – ValorDesconto).

ValorFreteCobrado: Valor decimal, com duas casas decimais. Representa o valor de frete que efetivamente foi cobrado.

ValorJuros: Valor decimal, com duas casas decimais. Representa o valor de juros do pedido.

ValorPresente: Valor decimal, com duas casas decimais. Representa o valor cobrado para embalagem de presente.

ValorVale: Valor decimal, com duas casas decimais. Representa o valor do vale utilizado no pedido.

ListaCodigo: Valor numérico. Representa do código da lista.

ParceiroCodigo: Código do parceiro. Esse código é responsável por buscar o funcionário ou indicador no ERP.

Observacao: Valor alfanumérico. Representa a observação do pedido.

FormaPgto: Valor numérico. Representa o código da forma de pagamento no e-Commerce.

C:Usersmarcus.viniciusDesktopimg23.JPG

CarOperadoraRetornoMensagem: Mensagem de retorno da operadora. Criptografado por padrão, caso precise do Vetor e da Chave para descriptografar, entrar em contato com o líder do produto.

CarAutorizacaoCodigo: Código de autorização da operadora, quando a transação é aprovada. Criptografado por padrão, caso precise do Vetor e da Chave para descriptografar, entrar em contato com o líder do produto.

Operadora: Valor numérico. Representa o código da operadora no e-Commerce.

Itens do Pedido (Array de Itens):

ItemValorFinal: Valor final do item. Valor Final do produto com Desconto aplicado.

ItemQtde: Quantidade comprada do item.

ItemPartNumber: Chave utilizada para descrever um produto e suas características. Será informada a referência configurada no cadastro de loja web.

CodigoInterno: Código Interno do Produto no ERP. Caso o campo ItemPartNumber estiver em branco, será considerado esse campo.

Presente: Indicador se o produto é para presente. Caso for presente, na tela de pedido será marcado na tabela de itens como presente.

ItemMsgPresente: Mensagem do presente.

ItemTipo: Identifica se o item está sendo pago com Vale Presente.

Tipo do Item

Produto = 1,

Brinde = 2,

ProdutoGratis = 3,

ValePresente = 4,

Personalizado = 5.

13.5.5 Atualização de Status

Botão Atualizar Status: o Integrador considerará o filtro informado, ou caso não tenha filtro informado será considerada a data da última atualização até a hora atual.

A atualização de Status é realizada para Pedidos e Notas alteradas no período informado no filtro. Para que o status do Pedido seja enviado, o Tipo de pedido deve estar devidamente configurado e atrelado a um Status Web nas configurações do ERP conforme segue: Vendas >> Tabelas Diversas >> Tipos de Pedido >> Tela [0756] CADASTRO DOS TIPOS DE PEDIDO >>Status Web >> Tela [1109] CADASTRO DE STATUS WEB >> Aba Integração Web.

LojaCodigo: É o código que representa o código da loja, quando o projeto opera no modo MultiLoja. Quando não opera, enviar zero. Atualmente enviamos fixo 0.

CodigoPedido: Valor numérico que representa o código do pedido no e-Commerce.

CodigoInternoPedido: Valor alfanumérico. Representa o código do pedido no ERP.

PedidoStatus: Valor numérico que representa o status do pedido. Será enviado o código de integração no cadastro de Tipo de Pedido.

StatusInternoPedido: Valor alfanumérico. Representa o código do status do pedido no ERP. Será enviada a descrição de integração no cadastro do Tipo de Pedido.

ObjetoSedex: Valor alfanumérico que representa o código do objeto sedex para rastreamento. Preenchido apenas após o pedido faturado.

NotaFiscal: Valor numérico. Representa o número da nota fiscal.

Serie: Valor alfanumérico. Representa a série da nota fiscal.

13 SIGEP WEB

O SIGEP WEB é um módulo do sistema com o propósito de preparar e gerenciar as postagens de Clientes dos Correios. Esse serviço engloba um conjunto de métodos que permitem automatizar a prestação de serviços dos Correios, como: SEDEX, Encomenda PAC, e-SEDEX entre outros.

13.1 MÓDULO E CONFIGURAÇÕES DO SISTEMA

(Utilitários >> Configurações >> Sistema >> Tela [0030] CONFIGURAÇÕES DO SISTEMA – CADASTRO DE EMPRESAS >> Alterar >> Tela [0444] CONFIGURAÇÕES DO SISTEMA)

Na opção 17. Módulos Habilitados, a opção 45. Integração SIGEP WEB deve estar marcada.

Ao habilitar o módulo, no parâmetro 24.Integração, será habilitada a aba SIGEP WEB.

URL Padrão: Responsável por acessar os principais serviços dos Correios, como consulta de CEP, pré lista de postagem, entre outros. URL disponibilizada pelos Correios.

URL Custos e Preços: Esta URL permite utilizar o serviço de cotação de frete dos Correios.

1.3 e 1.4 Usuário e Senha: Criados no correio pelo usuário.

  • A DLL ONSIGEPWEB.dll deve estar presente na pasta onde encontra-se o executável do ONCLICK.

13.2 PERMISSÕES DE USUÁRIO

(Utilitários >> Perfil e Usuários >> Perfil >> Tela [0984] CADASTRO DE PERFIL >> Permissões >> Tela [0645] PERFIL – PERMISSÃO DE ACESSO)

No parâmetro 13.Expedição :

4.1: A permissão 4.1 define se o usuário pode vincular um serviço do SIGEP na transportadora e acessar o cadastro de faixas de etiquetas.

4.2: A permissão 4.2 define se o usuário tem permissão para acessar o cadastro de pré lista de postagem.

13.3 TRANSPORTADORA

(Cadastros >> Transportadoras >> Tela [0122] CADASTRO DE TRANSPORTADORAS)

Nesta tela, será necessário cadastrar as transportadoras, utilizando as modalidades de frete dos Correios, vincular o serviço do correio com o cadastro do ONCLICK, e posteriormente cadastrar faixas na transportadora.

1 – Cadastro Transportadora:

Na Tela [0122] CADASTRO DE TRANSPORTADORAS, cadastre uma transportadora para cada modalidade de envio dos Correios, por exemplo, um registro para Sedex, outro para PAC, outro para Sedex 10, etc.

 

2– Vincular os serviços dos Correios com o cadastro do ONCLICK:

O objetivo é buscar os serviços contratados e relacionar a transportadora com um dos serviços dos correios.

(Cadastros >> Transportadoras >> Tela [0122] CADASTRO DE TRANSPORTADORAS >> Alterar >> Tela [0161] ALTERAÇÃO DE TRANSPORTADORAS >> aba Etiquetas de Expedição)

Tipo Serviço: Define se a transportadora em questão será uma modalidade de entrega dos Correios, caso seja, neste campo deve estar selecionado um serviço dos Correios (SEDEX, SEDEX 10, PAC, SEDEX A COBRAR, etc). O campo de BUSCA ao final da Tela, só ficará habilitado se o tipo de serviço for relacionado aos Correios.

Agência: Agência / unidade dos Correios. Campo não obrigatório.

Código Cartão: Número do cartão do cliente associado à PLP. Deve possuir 10 dígitos, caso não possua, completar com zeros (0) à esquerda.

Código Adm: Código administrativo do contrato do cliente.

Diretoria Regional: Diretoria Regional do contrato do cliente. Será utilizado no fechamento da pré lista de postagem (PLP). Este campo é obrigatório.

Grupo SERVIÇO CONTRATADO (SIGEP): Contém os campos ID SERVIÇO, CÓDIGO SERVIÇO e DESCRIÇÃO. Junto a estes campos há o botão BUSCAR, que busca os serviços contratados pelo cliente para que seja feita a vinculação. Caso o usuário queira desfazer a vinculação poderá clicar no botão LIMPAR. O botão BUSCAR só ficará habilitado se no campo TIPO SERVIÇO estiver selecionado um tipo de serviço dos Correios.

Faixa Etiquetas de Postagem: Há uma barra de percentual de uso que considera a média de uso da faixa vigente com as demais que estejam pendentes considerando o total de números e o total já utilizado da faixa vigente.

(Cadastros >> Transportadoras >> Tela [0122] CADASTRO DE TRANSPORTADORAS >> Faixa Etiquetas >> Tela [1131] FAIXA DE ETIQUETAS DE POSTAGEM)

Esta tela guardará o número inicial, número final, último número utilizado, sigla e a transportadora que pertence aquela faixa. Esta tela muda se o cliente utilizar SIGEP ou não, se não usar será um cadastro básico onde será incluso de forma manual os campos de Nr Inicio, Nr Fim e Sigla, o campo último número utilizado será atualizado conforme o uso dos números na rotina de impressão de etiquetas. A alteração ou exclusão só será permitida se a faixa estiver com o STATUS como PENDENTE.

Com o módulo do SIGEP habilitado, a inclusão será de forma automática, ficará visível o botão SOLICITA ETIQUETA, nele será solicitado o número de etiquetas que terá a faixa, colocando o valor e confirmando é feita a inserção ficando como PENDENTE, já com o botão FINALIZAR FAIXA, se uma determinada faixa ainda não estiver finalizada esse botão forçará que ela fique com esse status e a mesma passará a não ser mais utilizada.

Entende-se como uma faixa finalizada o último número ser igual ao último número utilizado.

A faixa de etiqueta possui 3 status e as seguintes regras:

PENDENTE – quando o campo ULTIMO UTILIZADO está em branco ou igual a 0.

VIGENTE – campo ULTIMO UTILIZADO maior que zero e menor que campo NUMERO FINAL;

FINALIZADO – campo ULTIMO UTILIZADO maior que zero e igual ao campo NUMERO FINAL.

13.4 CADASTRO DE PRODUTOS

(Cadastros >> Produtos >> Produtos >> Tela [0293] CADASTRO DE PRODUTOS >> Incluir >> Tela [0324] INCLUSÃO DE PRODUTOS)

Para fazer a cotação e a impressão de etiquetas, é necessário escolher a embalagem, sendo assim, é preciso que um produto do tipo EMBALAGEM esteja cadastrado e, dependendo da opção selecionada no campo TIPO EMB SIGEP, os campos abaixo deverão ser preenchidos:

O campo TIPO EMB SIGEP tem os seguintes valores: ENVELOPE, PACOTE/CAIXA, ROLO/CILINDRO. Se selecionar ENVELOPE, os campos LARGURA E COMPRIMETO são obrigatórios. Se selecionar PACOTE, os campos ALTURA, LARGURA e COMPRIMENTO são obrigatórios. Se selecionar CILINDRO, os campos COMPRIMENTO e DIÂMETRO são obrigatórios.

Para qualquer opção selecionada, o campo PESO BRUTO é obrigatório.

Estas informações serão utilizadas na Tela de Cotação e na impressão de etiquetas.

Valores no cadastro de produto:

1 – Envelope (largura e comprimento);

2 – pacote/caixa (altura, largura e comprimento);

3 – cilindro (comprimento e diâmetro);

13.5 COTAÇÃO DE PREÇOS E PRAZOS DOS SERVIÇOS DOS CORREIOS

(Vendas >> Notas Fiscais >> Nota Fiscal >> Tela [0565] NOTA FISCAL >> Incluir/Alterar >> Tela [0566] MANUTENÇÃO DA NOTA FISCAL)

Através do botão SIGEP, será feita a cotação de frete do SIGEP. Essa tela será acessada pelo Pedido de Venda e Nota Fiscal de Venda.

Ao clicar neste botão, será aberta a Tela [1127] COTAÇÃO SIGEP, ao abrir a tela será carregado o CEP do cliente, onde a regra será primeiramente o CEP dos dados de entrega, depois dados do consumidor e por fim dados de faturamento. Deverá ser informada a EMBALAGEM que carregará todos os produtos que sejam do tipo EMBALAGEM e tenham valor no campo TIPO EMB SIGEP.

Após selecionar a embalagem e clicar no botão Pesquisar o sistema irá pegar todas as transportadoras que tenha vínculo com o serviço contratado do SIGEP, será pesquisado de acordo com o CEP Origem, CEP Destino, tipo de embalagem e medidas.

Os serviços que retornarem, seus valores e prazos serão apresentados na grid, os que derem algum erro, será apresentada uma mensagem na tela com descrição do serviço e motivo retornado pelos correios.

Após fazer a cotação e escolher uma transportadora, o sistema perguntará se deseja alterar a transportadora no Pedido ou Nota, se clicar em NÃO nada será alterado, se clicar em SIM será alterado o campo transportadora e o valor do frete será gravado no campo FRETE NEGOCIADO. Após responder SIM para a primeira pergunta será perguntado se deseja adicionar o valor ao frete do pedido ou nota, respondendo SIM será alterado o valor do frete recebendo o que foi retornado da cotação.

13.6 IMPRESSÃO DE ETIQUETAS

(Expedição >> Etiquetas de Expedição >> Etiqueta de Postagem nos Correios >> Tela [0711] ETIQUETAS DE POSTAGEM)

 

Nesta tela serão impressas as etiquetas de postagem. Há um modelo de etiqueta padrão para o SIGEP WEB, conforme descrito no manual do SIGEP.

Selecione a nota através dos filtros de pesquisa e a mova para a parte debaixo da Tela clicando na seta para baixo.

Campo Embalagem Padrão: Este campo tem o objetivo de facilitar a seleção em massa do tipo de embalagem. Ao selecionar este campo, todas as notas receberão a opção selecionada, porém o usuário poderá trocar o mesmo na grid.  Esse campo só ficará habilitado caso o módulo SIGEP esteja habilitado.

Coluna Embalagem na grid: Poderá vir carregado caso o campo EMBALAGEM PADRÃO esteja preenchido, esse campo poderá ser alterado diretamente na grid, o mesmo é obrigatório quando se usa SIGEP, caso não tenha o módulo o mesmo não ficará visível.

Serão exibidos os volumes da nota fiscal selecionada, selecione o volume e clique em Imprimir >> Etiquetas para Postagem (SIGEP).

Após a impressão, será preenchida a coluna NR CONHECIMENTO.

Após relacionar o tipo de embalagem para as notas e gerar o número de conhecimento, será possível gerar a PLP clicando no botão GERAR PLP.

Há tipos de impressão para o SIGEP, foi criado 3 opções de menu para impressão de etiqueta, Etiquetas para postagem – SIGEP, Etiquetas para postagem – SIGEP (térmica) e etiquetas para aviso de recebimento (AR Modelo Sigep). Essas opções só ficarão visíveis ao utilizar o módulo do SIGEP.

Gerar PLP: Esse botão só fica visível se o módulo SIGEP estiver habilitado e o botão só fica habilitado se tiver volumes selecionados.

Ao clicar no botão o sistema faz algumas validações, como: a transportadora destino deve ter vínculo com serviço do SIGEP, se não tiver, será apresentada a mensagem “TRANSPORTADORA INFORMADA NÃO POSSUI VÍNCULO COM O SIGEP. PROCESSO ABORTADO!”

Depois das validações serão gravados o cabeçalho e os itens da PLP. No cabeçalho serão gravados os campos:

ID – sequencial

Data Cadastro – Data atual

Status – Pendente

Descrição – Será gravada uma descrição padrão onde a mesma poderá ser alterada dentro da tela da PLP. A descrição ficará “PLP Nº 123 GERADA PELA ETIQUETA DE POSTAGEM”

Cartão Postagem – cartão cadastrado na transportadora.

Nos itens serão gravados os campos:

ID – mesmo do cabeçalho

Serie – da nota

NrNota – número da nota

Volume – número do volume

NrConhecimento – número do rastreio

Campos: peso, altura, largura, comprimento, diâmetro, recuperados do cadastro da embalagem selecionada em cada volume.

Status – NÃO POSTADO

Após feito o cadastro, será aberta a tela da PLP com o novo registro posicionado onde o usuário poderá Fechar a PLP ou realizar outro procedimento.

13.7 PRÉ LISTA DE POSTAGEM (PLP)

(Expedição >> Integração Sigep >> Pré Lista Postagem >> Tela [1128] PRÉ LISTA DE POSTAGEM – SIGEP)

A PLP, ou pré-lista de postagem, é um controle para indicar que o vendedor realizou a postagem da mercadoria numa agência dos Correios e que os Correios receberam o (s) pacote (s). É um arquivo com todas as encomendas enviadas para o Correio.

Ao criar uma PLP, a mesma é criada com o status PENDENTE. Quando a PLP é fechada, é gerado um ID e o status fica como INTEGRADO. Ao clicar no botão INATIVO, fica com o status INATIVO.

Quando uma PLP é atualizada, o status fica ATUALIZADO. A PLP é atualizada quando os Correios alteram alguma informação após a sua geração, assim os campos COD UNID POSTAGEM, NOME UNID POSTAGEM, VALOR GLOBAL são preenchidos.

Ao clicar em Incluir, deverá ser informada a descrição da PLP, e selecionado o código do cartão. As notas podem ser inclusas manualmente informando a série e o número da nota, ou clicar no botão Volumes, onde será aberta a Tela [1129] PROCURA VOLUMES, e poderão ser pesquisados todos os volumes por nota fiscal, período, cliente, etc. No momento de lançar é validado se a nota/volume existe e se o volume já não se encontra em outra PLP.

Pelo menos 1 volume deve ser informado. Após a gravação da PLP será habilitado o botão Fechar e seu status ficará como pendente

Após selecionar as notas/volumes, clique em Gravar, este botão grava a PLP, mas não a transmite. Para transmiti-la, deve-se clicar no botão FECHAR PLP.

Gravar: Grava a PLP atual. Após gravar a PLP a mesma pode ser alterada ou excluída enquanto não for fechada.

Inativar: Uma vez integrada, a PLP pode ser inativada, esse recurso deixa os itens da PLP disponíveis para serem lançados em outra PLP se for o caso, no correio não será feita nenhuma atualização. Quando uma PLP é inativada, a mesma fica inativa somente para o sistema ONCLICK. Já para correios, valerá a PLP que tiver o voucher acompanhando os volumes e caso não receba o voucher da PLP inativada, a mesma será expirada com o tempo.

Fechar PLP: Transmite a PLP para os Correios. Se clicar em Fechar PLP a mesma será transmitida aos correios enviando um XML contendo informações do remetente, destinatário, objetos de rastreio, etc, essa rotina retorna o ID gerado no correio, o mesmo é apresentado na grid. Após o processo é perguntado se deseja imprimir o voucher, se clicar em SIM será impresso, se não imprimir nesse momento, poderá ser feito depois através do botão Imprimir Voucher.   O status ficará como integrado e será habilitada a opção de atualizar PLP e Imprimir Voucher.

Atualizar PLP: Esse botão ficará habilitado quando a PLP estiver fechada, ao clicar nele será feita a comunicação com o Correio enviando o número da PLP, o retorno serão informações atualizadas tanto no cabeçalho, quanto nos itens:

Campos que sofrerão alteração após a atualização:

CABEÇALHO, CODIGOUNIDADEPOSTAGEM, NOMEUNIDADEPOSTAGEM, VALORGLOBAL, ITENS, CUBAGEM, PESO, ALTURA, LARGURA, COMPRIMENTO, DIAMETRO, DATAPOSTAGEM, STATUSPROCESSAMENTO, NUMEROCOMPROVANTEPOSTAGEM, VALORCOBRADO.

Imprimir Voucher: O voucher (lista de postagem) é um relatório que agrupa o quantitativo dos objetos da PLP transmitida aos Correios, devendo uma via acompanhar a carga física. Esse botão imprimirá a etiqueta com 2 vias onde uma fica com o cliente e a outra com os correios, essa etiqueta deve acompanhar a carga, ela contém um código de barra com o número da PLP e a quantidade de objetos por serviço também são listados.

Imprimir PLP: Imprime uma listagem com os volumes da PLP, e seus dados, como peso, nr rastreio, nota, transportadora, etc.

Fluxograma do módulo SIGEP WEB: