Skip to main content
Lista o histórico de movimentações já encerradas das empresas informadas. Encerrada quer dizer com status completed (concluída) ou cancelled (cancelada). Cada linha identifica a empresa consultada pelo campo query-company-tax-id.

Parâmetros

Período

  • Com uma data ou com limite, a lista vem na própria resposta, em CSV, da mais recente para a mais antiga. O período padrão vale para a data que faltar: 30 dias atrás para o início e hoje para o fim. Só com limite, a consulta cobre os últimos 30 dias.
  • Sem datas e sem limite, a lista não vem na resposta. A ferramenta devolve um link para o histórico completo, sem o recorte de 30 dias, em páginas de 50. As páginas vêm em JSON, na ordem da origem. O assistente lê as páginas em sequência. Se o seu cliente não lê esse link sozinho, ele usa ler_pagina_listagem.
  • Com a data de início depois da data de fim, a ferramenta devolve um erro e não faz a consulta. Isso também acontece se você informar só a data_fim e ela for de mais de 30 dias atrás. Nesse caso, informe também a data_inicio.
O período usa a data da solicitação da movimentação. Se ela faltar, usa a data da última atualização ou de criação. Uma movimentação sem nenhuma dessas datas fica fora do resultado, e a resposta avisa quantas ficaram.
A Pipo lê no máximo 1 000 movimentações por empresa, antes de aplicar o status e o período. Se houver mais, a resposta avisa que a leitura foi cortada. Nesse caso, o resultado pode estar incompleto. Estreitar o período ou aumentar o limite não traz as movimentações que ficaram de fora da leitura.
Se um dos CNPJs não estiver no seu acesso ou falhar, a resposta avisa qual CNPJ falhou e traz as demais empresas. No link da lista completa é diferente: se um CNPJ falhar, só a primeira página vem, e a resposta marca partial. Para ver o restante, tire o CNPJ que falhou ou use limite. Se dois CNPJs forem da mesma empresa, a consulta é feita uma só vez, para não contar a mesma movimentação duas vezes.
O status mostra a visão de negócio da movimentação, e o campo status-source indica essa origem. Ele pode diferir do estado técnico que aparece em detalhe_movimentacao. Por proteção de dados, o resultado traz só campos operacionais: identificadores, membro, tipo de movimentação, produto, operadora, status e datas. Dados pessoais e financeiros ficam de fora.

Exemplos de perguntas

  • “Quais movimentações foram concluídas este mês na empresa 12.345.678/0001-95?”
  • “Mostre o histórico destas empresas na última semana”
  • “Quais movimentações foram canceladas entre janeiro e março?”