---
title: 8.1. Importar Títulos Avulsos
url: https://docs.vehub.com.br/API/Integra%C3%A7%C3%A3o%20FIDC/8.%20Importa%C3%A7%C3%A3o%20de%20T%C3%ADtulos%20Avulsos/8.1.%20Importar%20T%C3%ADtulos%20Avulsos/
---
| Método | URL |
|--------|-----|
| ![POST](https://img.shields.io/badge/POST-green) | `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. |

```` json title="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,
      "valorDesconto": 15.5,
      "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
      }
    }
  ]
}
````

```` json title="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,
      "valorDesconto": 15.5,
      "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
      }
    }
  ]
}
````

```` json title="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](#cedente) | Dados do cedente proprietário dos títulos. |
| `titulos` | Lista de [Título](#titulo) | 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 a **sigla** ou o **código numérico**. Ver [Espécies de título](#especies-de-titulo). |
| `jurosMoraDiaAtraso` | Decimal | Juros aplicados por dia de atraso. |
| `valorAbatimento` | Decimal | Valor de abatimento do título. |
| `valorDesconto` | Decimal | Valor de desconto concedido no título. Campo opcional; quando omitido, o título é gravado sem desconto. Não pode ser negativo nem superior ao `valorNominal`. |
| `tags` | Lista de texto | Tags associadas ao título. |
| `sacado` | [Sacado](#sacado) | Dados do pagador. |
| `lastro` | [Lastro](#lastro) | Dados do lastro do título. Obrigatório, exceto para as espécies `CCB` e `UR`. |

### Espécies de título

Informe a **sigla** ou o **código numérico** no campo `especie`. Ambas as formas são aceitas.

| Sigla  | Código numérico | Espécie |
|--------|-----------------|---------|
| `DM`   | `2`  | Duplicata Mercantil |
| `UR`   | `3`  | Unidade de Recebível |
| `NFSE` | `4`  | Nota Fiscal de Serviço |
| `ND`   | `5`  | Nota de Débito |
| `CCB`  | `6`  | CCB Pré Digital |
| `NP`   | `8`  | Nota Promissória |
| `NC`   | `9`  | Nota Comercial |
| `CT`   | `10` | Contrato |
| `NF`   | `11` | Nota Fiscal |
| `CPR`  | `12` | Cédula de Produto Rural |
| `CTE`  | `13` | CT-e |
| `CD`   | `14` | Confissão de Dívida |
| `AD`   | `15` | Assunção de Dívida |
| `FCC`  | `16` | Fatura de Cartão de Crédito |
| `BAP`  | `17` | Bloqueio Agenda Pagamento Cartão |

> **Espécies de cartão**: `FCC` e `BAP` cobrem os recebíveis de cartão que chegam pelo arquivo de estoque diário — respectivamente a fatura de cartão de crédito e o bloqueio de agenda de pagamento com baixa automática. Como qualquer espécie fora de `CCB` e `UR`, ambas exigem o objeto `lastro`.

### 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](#titulo-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. |
| `valorDesconto` | Decimal | Valor de desconto concedido no título. |
| `tags` | Lista de texto | Tags associadas ao título. |
| `sacado` | Objeto | Dados do pagador. Mesmos campos do [Sacado](#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](#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](#titulo-invalido) | 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](../2.%20Cess%C3%A3o%20de%20Direitos%20Credit%C3%B3rios/2.1.%20Criar%20Lote.md) seguido de [Adicionar Títulos](../2.%20Cess%C3%A3o%20de%20Direitos%20Credit%C3%B3rios/2.2.%20Adicionar%20T%C3%ADtulos.md).
- **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.