Cotacao B&B direto no checkout do parceiro.
A ideia e simples: o cliente compra no site do parceiro e ja ve a opcao da B&B Transportes com valor real, prazo de entrega e disponibilidade da cidade antes de finalizar o pedido.
Integracao feita com seguranca.
A loja envia os dados pelo backend, a B&B consulta a base operacional e o cliente ve apenas a cotacao final no carrinho.
Como o checkout deve funcionar
Fluxo esperado no site parceiro
O cliente escolhe os produtos e informa o destino da entrega.
A loja envia origem, destino, valor do pedido, volumes, peso e medidas.
A B&B valida cidade atendida, ponto de apoio, prazo e valor da cotacao.
O checkout mostra a transportadora com preco real e prazo estimado.
Depois da compra, o pedido pode seguir para coleta e rastreamento.
Preparacao do parceiro
O que seu site precisa ter
CEP, cidade e UF de origem e destino.
Peso real, volumes, altura, largura e comprimento dos itens.
Valor do pedido ou da nota fiscal.
CPF/CNPJ do remetente e do destinatario, quando a operacao pedir.
E-mail e telefone para retorno comercial ou suporte tecnico.
A chave da API e os dados de autenticacao devem ficar no servidor do parceiro. O frontend da loja nunca deve receber senha, token ou credencial.
Dados enviados para a B&B
Payload de cotacao
Para calcular corretamente, a loja precisa mandar os dados de origem, destino, volumes e valor do pedido. Com isso validamos a cidade, aplicamos as regras internas e retornamos uma cotacao pronta para aparecer no checkout.
-CEP, cidade e UF de origem e destino.
-Peso real, volumes, altura, largura e comprimento dos itens.
-Valor do pedido ou da nota fiscal.
-CPF/CNPJ do remetente e do destinatario, quando a operacao pedir.
-E-mail e telefone para retorno comercial ou suporte tecnico.
Retorno para o parceiro
O que a loja recebe
O retorno deve ser mostrado de forma limpa para o cliente final: transportadora, valor final e prazo. Taxas internas continuam tratadas pela B&B, sem aparecer separadas no carrinho.
-Cidade atendida ou nao atendida.
-Valor final da cotacao, sem detalhar taxas internas para o cliente.
-Prazo estimado conforme dias de atendimento da cidade.
-Observacoes importantes para carga acima do padrao.
-Codigo de cotacao quando a cotacao oficial for gerada.
Prazo e cobertura
Prazo certo para cada cidade
Em cerca de 80% das cidades atendidas, trabalhamos com prazo de 24 a 72Hrs. Algumas cidades tem dias reduzidos de atendimento, entao a API precisa respeitar a rota real antes de mostrar o prazo.
Atendemos cidades conforme os dias operacionais de cada rota. Consulte sua cidade ou gere uma cotacao para confirmar prazo e disponibilidade.
Antes de liberar em producao, fazemos uma validacao com pedidos reais de exemplo.
O parceiro precisa guardar o numero do pedido para ligar compra, coleta e rastreamento.
A chave de acesso da API deve ficar no backend da loja, nunca exposta no navegador.
Se a cidade tiver atendimento reduzido, o prazo mostrado deve respeitar os dias da rota.
Parceiros em acompanhamento: Mercado Norte | Autoparts Hub
Aviso importante para integracao
No momento, aceitamos integracao apenas para sites, lojas e e-commerces em que as encomendas saem de Sao Jose do Rio Preto/SP, Catanduva/SP, Mirassol/SP, Engenheiro Schmidt/SP, Cedral/SP e Elisiario/SP.
As demais cidades ainda nao estao habilitadas para integracao direta, mas voce pode entrar em contato por um dos nossos canais de atendimento para consultar possibilidades.
Proximo passo
Depois da analise, liberamos o ambiente, a chave e os exemplos de payload para o time tecnico do parceiro.