--- title: 9.4. Consultar Títulos sem NF e url: https://docs.vehub.com.br/API/Integra%C3%A7%C3%A3o%20FIDC/9.%20Lastros%20Avulsos/9.4.%20Consultar%20T%C3%ADtulos%20sem%20NF-e/ --- | Método | URL | | --------------------------------------------- | ---------------------------------------------------------------------------------------- | | ![GET](https://img.shields.io/badge/GET-blue) | `https://BASE_URL/public/v1/recebiveis/lotes/{idOperacao}/lastros/avulsos/nfe/sem-chave` | Lista os títulos da operação cuja NF-e ainda falta. Entra na lista o título: - **sem lastro**; ou - com lastro **sem chave de acesso** e **sem nenhum arquivo** anexado ao lastro. Caso típico: remessas importadas do banco (CNAB), que não trazem a chave da nota. Um lastro sem chave, mas que já tem um documento anexado (por exemplo, uma NFS-e ou um contrato), não aparece. Use este endpoint para localizar os títulos pendentes e então enviar os XMLs via [Anexar Lastros Avulsos](9.1.%20Anexar%20Lastros%20Avulsos.md). !!! tip "Uma linha por parcela" Uma nota com `N` parcelas aparece `N` vezes na resposta — uma entrada por título. Use `idEmpresa` para filtrar um cedente específico quando a operação tiver vários cedentes. ## Path Params | Campo | Tipo | Descrição | | ----------- | ------ | ---------------------------------------------------- | | `idOperacao` | Número | Identificador da operação, fornecido pela VeHub. | ## Query Params Aceita os mesmos filtros de paginação e busca de `GET /recebiveis/titulos`. Os mais usados: | Campo | Tipo | Obrigatório | Descrição | | ------------------- | ------ | ----------- | ----------------------------------------------------- | | `idEmpresa` | Número | Não | Filtra por cedente específico. | | `dataEmissaoInicio` | Data | Não | Data de emissão mínima (`YYYY-MM-DD`). | | `dataEmissaoFim` | Data | Não | Data de emissão máxima (`YYYY-MM-DD`). | | `indicePagina` | Número | Não | Página solicitada (padrão: `1`, máximo: `100000`). | | `tamanhoDaPagina` | Número | Não | Registros por página (padrão: `20`, máximo: `9000`). | Valores de `indicePagina` ou `tamanhoDaPagina` fora desses limites são recusados com `400 Bad Request`, no formato `ProblemDetails`. ## Response Body A resposta é paginada, no mesmo formato de [Consultar Título no Estoque](../4.%20Consultas/4.3%20Consultar%20T%C3%ADtulo%20no%20Estoque.md): os títulos vêm em `registros` e os dados da paginação em `paginacao`. A ordem é estável entre as páginas. ```json title="Response Body — 200 OK" { "registros": [ { "id": 10501, "idEmpresa": 42, "cnpjCedente": "11222333000181", "cpfCnpjSacado": "98765432100", "dataEmissao": "2026-09-15", "numeroNota": 1001, "numeroDocumento": "1001/01" }, { "id": 10502, "idEmpresa": 42, "cnpjCedente": "11222333000181", "cpfCnpjSacado": "98765432100", "dataEmissao": "2026-09-15", "numeroNota": 1001, "numeroDocumento": "1001/02" }, { "id": 10503, "idEmpresa": 55, "cnpjCedente": "99888777000166", "cpfCnpjSacado": "12345678901", "dataEmissao": "2026-09-20", "numeroNota": null, "numeroDocumento": "SEM-NOTA/01" } ], "paginacao": { "paginaAtual": 1, "paginaTotal": 1, "paginaQuantidadeRegistro": 20, "quantidadeRegistros": 3, "temPaginaAnterior": false, "temProximaPagina": false }, "mensagem": null } ``` | Campo | Tipo | Descrição | | ----------- | -------------------------------------- | ---------------------------------- | | `registros` | Lista de [Título sem NF-e](#titulo-sem-nf-e) | Títulos da página atual. | | `paginacao` | [Paginação](#paginacao) | Dados de paginação. | | `mensagem` | Texto | Mensagem complementar. Normalmente `null`. | ### Título sem NF-e | Campo | Tipo | Descrição | | ---------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------- | | `id` | Número | Id do título. Usar como referência para rastrear qual parcela corresponde ao XML enviado. | | `idEmpresa` | Número | Id do cedente — o mesmo `idEmpresa` exigido no endpoint de [Anexar Lastros Avulsos](9.1.%20Anexar%20Lastros%20Avulsos.md). | | `cnpjCedente` | Texto | CNPJ do cedente (emitente da nota), sem máscara. | | `cpfCnpjSacado` | Texto | CPF ou CNPJ do sacado (destinatário da nota), sem máscara. | | `dataEmissao` | Data | Data de emissão do título (`YYYY-MM-DD`). | | `numeroNota` | Número/nulo | Número da nota fiscal. Vem do lastro quando houver; caso contrário, extraído do título pela configuração da operação. Nulo quando nenhum dos dois existe. | | `numeroDocumento` | Texto/nulo | Número do documento como veio no arquivo de remessa. Útil para localizar a nota quando `numeroNota` é nulo. | ### Paginação | Campo | Tipo | Descrição | | -------------------------- | -------- | -------------------------------------- | | `paginaAtual` | Número | Página atual. | | `paginaTotal` | Número | Total de páginas. | | `paginaQuantidadeRegistro` | Número | Tamanho da página solicitado (`tamanhoDaPagina`). | | `quantidadeRegistros` | Número | Quantidade total de títulos encontrados. | | `temPaginaAnterior` | Booleano | Indica se existe página anterior. | | `temProximaPagina` | Booleano | Indica se existe próxima página. | ```bash title="Exemplo de cURL" curl -X GET "https://BASE_URL/public/v1/recebiveis/lotes/23/lastros/avulsos/nfe/sem-chave?idEmpresa=42&dataEmissaoInicio=2026-09-01&dataEmissaoFim=2026-09-30" \ -H "Authorization: Bearer {token}" \ -H "GrupoEconomico: {grupo}" ```