API Reference

Atualização de título

put
https://api.connect.staging.libercapital.com.br/v1//buyers//invoices/

Atualiza os dados de um título usando seu identificador único na Liber Connect. Essa atualização só pode ser realizada se o título estiver no estado BLOCKED.
Os únicos campos que podem ser diferentes do item original são: face_value, due_date e appointed_funder.
Assim que o titulo for atualizado na Plataforma Liber Capital, ele será desbloqueado.

Path Params
string
required

Código do programa Liber Capital no qual se deseja realizar a operação.

string
required
^[0-9A-Z]{8}$

Raiz (8 primeiros caracteres) do documento (CNPJ) do Sacado cadastrado na plataforma, sob o qual o título a ser ofertado para antecipação foi inserido.
Somente caracteres alfanuméricos.

string
required
length ≤ 100
^[\d\w~_.-]+$

Identificador único do título no sistema do cliente. Usado para identificar envio de títulos duplicados.
Aceita caracteres alfabéticos, dígitos e os caracteres especiais ponto (.), til (~), underscore (_) e hífem (-). Barras (/) não são permitidas para esse identificador.

Body Params

Documento que representa um acordo para realização de determinado pagamento. O valor de face do título deve ser indicado no campo face_value.
Quando o título será pago por uma dada filial, o campo payer deverá ser informado.
Quando o Sacado possui um acordo com um dado investidor para a compra do título, esse financiador pode ser indicado no campo funder.

string
required
length ≤ 100
^[\d\w~_.-]+$

Identificador único do título no sistema do cliente. Usado para identificar envio de títulos duplicados.
Aceita caracteres alfabéticos, dígitos e os caracteres especiais ponto (.), til (~), underscore (_) e hífem (-).

string | null
enum
Defaults to null

Caso nulo ou não indicado, título deve ser inserido e disponibilizado para antecipação.
Caso com valor BLOCKED, título deve ser inserido e imediatamente bloqueado de modo a não ser antecipado até que seja desbloqueado. Nesse caso deve-se informar também o campo block.

Allowed:
string
enum
Defaults to DIRECTED

Fluxo de trabalho para o título na Liber Capital.
Valores possíveis são:

  • DIRECTED: Fluxo direcionado (valor padrão).
    O título é apresentado para um investidor segundo as regras abaixo:

    • Se o campo appointed_funder estiver preenchido, o título é automaticamente apresentado (apenas) para o investidor especificado;
    • Se o campo appointed_funder não estiver preenchido, o time de back office da Liber Capital irá buscar ativamente um investidor para este título.

  • AUCTIONED: Fluxo de leilão.
    O título é apresentado para vários investidores e a Plataforma Liber Capital irá encontrar qual dos investidores oferece menor taxa ao fornecedor.

    O campo appointed_funder NÃO deve ser enviado ao utilizar o fluxo de leilão.

  • SUPPLIER_GROUP_DEFAULT: Fluxo via regra da plataforma.
    O título seguirá o fluxo determinado pela configuração de grupo de fornecedor da plataforma.

    Caso o fornecedor não tenha feito a configuração prévia na plataforma, a negociação seguirá o Fluxo de leilão (AUCTIONED).

    O campo appointed_funder NÃO deve ser enviado ao utilizar o fluxo SUPPLIER_GROUP_DEFAULT.

Allowed:
string
required
length ≤ 100

Número do título, incluindo parcela (se for o caso). Pode conter pontuação.

string
length ≤ 100

Identificador do agrupamento de títulos ao qual este título faz parte.
Para uso interno do cliente.

string
enum
required

Tipo do título.
Valores aceitos:

  • MERCANTILE: Duplicata mercantil;
  • SERVICE: Duplicata de serviços;
  • TRANSPORT: Conhecimento de transporte eletrônico.
Allowed:
date
required

Data do vencimento do título.

Notação full-date como definida pela RFC 3339.
Exemplo: 2021-12-31

face_value
object
required

Um valor em uma dada moeda.

supplier
object
required

Fornecedor dos bens ou serviços.

payer
object
required

Sacado destinatário da cobrança. Pode ser o sacado matriz do programa ou uma filial.

appointed_funder
object

Financiador da antecipação do título.

fiscal_document
required

Documento fiscal que dá lastro a um título.

block
object

Motivo de bloqueio de um título.

Responses
202

A requisição foi aceita e será processada posteriormente.
A alteração no título será ainda validada antes de estar disponível na plataforma Liber Capital.

401

Não foi enviado o cabeçalho de autorização ou este cabeçalho contém um token inválido/expirado.

403

O cliente está tentando realizar uma operação que não possui permissões.
Verifique a identificação do sacado na URL do recurso.

404

O item requisitado não foi encontrado.

Updated 2 months ago

Did this page help you?
Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago

Did this page help you?