Oferta

Permite a criação de uma nova oferta/agenda de antecipação, associando recebíveis a um valor disponibilizado para negociação.

📌 Endpoint

• Método: POST
• Endpoint: /offers

Após a criação, a oferta será registrada com um ID único, que poderá ser utilizado para acompanhamento e gestão da negociação.

Permite o download dos recebíveis associados a uma oferta/agenda, retornando um arquivo referente a essa solicitação.

📌 Endpoint

• Método: GET
• Endpoint: /offers/{id}/download-receivable

O ID da oferta/agenda deve ser informado para que o arquivo correspondente seja recuperado e disponibilizado.

Realiza o cálculo das margens de uma oferta com base na porcentagem e ID dos recebíveis, permitindo que o usuário avalie o impacto financeiro e opções disponíveis da antecipação antes da finalização da operação.

📌 Endpoint

• Método: POST
• Endpoint: /offers/percentage

Esse método fornece informações essenciais para tomada de decisão, garantindo que os valores negociados estejam dentro das margens esperadas.

Permite consultar as ofertas cadastradas na plataforma utilizando filtros específicos. Esse método possibilita recuperar ofertas com base em atributos como valor, status, datas e empresas envolvidas na operação.

📌 Endpoint

• Método: GET
• Endpoint: /offers

A consulta pode ser filtrada por diversos parâmetros, como:

• bandeira do cartão
• moeda da oferta
• valor da oferta
• valor total dos recebíveis
• ID do adquirente
• ID do investidor
• status da oferta
• data de criação
• data de expiração

Esse método é útil para listar ofertas de forma segmentada, acompanhar o status das operações ou filtrar por critérios específicos de negócio.

Permite recuperar os detalhes de uma oferta específica utilizando seu identificador único. Esse método retorna todas as informações associadas à oferta, incluindo valores, status, empresas envolvidas e dados dos recebíveis vinculados.

📌 Endpoint

• Método: GET
• Endpoint: /offers/{id}

Para utilizar este método, é necessário informar o ID da oferta que se deseja consultar. Essa funcionalidade é útil para visualizar informações completas de uma oferta específica antes de prosseguir com etapas como proposta ou formalização.

Permite cancelar uma oferta existente de forma simples, informando apenas o identificador da oferta. Uma vez cancelada, a oferta deixa de estar disponível para receber propostas.

📌 Endpoint

• Método: PUT
• Endpoint: /offers/{id}/cancel

Para realizar o cancelamento, é necessário informar o ID da oferta que se deseja cancelar. Este método é útil quando a oferta ainda não foi formalizada ou negociada e o cancelamento é necessário por motivos operacionais ou estratégicos.

Status