Método	URL
	`https://BASE_URL/public/v1/recebiveis/lotes/{idOperacao}/titulos/avulsos`

Importa um ou mais títulos diretamente na operação informada, sem vínculo a um lote. Útil quando há a necessidade de registrar títulos sem que eles passem pelo fluxo de cessão em lote — por exemplo, para uma carga ou complementação na operação. Os títulos são criados em definitivo no cadastro do cedente após as validações de cedente, sacado e lastro. Em caso de sucesso, o retorno traz o identificador (id) da entidade título e os dados básicos de cada título criado.

Path Params¶

Campo	Tipo	Descrição
`idOperacao`	Número	Identificador da operação fornecido pela Vertrau.

Request Body

{
  "cedente": {
    "tipoPessoa": 2,
    "cpfCnpj": "12345678000199"
  },
  "titulos": [
    {
      "numeroControleParticipante": "0001",
      "numeroDocumento": "12345",
      "nossoNumero": "00012345",
      "dataEmissao": "2024-11-28",
      "dataVencimento": "2024-12-28",
      "valorNominal": 1000.5,
      "valorAquisicao": 900.78,
      "bancoCobranca": 123,
      "agenciaDepositaria": 4567,
      "especie": "DM",
      "jurosMoraDiaAtraso": 0.5,
      "valorAbatimento": 20,
      "tags": ["CC01", "RATING_A"],
      "sacado": {
        "tipoPessoa": 2,
        "cpfCnpj": "12345678000199",
        "nome": "Sacado I",
        "cep": "12345678",
        "endereco": "Rua dos Sacados, 1000",
        "cidade": "Blumenau",
        "uf": "SC",
        "email": "financeiro@sacado.com.br",
        "telefone": "47999990000",
        "numero": 1000,
        "bairro": "Centro",
        "complemento": "Sala 1"
      },
      "lastro": {
        "numeroNotaFiscal": 123456789,
        "numeroSerieNotaFiscal": 1,
        "chaveNfe": "12345678901234567890123456789012345678901234",
        "chaveAcessoNfe": "",
        "inscricaoMunicipal": "",
        "codigoMunicipioIBGE": "4202404",
        "dataEmissao": "2024-11-28",
        "valorTotal": 1000.5,
        "tipoLastroPerformado": "BP",
        "quantidadeParcelas": 1
      }
    }
  ]
}

Response Body — 200 OK

{
  "status": "sucesso",
  "mensagem": "1 título(s) importado(s) com sucesso.",
  "titulos": [
    {
      "id": 2001,
      "numeroControleParticipante": "0001",
      "numeroDocumento": "12345",
      "dataEmissao": "2024-11-28",
      "dataVencimento": "2024-12-28",
      "valorNominal": 1000.5,
      "valorAquisicao": 900.78,
      "bancoCobranca": 123,
      "agenciaCobranca": 4567,
      "especie": "Duplicata",
      "jurosMoraDiaAtraso": 0.5,
      "valorAbatimento": 20,
      "tags": ["CC01", "RATING_A"],
      "sacado": {
        "tipoPessoa": 2,
        "cpfCnpj": "12345678000199",
        "nome": "Sacado I",
        "cep": "12345678",
        "endereco": "Rua dos Sacados, 1000",
        "cidade": "Blumenau",
        "uf": "Santa Catarina (SC)",
        "email": "financeiro@sacado.com.br",
        "telefone": "47999990000",
        "numero": 1000,
        "bairro": "Centro",
        "complemento": "Sala 1"
      },
      "lastro": {
        "numeroNotaFiscal": 123456789,
        "numeroSerieNotaFiscal": 1,
        "chaveNfe": "12345678901234567890123456789012345678901234",
        "chaveAcessoNfe": "",
        "inscricaoMunicipal": "",
        "codigoMunicipioIBGE": "",
        "dataEmissao": "2024-11-28",
        "valorTotal": 1000.5,
        "tipoLastroPerformado": "Bens performado",
        "quantidadeParcelas": 1
      }
    }
  ]
}

Response Body — 400 Bad Request

