--- title: 9.2. Consultar Importação de Lastros Avulsos url: https://docs.vehub.com.br/API/Integra%C3%A7%C3%A3o%20FIDC/9.%20Lastros%20Avulsos/9.2.%20Consultar%20Importa%C3%A7%C3%A3o%20de%20Lastros%20Avulsos/ --- | Método | URL | |--------|-----| | ![GET](https://img.shields.io/badge/GET-blue) | `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](9.1.%20Anexar%20Lastros%20Avulsos.md) 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`. | ```` bash title="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}" ```` ```` json title="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](9.1.%20Anexar%20Lastros%20Avulsos.md) e, para o fluxo vinculado a lote, [Consultar Importação de Lastros](../2.%20Cess%C3%A3o%20de%20Direitos%20Credit%C3%B3rios/2.6.%20Consultar%20Importa%C3%A7%C3%A3o%20de%20Lastros.md).