API Demander — Buscar dados no Demander (exportação para o ERP)

Este webservice (método GET) permite que o ERP ou a integração própria busque no Demander as alterações recentes e baixe um arquivo de exportação. Não é o Demander “empurrando” dados: o cliente consulta o endpoint e processa o arquivo retornado. Para integrações novas em tempo real, prefira a API REST — ela usa outra autenticação (API Token), não o Token da Empresa deste webservice.

https://busca-erp.demander.com.br/demander/producao/webservice/integracao/retta/exportacao_dados.php?token={token da Empresa}&periodoInicial={formato AAAA-MM-DD HH:MM}

Propriedade	Tipo	Obrigatório	Descrição
token	text	Sim	Token da Empresa (o mesmo do sincronizador / webservices legados). Como gerar. Não é o API Token da REST.
periodoInicial	datetime	Sim	Data e hora a partir da qual você quer buscar as informações do Demander. Formato `AAAA-MM-DD HH:MM`. O webservice gera o arquivo com as alterações feitas no Demander a partir desse momento (sujeito aos limites abaixo).

Esta chamada retorna o link de um arquivo. Esse arquivo precisa ser baixado e processado pelo ERP, importando as informações relevantes para a empresa.

Assim como o leiaute de envio de dados, o leiaute de busca de dados usa | como separador de campo.

Quando NÃO usar

Se a empresa usa o sincronizador oficial do Demander, ele já cuida dessa busca de forma recorrente — não é necessário chamar este webservice manualmente no dia a dia.
Para integrações novas ou em tempo real, prefira a API REST em vez deste webservice legado de exportação em arquivo.

Limites importantes para quem integra

Essas regras valem principalmente para integração própria (webservice/API direta). O sincronizador oficial do Demander já controla a frequência das buscas; a restrição de periodoInicial só costuma aparecer se a busca ficar mais de 7 dias sem rodar.

1) Limite do `periodoInicial` (7 dias)

Se a data informada em periodoInicial for mais antiga do que 7 dias em relação à data atual, ela é ignorada e substituída automaticamente por hoje − 7 dias.

Na prática: não adianta pedir “tudo desde 2020” — o Demander limita a janela de busca por alteração.

2) Limite de pedidos retornados (30 dias de emissão)

Além do filtro por alteração, pedidos só são retornados se a data de emissão estiver nos últimos 30 dias.

Filtro equivalente:

Pedido.dataAlteracao > {periodoInicial}
AND Pedido.dataEmissao > {hoje - 30 dias}

Pedidos com emissão mais antiga que 30 dias deixam de ser retornados para o ERP nessa busca, mesmo que tenham sido alterados recentemente.

O que fazer na sua integração

Guarde a data/hora devolvida no arquivo e use-a na próxima chamada como periodoInicial.
Rode a busca com frequência (idealmente diária ou contínua) para não estourar a janela de 7 dias.
Se precisar de pedidos muito antigos, use outro fluxo (consulta pontual / suporte) — a exportação contínua não é o canal para reprocessar histórico longo.
Se usar o sincronizador oficial, mantenha-o ativo; ele já evita a maioria desses casos.

Conteúdo do arquivo

Na primeira linha do arquivo baixado existem algumas informações:

Captura da tela 1

Considerando o arquivo acima, a data/hora indicada precisa ser salva no ERP para que, na próxima chamada, seja passada como periodoInicial.

Exemplo de busca pelo Postman:

Captura da tela 2