Integração BizCommerce

A seguir, todos os passos necessários para utilização da plataforma BizCommerce junto ao Dataplace ERP


Ao abrir o módulo de integração, a seguinte janela é apresentada:

CONFIGURADOR GERAL

Antes de seguir com as configurações no módulo de integração, é importante criar algumas opções que serão usadas e para isso acessaremos o módulo do Configurador Geral, para cadastrar estes campos que serão selecionados nos Parâmetros da integração, acesse Arquivo >> Gerador de campos >> campos e conteúdos:

Crie um campo com as opções destacadas, depois clique na aba 2 – Conteúdo:

Depois em Natureza da Operação eu adiciono este campo criado na Natureza Padrão que utilizarei na minha integração:

Feito o cadastro prévio é quando as informações podem ser disponibilizadas nos campos correspondentes nos parâmetros do módulo de integração.

PARÂMETROS

Vamos começar a configuração pelo menu Configuração >> Parâmetros, conforme imagem abaixo (também pode-se optar pelo atalho Ctrl + R):

Aba Configurações A

Começando pela janela Configurações A, vemos os seguintes campos:

Endereço do Web Service

Informação fornecida pelo integrador da plataforma

Username

Informação fornecida pelo integrador da plataforma

Senha

Informação fornecida pelo integrador da plataforma

Tipo de Pedido

A integração da plataforma online pode ser feita em uma das seguintes manutenções do Dataplace ERP

  • Pedido de Faturamento com Entrega
  • Pedido de Venda

Durante a implementação isto deve ser definido com o gestor do projeto.

Tipo de Reserva do Estoque do Pedido de Venda

Configuração necessária para o caso da integração ser feita através do Pedido de Venda (apresentado no item anterior):

  • Reserva de Estoque Imediata (já faz o empenho do estoque quando o pedido é baixado para o ERP, diminuindo portanto o estoque disponível).
  • Não Reservar o Estoque

Origem do cadastro do cliente

  • Do ERP para o ecommerce (o cliente é cadastrado diretamente na base da BizCommerce e não é feito download deste, para não haver substituição na base do ERP).
  • Do ecommerce para o ERP (é feito o download do cadastro e a origem fica sem especificação).

Após realizadas as configurações, basta clicar no botão SALVAR, no canto superior esquerdo.

Aba Configurações B

Nesta aba você vai inserir as Naturezas de Operação criadas e configuradas no ERP, que serão colocadas nos pedidos quando estes forem baixados da plataforma online para o ERP. Também irá colocar opções padrão que determinarão o comportamento, na sequência dos pedidos até seu encerramento, dentro do ERP.

Natureza de Operação Pessoa Jurídica

  • Dentro do Estado
    • Faça a pesquisa por Cd. (Código) e Descrição
  • Fora do Estado
    • Faça a pesquisa por Cd. (Código) e Descrição

Natureza de Operação Pessoa Física

  • Dentro do Estado
    • Faça a pesquisa por Cd. (Código) e Descrição
  • Fora do Estado
    • Faça a pesquisa por Cd. (Código) e Descrição

Natureza de Operação para Bonificação/Brinde

Faça a pesquisa por Cd. (Código) e Descrição

Vendedor Padrão

Faça a pesquisa por Cd. (Código) e Vendedor que será utilizado como indicador de venda por esta plataforma.

Tabela de Preços

Faça a pesquisa por Cd. (Código), Seq. (Sequência) e Tabela que será usada como a padrão para determinar o valor dos produtos

Up padrão de estoque

Faça a pesquisa por Cd. (Código) e Descrição para informar a UP em que os pedidos serão registrados.

  • Considera todo o estoque?
    • Marcando esta opção, você solicita ao sistema que utilize todas as UP’s (apenas do banco padrão conectado):

  • Se desmarcada, através da configuração multi-planta você pode selecionar “n” UP’s em “n” bancos que desejar:
Estoque Multi-Planta

Pelo menu ou utilizando o atalho Ctrl + Shift + E, a seguinte janela surgirá:

Selecione através da listagem, o endereço do servidor, depois selecione o banco de dados que deseja usar e que está neste servidor e em seguida escolha as UP’s que quer utilizar:

Após a escolha basta clicar na seta à direita para inserir o registro na janela logo abaixo. Simples não?

Origem padrão de venda

Faça a pesquisa por Cd. (Código) e Descrição

Condição Comercial Padrão

Faça a pesquisa por Cd. (Código) e Percentual de eventual desconto que aplicará por padrão.

