Envio de título

post

https://api.connect.staging.libercapital.com.br/v1/{program}/buyers/{document_number}/invoices

Insere um novo título a ser pago pelo Sacado, a fim de que possa ser ofertado para antecipação. O documento fiscal, se existir, é inserido conjuntamente ao título.

Assincronicidade entre resposta do serviço e inserção na plataforma Liber

Essa operação é realizada de maneira assícrona. A resposta de sucesso à requisição POST indica que os dados enviados são considerados bem-formados, porém validações sobre esses dados podem considerá-los inválidos. Por exemplo, o fornecedor indicado pode não estar devidamente cadastrado na plataforma Liber, impedindo a inserção do título. Recomenda-se ao sacado que realize um polling* do título alguns segundos após a operação de inserção, de modo a verificar seu sucesso e recuperar possíveis erros nos dados.

Envios de títulos bloqueados à antecipação

O título, se inserido com sucesso, estará disponível para antecipação pelo fornecedor.

Caso o sacado deseje enviar um título mas não queira que esse título esteja livre para ser antecipado até que seja realizada uma liberação posterior, é possível enviar o título para ser imediatamente bloqueado na plataforma Liber. Para isso, durante o envio do título devem ser preenchidos os campos status e block. Nesse sentido, o campo status deve possuir o valor BLOCKED e o campo block deve apresentar o campo reason que haverá, dentro dele, OTHER para o campo code, e uma descrição textual no campo message para o motivo do bloqueio para o operador do sacado na plataforma.

Path Params

program

string

required

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

document_number

string

required

Raiz (8 primeiros dígitos) do documento (CNPJ) do Sacado cadastrado na plataforma para o qual se deseja inserir o título a ser ofertado para antecipação. Somente os caracteres numéricos.

Body Params

reference_id

string

required

length ≤ 100

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 (-).

status

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:

workflow

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:

number

string

required

length ≤ 100

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

batch_id

string

length ≤ 100

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

type

string

enum

required

Tipo do título. Valores aceitos:

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

Allowed:

due_date

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

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 o programa e a identificação do sacado no URL do recurso.

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

400O corpo da requisição não está em conformidade do schema JSON esperado.

409Ocorreu um conflito entre os dados enviados pelo cliente e os dados já presentes no Liber Connect. Verifique o código de erro retornado no corpo da resposta para maiores detalhes sobre esse erro.