API Demander — Buscar datos en Demander (exportación al ERP)

Este webservice (método GET) permite que el ERP o la integración propia busque en Demander los cambios recientes y descargue un archivo de exportación. No es Demander “empujando” datos: el cliente consulta el endpoint y procesa el archivo devuelto. Para integraciones nuevas en tiempo real, prefiera la API REST — usa otra autenticación (API Token), no el Token de la Empresa de este webservice.

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

Propiedad	Tipo	Obligatorio	Descripción
token	text	Sí	Token de la Empresa (el mismo del sincronizador / webservices legados). Cómo generar. No es el API Token de la REST.
periodoInicial	datetime	Sí	Fecha y hora a partir de la cual desea buscar la información de Demander. Formato `AAAA-MM-DD HH:MM`. El webservice genera el archivo con los cambios hechos en Demander a partir de ese momento (sujeto a los límites siguientes).

Esta llamada devuelve la URL de un archivo. Ese archivo debe descargarse y procesarse en el ERP.

Como en el layout de envío, el layout de búsqueda/exportación usa | como separador de campo.

Cuándo NO usar

Si la empresa usa el sincronizador oficial de Demander, ya se encarga de esta búsqueda de forma recurrente — no es necesario llamar este webservice manualmente en el día a día.
Para integraciones nuevas o en tiempo real, prefiera la API REST en lugar de este webservice legado de exportación en archivo.

Límites importantes para quien integra

Estas reglas aplican sobre todo a integración propia (webservice/API directa). El sincronizador oficial de Demander ya controla la frecuencia; la restricción de periodoInicial suele aparecer solo si la búsqueda queda más de 7 días sin ejecutarse.

1) Límite de `periodoInicial` (7 días)

Si la fecha en periodoInicial es más antigua que 7 días respecto a hoy, se ignora y se reemplaza automáticamente por hoy − 7 días.

En la práctica: no sirve pedir “todo desde 2020” — Demander limita la ventana de búsqueda por cambio.

2) Límite de pedidos (30 días de emisión)

Además del filtro por cambio, los pedidos solo se devuelven si la fecha de emisión (dataEmissao) está en los últimos 30 días:

Pedido.dataAlteracao > {periodoInicial}
AND Pedido.dataEmissao > {hoy - 30 días}

Los pedidos con emisión más antigua que 30 días dejan de devolverse en esta búsqueda, aunque se hayan modificado recientemente.

Qué debe hacer su integración

Guarde la fecha/hora del archivo y úsela como periodoInicial en la siguiente llamada.
Ejecute la búsqueda con frecuencia (idealmente diaria o continua) para no superar la ventana de 7 días.
No use la exportación continua para reprocesar un historial largo.
Si usa el sincronizador oficial, manténgalo activo; ya evita la mayoría de estos casos.

Contenido del archivo

En la primera línea del archivo descargado hay información de control:

Captura de pantalla 1

Esa fecha/hora debe guardarse en el ERP para la próxima llamada.

Ejemplo en Postman:

Captura de pantalla 2