Aba Configurações C

Nesta aba vamos colocar os status cadastrados nos campos adicionais dos itens PV ou PFat no ERP para gerenciar as fases pelas quais o pedido passa quando é baixado, até ser encerrado.

Os valores dentro dos campos são fornecidos na plataforma. Acesse-a e após o login clique em SISTEMA e depois em STATUS DE PEDIDOS:

Veja nos campos destacados, onde as informações destas respostas são encontradas:

Status do Pedido

  • processing – É o pedido em processamento. Pedido efetuado e pago na plataforma.

Campo adicional de controle dos pedidos importados

Pesquisa pelo Cd. (Código) e Descrição o campo adicional correspondente

Respostas

Após importação (preparando entrega)

  • etp_processing – É o pedido completo, sem a emissão da NF-e.

Após faturamento

  • complete – É o pedidos já completos e encerrado com a emissão da NF-e.

Informações do Cliente

Situação Padrão

Selecione a situação padrão quando um pedido é baixado:

  • ATIVO
  • INATIVO
  • PROSPECT
  • BLOQUEADO

Área Padrão

Escolha uma cadastrada previamente no ERP, pode ser específica para o e-commerce. Posteriormente pode ser alterada para que corresponda a uma necessidade.

Categoria Padrão

Da mesma forma uma cadastrada previamente. Posteriormente pode ser alterada para que corresponda a uma necessidade.

Prefixo para Códigos de Produtos

Serve para adicionar um prefixo ao código SKU do produto quando for realizado o envio para a plataforma online (utilizável em casos muito específicos, por exemplo implementar diferença de preços para B2B e B2C onde o produto é o mesmo mas deve fazer a distinção por conta de valores diferenciados).

VISUALIZANDO OS CAMPOS

No exemplo abaixo a nossa integração se dá nos Pedidos de Venda, vamos ver onde podemos visualizar esses campos que cadastramos, quando eles são utilizados ao baixarmos o pedido da plataforma para o ERP:

Veja no destaque da imagem onde você pode clicar para visualizar o campo adicional. A seguinte janela aparecerá:

O campo e a resposta, conforme cadastramos, registrando o status adequado para o momento do pedido. Os status são atualizados quando se vai em Ferramentas >> Atualização de status de Pedido (Ctrl + Shift + S):

Simples, não é mesmo?

CADASTRO DE PRODUTOS

Vamos em Ferramentas >> Cadastro de Produtos (Ctrl + P), para subirmos os produtos para a plataforma:

Campos a Configurar (produtos)

Configurações necessárias para sincronizar os produtos:

Na manutenção do Produto, selecione-o e vá na aba e-commerce / Geral >> disponível para sfa/e-commerce, marque esta seleção.

  • Campo01 – MetaTitle – Título do produto
  • Campo02 – MetaKeywords – Palavras chave para pesquisas
  • Campo03 – MetaDescription – Descrição do produto
  • Campo04 – ShortDescription – Descrição curta
  • Descrição para ambiente e-commerce – Descrição

Também há campos adicionais a incluir:

  • SYE03 – Campo alternativo para o nome do produto na plataforma, se em branco, será considerado o DsVenda.
  • SYE31 – Disponível para E-Commerce (BizCommerce) – (S/N)
  • SYE32 – Categorias (BizCommerce) – (ID da categoria, encontrada no painel administrativo da plataforma, em Gerenciar Categorias, informar ID’s separados por vírgula).
  • SYE33 – Id da Marca (BizCommerce) – (Título da marca, encontrada no painel administrativo da plataforma, em Marcas / Gerenciar Marcas).
  • SYE25 – Altura do produto em cm
  • SYE26 – Comprimento do produto em cm
  • SYE27 – Largura do produto em cm
  • SY047 – Pendente para EDI – (S/N)

Obs.: Para que o produto seja atualizado, é necessário que o campo SY047 esteja definido como “S”, caso contrário, mesmo que esteja marcado como disponível para e-commerce, ele não será atualizado.

Imagens dos Produtos

Importante que estas imagens devem ser adicionadas de uma pasta comum à todos os PC’s da empresa (rede), para que não quebrem ao acessar a manutenção de produtos.
Exemplo de um endereço válido: \\172.16.50.4\img_sites\Publicados\26562.jpg

BizCommerce x ERP

Como identificar na plataforma um valor que precisa ser inserido em um campo adicional? Muito simples, vamos seguir a instrução colocada entre parêntesis colocada no campo SYE32, acima:

