Sincronize pacientes, produtos & estoque e pedidos entre a Xuru e o seu ERP, e-commerce, BI ou automações. REST previsível, JSON, autenticação por API Key e webhooks. Comece em minutos.
# Liste seus produtos — basta um header de autenticação
curl https://app.xuru.com.br/api/v1/products \
-H "X-API-Key: xuru_live_xxxxxxxxxxxxxxxxxxxx"# Upsert pelo ID do seu sistema — sem mapear ids da Xuru
curl -X PUT https://app.xuru.com.br/api/v1/patients/external/C0001 \
-H "X-API-Key: xuru_live_xxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{ "externalId": "C0001", "name": "Maria Souza", "email": "maria@exemplo.com" }'Menos tempo lendo documentação, mais tempo integrando.
Recursos claros, verbos HTTP padrão e JSON em tudo. Sem surpresas.
Só a sua API Key no header X-API-Key. Ela já escopa sua organização.
Mesmo envelope { success, data, meta } e códigos de erro estáveis em toda a API.
Idempotency-Key garante que retries nunca dupliquem pacientes ou pedidos.
Do zero à primeira sincronização em três passos.
No dashboard, em Configurações → Integrações → API Keys. Use a chave de sandbox (xuru_test_) para testar.
Envie o header X-API-Key em todas as chamadas. A chave escopa sua organização automaticamente.
Faça upsert por externalId e leia mudanças com updatedSince. Assine webhooks para tempo real.
Endpoints versionados sob /api/v1.
Sincronize a base de pacientes/associados.
Mantenha catálogo e estoque sempre alinhados.
Crie e acompanhe pedidos com validação automática.
Receba eventos em tempo quase real na sua URL.
A mesma API atende a vários cenários. Conectar um ERP é só um deles.
Espelhe pacientes, produtos e pedidos entre o seu ERP (financeiro, fiscal, logística) e a Xuru.
Sincronize catálogo e estoque e empurre pedidos da sua loja para a Xuru.
Leia incrementalmente com updatedSince para alimentar relatórios e dashboards.
Dispare fluxos internos a partir de webhooks de pedidos, pacientes e estoque.
Três ideias e você já domina o sincronismo.
Use o ID do seu sistema para upsert direto (PUT /external/{externalId}) sem mapear ids internos da Xuru.
updatedSince + paginação por cursor trazem apenas o que mudou desde a última sincronização.
Headers X-RateLimit-* em toda resposta e 429 com Retry-After. Trate com backoff exponencial.
Como os dados trafegam entre o seu sistema e a Xuru.
Seu sistema fala com a API; a API Key resolve a organização e os dados ficam isolados.
Envie cadastros com o ID do seu sistema — a API cria ou atualiza automaticamente.
Sincronização incremental paginada por cursor.
Ative os webhooks, escolha os eventos e informe a URL de destino. A Xuru entrega notificações assinadas (HMAC), com retentativa automática e garantia de entrega — e suspende endpoints fora do ar para evitar loops.
# Assine eventos e receba notificações na sua URL
curl -X POST https://app.xuru.com.br/api/v1/webhooks \
-H "X-API-Key: xuru_live_xxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"url": "https://seu-sistema.com/webhooks/xuru",
"events": ["patient.updated", "order.status_changed", "stock.updated"]
}'Referência interativa, contrato e guias para você integrar.