Rotozoom B2B Manager — Manual

Transforme sua loja WooCommerce em um canal atacadista. O B2B Manager adiciona um papel dedicado de cliente comercial, descontos personalizados, um fluxo de aprovação para novas contas atacadistas, um catálogo de endereços de entrega para seus parceiros e — no Pro — três modos de atendimento com acompanhamento de margem, pagamento diferido, protocolos de comissão e créditos na loja.

• Versão gratuita: papel de cliente B2B, registro e aprovação, uma regra de desconto global por parceiro, o catálogo de endereços do parceiro, dados da empresa bloqueados e solicitações de alteração.
• Versão Pro: descontos por marca / categoria / atributo, modos de atendimento, pagamento diferido, créditos e comissão (razão, protocolos, pagamentos, transferências entre fundos), dicas de crédito e notificações por e-mail.
• Preço Pro: 49 € / ano por site, c/ IVA incluído (empresas da UE com um número de IVA válido: autoliquidação).
• Como obter o Pro: utilize a edição descarregada de rotozoom.com — esta instala o Rotozoom Connect automaticamente — compre o Pro em rotozoom.com e inicie sessão através do Rotozoom Connect. Uma licença está ativa num site; "Alterar site" no seu painel de controlo de rotozoom.com move-a.

---

O que há de novo (1.2.x, atual 1.2.10)

• Catálogo de endereços de entrega para parceiros aprovados, em Minha conta → "Delivery addresses": escritórios de transportadora e armários escolhidos a partir da nomenclatura do Sell & Ship (lista e mapa) ou um endereço de rua simples, com destinatário editável. Sem limite de quantidade de endereços, em qualquer um dos planos.
• Os dados da própria empresa do parceiro ficam bloqueados na finalização da compra e são preenchidos automaticamente (nome da empresa, CNPJ/identificação, número de IVA, pessoa responsável, endereço registrado) — aplicado ao pedido no servidor, não apenas no formulário.
• Solicitações de alteração: o parceiro pede uma alteração dos dados da empresa em Minha conta → "B2B account"; você a analisa na aba "Change requests". Enquanto uma solicitação estiver pendente, o parceiro não pode concluir um pedido.
• Modos de atendimento (Pro): "Invoice & ship", "Retail — commission" e "Retail — credits", com um painel ao vivo "Buying for · Selling for · Profit" e um limite de margem aplicado na camada de dados.
• Pagamentos por parceiro (Pro): escolha quais métodos cada parceiro pode usar, mais um novo gateway "Deferred payment (on account)" com limite de crédito.
• Créditos e comissão (Pro): dois fundos separados (comissão e créditos), uma razão somente-adição, protocolos de comissão PR-YYYY-NNNN, solicitações de pagamento PO-YYYY-NNNN e transferências entre os dois fundos.
• Dicas de crédito (Pro): uma única linha cinza no catálogo, na página do produto e no carrinho mostrando o saldo de créditos do parceiro e o que resta após a compra.
• Notificações por e-mail (Pro): cinco eventos por parceiro — encomenda não entregue após N dias, entregue, devolvida, comissão ou créditos pagos, saldo acima de um limiar — gerenciados em Minha conta → "Notifications".
• Minha conta no celular: com uma conta B2B ativa, as páginas não-B2B ficam recolhidas em "More about the account".
• Requer Sell & Ship 1.9.2 ou posterior para o seletor de escritório/armário dentro do catálogo de endereços e para as notificações de entrega / devolução.
• Desde a 1.2.3: um separador "Go PRO" lista o que o Pro adiciona (num site Pro diz "PRO"); um papel B2B atribuído manualmente em Utilizadores aparece em "Pending" para aprovação; o tipo de desconto por marca deteta a taxonomia de marcas que a sua loja realmente utiliza (por exemplo, as marcas próprias do XStore); os extratos de comissões e faturas de parceiros são armazenados sob nomes de ficheiro impossíveis de adivinhar; e os campos de empresa bloqueados são aplicados exatamente como no registo da empresa, mesmo quando um campo está vazio.