No exemplo abaixo, queremos identificar qual o ID da categoria que preciso disponível (incluindo subcategorias se houver) para inserir no campo correspondente. Na plataforma vá em Catálogo >> Gerenciar Categorias:

Depois anote o número das categorias e subcategorias (para visualizar uma subcategoria, basta clicar no nome da categoria principal):

Em seguida vá atá a manutenção de Produtos e insira no cadastro do produto no ERP, no campo adicional de e-commerce as informações da categoria, no campo adicional SYE32 Categorias (BizCommerce):

Veja que depois da categoria, vêm quantas subcategorias quiser, separadas por vírgulas.

Personalização (produtos)

Caso deseje alterar algum aspecto dos parâmetros necessários para a escolha dos produtos, basta editar o Engine Code (que é o script de customização do Dataplace ERP):

Finalizada a configuração, basta clicar em Processar.

CADASTRO DE CLIENTES

Vamos em Ferramentas >> Cadastro de Clientes (Ctrl + U), para subirmos os clientes para a plataforma:

Veja que o layout da manutenção que faz o envio é igual ao de produtos. Todas têm o mesmo layout.

Campos a Configurar (clientes)

Na manutenção de Clientes, deve haver a seguinte configuração nos campos adicionais a seguir:

  • SYE04 – Envia cliente para eCommerce? (S/N)
  • SYE05 – ID do Cliente (BizCommerce)
  • SYE06 – Cliente pendente para atualização?(S/N)

Vá em Campos Adicionais de e-commerce, para adicionar e configurar estes campos, na manutenção de clientes:

Depois de feita a configuração, clicar em Processar (esta manutenção não possui EC para personalizar). Obs.: EC (Engine Code, o script de customização).

ATUALIZAÇÃO DE PREÇOS

Vamos em Ferramentas >> Atualização de Preços (Ctrl + Shift + P), para atualizarmos os preços dos produtos para a plataforma:

A manutenção é a seguinte:

Personalização (preços)

Também é possível alterar o padrão para considerar outros critérios para a atualização de preços dos produtos, através de personalização do EC. Caso não mude nada, o sistema seguirá verificando se o produto está disponível para e-commerce e se houve alteração de preços.

Feitas as configurações, bastas clicar em Processar.

ATUALIZAÇÃO DE ESTOQUE

Vamos em Ferramentas >> Atualização de Estoque (Ctrl + E), para subirmos as atualizações de estoque dos produtos para a plataforma:

Esta manutenção atualizará as quantidades com base nas movimentações de compras e vendas que aconteceram nas UP’s configuradas lá no início em Parâmetros, na sua forma padrão.

Personalização (estoque)

Também há um EC que pode ser personalizado, caso o cenário do cliente exija outros parâmetros para determinar como deve ocorrer a atualização do estoque. Obs.: EC (Engine Code, o script de customização).

Feitas as configurações, basta clicar em Processar.

INTEGRAÇÃO DE PEDIDOS

Vamos em Ferramentas >> Atualização de status do Pedido (Ctrl + S), para recebermos os pedidos da plataforma:

A seguinte manutenção abrirá:

Quais pedidos são baixados? Todos os que estão com o status como processing. Não possui EC, basta clicar em Processar.

ATUALIZAÇÃO DE STATUS DO PEDIDO

Vamos em Ferramentas >> Atualização de status do Pedido (Ctrl + Shift + S), para atualizarmos os status dos pedidos para a plataforma:

A seguinte manutenção se abre:

Para essa atualização o sistema considera a emissão e o envio efetivo da Nota Fiscal, completando o ciclo de vida do pedido, dentro da plataforma. Não possui EC para personalização. Obs.: EC (Engine Code, o script de customização).

Basta clicar em Processar.

VISUALIZAÇÃO DE LOGS

Acesse em Consultas >> Visualização de Logs (Ctrl + L):

A seguinte janela aparecerá:

Integrações

Datas automáticas que informam quando as integrações com a plataforma BizCommerce ocorreram.

Filtros

Vale a pena mencionar, além dos campos autoexplicativos, que você pode buscar por uma inconsistência por Tipos diversos e através de Palavra-chave (dentro dos resultados obtidos), para ser específico na análise do seu log.

Obs.: A integração pode ser feita tanto no banco mandatório, como no dependente (no caso de empresas que trabalham com sincronização), a integração sempre levará em conta as tratativas e consistências que acontecem no banco mandatório, sem nenhum problema, garantindo a integridade do banco de dados.

Esta documentação foi útil para você?