O Bsale é um ERP na nuvem para PMEs que permite controlar estoque, armazéns, preços e gerar notas fiscais eletrônicas. A seguir, explicamos tudo sobre a integração entre o Bsale e o Yuju.
Escopo do módulo.
Um dos métodos de integração oferecidos pelo Yuju é por meio do Bsale, o que permite automatizar vários processos.
Criação de produtos.
A criação de produtos do Bsale para o Yuju é realizada automaticamente uma vez por dia (às 4h, horário do Chile), e apenas os novos produtos são criados no Yuju.
Para que os produtos sejam criados corretamente, é necessário cumprir certas condições:
Os produtos devem estar ativos no Bsale.
Eles devem ter um preço ou uma lista de preços atribuída, mesmo que não tenham estoque.
Mapeamento de produtos.
O mapeamento de produtos é feito automaticamente uma vez por dia (às 5h, horário do Chile).
No Bsale, todos os produtos têm um produto pai e variações associadas. Para mapear os produtos corretamente, é necessário que os produtos tenham o mesmo SKU no Yuju e no Bsale no nível da variação. Não é necessário que os produtos tenham a mesma estrutura.
Atualização de produtos.
A gestão de estoque e preço é feita no Bsale e as alterações são refletidas automaticamente no Yuju.
Qualquer alteração no estoque no Bsale (pedidos de venda, compra de mercadorias, atualização de inventário, transferências entre armazéns, etc.) é refletida automaticamente no Yuju em tempo real graças ao uso de webhooks.
As alterações de preços no Bsale são atualizadas no Yuju 4 vezes ao dia nos seguintes horários: 10h, 14h, 18h, 23h (horário do Chile). O Bsale não possui webhooks em sua API para atualizar preços em tempo real; portanto, fazemos várias consultas por dia.
Pedidos de venda.
As vendas de todos os canais de vendas online (marketplaces, seu e-commerce) conectados ao Yuju são importadas automaticamente para o Bsale. De acordo com a configuração, o pedido é enviado como boleta, pedido ou nota fiscal eletrônica.
Observação: Se forem enviadas como fatura eletrônica e uma venda não tiver as informações completas ou o CNPJ correto, nesse caso será enviada como boleta.
O pedido é atribuído a um determinado escritório (armazém) no Bsale de acordo com a configuração entre canais e tipo de envio: completo/vendedor.
Quando a venda do Yuju é inserida no Bsale, o cliente é criado com base nos dados do pedido.
Fluxo de venda:
A venda chega ao Yuju e é encaminhada para o Bsale.
Se o produto vendido pelo marketplace existir no Bsale e houver estoque, a venda é gerada no Bsale.
Se o produto vendido pelo marketplace não existir no Bsale, ele pode ser inserido por nota de correção (se estiver configurado). Nesse caso, para a geração da venda, apenas a descrição do produto é utilizada, em vez do SKU. Isso implica que não há estoque desse produto no Bsale e, portanto, o estoque nunca é enviado para o Yuju.
Nota:
O método de pagamento especificado no arquivo de configuração deve estar previamente registrado no Bsale para que a venda seja gerada.
Se a venda for cancelada no marketplace, o cancelamento não será refletido no Bsale devido à falta de um endpoint para essa ação na API do Bsale. Nessa situação, é necessário realizar uma ação manual, como gerar uma nota de crédito, para repor o estoque no Bsale. Isso garante a atualização das informações tanto no Yuju quanto no marketplace.
Se você inserir as vendas por nota fiscal e não criar seus produtos no Bsale, poderá utilizar a integração do Bsale exclusivamente para gerar notas fiscais e faturas sem atualizar o estoque e os preços dos seus produtos no Yuju.
Dados enviados do Yuju para o Bsale para as vendas: Número ou referência do marketplace, Produtos, Total, Canal, Cliente, Data.
Notas fiscais/faturas.
A nota fiscal ou fatura gerada no Bsale é enviada automaticamente para o Yuju associada ao pedido correspondente. O Yuju, por sua vez, a envia para os canais conectados.
Observação: São realizadas várias tentativas de recuperação da nota fiscal ou fatura durante um período de até 48 horas, caso ocorra algum erro ao tentar obtê-la.
Notas de crédito
O que é?
Uma nota de crédito é um documento fiscal ou contábil emitido para reduzir ou anular total ou parcialmente o valor de uma fatura já emitida.
Em que momentos é emitida?
É utilizada, por exemplo, quando:
Um pedido é cancelado.
Um, vários ou todos os produtos do pedido são devolvidos.
Houve cobrança a maior.
Há erros na fatura (preço, quantidade, impostos).
São aplicados descontos posteriores.
O que você pode configurar?
O módulo do Yuju com o Bsale permite configurar o seguinte:
Ativar/desativar a geração de notas de crédito.
A geração da nota de crédito: pode ser manual ou automática.
4 parâmetros:
Com que tipo deseja que a nota de crédito seja gerada? Deve-se escolher um único tipo, e esse tipo será aplicado a todas as notas geradas.
São 4 tipos: Para devolução de dinheiro, forma de pagamento de nova venda, para crédito em conta, para outra devolução.Motivo: O vendedor especifica o texto que será impresso na nota de crédito. Ele será aplicado a todas as notas geradas. Se nada for inserido, ficará em branco.
Declarar diretamente: Se será declarado ao SII ou não (sim, não).
No Bsale, existem documentos para cada processo; o vendedor deve indicar o nome do documento que será usado para a nota de crédito.
Explicação
Existem duas maneiras de gerenciar a nota de crédito:
Automática: A nota de crédito é aplicada imediatamente assim que for recebido, via webhook, o cancelamento ou a devolução de um ou vários produtos de um pedido.
Manual: É gerado um registro nas informações de saída (localizado na página de detalhes do pedido), a partir do qual o vendedor pode gerar a nota de crédito com um único clique.
Perguntas frequentes.
Por que o estoque de um produto não é atualizado do Bsale para o Yuju?
Listamos algumas razões possíveis:
O produto está desativado no Bsale. Para que o estoque seja atualizado no Yuju, é necessário que o produto esteja ativado no Bsale.
O SKU do produto não é o mesmo no Bsale e no Yuju.
É importante verificar se o estoque do produto não está negativo no Bsale, pois, nesse caso, o Bsale não o reporta na API. Para garantir sua atualização no Yuju, é necessário definir o estoque como 0.
Por que o preço de um produto não é atualizado do Bsale para o Yuju?
Listamos algumas razões possíveis:
O produto está desativado no Bsale. Para que os preços sejam atualizados no Yuju, é necessário que o produto esteja ativado no Bsale. Além disso, uma vez que o produto esteja ativado, é preciso aguardar a próxima execução da atualização de preços para que as alterações sejam refletidas no Yuju.
O SKU do produto não é o mesmo no Bsale e no Yuju.
A API do Bsale não respondeu por algum motivo e a tarefa de atualização de preços não foi executada. No entanto, ela será atualizada na próxima atualização. Caso contrário, avise seu KAM ou soporte@yuju.io.
Por que a venda/nota fiscal não é criada no Bsale?
Antes de mais nada, verifique se os SKUs vendidos existem no Bsale (pode ser que o SKU de alguma variação não esteja no Bsale) e certifique-se de que o produto tenha estoque disponível. Além disso, verifique se o método de pagamento especificado no arquivo de configuração está registrado no Bsale.
É possível gerar notas fiscais sem criar o cliente?
Existe uma funcionalidade no Bsale que permite gerar notas fiscais sem a necessidade de criar o cliente. Para isso, deve-se usar um RUT genérico 66666666-6; é possível configurá-lo mediante solicitação ao seu KAM ou para soporte@yuju.io.
O que acontece se eu excluir meu produto no Bsale?
Se você excluir ou alterar o SKU de um produto no Bsale que esteja sincronizado com o Yuju, por motivos de segurança, ele não será excluído do Yuju. O produto continuará existindo no Yuju, mas os preços e o estoque não serão mais atualizados (você pode excluí-lo do Yuju caso não queira mais vender esse SKU).
Se você criar novamente o mesmo produto no Bsale, ele será sincronizado novamente com o Yuju.
Processo de instalação/configuração.
A integração com o Bsale é altamente personalizável e o usuário pode escolher como ela funciona por meio da configuração que desejar. Veja o exemplo.
Configurações disponíveis.
Algumas das opções que podem ser escolhidas são as seguintes:
Criação de produtos do Bsale no Yuju.
Mapeamento de produtos.
Atualização automática de estoque do Bsale para o Yuju.
Atualização automática de preços do Bsale para o Yuju.
Importação automática de pedidos de venda do Bsale.
Envio automático para o Yuju da nota fiscal gerada no Bsale.
Lista de preços do Bsale que deve ser aplicada a cada um dos seus canais.
Configuração do método de pagamento aplicável a cada marketplace na geração das notas fiscais ou faturas.
Nome do vendedor associado a cada pedido de venda importado para o Bsale.
Dados de conexão.
Os dados necessários para conectar-se ao seu Bsale são os seguintes:
Token da sua conta do Bsale
País de residência
Para qualquer dúvida e/ou esclarecimento, entre em contato com seu KAM designado ou escreva para soporte@yuju.io.