Criar provedor do mecanismo de taxa e mecanismo de taxa

Criar um provedor de mecanismo de taxa

Crie um provedor de mecanismo de taxa para armazenar informações sobre a classe do adaptador do Apex que gerencia a comunicação com o mecanismo de taxa.

1. No Iniciador de aplicativos, localize e selecione Fornecedores de mecanismos fiscais.
2. Clique em Novo.
3. Insira um rótulo e um nome de API para o provedor do mecanismo fiscal.
4. Selecione o ID do adaptador do Apex que você deseja que o provedor do mecanismo fiscal use.

   Se quiser calcular o imposto padrão ou usar seu próprio mecanismo de imposto, selecione o adaptador de imposto personalizado que você configurou.

   

   Nota Selecione um adaptador Apex exclusivo para cada provedor de mecanismo de taxa.
5. Se você tiver chamadas de taxa estendidas, insira o nome da API do tipo de metadados personalizados criado.
6. Salve suas alterações.

Criar um mecanismo de taxa

Armazene uma instância do provedor do mecanismo de taxa no Salesforce usando credenciais nomeadas e os detalhes do provedor. O registro do Mecanismo de taxa contém informações que são passadas para o mecanismo de taxa.

1. No Iniciador de aplicativos, localize e selecione Motores fiscais.
2. Clique em Novo.
3. Insira um nome para o mecanismo de taxa.
4. Selecione o provedor do mecanismo fiscal.
5. Selecione a credencial nomeada que você criou para autenticar o mecanismo de taxa.
   Uma credencial nomeada não é usada ao calcular a taxa padrão. No entanto, selecione a credencial nomeada que você configurou, pois esse é um campo obrigatório.
6. Insira o código do vendedor do provedor fiscal.
7. Selecione o status como Ativo.
   Você pode usar apenas mecanismos fiscais ativos para calcular impostos.
8. Insira o endereço do provedor fiscal.
9. Para capturar impostos no nível do cabeçalho, selecione Capturar impostos no cabeçalho.
   A caixa de seleção Capturar impostos no cabeçalho aparece apenas quando o nível de solicitação de crédito e pagamento é Fatura.
10. Salve suas alterações.

Totais de impostos nos níveis de linha e cabeçalho

Entenda como o Billing aplica valores de imposto no nível da linha e no nível do cabeçalho durante o cálculo do saldo.

Quando a opção Capturar impostos no nível do cabeçalho estiver ativada:

• O Billing armazena o valor do imposto consolidado retornado pelo seu mecanismo de imposto no campo Total de impostos capturados no cabeçalho em faturas e avisos de crédito.
• Os cálculos do saldo da fatura usam o valor do imposto do cabeçalho em vez da soma dos impostos no nível da linha.
• O Billing retém os detalhes de imposto no nível da linha como um total agregado de todas as linhas de fatura para relatório ou reconciliação quando fornecido pelo adaptador de imposto.
• Para avisos de crédito criados a partir de faturas com base no imposto do cabeçalho, o aviso de crédito registra o valor do imposto do cabeçalho correspondente. O campo Total de impostos capturados no cabeçalho armazena o valor do imposto retornado para o cálculo do aviso de crédito.

O Billing aplica a taxa no nível da linha em vez da taxa no nível do cabeçalho nestas situações:

• O montante do imposto do cabeçalho é nulo ou ausente.
• O mecanismo de taxa falha ao retornar um valor de imposto de cabeçalho.
• A fatura é criada antes da ativação do imposto do cabeçalho.
• O nível de solicitação de crédito e pagamento é alterado de Fatura para Linha de fatura após a criação da fatura.
• Os usuários editam manualmente os valores de impostos enquanto a fatura está no status de rascunho.
• Um tempo limite do mecanismo de taxa ocorre durante o cálculo do imposto do cabeçalho.
• Um problema de conectividade de rede interrompe chamadas de serviço de taxa.
• A conversão de moeda falha para o valor do imposto do cabeçalho.
• Erros de cálculo da taxa de câmbio afetam o valor do imposto do cabeçalho.
• O formato de imposto do cabeçalho na solicitação de API é inválido.
• Um problema de compatibilidade de versão da API impede o processamento de taxa do cabeçalho.