9.4. Consultar Títulos sem NF e

Método	URL
	`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.

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: os títulos vêm em registros e os dados da paginação em paginacao. A ordem é estável entre as páginas.

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	Títulos da página atual.
`paginacao`	Paginação	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.
`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.

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}"