Docs Entrar na plataforma

Pré-autorizações

Como funcionam as pré-autorizações

Uma pré-autorização é a sua empresa dizendo ao fornecedor: esta nota pode ser antecipada. O que acontece depois chega por webhook.

Quem é quem

PapelNa APIO que faz
Construtora (tomadora) payer A sua empresa. Na criação, é a matriz dona da chave; na consulta, é a empresa da nota, que pode ser uma filial. Cria a pré-autorização e paga o boleto no vencimento.
Fornecedor (cedente) supplier Quem emitiu a nota. Recebe a oferta e decide se antecipa.
Oneos — Analisa, paga o fornecedor e emite o boleto para a construtora.

Ciclo de vida

Cada seta é um webhook. O status que você recebe é sempre o de depois do evento:

  1. pre_authorization.created IN_PRE_AUTH Pré-autorizada aguarda o fornecedor
  2. anticipation.requested TO_APPROVE Solicitada aguarda a sua aprovação
  3. anticipation.approved IN_ANALYSIS Em análise análise da Oneos
  4. anticipation.analysis_approved TO_PAY A pagar pagamento ao fornecedor
  5. anticipation.paid TO_BILL Paga emissão do boleto
  6. anticipation.billed TO_RECEIVE A receber boleto da construtora
  7. anticipation.concluded CONCLUDED Concluída ciclo encerrado
REPROVED encerra a operação em qualquer etapa até a análise pre_authorization.declined fornecedor recusou · pre_authorization.revoked você cancelou · pre_authorization.expired prazo acabou · anticipation.reproved reprovada na aprovação ou na análise

Quando o fornecedor ainda não usa a Oneos

Se o CNPJ não está na plataforma, envie supplier.name e supplier.contactName: a Oneos cria o cadastro e manda um convite ao fornecedor. Quem já tem conta recebe o aviso da oferta direto.

Solicitação e aprovação

Quando o fornecedor pede a antecipação, a operação vai para TO_APPROVE e espera a aprovação da sua empresa na plataforma. Pré-autorizações criadas pela API não nascem pré-aprovadas.

Expiração

A pré-autorização tem prazo para o fornecedor solicitar, informado em expiresAt. Passou do prazo sem solicitação, ela expira sozinha (REPROVED, evento pre_authorization.expired).

expiresAt = o menor entre (primeira data útil + N dias) e (vencimento − 5 dias), às 23:59:59 de Brasília
  • Primeira data útil: hoje, ou o próximo dia útil se a criação for depois das 14h ou em dia não útil.
  • N: o prazo configurado pela sua empresa na plataforma; quando não há configuração, 3 dias.

A expiração é verificada algumas vezes por hora — o evento pode chegar alguns minutos depois do horário exato.

Cancelar

Enquanto o fornecedor não solicitou, você pode cancelar. Depois da solicitação, a decisão acontece na aprovação, dentro da plataforma.

Esc