Integração de API é fazer dois sistemas trocarem informação sozinhos, sem ninguém copiando e colando. A loja virtual avisa o ERP que saiu um pedido, o ERP devolve o estoque atualizado, a transportadora informa que a encomenda foi entregue. A API (interface de programação, na sigla em inglês) é a porta que cada sistema abre pra isso, com regras de quem pode entrar e do que pode pedir.
Como funciona uma API, em linguagem de operação
Pense num balcão de atendimento. Você chega, faz um pedido num formato combinado e recebe a resposta também num formato combinado. A API é esse balcão, só que entre sistemas. A loja chega no balcão da transportadora e pergunta quanto custa mandar uma caixa de Porto Alegre pra Recife. A transportadora responde com prazo e valor.
Pra isso funcionar, três coisas precisam estar acertadas:
- O endereço. Cada tipo de pedido tem um endereço próprio na API: cotar frete, gerar etiqueta, consultar rastreio.
- A credencial. Uma chave ou token que diz quem está pedindo. Sem ela, o balcão não atende.
- O formato. Quais campos vão, com que nome, e como vem a resposta. Quase sempre em JSON, um texto estruturado que os dois lados sabem ler.
REST e webhook: quem chama quem
A maior parte das APIs que você vai encontrar segue o modelo REST. Nele, o seu sistema chama o outro quando precisa de algo: busca um dado, cria um registro (um pedido novo), altera (muda o status) ou apaga. Quem toma a iniciativa é sempre quem pergunta.
O problema aparece quando você quer saber de algo que acontece do outro lado. Perguntar a cada minuto "já pagou?", "já entregou?" funciona, mas gasta recurso e chega atrasado. Pra isso existe o webhook, que inverte a direção: o outro sistema avisa o seu assim que o evento acontece. O pagamento foi confirmado, o gateway chama um endereço do seu sistema e entrega a notícia. Quando a transportadora oferece esse tipo de aviso, a saída pra entrega chega do mesmo jeito.
Na prática, uma integração bem feita usa os dois: REST pra pedir, webhook pra ser avisado. Como isso fica no caso de Pix, boleto e cartão está em integração de pagamento com Pix.
Exemplos de integração de API no dia a dia
ERP e loja virtual
Produto cadastrado uma vez no ERP aparece na loja com preço e estoque. Pedido feito na loja entra no ERP pra faturar e separar. Sem integração, alguém faz isso na mão, e o cliente compra um item que acabou ontem.
Loja e transportadora
Cotação de frete no carrinho, etiqueta gerada sem digitar endereço, rastreio que atualiza sozinho. O Forja, marketplace de venda local que a gente desenvolveu, tem checkout próprio e frete inteligente em quatro transportadoras (Correios, SuperFrete, Loggi e outras). No LogMoney, plataforma de venda com pagamento na entrega que já passou de 119 mil pedidos, as etiquetas saem em lote e o rastreio atualiza sozinho.
Sistema e WhatsApp
Pedido confirmado vira mensagem pro cliente. Mensagem do cliente vira registro no sistema. O caminho aqui é a API do WhatsApp, oficial da Meta ou não oficial, escolhida conforme o volume e o tipo de uso.
O que pode dar errado numa integração
Integração não é ligar um fio e esquecer. O outro lado é um sistema que você não controla, e ele falha, muda e tem limite. Os problemas mais comuns:
- O outro sistema sai do ar. Se o seu trava junto, a operação para. O certo é guardar o pedido numa fila e tentar de novo sozinho quando o outro voltar.
- Aviso duplicado ou perdido. Webhook pode chegar duas vezes, ou não chegar. A integração precisa reconhecer o repetido e conferir de tempos em tempos o que ficou pra trás.
- Limite de chamadas. Muitas APIs aceitam só um certo número de pedidos por minuto. Sincronizar o catálogo inteiro de uma vez sem respeitar isso dá erro no meio do caminho.
- Dado em formato diferente. CPF com ponto num lado e sem ponto no outro, datas em formatos trocados, produto com código diferente em cada sistema. É aqui que mora boa parte do trabalho.
- Mudança de versão. O fornecedor atualiza a API e avisa com antecedência (ou não). Integração sem manutenção quebra num dia qualquer.
- Erro silencioso. O pior caso: a integração falha e ninguém fica sabendo. Por isso toda integração séria guarda registro do que foi enviado e recebido, e avisa alguém quando algo não passa.
E quando o sistema não tem API
Acontece, principalmente com sistema antigo ou de nicho. Aí as saídas são exportar e importar arquivo (planilha ou CSV) em horário marcado, ler direto do banco de dados quando o fornecedor permite, ou usar um robô que opera a tela como uma pessoa faria. Cada uma tem prós e contras, e a gente compara essas formas em automação de processos.
Vale ser honesto também: se a integração é simples (um formulário que vira linha numa planilha, um pedido que vira e-mail), ferramentas prontas como Zapier, Make ou n8n resolvem sem programação sob medida. O sob medida entra quando tem regra de negócio, volume ou dinheiro passando pela integração.
Como pedir uma integração de API
- Diga quais sistemas precisam conversar e o nome de cada um (fornecedor e versão).
- Descreva o que deve acontecer em linguagem de operação: "quando o pedido for pago, gerar a etiqueta e avisar o cliente".
- Pergunte ao fornecedor do outro sistema se ele tem API e documentação. Se tiver, metade do caminho está andado.
- Defina o que acontece quando der errado: quem é avisado e como.
Integração faz parte do trabalho de desenvolvimento de sistemas web da Verso: ERP, gateway de pagamento, transportadora, planilha e WhatsApp. Chama no WhatsApp dizendo quais sistemas você quer ligar e o que deveria acontecer entre eles. O orçamento fechado sai em até 24h.