---

Para iniciantes: o que este plugin faz

Muitas lojas vendem para dois tipos de comprador: clientes comuns e clientes comerciais ou atacadistas que devem ver preços especiais. O B2B Manager permite tratar esses grupos de forma diferente na mesma loja:

• Os compradores atacadistas fazem login e veem automaticamente os seus preços com desconto.
• Novos compradores comerciais solicitam uma conta que você aprova.
• Uma vez aprovado, o parceiro mantém um catálogo de endereços de entrega, compra a preços comerciais e — se você ativar — revende aos próprios clientes enquanto a loja envia diretamente e a margem do parceiro é acompanhada para você.

Configuração

1. Entenda o papel de cliente B2B

O WordPress atribui a cada usuário um papel (Cliente, Gerente da loja e assim por diante). O B2B Manager adiciona um papel Cliente B2B. Qualquer usuário com esse papel é tratado como comprador atacadista e recebe os descontos que você configurar.

Pode atribuir o papel manualmente (em Utilizadores) — o utilizador aparece então no separador "Pending" do plugin para aprovar ou rejeitar — ou deixar que os compradores o solicitem através do formulário de registo e aprová-los aí.

2. Defina suas regras de desconto

Abra a linha do parceiro e adicione regras de desconto para esse parceiro. Comece com uma regra global (por exemplo, "10% de desconto em tudo") e refine a partir daí. As regras por marca, categoria e atributo são Pro.

3. Preencha os dados da empresa do parceiro

Cada parceiro aprovado carrega um registro de empresa: "Company name", "Company ID (UIC)", "VAT no.", "Responsible person" e "Registered address". São esses os dados que o plugin escreve em cada pedido que o parceiro faz, então complete-os antes do primeiro pedido dele. Você os edita no formulário "Company details" dentro da linha do parceiro; o parceiro só pode solicitar uma alteração.

4. (Pro) Decida como cada parceiro trabalha com você

Abra a linha do parceiro → "Fulfilment & payment settings" e escolha os "Enabled modes", os "Payment methods (Invoice & ship)" permitidos, o "Credit limit", a "Minimum margin", o "Maximum customer discount", o "Margin hold" e os "Programs" (comissão e/ou créditos).

Referência de recursos

Papel de cliente B2B e aprovação

Um papel distinto que marca um usuário como comprador atacadista. Os descontos, o catálogo de endereços, os modos e os fundos de crédito se baseiam nele, então o comprador simplesmente faz login e vê os preços e as páginas corretas.

Os candidatos chegam em "Pending"; aprovar move o usuário para o papel Cliente B2B. As abas são "Pending", "Approved", "Rejected", "All" e "Change requests".

Mecanismo de descontos

Os descontos são aplicados durante o cálculo dos totais do carrinho, então o preço reduzido se propaga de forma consistente pela página do produto, carrinho e finalização da compra.

• Desconto global (Free): uma percentagem aplicada a todos os produtos para esse parceiro.
• Por marca / categoria / atributo (Pro): direcione os descontos com precisão — por exemplo, 15% em uma marca, 5% em uma categoria.

Catálogo de endereços de entrega (Free)

Em Minha conta → "Delivery addresses" um parceiro aprovado mantém os locais aos quais seus pedidos são entregues:

• "Courier office / locker" — escolhido na nomenclatura da transportadora pelo seletor do Sell & Ship (lista pesquisável mais mapa), de modo que o ponto salvo é um código real de escritório, não texto livre. Um ponto cujo código não existe mais na nomenclatura é exibido como "Unavailable" e não pode ser selecionado.
• Endereço de rua — "Street address", "Apartment, floor, entrance (optional)", "Town / City", "Postcode", "State / Region", "Country".
• Destinatário — "First name", "Last name", "Phone", "Email", "Company (optional)", para que a guia de transporte viaje até o destinatário final enquanto a fatura permanece com o parceiro.
• Um endereço pode ser marcado como "Default"; não há limite de quantidade de endereços em nenhum dos planos.

