Ir para o conteúdo
Método URL
GET 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.
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}" \
  -H "TipoUsuario: Cedente"
Response Body — 200 OK
{
  "canalIntegracao": "Importação de Arquivo via Tela",
  "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",
    "hashArquivo": "8c370a5c..."
  },
  "historicoImportacaoLastro": {
    "dataImportacao": "2026-06-11T16:04:52.969954-03:00",
    "idOperacao": 23,
    "idEmpresa": 9,
    "tipoArquivoIntegracao": 2,
    "status": 3,
    "quantidadeTotalArquivos": 3,
    "quantidadeVinculados": 1,
    "quantidadePendentes": 1,
    "quantidadeRejeitados": 1,
    "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
      },
      {
        "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
      },
      {
        "nomeArquivo": "arquivo-invalido.xml",
        "resultado": 4,
        "idLastro": null,
        "idTitulo": null,
        "mensagem": "Arquivo 'arquivo-invalido.xml' nao e XML de NFe, Evento ou PDF valido.",
        "id": 45
      }
    ]
  },
  "id": 44570
}

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
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.