---
title: "Como migrar do Brazilian Market sem quebrar gateway, frete, ERP e nota fiscal"
description: "Como migrar do Brazilian Market para o Checkout Rishi: o que migra sozinho, o que muda e como testar gateway, frete, ERP e nota fiscal."
url: "https://rishi.com.br/blog/migrar-do-brazilian-market"
published: "2026-10-18T12:42:08+00:00"
updated: "2026-10-18T12:42:08+00:00"
author: "Equipe Rishi"
tags: ["WooCommerce", "Checkout", "Brazilian Market"]
reading_time: "6 min"
---

# 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.

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](/blog/alternativa-ao-brazilian-market).

## 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**:

![Seção Dados brasileiros nas configurações do Checkout Rishi, com as opções Tipo de pessoa, Exibição do tipo de pessoa em botões PF/PJ, Exibir RG, Exibir Inscrição Estadual e Exibir data de nascimento.](https://assets.rishi.com.br/blog/rishi/2026/10/screenshot-dados-brasileiros-izy5a7ix.webp)

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:

1. **Compra como pessoa física**, com CPF, pagando pela forma que mais vende.
2. **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.
3. **Pedido no painel:** abra o pedido e confira se documento, número e bairro aparecem e podem ser editados.
4. **Gateway:** confirme que o pagamento foi aprovado sem erro de documento.
5. **Frete:** gere uma etiqueta de teste e confira número, bairro e documento do destinatário.
6. **ERP e nota fiscal:** veja se o pedido chegou com os mesmos campos de antes.
7. **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](/blog/abandono-de-checkout-funil) ajuda a ver se alguma etapa passou a perder mais clientes.

## Resumo da migração

1. Liste as integrações que usam CPF, CNPJ, número e bairro.
2. Instale o Checkout Rishi e confira a seção **Dados brasileiros**.
3. Decida o que fazer com gênero e celular separado, que deixam de existir.
4. Desative o Brazilian Market pelo botão da seção **Sobre**.
5. 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](https://rishi.com.br/checkout/brazilian-checkout). O que avaliar no checkout além dos campos está em [CEP automático, CPF e CNPJ: campos brasileiros no checkout](/blog/cep-automatico-cpf-cnpj-campos-brasileiros-no-checkout).

## Perguntas frequentes

### Perco os dados dos pedidos antigos ao desativar o Brazilian Market?

Não. Os pedidos antigos continuam com CPF, CNPJ, número e bairro, e no Checkout Rishi esses dados seguem disponíveis para as integrações pela API depois que o plugin antigo é desativado.

### Posso deixar o Brazilian Market e o Checkout Rishi ativos juntos?

Não. Os dois adicionam campos brasileiros e preenchimento pelo CEP e entram em conflito. O Checkout Rishi mostra um aviso na seção Sobre com o botão Desativar.

### O que o Checkout Rishi migra do Brazilian Market?

As configurações de tipo de pessoa (PF, PJ ou ambos), RG, inscrição estadual e data de nascimento, sem sobrescrever o que já estava salvo no Checkout Rishi.

### Os campos de gênero e celular do Brazilian Market continuam?

Não. O Checkout Rishi não pede gênero e usa o próprio campo Celular/WhatsApp no lugar do celular separado.