Na finalização da compra, os endereços salvos aparecem como chips em "Delivery to your customer". Aplicar um deles preenche a transportadora, o escritório e o destinatário. O cartão do destinatário continua editável, e "Save these changes to the saved address" grava a correção de volta no catálogo. O escritório ou o próprio endereço é sempre alterado no seletor, nunca digitando.

Funciona tanto na finalização clássica quanto no bloco de Finalização do WooCommerce.

Dados da empresa bloqueados e solicitações de alteração (Free)

Na finalização da compra, a identidade de faturamento do próprio parceiro é somente leitura e pré-preenchida a partir do registro da empresa; o plugin a escreve no pedido no servidor, independentemente do que o formulário enviar. O editor Endereços → Faturamento do WooCommerce fica bloqueado para clientes B2B pelo mesmo motivo.

Para corrigir algo, o parceiro abre Minha conta → "B2B account", vê os dados atuais e envia um "Request a change" apenas com os campos que diferem, mais uma "Note to the administrator (optional)" opcional. Enquanto a solicitação estiver pendente, o parceiro não pode concluir um pedido — a finalização é recusada com uma frase, tanto na versão clássica quanto na de blocos. Você a aprova ou rejeita em "Change requests"; o parceiro recebe e-mail nos dois casos e também pode "Withdraw the request".

Modos de atendimento (Pro)

Na finalização da compra um parceiro aprovado escolhe no painel "How are you fulfilling this order?":

Modo	O que significa
"Invoice & ship"	O parceiro compra a preços B2B e você envia ao ponto que ele escolher. A fatura vai para o parceiro.
"Retail — commission"	Você vende ao cliente final; a fatura é emitida para esse cliente e a margem do parceiro é acumulada no fundo de comissão.
"Retail — credits"	O mesmo, mas a margem é acumulada no fundo de créditos, que o parceiro pode gastar na sua loja.

O painel mostra "Buying for", "Selling for" e "Profit", e permite ao parceiro definir um "Discount for your customer" como porcentagem ou valor. Dois limites são aplicados na camada de dados, não apenas no formulário: "Minimum margin" e "Maximum customer discount" — uma violação recusa o pedido em vez de corrigi-lo silenciosamente.

Ambos os modos de varejo exigem um endereço de entrega aplicado (é preciso haver um cliente final para quem enviar). Em um modo de varejo a fatura é emitida para o cliente final, e o grupo opcional do formulário de endereço "Invoice to the recipient's company (optional)" fornece os dados da empresa desse cliente.

Um modo só é oferecido quando está ativado globalmente, ativado para aquele parceiro e seu programa está ligado: "Retail — commission" precisa do "Commission program", "Retail — credits" precisa do "Credits program".

Pagamentos por parceiro (Pro)

"Payment methods (Invoice & ship)" lista "Card", "Bank transfer", "Deferred payment (on account)" e "Credits". O filtro apenas remove métodos:

• Em "Invoice & ship" o parceiro vê o que você permitiu; o pagamento na entrega é sempre removido.
• Nos modos de varejo apenas o pagamento na entrega é oferecido. (Um link de pagamento para o cliente final não foi construído.)
• Um parceiro sem modo selecionado finaliza a compra como um cliente B2B comum, com os métodos normais da loja.

"Deferred payment (on account)" coloca o pedido em espera e não pago, e só é oferecido enquanto a exposição em aberto do parceiro mais este pedido permanecer dentro do seu "Credit limit". A exposição é calculada ao vivo a partir dos pedidos diferidos em aberto do parceiro menos os reembolsos — não há contador em cache para se desviar.

Créditos, comissão e a razão (Pro)

