// 05 · integrações & apis

Integração de sistemas, APIs e webhooks

Empresa madura tem 8 sistemas que precisam conversar. ERP, banco, nota fiscal, marketplace, CRM, ferramenta de email, gateway de pagamento, planilha do diretor. Quando não conversam, alguém digita duas vezes — e erra. A Oryxi constrói camadas de integração resilientes: filas, retry, idempotência, dashboard de execução, alerta quando algo trava. Conectamos REST, GraphQL, SOAP, webhook, polling, FTP, EDI — o que o legado tiver. E quando o sistema não tem API, escrevemos um adapter (até web scraping responsável quando é a única saída).

// o que entregamos

Capacidades

  • 01REST, GraphQL, SOAP, webhook, FTP, EDI — qualquer protocolo.
  • 02Filas Postgres/Redis/SQS com retry exponencial e DLQ.
  • 03Idempotência por chave única — duplicidade não vira problema.
  • 04Dashboard de execução: vê o que rodou, o que falhou, o que está na fila.
  • 05Alertas em Slack/email quando algo trava.
  • 06Marketplace: Mercado Livre, Shopee, Amazon, B2W, Magalu.
  • 07ERP: Bling, Tiny, Omie, Sankhya, Totvs, SAP (sim, SAP também).
// processo

Como entregamos integração de sistemas, apis e webhooks

  1. 01

    Inventário de sistemas

    Mapeamos tudo que conversa hoje, tudo que devia conversar e tudo que está no copia-e-cola humano.

  2. 02

    Desenho de fluxo

    Definimos eventos, ordem, idempotência, retry e tratamento de erro. Documentamos em diagrama de sequência.

  3. 03

    Construção em camadas

    Começamos pela integração de maior ROI (geralmente nota fiscal ou banco), seguimos pela próxima quando aquela está estável.

  4. 04

    Observabilidade

    Sentry pra erros, Grafana pra métricas, dashboard interno pra status das integrações em tempo real.

  5. 05

    Manutenção e evolução

    API quebra, layout muda, marketplace lança versão nova. A gente acompanha e ajusta antes do problema chegar no cliente.

// perguntas frequentes

Dúvidas comuns sobre integração de sistemas, apis e webhooks

Vocês integram com qual ERP?

Já integramos com Bling, Tiny, Omie, Sankhya, Totvs, SAP Business One, Conta Azul. Se o ERP tem API ou consegue exportar CSV/XML, a gente integra.

E se o sistema não tem API?

Tem três saídas. (1) Adapter via interface web (RPA com Playwright). (2) Importação por CSV/XML programada. (3) Direto no banco quando temos acesso. A gente escolhe o caminho mais estável e te conta os trade-offs.

Quanto tempo demora uma integração típica?

Integração simples (webhook + 1 endpoint): 1 a 2 semanas. Integração complexa com várias entidades, retry e conciliação: 4 a 8 semanas.

Como vocês evitam duplicidade quando o webhook chega duas vezes?

Idempotência por chave única (geralmente o ID do evento no sistema de origem). Se chegar de novo, o segundo é ignorado mas registrado. Auditoria completa.

// projetos relacionados

Cases que usam essa capacidade

Bora construir isso?

Conta o problema. Devolvemos um diagnóstico com escopo e orçamento. Primeira conversa sem compromisso.

Fale com a Oryxi →