Integrar sistemas públicos é permitir que informações necessárias circulem com significado e responsabilidade. Antes de pedir que duas plataformas se conectem, determine qual dado será compartilhado, por qual motivo e quem poderá utilizá-lo. Uma API é um meio técnico; não substitui a definição do processo.
Identifique a fonte de cada informação
Liste os dados necessários e o sistema responsável por mantê-los. Um cadastro pode existir em mais de uma plataforma com nomes ou códigos diferentes. Defina qual fonte prevalece e como divergências serão verificadas pela equipe.
Como exemplo hipotético, um pedido de material utiliza o código de uma unidade administrativa que precisa corresponder ao registro do almoxarifado. Se os códigos não se alinham, a integração pode transmitir informações válidas para o setor errado. Esse problema não se resolve apenas com uma conexão funcionando.
Combine o significado dos campos
Explique o que cada status, data, identificador e categoria representa. O mesmo termo pode ter sentidos distintos em setores diferentes. A ePING inclui dimensões técnica, semântica e organizacional da interoperabilidade, uma referência útil para separar formato de informação, significado e responsabilidade.
Registre regras de transformação e trate campos ausentes de maneira explícita. Evite preencher lacunas com valores presumidos. A equipe precisa distinguir dado desconhecido, informação ainda não recebida e registro efetivamente vazio.
Defina acesso e finalidade
Compartilhar dados não significa disponibilizá-los a qualquer usuário. Esclareça a finalidade, as permissões e a necessidade de cada setor. Separe informações que podem ser publicadas de dados pessoais ou restritos. A avaliação das condições jurídicas deve envolver os responsáveis do órgão.
A presença de um portal público não autoriza publicar automaticamente toda base interna. Fontes, revisão e periodicidade de atualização precisam ser definidas antes da exposição das informações.
Planeje o que acontece quando falha
Discuta indisponibilidade, alteração de formato, pedidos repetidos e dados que chegam fora de ordem. Quem recebe o aviso? Como se retoma o envio sem duplicar uma operação? Qual equipe verifica se o registro foi realmente aceito pelo destino?
No contrato ou escopo, identifique quem mantém cada lado da integração. Serviços externos podem impor limites, credenciais, versões e custos. Não assuma que o fornecedor terá acesso às interfaces necessárias antes de confirmar sua disponibilidade.
Valide um percurso completo
Teste com dados adequados e verifique entrada, transformação e consulta no destino. Inclua registros incompletos e uma falha simulada. Uma resposta técnica de sucesso não prova que o servidor consegue executar a tarefa final.
O SIGEM é apresentado para estoque e materiais, enquanto o Portal da Transparência atende a publicação de informações públicas. São frentes distintas; conexões e responsabilidades dependem do projeto. O guia municipal ajuda a preparar os requisitos antes da proposta.
Perguntas para o levantamento
- Qual sistema é a fonte de cada campo?
- Quais identificadores são compatíveis?
- Quem acessa e com qual finalidade?
- Como a equipe trata erros e duplicidades?
- Quem mantém a integração após mudanças?
Referência
ePING — interoperabilidade técnica, semântica e organizacional.
