Engenharia e Desenvolvimento
APIs e Integrações
Quando dois sistemas precisam “conversar”, o problema quase nunca é só técnico — é dado duplicado, horário errado de sincronia ou mensagem de erro que ninguém entende. A Viscale desenha e implementa APIs e integrações com linguagem de negócio na mesa: o que pode falhar, o que não pode se perder e como o time de suporte descobre rápido onde encostou o carro.
Integração boa parece “invisível”: o pedido nasce na loja, aparece no financeiro e o cliente recebe o e-mail certo. Integração ruim vira planilha paralela, ligação de madrugada e medo de apertar qualquer botão. Por isso documentamos o contrato (o que entra, o que sai, em que formato), tratamos erro de forma previsível e evitamos guardar informação sensível onde não precisa.
Exemplos do dia a dia
Loja e estoque no mesmo ritmo
Venda online atualiza quantidade no sistema que o armazém já usa.
Pagamento confirma pedido
Gateway avisa quando o pagamento cai; o pedido muda de status sozinho.
Lead do site vira oportunidade no CRM
Formulário manda dados certos para o time comercial sem copiar e colar.
App móvel e servidor central
Telas no celular consomem a mesma fonte de verdade que o painel web.
Parceiro consulta dados autorizados
API externa com limite claro: só vê o que o contrato permite.
Aviso quando algo importante acontece
Webhook ou fila: assinatura de contrato, NF emitida ou cliente VIP cadastrado.
Ler dados do sistema antigo
Novo produto consome informação legada sem obrigar migração big-bang na hora zero.
Um painel com informação de duas fontes
Combina financeiro e operação numa tela única para o gestor.
Catálogo público para parceiros
Preço e disponibilidade expostos com autenticação simples e registro de acesso.
Substituir integração quebrada
Fornecedor mudou o formato: reescrevemos o conector com testes e plano de corte.
Segurança entra no pacote: acesso com senha forte ou token que expira, permissão só para o que aquele sistema precisa e trilha básica de “quem chamou o quê” quando o negócio exige auditoria. Quando um fornecedor muda a API deles, você tem um mapa do que atualizar — não um mistério espalhado em dez pastas.
Testamos fluxos críticos antes de soltar em produção (pagamento, estoque, cadastro de cliente) e deixamos exemplos de chamada e respostas típicas para o próximo desenvolvedor não recomeçar do zero. Se o volume crescer, combinamos filas ou reprocessamento para nada travar na hora do pico.
Portfólio de APIs e Integrações
Entregáveis
Integração em produção
Fluxos combinados funcionando com HTTPS e credenciais corretas.
Código em repositório privado
Conector ou serviço versionado com README.
Documentação do contrato
URLs, métodos, campos e exemplos de requisição e resposta.
Lista de erros e o que fazer
Tabela simples: sintoma → causa provável → ação.
Registro de credenciais (fora do Git)
Onde ficam chaves e quem tem acesso em cada ambiente.
Relatório de testes executados
Cenários e resultado antes do corte em produção.
Checklist de segurança básica
Permissões mínimas, tráfego cifrado e dados sensíveis tratados.
Configuração de alertas
Falha repetida, tempo de resposta alto ou fila parada.
Runbook de reprocessamento
Como rodar de novo um lote que falhou sem duplicar cobrança.
Plano de desligamento da integração antiga
Quando substituir legado, com janela e rollback.
Sessão de handoff
Dúvidas com o time que fica responsável pelo dia a dia.
Metodologia de execução
-
Mapeamento dos sistemas
O que existe hoje, quem é dono de cada dado e qual dor a integração resolve.
-
Definição do fluxo desejado
Passo a passo em linguagem de negócio antes de falar de código.
-
Contrato da API ou arquivo
Campos obrigatórios, formatos de data e o que acontece em caso de erro.
-
Implementação e ambiente de teste
Conector ou endpoint novo rodando contra cópia ou sandbox segura.
-
Segurança e credenciais
Quem acessa o quê, rotação de senha e segredo fora do código-fonte.
-
Testes de ponta a ponta
Cenários reais com volume parecido com a produção quando possível.
-
Documentação para humanos
Exemplos de chamada, lista de erros comuns e quem chamar em cada fornecedor.
-
Publicação e monitoração
Go-live com checklist e alerta se a taxa de falha subir demais.
-
Plano quando o fornecedor mudar de novo
Versão da API, data de corte e teste de regressão.
-
Treinamento rápido
Para suporte ou TI interno saber onde olhar quando der problema.
