Atenção!!!
Visite o link abaixo antes de escalonar chamados para o Desenvolvimento RZBusiness
Chamados escalonados fora do parão especificado serão cancelados
Manual de escalonamento de chamados de Integrações com ETL SysMiddle (wiki interna)
Os pré-requisitos de ajuste do cadastro devem ser realizados por um usuário que conheça bem o inventário da empresa. Este procedimento poderá ser demorado.
Somente prosseguir após ter certeza que os pré-requisitos obrigatórios tenham sido atendidos.
Antes de implantar, leia o manual da integração na íntegra, pois ele contém informações importantes sobre o funcionamento da integração.
No RZBusiness acesse: \Arquivo\Configuração de integração força de vendas:
1.1 - Inclua uma integração de tipo NuvemShop para a empresa que corresponda à empresa cadastrada na API.
Será necessário gerar um token para o serviço se comunicar com a API.
O processo de geração do token deve ser executado pelo usuário ou por alguém da equipe da agência que está implantando a plataforma no cliente.
Temos duas versões de manuais que ensinam a gerar o token
Versão Oficial da Tienabube:
Clique aqui para consultar o manual de como gerar o token.
Versão traduzida:
Clique aqui para consultar o manual de como gerar o token.
1.2 - Acesse as configurações do serviço e preencha as seguintes informações:
1.2.1 - Token de acesso (AccessToken)
Descrito no item 1.1
1.2.2 - ID de usuário (user_id)
O valor deste campo deverá ser fornecido pelo cliente ou por alguém da equipe da agência que está implantando a plataforma no cliente.
1.3 - Configure os recebimentos:
1.3.1 - Cadastre o sacado que representa o gateway de recebimentos contratado pela empresa (Ex: pague seguro, wirecard, etc.).
1.3.2 - Cadastre uma espécie de caixa "Cartão de Crédito" para utilizar com a integração:
Vincule o sacado do passo 1.3.1
Inclua a bandeira Diversos, e demais bandeiras que serão operadas, com vencimento 30 dias, e obtenha a taxa com o cliente.
Na configuração da integração, na guia recebimentos, inclua uma configuração sem código, com a descrição igual a do nome da bandeira, para cada bandeira de cartão que o cliente for utilizar.
O manual da integração não fornece todos os nomes possíveis e caso fique faltando registro, não será possível gerar o recebimento corretamente.
É recomendável atenção e cuidado com estes cadastros.
1.3.3 - Cadastre a condição de pagamento para ser utilizada nos cabeçalhos dos pedidos.
Inclua uma condição de pagamento com tipo de cálculo "Automático calculado pelo Força de vendas".
As demais configurações da condição de pagamento podem permanecer conforme o padrão do formulário.
Na configuração da integração, na guia configurações, selecione a condição de pagamento e salve as alterações.
1.3.4 - Cadastre a condição de pagamento para recebimentos com boleto.
Inclua uma condição de pagamento com tipo de cálculo "Automático", a prazo, e vincule o sacado do passo 1.3.1.
Fluxo: 100% do valor, carência 0, referência Hoje, parcelas 1, intevalo 0.
Na configuração da integração, na guia recebimentos, inclua uma configuração sem código, com a descrição "bankinvoice", selecione o tipo "Condição de pagamento" e em registro a gerar, selecione a condição cadastrada no passo acima.
1.3.5 - A plataforma permite que o cliente crie formas de recebimento customizadas.
Será necessário analisar o caso, para identificar o tipo de registro que será necessário ser gerado no sistema, quando o pedido for recebido com uma forma de recebimento assim.
Realize a configuração corretamente.
1.4 - Configuração das entregas para a integração (guia "entrega" da configuração de integrações força de vendas):
O manual da integração não lista as opções de enterga possíveis.
O sistema usa o elemento "shipping_option" do pedido, para determinar como definir o tipo de entrega.
A descrição deve ficar exatamente conforme veirá no pedido, para que o sistema consiga identificar corretamente.
Solicite a lista de tipos de entrega ao cliente.
Como referência, poderá ser mostrado ao cliente, o elemento "shipping_option" no Json de pedido de exemplo, contido no manual da API, na seção que exemplifica a rota "POST /orders".
Clique aqui para acessar o exemplo mencionado acima.
1.5 - Configuração das notificações:
Configure os alertas de usuário para a integração padrão, na guia "Notificações"
1.6 - Configuração dos almoxarifados:
Em Movimentações/Força de vendas/Configuração de registros para integração, na guia "Saldo de estoque", configure para cada integração, quais almoxarifados e empresas devem ser considerados para enviar o saldo de estoque.
1.7 - Finalização das configurações
Na guia "Configurações" da integração, preencha os dados restantes.
Siga estes passos para instalar o serviço ETL e Monitoramento
Depreciado, conteúdo descrito no item 2 (acima)
Depreciado, seguir os passos no item 2
Marcar a opção de atualização automática.
Ministrar o treinamento conforme especificado no manual
Observação importante:
NUNCA exclua registros diretamente na plataforma, pois resultará em falhas de sincronia na integração.
1.1 - Categorias de produtos e-commerce
Envia a hierarquia de categorias de produtos e-commerce (Inclusão e alteração).
Você pode acessar o cadastro de categorias de produtos e-commerce através do menu:
Cadastros > Estoque > Categoria E-Commerce ou diretamente no cadastro do item, na guia "e-commerce".
Toda a hierarquia cadastrada é enviada sem a necessidade de se selecionar no formulário de seleção de registros a integrar, devido a necessidade de enviar toda a estrutura hierárquica e de se tratar de um cadastro exclusivo para o e-commerce.
Definição dos campos enviados:
Nome da entidade: "category"
O campo "Nome" é enviado "capitalizado" no elemento "name".
O campo "Descrição" é enviado no elemento "Description".
Esta entidade é obrigatória visto que o cadastro de um produto é rejeitado quando enviado sem o devido relacionamento com ela.
1.2 - Produtos
Envia cadastros de produtos (Inclusão e alteração).
A plataforma movimenta o produto através das variações atribuídas a ele.
Quando o tipo de controle do produto no Business for Unitário, o produto terá uma variação.
Quando o tipo de controle do produto no Business for Grade, cada produto terá uma variação para cada configuração de grade do produto.
Serão enviados os cadastros dos produtos selecionadas no formulário de seleção de registros a integrar.
Inclusão:
Itens não controlados por grade:
No momento do cadastro do produto, a API retorna o id do produto cadastrado e o id da variação atribuída a ele.
Itens controlados por grade:
No momento do cadastro do produto, a API retorna o id do produto e todos os ids das variações atribuídas às grades do produto.
Atualização:
Como a entidade que é movimentada na plataforma é a variação e não o produto em si, a atualização é realizada de forma separada, sendo que alguns campos são enviados na entidade "product" e outros na entidade "product_variant"
Definição dos campos enviados:
1.2.1 - Nome da entidade: "Product"
O campo "Descrição curta" da guia "E-Commerce" quando preenchido, é enviado "capitalizado" no elemento "name". Quando não preenchido é enviado o campo "Descrição" da guia principal, "capitalizado".
O campo "Descrição longa" da guia "E-Commerce" é enviado no elemento "description".
O campo "Descrição Marca" da guia "principal" é enviado no elemento "brand".
O campo "Código NCM" da guia "Fiscal" é enviado no elemento "TaxCode".
O campo "Descrição SEO / Slug" da guia "E-Commerce" é enviado nos elementos "seo_title" e "seo_description"
O campo "Tags / Meta Keywords" da guia "E-Commerce" é enviado no elemento "tags"
A categoria e-commerce vinclada ao produto é enviada no elemento "categories" com o código recebido da API após o envio da categoria.
Caso o item seja do tipo "produto" o campo "requires_shipping" é enviado com o valor "true", caso contrário, "false".
Para inativar um produto e todos as suas variações na plataforma, no formulário de registros a integrar, altere o seu percentual de estoque para ZERO.
1.2.2 - Nome da entidade: "product_variants"
O grupo de confgurações "Dimensões da embalagem do produto em metros" da guia "Complemento" é enviado nos elementos "height", "width", "depth" respectivamente, representando as dimensões do produto com a embalagem.
O campo "Peso Bruto KG" da guia "Fiscal" é enviado no elemento "weigth" representando o peso do produto com a embalagem.
O elemento "sku" é preenchido com o código do item, seguido da sequência da grade separados pelo caractere "|".
Itens não controlados por grade, terão a segunda posição do elemento "sku" preenchido com o valor zero.
O acompanhamento da fila de atualização dos registros integrados desta entidade, deverá ser realizado através da opção "Registro auxiliar de produto".
1.3 - Estoque e preço
Envia atualização de estoque e preço das variações do produto.
O preço considerado será o preço válido na data corrente na tabela vinculada ao item no formulário de seleção de registros integração.
O saldo de estoque enviado será calculado com base no percentual vinculado ao produto no formulário de seleção de registros integração, considerando-se:
1 - Os almoxarifados e empresas configurados para a integração.
2 - A reserva de estoque, onde configurado.
Obs. A plataforma espera que o estoque seja enviado como número inteiro. Por este motivo, o saldo é enviado arredondado pra baixo.
1.4 - Imagens de produtos
Envia todas as imagens do produto, configuradas como "Enviar para força de vendas".
A imagem principal de cada produto, é enviada independentemente de estar configurada como "Enviar para força de vendas".
Formatos testados:
jpg, png.
1.5 - Clientes e endereços
Recebe:
Novos clientes, novos endereços de entrega.
A internalização dos dados de novos clientes e endereços de entrega é realizada juntamente com a internalização do pedido força de vendas.
1.6 - Pedidos força de vendas
1.6.1 - Recebe:
Pedidos com pagamento aprovado e status "open", são internalizados na base de dados e disponibilizados no formulário de importação de dados força de vendas, onde permanecerão até que algum usuário os selecione para geração de pedido de venda.
Após a internalização do pedido, a integração atualiza o status do pedido na plataforma para "Embaado" de modo que uma vez internalizado, um pedido não aparecerá novamente na lista de pedidos disponíveis para internalizar.
Pedidos aguardando aprovação de pagamento, são internalizados como reserva de estoque, se a integração estiver configurada para tal.
Ao gerar com sucesso um pedido de venda a partir de um pedido força de vendas internalizado, a reserva de estoque da força de vendas é automaticamente excluída.
Pedidos cancelados, são cancelados automaticamente na internalização quando não houver atendimento prévio do pedido.
Caso já exista atendimento para o pedido força de vendas, o cancelamento do pedido é importado como "Pendente" e fica disponível no formulário de importação de dados força de vendas, na guia cancelamentos, para que o usuário realize o estorno do fluxo conforme necessário (separação de mercadorias, cancelamento de NF, etc.).
1.6.2 - Atualiza os status do pedido (Followup):
A - Ao informar a saída para a entrega (Atendimento pedido de venda), envia os códigos de rastreio se informados e comanda a atualização do status.
B - Ao cancelar o pedido no Business, envia o cancelamento.
2.1 - Formulário de seleção de registros a integrar.
2.2 - Formulário de importação de dados força de vendas.
2.3 - Formulário de consulta de logs de importação (Pedido, cliente, endereço).
2.4 - Formulário de acompanhamento de registros integração.
2.5 - Esclarecimento referente aos itens pertinentes nos requisitos.
Esta seção está constantemente em construção.
Contribua com a sua melhoria contínua.