Tudo o que um parceiro ganha ou gasta é registrado como um evento em uma razão somente-adição: nada é jamais excluído, e os saldos são somados ao vivo.

• Dois fundos. "Retail — commission" acumula em comissão; "Retail — credits" acumula em créditos. Cada fundo tem seu próprio saldo e seu próprio valor "In process".
• Período de retenção. Uma margem acumula como pendente e fica disponível "Margin hold" dias após o pedido ser pago.
• Reembolsos revertem, não excluem. Um reembolso lança um contra-registro; um saldo nunca fica abaixo de zero, e um restante não coberto aguarda como dívida até que nova margem o cubra.
• Minha conta → "Credits & commission" mostra os dois fundos lado a lado com "In process", o formulário de pagamento, o formulário de transferência e um "History" filtrável e paginado abrangendo os dois fundos.
• Transferências. Com os dois programas ligados, o parceiro pode mover dinheiro disponível entre os fundos em qualquer direção ("Commission → Credits", "Credits → Commission").
• Pagar com créditos. O gateway "Pay with credits (B2B)" liquida um pedido contra o saldo de créditos — uma compensação, não uma execução de pagamento, de modo que o faturamento segue normalmente. "Allow partial credit coverage" no separador "Settings" (uma caixa "Use credits" que aplica parte do saldo) vem desligada por padrão; deixe-a desligada a menos que o seu contabilista tenha confirmado como uma compensação parcial deve aparecer nas suas faturas.
• Pagamentos. O parceiro solicita o pagamento dos créditos disponíveis para o IBAN cadastrado, entre o "Minimum payout" e seu saldo. Você o aprova na aba "Credits"; um pagamento aprovado vira um documento numerado PO-YYYY-NNNN, que você depois marca com "Mark paid".

Protocolos de comissão (Pro)

Minha conta → "Commission statements" lista os documentos de comissão do parceiro. Você emite um protocolo na aba administrativa "Statements": ele reúne os lançamentos de comissão disponíveis e não vinculados do parceiro, compensa as reversões e numera o documento como PR-YYYY-NNNN a partir de seu próprio contador (nunca toca na numeração de faturas do Sell & Ship).

Um protocolo passa por rascunho → emitido → faturado → pago. Ele é baixado como HTML, PDF (onde houver um motor de PDF, por exemplo com o Rotozoom Warranty instalado) ou CSV. Para um protocolo emitido o parceiro vê o texto exato que sua própria fatura deve conter — a partir do modelo "Partner invoice text" na aba administrativa "Settings", com marcadores como {number}, {date}, {period}, {amount}, {currency}, {company}, {eik}, {vat}, {mol} — um botão "Copy text" e um formulário para devolver o "Invoice number" e o "Invoice file (PDF, JPG or PNG, up to 5 MB)". Os extratos e faturas enviadas são armazenados sob nomes de ficheiro impossíveis de adivinhar e só são disponibilizados através de um link de descarga protegido para o parceiro ou um gestor da loja.

Dicas de crédito (Pro)

Uma linha cinza, sem chamada para ação: "Credits: €100.00 · after this purchase: €92.00", ou "… short by €12.60". Ela aparece no catálogo, na página do produto e no carrinho — para um parceiro aprovado e autenticado em um site Pro com o programa de créditos ligado, e para mais ninguém (visitantes e clientes comuns não recebem marcação, nem folha de estilo, nem dados de script). O valor acompanha os seletores de quantidade e as mudanças de variação sem recarregar a página.

Notificações por e-mail (Pro)

Cinco eventos, cada um ativável por parceiro na linha "Email notifications" do painel do parceiro, e pelo parceiro em Minha conta → "Notifications":

1. "Parcel not delivered after N days" — o limiar é a configuração "Not delivered after" (padrão de 3 dias).
2. "Parcel delivered to your customer".
3. "Parcel returned to the shop".
4. "Commission or credits paid out" — um protocolo PR- ou um pagamento PO- marcado como pago.
5. "Balance above the threshold" — o "Balance threshold", enviado uma vez por cruzamento, rearmado quando o saldo cai novamente abaixo dele.