{
  "status": "erro",
  "mensagem": "Erro ao importar títulos avulsos.",
  "titulos": [
    {
      "regra": "Título vencido. Operação não permite importação de títulos com data de vencimento anterior à data atual.",
      "quantidadeOcorrencia": 1,
      "numeroDocumento": "12345",
      "dataEmissao": "2024-11-28",
      "dataVencimento": "2024-10-28",
      "valorNominal": 1000.5,
      "especie": 1,
      "documentoSacado": "12345678000199"
    }
  ]
}

Modelo de dados¶

Requisição¶

Campo	Tipo	Descrição
`cedente`	Cedente	Dados do cedente proprietário dos títulos.
`titulos`	Lista de Título	Lista de títulos a serem importados na operação.

Cedente¶

Campo	Tipo	Descrição
`tipoPessoa`	Número	`1` = Pessoa Física, `2` = Pessoa Jurídica.
`cpfCnpj`	Texto	Documento do cedente, somente números. O cedente precisa estar previamente vinculado à operação informada.

Título¶

Campo	Tipo	Descrição
`numeroControleParticipante`	Texto	Número de controle do participante.
`numeroDocumento`	Texto	Número do documento.
`nossoNumero`	Texto	Nosso número do boleto. Campo opcional.
`dataEmissao`	Data	Data de emissão do título.
`dataVencimento`	Data	Data de vencimento do título.
`valorNominal`	Decimal	Valor original do título.
`valorAquisicao`	Decimal	Valor de aquisição do título.
`bancoCobranca`	Número	Código do banco responsável pela cobrança. Campo opcional.
`agenciaDepositaria`	Número	Agência depositária do banco de cobrança. Campo opcional.
`especie`	Texto ou Número	Espécie do título. Aceita o código em string ou numérico: `DM` ou `2` (Duplicata Mercantil), `UR` ou `3` (Unidade de Recebível), `CCB` ou `6` (CCB Pré Digital), `CTE` ou `13` (CT-e).
`jurosMoraDiaAtraso`	Decimal	Juros aplicados por dia de atraso.
`valorAbatimento`	Decimal	Valor de abatimento do título.
`tags`	Lista de texto	Tags associadas ao título.
`sacado`	Sacado	Dados do pagador.
`lastro`	Lastro	Dados do lastro do título. Obrigatório, exceto para as espécies `CCB` e `UR`.

Sacado¶

Campo	Tipo	Descrição
`tipoPessoa`	Número	`1` = Pessoa Física, `2` = Pessoa Jurídica.
`cpfCnpj`	Texto	Documento do sacado, somente números.
`nome`	Texto	Nome do sacado.
`cep`	Texto	CEP do endereço.
`endereco`	Texto	Endereço do sacado.
`cidade`	Texto	Cidade do sacado.
`uf`	Texto	Unidade federativa do sacado.
`email`	Texto	E-mail do sacado. Campo opcional.
`telefone`	Texto	Telefone do sacado. Campo opcional.
`numero`	Número	Número do endereço. Campo opcional.
`bairro`	Texto	Bairro. Campo opcional.
`complemento`	Texto	Complemento do endereço. Campo opcional.

Lastro¶

Campo	Tipo	Descrição
`numeroNotaFiscal`	Número	Número da nota fiscal. Campo opcional.
`numeroSerieNotaFiscal`	Número	Número de série da nota fiscal. Campo opcional.
`chaveNfe`	Texto	Chave da nota fiscal eletrônica.
`chaveAcessoNfe`	Texto	Chave de acesso da NF-e. Campo opcional.
`inscricaoMunicipal`	Texto	Inscrição municipal. Campo opcional.
`codigoMunicipioIBGE`	Texto	Código do município segundo o IBGE. Campo opcional.
`dataEmissao`	Data	Data de emissão da nota fiscal.
`valorTotal`	Decimal	Valor total da nota fiscal.
`tipoLastroPerformado`	Texto ou Número	Tipo do lastro performado. Aceita o código em string ou numérico: `SN` ou `0`, `SP` ou `1`, `BN` ou `2`, `BP` ou `3`, `MN` ou `4`, `MP` ou `5` (ver Adicionar Títulos na seção de Cessão de Direitos Creditórios).
`quantidadeParcelas`	Número	Quantidade de parcelas vinculadas ao lastro. Campo opcional.

