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#
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#
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".Modified at 2023-04-14 12:10:49
