query-company-tax-id, o que permite consultar várias empresas de uma vez sem perder a origem do dado.
Parâmetros
Período
- Sem datas, a consulta traz todas as movimentações ativas, sem recorte de período.
- Com só uma das datas, a outra recebe um valor padrão:
data_iniciopassa a ser 30 dias atrás, edata_fimpassa a ser hoje. - 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_fime ela for de mais de 30 dias atrás.
Sem datas e sem
limite, a lista não vem na resposta. A ferramenta devolve um link para a lista completa, 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 datas ou com limite, a lista vem na própria resposta, em CSV, da mais recente para a mais antiga.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.Status
O status mostra a visão de negócio da movimentação. O campostatus-source de cada linha indica essa origem.
Quais status contam como em andamento
Quais status contam como em andamento
waiting-for-beneficiary, requested, scheduled, submitted, submitted-to-broker, broker-processing, submitted-to-carrier, carrier-processing, carrier-processing-failed, missing-documents, incorrect-data, broker-open-issue, carrier-submission-failed, requested-cancellation e submitted-cancellation.Os pedidos de cancelamento ainda não concluídos também aparecem aqui.Exemplos de perguntas
- “Quais movimentações estão em andamento na empresa 12.345.678/0001-95?”
- “Tem alguma inclusão pendente nestas empresas?”
- “Quais movimentações estão com documentos faltando?”