Servidores próprios na Europa · RGPD · Suporte no seu idioma

Integrações

Ligamo-nos a qualquer sistema, não só ao seu ERP

Além do ERP, o Kimobox liga-se a qualquer sistema aberto ou com API: um CRM, uma loja online, um portal da administração, um desenvolvimento próprio. A ligação é bidirecional e o processamento de cada dado adapta-se ao seu caso, não a um modelo genérico.

O que se pode ligar

Uma plataforma fechada acaba por ser mais um silo, por melhor que seja. O Kimobox disponibiliza uma API REST documentada para ler e escrever qualquer dado do sistema, e admite webhooks para avisar outros sistemas quando algo acontece. Com isso, a ligação não se limita ao ERP: um CRM, uma loja online, um sistema SCADA, um portal da administração ou um desenvolvimento próprio podem participar nos mesmos processos.

Conteúdo revisto em

Estilo de interface
REST sobre HTTPS Com autenticação por token e permissões por âmbito
Sentido
Leitura e escrita A API não é uma mera exportação de consulta
Eventos
Webhooks de saída O sistema externo sabe no momento, sem sondar a cada minuto
Formato
JSON Descrito com especificação OpenAPI
Rastreabilidade
Cada chamada fica registada Com origem, âmbito, resultado e tempo de resposta

API bidirecional

Os dados entram e saem: o Kimobox lê do seu sistema e também escreve nele.

Qualquer sistema com API

CRM, e-commerce, banca, administração pública ou um desenvolvimento próprio: se disponibiliza uma API ou uma base de dados, liga-se.

Processamento personalizado

Cada integração é programada à medida: que dado transforma, que regra aplica e em que formato o entrega.

Registo de cada troca

Log consultável, novas tentativas automáticas e aviso se algo falhar.

Sem abrir o seu sistema a terceiros

A ligação usa credenciais que a empresa controla e pode revogar.

Migrações e importações pontuais

Cargas iniciais ou pontuais a partir de Excel, ficheiros ou qualquer outra fonte.

O que se liga habitualmente


Sistemas com que já trabalhámos

  • CRM e ferramentas comerciais
  • Lojas online e marketplaces
  • Bancos e gateways de pagamento
  • Portais da administração pública
  • Desenvolvimentos à medida com API própria
  • Folhas de cálculo e ficheiros planos
KIMOBOX CRM E-COMMERCE BANCA E PAGAMENTOS ADMIN. PÚBLICA DESENVOLV. PRÓPRIO API BIDIRECIONAL · PROCESSAMENTO PERSONALIZADO POR SISTEMA

Exemplos reais


Ligações que não são o ERP

Comércio eletrónico

Ocorrências de encomenda a partir da loja

Antes A reclamação chega ao e-mail do apoio ao cliente e alguém a copia à mão para o sistema da qualidade, quando se lembra.

Depois A loja cria a não conformidade por API com o número da encomenda e as fotografias. O circuito de tratamento arranca no momento.

Indústria · sistema SCADA

Alarmes de processo que não deixam registo

Antes O alarme toca na sala de controlo e é anotado num caderno se o operador tiver tempo.

Depois O SCADA envia o alarme para o Kimobox, que abre o registo com a hora exata e o valor. A revisão mensal faz-se sobre dados completos.

Serviços · portal público

Submissões à administração

Antes Alguém entra no balcão eletrónico, submete e guarda o comprovativo numa pasta, se se lembrar.

Depois O processo é preparado no Kimobox, submetido pela interface correspondente e o comprovativo regressa automaticamente ao processo.

Vocabulário


Termos de interoperabilidade

API REST
Interface baseada em HTTP com operações normalizadas sobre recursos identificados por URL. A sua vantagem prática é que qualquer linguagem a sabe consumir sem bibliotecas especiais.
Webhook
Chamada que o sistema de origem faz ao destino quando ocorre um evento. Inverte o modelo de sondagem: em vez de perguntar a cada minuto se há novidades, recebe-se o aviso.
OpenAPI
Especificação normalizada para descrever uma API de forma legível por máquinas. Permite gerar clientes e documentação sem os escrever à mão.
Âmbito (scope)
Permissão concreta associada a um token de acesso. Limitar o âmbito é o que evita que uma integração só de leitura possa apagar algo por erro.
Limite de chamadas
Teto de pedidos por unidade de tempo. Protege o sistema de uma integração mal escrita e obriga a desenhar a sincronização por lotes quando o volume o pede.

Perguntas frequentes


O que nos perguntam antes de começar

E se o meu sistema não tiver API?

Se disponibilizar base de dados, ficheiros ou outro ponto de acesso, quase sempre há uma via. Avaliamos caso a caso.

Quem programa a integração?

A nossa equipa, a partir do que precisa de transformar e com que regras.

Posso ter várias integrações ao mesmo tempo?

Sim, cada uma é independente e monitorizada em separado.

O que se pode fazer com a API?

Ler e escrever praticamente qualquer dado do sistema: criar registos, avançar um fluxo, consultar o estado de um processo, descarregar documentos. Não é uma exportação só de leitura.

Como é feita a autenticação?

Com tokens de acesso aos quais se atribui um âmbito concreto. Limitar o âmbito é o que evita que uma integração pensada para consultar possa apagar algo por descuido.

O que são os webhooks e para que servem?

São avisos que o Kimobox envia ao sistema externo quando ocorre um evento. Evitam que o outro sistema tenha de perguntar a cada minuto se há novidades, e fazem com que as integrações reajam no momento.

Está documentada?

Sim, com especificação OpenAPI, de modo que se podem gerar clientes e documentação automaticamente em vez de os escrever à mão.

Há limite de chamadas?

Sim, para proteger o serviço de uma integração mal escrita. Quando o volume o exige, a sincronização é desenhada por lotes em vez de registo a registo.

Conte-nos que sistema quer ligar

Mostramos-lhe o módulo a funcionar com dados semelhantes aos seus.

Pedir uma demonstração

Fontes


De onde vem cada dado

Referências ao texto oficial em vigor. Se uma norma for revista, esta página é atualizada e a data de revisão reflete-o.

  1. OpenAPI Specification OpenAPI Initiative · Especificação em vigor
  2. RFC 9110 — HTTP Semantics IETF · Junho de 2022
  3. Regulamento (UE) 2023/2854 dos Dados (Data Act), sobre acesso e interoperabilidade EUR-Lex · 13 de dezembro de 2023

Conectividade aberta: integre o Kimobox com qualquer sistema com API

O Kimobox oferece conectividade aberta através de uma API REST bidirecional, que permite integrar qualquer sistema que disponibilize uma API ou uma base de dados acessível: CRM, e-commerce, banca, administração pública ou desenvolvimentos próprios, além do ERP.

Cada integração é processada de forma personalizada segundo as regras de negócio do cliente, com registo de cada sincronização, novas tentativas automáticas e alertas perante erros, sem necessidade de abrir o sistema de origem a terceiros.