Entendendo a Pré-Autorização

Introdução

A funcionalidade Pré-Autorizações permite que a construtora envie os dados de medição e faturamento a seus fornecedores que estarão pré-autorizados a solicitar a antecipação do recebível em questão.

A Pré-Autorização via integração é criada após a aprovação da medição em seu ERP, garantindo que os fornecedores não solicitarão antecipações indevidas, seja para tomador da nota fiscal incorreto ou referente a serviços não executados.

Status de Pré-Autorizações

As pré-autorizações na ONE possuem os seguintes status:

• AUTOMATICALLY_REVOKED;
• WAITING_CONTRACTED;
• ANTICIPATION_REQUESTED
• EXPIRED;
• REVOKED.

AUTOMATICALLY_REVOKED

Revogada Automaticamente é o status que indica que a pré-autorização apesar de criada, não poderá ser utilizada. Há dois principais motivos para que uma pré-autorização seja revogada automaticamente: quando a construtora insere o fornecedor em sua blacklist, impedindo que este faça antecipações; quando algum parâmetro está com formato ou valor incorreto.

WAITING_CONTRACTED

Aguardando Fornecedor é o status que informa que todos os parâmetros e validações tiveram êxito e que o fornecedor está apto a antecipar este recebível, se desejar. O fornecedor receberá esta pré-autorização em sua conta para prosseguir com a solicitação.

ANTICIPATION_REQUESTED

Antecipação Solicitada se refere ao momento em que o fornecedor finaliza a solicitação. A partir desse momento, a solicitação seguirá o fluxo de aprovação definido pela construtora na plataforma ONE.

EXPIRED

No menu Pré-Autorização na página de configurações, a construtora seleciona o prazo em dias que uma pré-autorização ficará disponível para solicitação pelo fornecedor. Ao fim deste prazo, a pré-autorização é expirada.

REVOKED

Caso deseje, a construtora pode cancelar uma pré-autorização cujo status seja WAITING_CONTRACTED, tornando-a revogada.

Criando Pré-Autorizações

Após autenticar-se na plataforma será possível utilizar esta funcionalidade. Saiba mais no tópico Criando uma Pré-Autorização.

Resposta de Sucesso

Com o código de retorno Http 201 - a API apresentará em seu body os dados da pré-autorização, bem como seu status WAITING_CONTRACTED.

Resposta de Falha

Com o código de retorno Http 400 - a API apresentará em seu body os dados da pré-autorização, bem como seu status AUTOMATICALLY_REVOKED e detalhes da falha no campo "revocationReason".