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.