Saltar para o conteúdo
Desenvolvimento

Integrações e APIs que ligam os seus sistemas: os dados a passar de um lado ao outro

Ligações entre o site, a loja e os programas que já usa, para que a informação seja introduzida uma vez só.

Para quem são as integrações e APIs

As integrações e APIs servem para pôr dois sistemas a falar um com o outro sem ninguém pelo meio. Uma API é a porta pela qual um programa pede informação a outro e lhe devolve resposta: o site pergunta ao armazém quantas unidades restam, a loja avisa a faturação de que houve uma venda, o formulário cria uma ficha de cliente na plataforma comercial.

Este serviço é para empresas que já têm ferramentas a funcionar e não as querem substituir. O problema não é a falta de software, é o software não comunicar. Quando isso acontece, a ligação em falta é feita por pessoas, à mão, com o custo e os erros que isso traz.

Se, em vez de ligar o que existe, precisa de construir a ferramenta de raiz, veja o serviço de aplicações web.

Problemas que este serviço resolve

Os pedidos de integração costumam nascer de um destes sintomas.

Dupla introdução de dados

A encomenda é registada na loja e depois copiada à mão para o programa de faturação ou de logística.

Stock que não corresponde à realidade

O site mostra disponibilidade que já não existe porque o inventário só é atualizado ao fim do dia.

Contactos perdidos entre ferramentas

Os pedidos entram por correio eletrónico e ficam numa caixa de entrada em vez de darem entrada no processo comercial.

Relatórios feitos a partir de exportações

Todos os meses alguém junta ficheiros de três sistemas diferentes para conseguir ver o negócio inteiro.

Serviços externos por ligar

Pagamentos, transportadoras, faturação certificada ou plataformas de parceiros que estão disponíveis mas ninguém ligou ao site.

Cada dado introduzido duas vezes é uma oportunidade de os dois ficarem diferentes.

Como trabalhamos

Uma integração mal feita é pior do que nenhuma, porque espalha dados errados depressa. Por isso trabalhamos devagar no início e só depois automatizamos.

Mapa dos sistemas

Levantamos que ferramentas existem, que dados guardam, quais são a fonte de verdade para cada informação e que documentação de API disponibilizam. Nem todos os programas de gestão permitem ligações, e isso descobre-se antes de haver proposta.

Desenho do fluxo

Definimos o que passa, em que sentido, com que frequência e o que acontece quando os dois lados discordam. É aqui que se decide, por exemplo, quem manda no preço: a loja ou o programa de gestão.

Construção e ambiente de testes

A ligação é construída e experimentada contra ambientes de teste, com dados falsos, até que os casos maus (falha de rede, resposta inesperada, registo duplicado) estejam todos tratados.

Entrada em serviço controlada

Passamos a produção por fases, muitas vezes com a operação manual a correr em paralelo nos primeiros dias, para comparar resultados antes de desligar o método antigo.

Vigilância

Fica um registo de tudo o que passa e um alerta quando algo falha. Uma integração silenciosa que deixa de funcionar pode custar semanas de dados perdidos.

O que recebe

Além da ligação a funcionar, fica com o que é preciso para perceber e manter o que foi feito.

A integração em produção

Ativa, agendada ou em tempo real conforme o que ficou definido, com as credenciais em nome da sua empresa.

Documentação do fluxo

Que dados passam, em que sentido e com que regras, num documento que qualquer técnico consegue ler.

Registo de operações

Histórico do que foi enviado e recebido, para poder investigar qualquer divergência sem adivinhar.

Tratamento de erros

Nova tentativa automática nas falhas passageiras e aviso quando a falha é persistente.

API própria, quando é esse o caso

Se for a sua empresa a disponibilizar dados a terceiros, entregamos a API documentada e com autenticação.

Código e acessos

O repositório e as chaves ficam consigo, para que outra equipa possa assumir o trabalho.

Perguntas frequentes sobre integrações

O que nos perguntam com mais frequência antes de ligar sistemas.

O meu programa de gestão permite integrações?

Depende do programa e, muitas vezes, do módulo contratado. Alguns têm API documentada e aberta, outros só com licença adicional, e há ainda os que obrigam a soluções de recurso, como ficheiros trocados numa pasta partilhada. Verificamos isso antes de apresentar proposta.

A integração funciona em tempo real?

Pode ser em tempo real, a cada alteração, ou por sincronização periódica de poucos em poucos minutos ou uma vez por dia. A escolha depende do que o sistema do outro lado aguenta e da diferença que a atualização imediata faz ao seu negócio.

O que acontece se um dos sistemas mudar?

Se o fornecedor alterar a API, a ligação pode deixar de funcionar. É por isso que deixamos alertas: em vez de descobrir semanas depois, sabe no próprio dia e a correção é feita sobre um problema pequeno.

Os dados ficam seguros?

As ligações usam canais cifrados e chaves de acesso próprias, com permissões limitadas ao estritamente necessário. Não guardamos cópias de dados que não sejam precisas para o funcionamento, e as credenciais ficam registadas em nome da sua empresa.

Podem ligar ao site uma plataforma que só nós usamos?

Sim, desde que exista uma forma de acesso, seja API, base de dados ou troca de ficheiros. Quando não existe nada disso, avaliamos se compensa construir essa porta ou se é preferível repensar a ferramenta.

Diga-nos que sistemas quer ligar

Indique as ferramentas que usa e o trabalho manual que quer deixar de fazer. Avaliamos se a ligação é possível e, se for, o que custa.

Outros serviços de Desenvolvimento

Marcar reunião

Diga-nos quando lhe dá jeito e respondemos com a confirmação. Não é uma marcação automática: a reunião é sempre confirmada por uma pessoa.

Manhã ou tarde

Ready for now?

Receba no email o que vamos fazendo: projetos novos, o que aprendemos pelo caminho e pouco mais. Sem spam, e sai quando quiser.