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

CampoTipoObrigatórioDescrição
scoreintegerNãoPercentual 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
30,03%
300,30%
1001,00%
1501,50%
3003,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.

CampoDescrição
taxAntecipationPercentual da taxa de antecipação praticada pela Celcoin.
totalTaxAntecipationValor monetário correspondente à taxa de antecipação da Celcoin.
spreadPercentPercentual de spread aplicado conforme o valor informado em score.
spreadValueValor 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.


Did this page help you?