Os eventos de remessa vêm do Sell & Ship e cobrem Econt e Speedy; o BoxNow fica de fora porque seu rastreamento não retorna informações. Os e-mails usam seu modelo de e-mail do WooCommerce. Um interruptor desligado continua sendo registrado, então ligá-lo depois não reproduz o histórico.

Free vs Pro num relance

Recurso	Free	Pro
Papel de cliente B2B	✓	✓
Fluxo de registro e aprovação	✓	✓
Regra de desconto global	✓	✓
Catálogo de endereços de entrega (sem limite)	✓	✓
Dados da empresa bloqueados na finalização	✓	✓
Solicitações de alteração	✓	✓
Descontos por marca / categoria / atributo	—	✓
Modos de atendimento e painel de margem	—	✓
Pagamento diferido (em conta)	—	✓
Créditos e comissão: razão, protocolos, pagamentos, transferências	—	✓
Dicas de crédito nos produtos e no carrinho	—	✓
Notificações por e-mail	—	✓

Notas avançadas

• Onde os descontos se aplicam: os preços são ajustados durante o cálculo do carrinho (o ponto de extensão padrão e seguro do WooCommerce), então totais, impostos e registros do pedido refletem todos o preço comercial.
• Acúmulo: os descontos nunca se somam. Quando várias regras correspondem a um produto, aplica-se a percentagem mais alta, seja qual for o tipo de regra.
• O Sell & Ship é necessário para as partes de transportadora. O seletor de escritório/armário do catálogo de endereços e as notificações de entrega / devolução leem o Sell & Ship; é preciso a 1.9.2 ou posterior, também para os chips de endereço na finalização por blocos. Sem o Sell & Ship, My Account → "Delivery addresses" continua a funcionar como um formulário simples de endereço de rua, sem escritórios de transportadoras ou cacifos.
• O gating é aplicado no servidor, e não apenas no formulário. Por exemplo, um método de pagamento Pro enviado diretamente para a Store API num site Free é rejeitado e nenhum pedido é criado.
• Combinação com Conditions: combine com o gratuito Rotozoom Conditions para também alterar as opções de pagamento e envio para clientes comerciais por regras de carrinho.

Resolução de problemas

• Os descontos não se aplicam — confirme que o utilizador do comprador realmente tem o papel Cliente B2B e que existe pelo menos uma regra para esse parceiro e que está ativada.
• Um comprador vê preços de varejo e não comerciais — ele pode estar desconectado ou no papel errado; verifique Usuários.
• O parceiro não consegue fazer um pedido — provavelmente há uma solicitação de alteração pendente; aprove-a ou rejeite-a em "Change requests".
• Falta um modo de varejo na finalização — ele precisa estar ativado globalmente, ativado para o parceiro, e seu programa ("Commission program" / "Credits program") precisa estar ligado; os modos de varejo também exigem um endereço de entrega aplicado.
• Um escritório salvo aparece como "Unavailable" — o código do escritório não está mais na nomenclatura da transportadora; escolha o ponto novamente. Atualizar a nomenclatura do Sell & Ship restaura a lista.
• O "Deferred payment" não é oferecido — a exposição em aberto do parceiro mais este pedido excede seu "Credit limit", ou o método não está ativado para ele.
• O formulário de pagamento diz "between X and X" — o saldo de créditos disponível é igual ao pagamento mínimo; o valor precisa estar entre o mínimo e o saldo.
• Nenhum e-mail de notificação — as notificações são Pro, o evento precisa estar ligado, a transportadora precisa ser Econt ou Speedy, e a remessa precisa ter sido etiquetada depois de o recurso ser ativado.

Para ativar o Pro (iniciar sessão através do Rotozoom Connect), consulte Instalar e atualizar plugins.