Comprar a partir de um chamado, sem redigitar nada no portal de compras. O módulo Mercado Eletrônico do NexTool liga o GLPI à plataforma de compras Mercado Eletrônico (ME) e transforma um chamado numa requisição de compra - com catálogo sincronizado, aprovação única e acompanhamento automático do ciclo até ao pedido, tudo dentro do GLPI.
O problema
Quando a TI ou o setor de compras recebe um pedido de compra por chamado, o fluxo tradicional é manual e duplicado: o técnico regista o chamado no GLPI, abre o portal do Mercado Eletrônico, volta a digitar os itens, escolhe fornecedor e aprovador e depois regressa ao chamado para anotar o número. Cada requisição passa por duas ferramentas e, muitas vezes, por duas aprovações. O resultado é retrabalho, erro de digitação e - o que mais custa numa auditoria - perda de rastreabilidade entre o chamado que originou a compra e o pedido que saiu. Quando alguém pergunta "esse pedido foi mesmo aprovado por quem devia?", a resposta desaparece entre dois sistemas.
Como funciona o Mercado Eletrônico
O módulo adiciona o separador Requisição ME ao chamado e trata da ponte com o ME de ponta a ponta:
- Catálogo sincronizado - produtos, grupos, fornecedores, filiais e utilizadores do ME são importados para dentro do GLPI, com pesquisa em todos os campos.
- Requisição no próprio chamado - cascata Grupo → Produto, aprovador, filial de entrega, categoria e quantidade, com o total estimado calculado ao vivo.
- Aprovação única - quem tem a permissão "Enviar requisição já aprovada" envia a requisição ao ME já aprovada, eliminando a segunda aprovação manual; sem essa permissão, chega ao ME a aguardar aprovação.
- Confirmação automática - o estado volta do ME por webhook e uma rotina de reconciliação mantém tudo sincronizado; quando o ME recusa a requisição por falta de permissão no grupo de produtos, o chamado mostra o motivo, a requisição volta para correção e reenvio e o grupo fica marcado como bloqueado no catálogo.
- Linha do tempo no chamado - pré-pedido, cotação e pedido surgem como etapas no próprio chamado, sem abrir o portal do ME.
O que o módulo entrega além do GLPI nativo
O GLPI tem um registo sólido de fornecedores, contratos e orçamentos - mas não dialoga com uma plataforma de compras externa. É exatamente essa ponte que o módulo constrói:
| Necessidade | GLPI nativo | Com o módulo Mercado Eletrônico |
|---|---|---|
| Registar pedido de compra a partir de um chamado | Nota manual no texto do chamado, sem estrutura | Separador Requisição ME com itens, aprovador e total estimado |
| Catálogo de produtos e fornecedores | Registo manual de fornecedores; sem catálogo do ME | Catálogo do ME (produtos, grupos, fornecedores, filiais) sincronizado |
| Enviar a requisição à plataforma de compras | Voltar a digitar tudo no portal do ME | Envio direto do chamado, sem redigitação |
| Acompanhar pré-pedido, cotação e pedido | Consultar o portal do ME manualmente | Linha do tempo automática no chamado, via webhook |
| Grupo sem permissão de compra | Recusa vista só no portal do ME | Recusa mostrada no chamado, com o motivo, e grupo marcado como bloqueado no catálogo |
Do chamado ao pedido, sem sair do GLPI
Depois de enviada, a requisição percorre o ciclo do ME - pré-pedido, cotação e pedido. O módulo acompanha cada etapa automaticamente pelos webhooks do Mercado Eletrônico e desenha uma linha do tempo no próprio chamado: o técnico vê se o pré-pedido foi gerado, em que fase está a cotação e quando o pedido foi emitido. Cada evento que o ME envia passa por estas etapas antes de chegar ao chamado:
# o que o GLPI faz com cada evento que o ME envia
1. confere o Basic Auth: utilizador e palavra-passe da credencial desta instancia (sem eles, recusa com 401)
2. confere a assinatura HMAC (X-ME-WEBHOOK-SIGNATURE), so se o token de verificacao estiver configurado
3. ignora eventos repetidos (X-ME-EVENT-ID) e guarda o evento em bruto na caixa de entrada
4. responde 200 em menos de 10 s, dentro do prazo do ME
5. a tarefa "tracking" (a cada 2 min) consulta o pre-pedido, a cotacao ou o pedido pelo ID na API do ME
e atualiza a linha do tempo do chamado
Um detalhe que só aparece quando se opera a integração em produção: os endpoints de listagem da API do Mercado Eletrônico (/pre-orders e /orders) ignoram boa parte dos filtros de consulta que a documentação sugere. Descobrimos isso na sustentação ao ver a reconciliação trazer registos que deviam estar filtrados. A decisão foi tratar a integração como caixa de entrada: em vez de confiar em filtro remoto, o módulo guarda cada evento recebido, consulta o recurso pelo próprio ID na API do ME e faz a correspondência com o chamado localmente, pelo número da requisição, que vem no evento ou nos itens do pré-pedido. Além disso, todo o webhook tem de passar pelo Basic Auth, com o utilizador e a palavra-passe da credencial desta instância, e a assinatura HMAC pode ser exigida como camada extra: um webhook sem credencial válida é recusado, porque o estado de uma compra não pode ser forjado por um pedido qualquer que encontre o URL.
Como ativar
- Instale o NexTool no seu GLPI 11.
- Aceda a Configuração > NexTool > Módulos e ative o Mercado Eletrônico.
- No separador Integrações, indique as credenciais da API do ME e teste a ligação.
- Defina o âmbito (entidades e categorias de chamado) que poderão gerar requisição.
- Registe os webhooks de ciclo com um clique e confirme o URL de retorno configurado no ME.
Para quem é indicado
Empresas que usam o Mercado Eletrônico como plataforma de compras e atendem pedidos via service desk no GLPI - TI, compras e facilities que querem eliminar a dupla digitação e manter chamado e compra rastreáveis no mesmo sítio.
Quando NÃO usar: se a empresa não usa o Mercado Eletrônico como plataforma, o módulo não se aplica - é específico do ME, não um catálogo genérico de compras. Se o pedido de compra não nasce de um chamado, a integração não acrescenta rastreabilidade. E se só precisa de registar fornecedores, contratos e orçamentos internos, o registo nativo do GLPI já resolve, sem integração externa.
Compatibilidade
- GLPI: 11.0+
- Plano: Licenciado (a pedido)
- Plugin: NexTool 6.15.0+
- Mercado Eletrônico: API v1 (homologação e produção)
Próximo passo
O Mercado Eletrônico faz parte do NexTool, ecossistema de módulos para expandir o GLPI sem personalizações de código. Veja a página do módulo ou fale com a equipa para uma demonstração.
Revisto pela equipa NexTool Solutions.
