Como migrar do Brazilian Market sem quebrar gateway, frete, ERP e nota fiscal
O que o Checkout Rishi migra sozinho do Brazilian Market, o que deixa de existir e o roteiro de testes para trocar sem perder CPF, CNPJ, número e bairro no caminho.
Neste artigo
Migrar do Brazilian Market para outro checkout é seguro quando você sabe, antes de desativar o plugin, quais integrações leem CPF, CNPJ, número e bairro e testa cada uma depois da troca. No Checkout Rishi, as configurações do Brazilian Market são migradas automaticamente e os documentos, o número e o bairro continuam disponíveis para as integrações depois que o plugin antigo é desativado.
Este guia é mais técnico que o normal do blog, porque a troca mexe nos dados que gateway, ERP e emissor de nota usam. A decisão de trocar ou não está em Alternativa ao Brazilian Market on WooCommerce.
Por que a migração assusta (e onde está o risco de verdade)
O medo de trocar o Brazilian Market vem de uma coisa concreta: muitos plugins da loja dependem dos dados que ele grava. O gateway usa o CPF para aprovar o pagamento, o plugin de frete usa número e bairro para gerar a etiqueta e o ERP puxa o CNPJ para emitir a nota.
O risco não é a loja parar de vender. O risco é a loja continuar vendendo e algum desses dados chegar vazio na outra ponta, sem ninguém perceber por alguns dias. Por isso a migração começa por um inventário, não pela instalação.
Passo 1: faça o inventário do que depende do Brazilian Market
Antes de mexer em qualquer coisa, liste:
- Gateway de pagamento: quais formas pedem CPF ou CNPJ (cartão, boleto e Pix costumam pedir).
- Frete e etiquetas: o plugin de frete ou a plataforma de envio que usa número, bairro e documento do destinatário.
- ERP e emissor de nota fiscal: como eles recebem o pedido (API REST do WooCommerce, webhook ou exportação).
- Campos que você usa hoje: RG, inscrição estadual, data de nascimento, gênero e celular separado do telefone.
- Código próprio: snippets no tema ou em plugins que leem os campos do Brazilian Market.
Esse inventário vira o roteiro de testes do passo 4.
Passo 2: o que o Checkout Rishi migra sozinho
O Checkout Rishi migra automaticamente as configurações do Brazilian Market que têm equivalente no checkout, sem sobrescrever o que já estava salvo nele. A migração acontece mesmo quando o plugin é atualizado em segundo plano. Isso inclui:
- tipo de pessoa aceito (pessoa física e jurídica, só física ou só jurídica);
- exibição do RG;
- exibição da inscrição estadual;
- exibição da data de nascimento.
As opções ficam em WooCommerce → Checkout Rishi, na seção Dados brasileiros:
Confira essa tela logo depois da instalação. Se a sua loja pedia RG ou inscrição estadual no Brazilian Market, as caixas correspondentes devem estar marcadas.
Passo 3: o que muda e o que deixa de existir
Nem tudo o que o Brazilian Market fazia tem equivalente, e é melhor saber antes:
| No Brazilian Market | No Checkout Rishi |
|---|---|
| CPF, CNPJ, RG, inscrição estadual | Mantidos, com máscara e validação na tela e ao finalizar |
| Número e bairro | Mantidos e sempre obrigatórios |
| Data de nascimento | Mantida, opcional |
| CNPJ só com números | Aceita o numérico e o alfanumérico |
| Campo de gênero | Não existe |
| Celular separado do telefone | Não existe; o checkout usa o próprio campo Celular/WhatsApp |
| Endereço digitado pelo cliente | Preenchido pelo CEP (BrasilAPI ou ViaCEP) |
Se algum relatório ou automação da loja usa o gênero do cliente, decida antes da troca o que fazer com ele, porque o campo deixa de ser pedido nos pedidos novos.
Passo 4: desative o plugin antigo e teste o fluxo inteiro
O Brazilian Market e o Checkout Rishi não devem ficar ativos juntos: os dois adicionam campos brasileiros e preenchimento pelo CEP, e um duplica o outro. Quando o Brazilian Market está ativo, a seção Sobre das configurações do Checkout Rishi mostra um aviso com o botão Desativar. Em instalações novas, ele já é desativado automaticamente.
Com o plugin antigo desativado, faça o teste com o inventário do passo 1 na mão:
- Compra como pessoa física, com CPF, pagando pela forma que mais vende.
- Compra como pessoa jurídica, com um CNPJ alfanumérico de exemplo (12.ABC.345/01DE-35) e inscrição estadual, se a loja pede.
- Pedido no painel: abra o pedido e confira se documento, número e bairro aparecem e podem ser editados.
- Gateway: confirme que o pagamento foi aprovado sem erro de documento.
- Frete: gere uma etiqueta de teste e confira número, bairro e documento do destinatário.
- ERP e nota fiscal: veja se o pedido chegou com os mesmos campos de antes.
- Minha Conta: edite o endereço como cliente PF e como cliente PJ.
Se tudo passar, a migração terminou.
Os pedidos antigos continuam com os dados?
Sim. Os pedidos feitos com o Brazilian Market continuam com CPF, CNPJ, número e bairro, e esses dados seguem disponíveis para as integrações pela API depois que o plugin é desativado. Ao criar um pedido pelo painel e escolher um cliente que já existe, os dados brasileiros dele também são carregados.
Para os pedidos novos, a API REST de pedidos e clientes do WooCommerce expõe CPF, CNPJ, RG, inscrição estadual, tipo de pessoa, data de nascimento, número e bairro, também nos webhooks. Integrações podem criar e atualizar esses campos em billing e shipping, inclusive em lote, e o checkout valida CPF, CNPJ e data de nascimento antes de salvar.
Erros comuns na troca
- Deixar os dois plugins ativos "para garantir". Gera campos duplicados e validações que brigam entre si.
- Testar só a compra como pessoa física. O cliente empresa é o que mais sofre com campo errado, e o CNPJ alfanumérico só aparece nesse fluxo.
- Esquecer o plugin de autocompletar endereço. O Checkout Rishi já busca o endereço pelo CEP; outro plugin fazendo o mesmo causa conflito.
- Não olhar a etiqueta e a nota. O checkout pode estar perfeito e o dado chegar errado no ERP. O teste só termina na outra ponta.
E se algo der errado?
A troca tem volta. Desativar o Checkout Rishi devolve a loja ao checkout padrão do WooCommerce, e o Brazilian Market pode ser reativado em Plugins. Por isso vale fazer a migração num horário de pouco movimento e acompanhar os primeiros pedidos reais de perto. Depois da troca, o funil do checkout ajuda a ver se alguma etapa passou a perder mais clientes.
Resumo da migração
- Liste as integrações que usam CPF, CNPJ, número e bairro.
- Instale o Checkout Rishi e confira a seção Dados brasileiros.
- Decida o que fazer com gênero e celular separado, que deixam de existir.
- Desative o Brazilian Market pelo botão da seção Sobre.
- Faça uma compra PF e uma PJ e siga o pedido até o gateway, a etiqueta e a nota.
Os detalhes de cada campo estão em Checkout feito para o Brasil. O que avaliar no checkout além dos campos está em CEP automático, CPF e CNPJ: campos brasileiros no checkout.
