Validação do ID Fiscal para Transações B2B
- Se um ID Fiscal válido for fornecido durante o checkout, a fatura incluirá:
- As deduções fiscais serão determinadas com base nas regulamentações aplicáveis ao país do cliente.
- A fatura incluirá os detalhes fiscais da Dodo Payments, juntamente com o imposto aplicado à transação.
Coletando um Nome Empresarial para Faturas B2B
Para compras B2B, você pode ter o nome empresarial legal do cliente na fatura em vez do nome pessoal do comprador. Isso é coletado juntamente com o ID Fiscal via o campo customer_business_name.
Quando o cliente seleciona Comprando como empresa no checkout, ele é solicitado a fornecer tanto um Nome Empresarial quanto um Número de ID Fiscal.
O nome empresarial aparece na fatura somente quando todas as três condições são atendidas:
- A transação é B2B (
b2b = true)
- Um
tax_id está presente
- Um
customer_business_name não vazio é fornecido
Se alguma condição não for atendida, o nome pessoal do cliente é usado em vez disso.
Configurando no checkout
Passe customer_business_name diretamente e/ou habilite allow_customer_editing_business_name para permitir que o cliente insira ou edite no checkout ao lado do ID Fiscal:
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
customer: { email: 'buyer@acme.com' },
tax_id: 'GB123456789',
customer_business_name: 'Acme Corp Ltd',
feature_flags: {
allow_tax_id: true,
allow_customer_editing_business_name: true // optional: let the customer edit it
},
return_url: 'https://yoursite.com/return'
});
| Superfície | Campo | Notas |
|---|
| Sessões de Checkout | customer_business_name, feature_flags.allow_customer_editing_business_name | Máx. 250 caracteres; o flag padrão é false |
| Pagamentos | customer_business_name | Máx. 250 caracteres |
| Assinaturas | customer_business_name | Definido ou limpo via PATCH /subscriptions/{id} |
customer_business_name não pode ser definido sem um tax_id — a solicitação é rejeitada. Limpar o tax_id também limpa o nome empresarial, pois os dois estão vinculados na fatura. Espaços em branco ao redor são removidos, e valores somente de espaços em branco são tratados como uma limpeza explícita.
Tratamento Fiscal para Transações B2C
- Transações onde um ID Fiscal válido não é fornecido serão tratadas como transações B2C, e o imposto será deduzido conforme as regulamentações fiscais aplicáveis no país do cliente.
- A fatura incluirá os detalhes fiscais do Dodo Payments, junto com o imposto aplicado à transação.
Mecanismo de Cobrança Reversa
Geralmente, o fornecedor de bens ou serviços é responsável por pagar o IVA/Imposto sobre Serviços/ICMS.
No entanto, em casos especificados como importações e outras fornecimentos notificados, a responsabilidade é do destinatário (cliente) sob o mecanismo de cobrança reversa. Cobrança Reversa significa que a obrigação de pagar o imposto é do destinatário do fornecimento de bens ou serviços, em vez do fornecedor desses bens ou serviços, em relação às categorias de fornecimento notificados.
Aplicabilidade da Cobrança Reversa
- Em certos casos, quando aplicável por lei, o imposto não será deduzido no checkout e a transação estará sujeita a um mecanismo de cobrança reversa.
- A fatura indicará claramente quando uma cobrança reversa se aplica, conforme as exigências regulamentares.
