Ir para o conteúdo

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

Consulta a fotografia da sessão de importação de lastros avulsos — retorna o status agregado do processamento mais o detalhamento individual por arquivo enviado (vinculação realizada, pendência ou rejeição).

Use os ids retornados em idsLogIntegracao por Anexar Lastros Avulsos para acompanhar cada sessão.

Path Params¶

Campo	Tipo	Descrição
`idOperacao`	Número	Identificador da operação. A consulta é escopada por ela — um `idLogIntegracao` de outra operação retorna `404`.
`idLogIntegracao`	Número	Id do log de integração retornado em `POST /lastros/avulsos/nfe`.

Exemplo de cURL

curl -X GET "https://BASE_URL/public/v1/recebiveis/lotes/23/lastros/avulsos/importacao/44580" \
  -H "Authorization: Bearer {token}" \
  -H "GrupoEconomico: {grupo}"

Response Body — 200 OK

{
  "canalIntegracao": "API",
  "cedente": "ACME LTDA",
  "importadoEm": "2026-06-11T16:04:53.07377-03:00",
  "ultimaAtualizacao": "2026-06-11T16:04:56.498707-03:00",
  "status": "Processado",
  "arquivo": {
    "nome": "nfe-001-com-cobranca.xml",
    "hashArquivo": "8c370a5c..."
  },
  "historicoImportacaoLastro": {
    "dataImportacao": "2026-06-11T16:04:52.969954-03:00",
    "idOperacao": 23,
    "idEmpresa": 9,
    "tipoArquivoIntegracao": 2,
    "status": 2,
    "quantidadeTotalArquivos": 1,
    "quantidadeVinculados": 1,
    "quantidadePendentes": 0,
    "quantidadeRejeitados": 0,
    "itens": [
      {
        "nomeArquivo": "nfe-001-com-cobranca.xml",
        "resultado": 2,
        "idLastro": 2006722,
        "idTitulo": 2771776,
        "numeroDocumentoTitulo": "001",
        "nomeSacadoTitulo": "CATERPILLAR BRASIL LTDA",
        "dataVencimentoTitulo": "2026-06-27",
        "valorNominalTitulo": 1000.00,
        "mensagem": null,
        "id": 46
      }
    ]
  },
  "id": 44580
}

Modelo de dados¶

Retorno¶

Campo	Tipo	Descrição
`id`	Número	Id do log de integração consultado.
`canalIntegracao`	Texto	Canal pelo qual a importação foi recebida.
`cedente`	Texto	Nome do cedente.
`importadoEm`	Data/Hora	Quando a importação foi recebida.
`ultimaAtualizacao`	Data/Hora	Última atualização de status.
`status`	Texto	Status agregado (`Processado`, `Rejeitado`, `EmProcessamento`).
`arquivo`	Objeto	Nome e hash do arquivo enviado.
`historicoImportacaoLastro`	Objeto	Fotografia detalhada da sessão (ver abaixo).

`historicoImportacaoLastro`¶

Campo	Tipo	Descrição
`idOperacao`	Número	Operação informada no `POST /lastros/avulsos/nfe`.
`idEmpresa`	Número	Empresa (cedente) informada no `POST /lastros/avulsos/nfe`.
`status`	Enum (`int`)	`1` Processando · `2` Concluída · `3` Concluída com pendências · `4` Rejeitada.
`quantidadeTotalArquivos`	Número	Total de arquivos processados na sessão.
`quantidadeVinculados`	Número	Quantos foram vinculados a títulos existentes.
`quantidadePendentes`	Número	Quantos ficaram como pendentes de vínculo.
`quantidadeRejeitados`	Número	Quantos foram rejeitados.
`itens`	Lista	Detalhe individual por arquivo (ver abaixo).

`historicoImportacaoLastro.itens[]`¶

Campo	Tipo	Descrição
`nomeArquivo`	Texto	Nome original do arquivo enviado.
`resultado`	Enum (`int`)	`1` Processando · `2` Vinculado · `3` Pendente de vínculo · `4` Rejeitado.
`idLastro`	Número \| `null`	Id do lastro criado (quando aplicável).
`idTitulo`	Número \| `null`	Id do título vinculado (somente quando `resultado = 2`).
`numeroDocumentoTitulo`	Texto \| `null`	Número do documento do título casado, quando houver.
`nomeSacadoTitulo`	Texto \| `null`	Nome/Razão social do sacado.
`dataVencimentoTitulo`	Data \| `null`	Vencimento do título.
`valorNominalTitulo`	Decimal \| `null`	Valor nominal do título.
`mensagem`	Texto \| `null`	Mensagem explicativa em casos de rejeição ou pendência.

Observações¶

Pendente de vínculo (resultado = 3): ocorre quando a chaveNfe do XML não casa com nenhum título já cadastrado na operação/empresa — o lastro fica salvo, aguardando que o título correspondente seja criado ou identificado. Veja também Anexar Lastros Avulsos e, para o fluxo vinculado a lote, Consultar Importação de Lastros.