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

Consulta a fotografia da sessão de importação de lastros — 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 POST /lastros/nfe para acompanhar cada sessão.

Path Params¶

Campo	Tipo	Descrição
`idLote`	Número	Identificador do lote. A consulta é escopada pela operação dona deste lote — um `idLogIntegracao` de outro lote/operação retorna `404`.
`idLogIntegracao`	Número	Id do log de integração retornado em `POST /lastros/nfe`.

Exemplo de cURL

curl -X GET "https://BASE_URL/public/v1/recebiveis/lotes/987/lastros/importacao/44570" \
  -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": "teste-fotografia.zip",
    "hashesArquivos": ["8c370a5c..."]
  },
  "erros": [],
  "avisos": [],
  "idContaCorrente": null,
  "tipoArquivoIntegracao": 2,
  "quantidadeImportada": 0,
  "quantidadeRejeitada": 0,
  "titulosRejeitados": [],
  "quantidadeMovimentacoesRejeitadas": 0,
  "movimentacoesRejeitadas": [],
  "lotesGerados": [],
  "historicoImportacaoLastro": {
    "id": 812,
    "dataImportacao": "2026-06-11T16:04:52.969954-03:00",
    "idUsuario": "5f0c2a1e-8d3b-4c7a-9e61-2b7d4f1a0c93",
    "idOperacao": 23,
    "idEmpresa": 9,
    "tipoArquivoIntegracao": 2,
    "status": 3,
    "quantidadeTotalArquivos": 3,
    "quantidadeVinculados": 1,
    "quantidadePendentes": 1,
    "quantidadeRejeitados": 1,
    "itens": [
      {
        "idHistoricoImportacaoLastro": 812,
        "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
      },
      {
        "idHistoricoImportacaoLastro": 812,
        "nomeArquivo": "nfe-002-sem-cobranca.xml",
        "resultado": 3,
        "idLastro": 2006723,
        "idTitulo": null,
        "numeroDocumentoTitulo": "2",
        "nomeSacadoTitulo": "CATERPILLAR BRASIL LTDA",
        "dataVencimentoTitulo": null,
        "valorNominalTitulo": 500.00,
        "mensagem": "NFe sem dados de cobranca; lastro pendente de criacao de titulo.",
        "id": 47
      },
      {
        "idHistoricoImportacaoLastro": 812,
        "nomeArquivo": "arquivo-invalido.xml",
        "resultado": 4,
        "idLastro": null,
        "idTitulo": null,
        "numeroDocumentoTitulo": null,
        "nomeSacadoTitulo": null,
        "dataVencimentoTitulo": null,
        "valorNominalTitulo": null,
        "mensagem": "Arquivo 'arquivo-invalido.xml' nao e XML de NFe, Evento ou PDF valido.",
        "id": 45
      }
    ]
  },
  "id": 44570
}

Importação não encontrada¶

Quando o idLogIntegracao não existe ou não pertence à operação do lote, a resposta é 404 Not Found, com a mensagem no corpo:

Response Body — 404 Not Found

"O registro '44570' não foi localizado."

Se o próprio lote não for encontrado, a resposta é 400 Bad Request com o envelope RetornoPadrao:

Response Body — 400 Bad Request (lote inexistente)

{
  "status": "erro",
  "mensagem": "Não foi possível identificar o lote 987."
}

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. Pela API pública, `Api`.
`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 da importação: `Na fila`, `Processando`, `Processado`, `Processado com aviso`, `Processado parcial`, `Rejeitado` ou `Cancelado`.
`arquivo`	Objeto	Arquivo recebido: `nome` (nome do arquivo) e `hashesArquivos` (lista de hashes do conteúdo).
`erros`	Lista de texto	Motivo da rejeição, quando `status` é `Rejeitado`. Vazia nos demais casos.
`avisos`	Lista de texto	Observações do processamento, quando `status` é `Processado com aviso` ou `Processado parcial`. Vazia nos demais casos.
`idContaCorrente`	Número \| `null`	Não se aplica à importação de lastros: vem `null`.
`tipoArquivoIntegracao`	Número	Tipo do arquivo importado. Para XML de NF-e ou CT-e, `2`.
`quantidadeImportada`	Número	Quantidade de títulos vinculados ao log de integração.
`quantidadeRejeitada`	Número	Quantidade de títulos rejeitados no log de integração.
`titulosRejeitados`	Lista	Títulos rejeitados no log de integração, com a regra que falhou. Normalmente vazia na importação de lastros: o resultado por arquivo fica em `historicoImportacaoLastro.itens`.
`quantidadeMovimentacoesRejeitadas`	Número	Não se aplica à importação de lastros: vem `0`.
`movimentacoesRejeitadas`	Lista	Não se aplica à importação de lastros: vem vazia.
`lotesGerados`	Lista	Lotes gerados pela importação. Na importação de lastros, vem vazia.
`historicoImportacaoLastro`	Objeto	Fotografia detalhada da sessão (ver abaixo). Omitido quando a fotografia não existe.

`historicoImportacaoLastro`¶

Campo	Tipo	Descrição
`id`	Número	Identificador da fotografia.
`dataImportacao`	Data/Hora	Quando a sessão de importação foi registrada.
`idUsuario`	Texto	Identificador do usuário que enviou os arquivos.
`idOperacao`	Número	Operação em que os arquivos foram importados.
`idEmpresa`	Número \| `null`	Empresa (cedente) dona dos lastros.
`tipoArquivoIntegracao`	Número	Tipo do arquivo importado. Para XML de NF-e ou CT-e, `2`.
`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). Omitida quando não há itens.

`historicoImportacaoLastro.itens[]`¶

Campo	Tipo	Descrição
`id`	Número	Identificador do item.
`idHistoricoImportacaoLastro`	Número	Identificador da fotografia a que o item pertence.
`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.