Retorno¶

Em caso de sucesso (200), o retorno traz os títulos efetivamente criados — cada um com o identificador da entidade título (id) e os dados básicos. Em caso de erro de validação (400), o campo titulos traz a lista de títulos rejeitados.

Sucesso (200 OK)¶

Campo	Tipo	Descrição
`status`	Texto	Status do processamento (`sucesso`).
`mensagem`	Texto	Mensagem retornada pela API.
`titulos`	Lista de Título criado	Títulos criados na operação.

Título criado¶

Campo	Tipo	Descrição
`id`	Número	Identificador da entidade título criada. Utilize-o nas operações subsequentes (ex.: exclusão — ver Excluir Títulos Avulsos).
`numeroControleParticipante`	Texto	Número de controle do participante.
`numeroDocumento`	Texto	Número do documento.
`dataEmissao`	Data	Data de emissão do título.
`dataVencimento`	Data	Data de vencimento do título.
`valorNominal`	Decimal	Valor nominal do título.
`valorAquisicao`	Decimal	Valor de aquisição do título.
`bancoCobranca`	Número	Código do banco de cobrança.
`agenciaCobranca`	Número	Agência de cobrança.
`especie`	Texto	Descrição da espécie do título (ex.: `Duplicata`, `UR`, `CCB Pré Digital`).
`jurosMoraDiaAtraso`	Decimal	Juros aplicados por dia de atraso.
`valorAbatimento`	Decimal	Valor de abatimento do título.
`tags`	Lista de texto	Tags associadas ao título.
`sacado`	Objeto	Dados do pagador. Mesmos campos do Sacado da requisição; no retorno, `uf` é devolvido por extenso (ex.: `Santa Catarina (SC)`).
`lastro`	Objeto	Dados do lastro, quando houver. Mesmos campos do Lastro da requisição; no retorno, `tipoLastroPerformado` é devolvido por extenso (ex.: `Bens performado`).

Erro de validação (400 Bad Request)¶

Campo	Tipo	Descrição
`status`	Texto	Status do processamento (`erro`).
`mensagem`	Texto	Mensagem de erro retornada pela API.
`titulos`	Lista de Título inválido	Lista preenchida quando houver inconsistências por título.

Título inválido¶

Campo	Tipo	Descrição
`regra`	Texto	Regra de validação que rejeitou o título.
`quantidadeOcorrencia`	Número	Quantidade de ocorrências da regra.
`numeroDocumento`	Texto	Número do documento rejeitado.
`dataEmissao`	Data	Data de emissão informada.
`dataVencimento`	Data	Data de vencimento informada.
`valorNominal`	Decimal	Valor nominal informado.
`especie`	Número	Código da espécie do título.
`documentoSacado`	Texto	Documento do sacado informado.

Observações¶

Sem lote: este endpoint não cria lote nem vincula os títulos a um lote existente. Para o fluxo tradicional de cessão em lote, utilize Criar Lote seguido de Adicionar Títulos.
Operação inexistente: se a operação informada na rota (idOperacao) não existir, a importação é rejeitada com 400 Bad Request e a mensagem Operação com ID {idOperacao} não encontrada., antes de qualquer gravação. Confirme que o idOperacao é o identificador fornecido pela Vertrau.
Cedente: o cedente informado precisa estar previamente vinculado à operação. Caso contrário, a importação é rejeitada.
Cedente inativo: se o cedente (resolvido pelo cpfCnpj) estiver inativo, a importação é rejeitada com 400 Bad Request e a mensagem Cedente {cpfCnpj} está inativo e não pode receber novos títulos., antes de qualquer gravação. Títulos e lotes já em andamento não são afetados; basta reativar o cedente para voltar a importar novos títulos.
Validações de título: as mesmas regras de validação aplicadas no fluxo de adição em lote (cedente, sacado, lastro, espécie, datas, valores) são executadas aqui. Erros específicos por título retornam na lista titulos do response.