Aplicação do Spread
O que é o Spread?
A funcionalidade de Spread permite que o tenant aplique uma taxa adicional à taxa de antecipação de recebíveis da Celcoin, possibilitando a definição de condições comerciais personalizadas para suas subcontas.
A taxa de spread é informada diretamente pelo tenant no momento da simulação da antecipação, por meio do campo opcional score.
Quando informado, o spread é considerado no cálculo do custo total da antecipação, juntamente com a taxa praticada pela Celcoin.
1. Consulta de recebíveis disponíveis para antecipação
A consulta dos recebíveis disponíveis para antecipação permanece inalterada.
Não é necessário informar o spread nessa etapa. O tenant deverá continuar utilizando o fluxo de consulta já existente para identificar os recebíveis elegíveis à antecipação.
Para mais informações, consulte a documentação de Antecipação Pontual de Recebíveis.
2. Simulação da antecipação com Spread
Para aplicar o spread, utilize o endpoint de simulação de antecipação de recebíveis, incluindo o campo opcional score no corpo da requisição.
Endpoint Simular Antecipação de Recebíveis
Novo parâmetro da requisição
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
score | integer | Não | Percentual de spread que o tenant deseja aplicar à antecipação, informado em centésimos de ponto percentual. |
Como informar a taxa
O campo score utiliza um valor numérico inteiro para representar o percentual de spread.
Valor enviado (score) | Spread aplicado |
|---|---|
3 | 0,03% |
30 | 0,30% |
100 | 1,00% |
150 | 1,50% |
300 | 3,00% |
Exemplo de utilização
{
"score": 30
}O exemplo apresenta apenas o novo campo. Os demais parâmetros obrigatórios da simulação devem ser mantidos conforme a documentação do endpoint.
Nesse cenário, será aplicado um spread de 0,30%, adicional à taxa de antecipação da Celcoin.
Utilização sem spread: Caso o tenant não deseje aplicar uma taxa adicional, basta não enviar o campo
score. Nesse cenário, a simulação considerará somente a taxa de antecipação da Celcoin.
3. Retorno da simulação
A resposta da simulação apresenta separadamente os componentes utilizados no cálculo da antecipação.
| Campo | Descrição |
|---|---|
taxAntecipation | Percentual da taxa de antecipação praticada pela Celcoin. |
totalTaxAntecipation | Valor monetário correspondente à taxa de antecipação da Celcoin. |
spreadPercent | Percentual de spread aplicado conforme o valor informado em score. |
spreadValue | Valor monetário correspondente à taxa adicional de spread. |
Esses campos permitem que o tenant identifique os componentes da operação e calcule os valores totais que deverão ser apresentados ao usuário final.
4. Apresentação das taxas ao usuário final
Ao disponibilizar a funcionalidade de antecipação de recebíveis em sua interface, o tenant deverá apresentar ao usuário final a taxa total de antecipação e o valor monetário total das taxas, considerando obrigatoriamente a soma da taxa Celcoin com o spread aplicado.
Os valores não deverão ser apresentados de forma individualizada ao usuário final.
Cálculo do percentual total
Taxa total (%) = taxAntecipation + spreadPercent
Exemplo:
- Taxa Celcoin: 1,50%
- Spread: 0,30%
- Taxa total apresentada: 1,80%
Cálculo do valor total das taxas
Valor total das taxas (R$) = totalTaxAntecipation + spreadValue
Exemplo:
- Taxa Celcoin: R$ 15,00
- Spread: R$ 3,00
- Valor total apresentado: R$ 18,00
Regra obrigatória de apresentação
O tenant deverá garantir que sua interface apresente o custo total da antecipação de forma consolidada, contemplando tanto a taxa de antecipação da Celcoin quanto o spread aplicado.
Não é permitido apresentar exclusivamente a taxa da Celcoin, exclusivamente o spread ou discriminar esses componentes separadamente na interface destinada ao usuário final.
5. Efetivação da antecipação
O processo de efetivação da antecipação permanece inalterado.
Após realizar a simulação, o tenant deverá utilizar o identificador idRequest para efetivar a operação, seguindo o fluxo já documentado.
Endpoint Efetivar Antecipação de Recebíveis
Não é necessário informar novamente o campo score na efetivação, pois as condições da antecipação já foram consideradas na simulação correspondente.
6. Liquidação e repasse do Spread
Na liquidação dos recebíveis antecipados, serão consideradas as taxas de antecipação da Celcoin e, quando aplicável, a taxa adicional de spread informada pelo tenant.
O valor correspondente ao spread será repassado à conta do tenant, conforme o fluxo financeiro da operação.
Caso a antecipação tenha sido realizada sem spread, será considerada somente a taxa de antecipação da Celcoin.
A utilização do spread não altera as etapas de consulta, efetivação ou os demais procedimentos operacionais da antecipação de recebíveis.
Updated 1 minute ago