Catálogo de Adapters de Integração do ADMS — Manual Técnico Schneider (Anexo 4)

Projeto: DSB26201 · Assessment de Arquitetura de Integrações · Energisa Fonte: Anexo A - 4. Manual Técnico do EcoStruxure ADMS 3.8 (1).pdf (933 páginas, fabricante Schneider Electric), seção "Adaptadores de integração do ADMS Online", páginas 883–902 Status: Achado novo — catálogo do fabricante, ainda não cruzado com inventário de uso real em produção na Energisa Elaborado por: Syntropy Labs

Por que este artefato existe

Este catálogo é o que o fabricante documenta como disponível na plataforma de integração do EcoStruxure ADMS — não é, por si só, evidência de que a Energisa usa todos esses adapters hoje. É importante manter essa distinção clara: alguns adapters já têm evidência de uso confirmada em outros artefatos (WFM, CRM/OSR/ONT — ver seção "Cruzamento com uso confirmado"), outros aparecem no manual mas não têm nenhuma menção em Ata, transcrição ou diagrama deste assessment até agora.

Este artefato nasceu de uma pergunta direta sobre uma tabela de siglas (CRM/ONT/OSR/WFM/SMR/SMN/AVL/FM/FU) que havia sido colada em conversa — na extração do manual, o catálogo real do fabricante acabou sendo mais completo (13 adapters, não 10) e revelou duas correções importantes em relação à tabela original: IQOS não existe no manual (zero ocorrências em 933 páginas) e "Send Works Service" pertence ao adapter SMN, não ao WFM (a tabela original atribuía esse serviço à direção S→E do WFM).

Padrão técnico comum a todos os adapters

Segundo o manual (p. 883): todos os adapters seguem a arquitetura de microsserviços, cada um expondo um conjunto de web services SOAP conforme os padrões IEC 61970 e IEC 61968 (em particular a série IEC 61968-100), com segurança via WS-Security. A plataforma já está em produção em mais de 80 distribuidoras globalmente, historicamente integrada a middlewares como Apache MQ, IBM Integration Bus/WebSphere MQ, JBoss Fuse, Microsoft BizTalk, Mule ESB, Oracle Service Bus, SAP PI, Software AG webMethods e TIBCO EMS — nenhuma dessas é a stack usada pela Energisa hoje (Kafka/Confluent), citada aqui só como contexto do produto.

Catálogo completo (16 adapters, p. 883–902)

Sigla	Nome completo	Direção / padrão de comunicação	Serviços web principais	Página
AMI	Advanced Metering Infrastructure	Solicitação/resposta e polling — status e leitura de medidores	GetMeterReadingsService e outros, conforme IEC 61968-9/100	884–887
AVL	Automated Vehicle Location	E→S, quase tempo real	ReceiveVehicleCoordinatesService (ChangedVehiclesCoordinates)	892–893
CRM/IVR	Customer Relationship Management / Interactive Voice Response	E→S (criação/atualização de ticket) e S→E (callbacks)	ReceiveTroubleTicketsService, GetTroubleTicketsService, GetCallBacksService, ReceiveCallBacksResultsService, SendCallBacksClient	887–888
DERMS	Distributed Energy Resource Management	E→S (comandos) e S→E (status/previsão)	GetDERGroupStatuses, GetDERGroupForecasts, ExecuteDERGroupDispatches (Web Service Client)	897–898
Email	Integração de E-mail	ADMS → SMTP, sob demanda (via DMD) ou por exceção (evento)	Sem serviço web dedicado — propagação via protocolo SMTP; também expõe recuperação de catálogo de endereços (Active Directory do sistema DMZ)	900
Integração de Arquivos (Claim Check / Monitor / Upload)	—	Depende do padrão: notificação, monitoramento de pasta compartilhada, ou upload para destino externo	ReceiveFileNotification (Claim Check Adapter), FileMonitoringService (Monitor de Arquivo), SendFileNotifications (Upload de Arquivo)	894
NIN	Network Import Notifications	ADMS → sistema externo	Web Service Client + upload SOAP — notifica mudança de estado de extrato/changeset	895
ONT	Outage Notification	S→E, publish/subscribe, quase tempo real	SendIncidentsService, SendIncidentUsagePointsService, SendIncidentTroubleTicketsService	890–891
OSR	Outage Status and Reporting	E→S, request/response	ReceiveIncidentHazardsService, GetIncidentHazardsService, ReceiveIncidentsService, GetIncidentsService, GetIncidentUsagePointsService	889–890
RLN	Redlining	ADMS → sistema externo (GIS); integração pronta com EcoStruxure ArcFM via REST, outros GIS via SOAP IEC 61968-100	SendRedlinesService (CreatedRedlines/ChangedRedlines/DeletedRedlines)	896–897
SSS (Seamless / SiteSwitch)	Integração Seamless — troca de site	Consulta (REST)	IsActive — informa qual site ADMS está ativo, para o balanceador de carga rotear o tráfego DNS; automatiza o processo de troca de site	901
SNI	Site Notes Integration	Bidirecional — E→S (CIS → ADMS) e S→E (ADMS → CIS)	ReceiveUsagePointsSiteNotesService (ChangedUsagePointSiteNotes), ExecuteSiteNotesService (CreateSiteNotes)	902
SMN	Switching Management Notification	S→E, unidirecional ADMS→externo, quase tempo real	SendWorksService (CreatedWorks/ChangedWorks/DeletedWorks), SendSwitchingPlansService, SendSwitchingSteps	899
SMR	Switching Management Reporting	E→S, request/response	ReceiveWorksService, ReceiveSwitchingPlansService, ReceiveSwitchingStepsService, GetWorksService, GetSwitchingPlansService	899
WDI	Weather Data Integration	E→S	Camada de comunicação genérica (SOAP, REST, arquivo ou banco compartilhado)	893
WFM	Workforce Management	E→S	ReceiveCrewAssignmentsService, ReceiveVehiclesService, ReceiveCrewsService; alternativa via ReceiveCrewModelService (MWF Adapter) ou Claim Check Adapter para volumes grandes	891–892

Correções em relação à tabela originalmente levantada

• IQOS não existe neste manual. Busca por "IQOS" nas 933 páginas do documento: zero ocorrências. O "IQOS" referenciado em outros artefatos deste assessment (motor de cálculo de indicadores, tratado em integracao-wfm-adms.md e na sessão de Monitoramento/Observabilidade) é quase certamente um sistema/componente próprio da Energisa (possivelmente ligado ao Oracle "IQOS" já catalogado como um dos 5 bancos corporativos em blueprint-componentes-adms.md, seção C.0), não um adapter do catálogo padrão do fabricante Schneider. Não presumir que são a mesma coisa sem confirmação. Pista externa não confirmada (28/08/2026): pesquisa web (não é fonte primária da Energisa) identifica "IQOS" como Onesait IQOS, produto da Minsait (mesmo fornecedor já confirmado do GIS Adapter e do motor de cálculo IQOS — ver integracao-gis-adms.md e integracao-wfm-adms.md) para cálculo e auditoria de indicadores regulatórios de continuidade (DEC/FEC, ANEEL), integrado ao ADMS a partir do módulo OMS. Coerente com as duas outras menções de "IQOS" no assessment. Confirmado por Castellani (Syntropy Labs), 05/09/2026: IQOS é de fato produto Minsait (Onesait IQOS), fechando essa hipótese. Continua não sendo, tecnicamente, um dos 13 adapters do catálogo do fabricante Schneider — é um sistema/produto à parte que aparece listado ao lado dos adapters do catálogo em comunicações da Energisa (ex.: a mesma mensagem de Norberto da Silva Prado de 27/08/2026 sobre a planilha catalogo-adapters-schneider-adms.xlsx inclui "IQOS" na lista de itens confirmados em uso, tratando-o informalmente como parte do mesmo grupo).
• "Send Works Service" pertence ao SMN, não ao WFM. A tabela originalmente colada atribuía esse serviço à direção S→E da linha WFM — o manual mostra que é o adapter SMN (Switching Management Notification) quem expõe SendWorksService, SendSwitchingPlansService e SendSwitchingSteps, todos no sentido ADMS→sistema externo. O adapter WFM, por sua vez, só tem serviços E→S (Receive*) — não expõe nenhum serviço de notificação de saída.
• "FM" e "FU" não são as siglas usadas pelo manual. O documento não usa essas abreviações — descreve três componentes distintos sob "Integração de Arquivos" (p. 894): Claim Check Adapter, Adaptador de Monitor de Arquivo e Adaptador de Upload de Arquivo. A intenção provavelmente é a mesma (mecanismos de troca de arquivo — File Monitoring / File Uploading), mas o nome exato usado no manual é diferente do que constava na tabela original.
• Catálogo é maior do que a tabela original: o manual documenta 13 adapters, cinco dos quais (AMI, NIN, RLN, SNI, WDI) não apareciam na tabela original e não têm, até este artefato, nenhuma evidência de uso na Energisa em nenhum outro documento deste assessment.
• Leitura completa da seção (07/09/2026) revela mais 3 adapters e fecha o detalhe técnico de 2 outros. A citação de página original (883–899) parava exatamente onde a tabela parava — mas a seção continua até a p. 902 com três subseções que a extração original não cobriu: Integração de e-mail (p. 900), Integração Seamless / SiteSwitch — SSS (p. 901), e o detalhamento técnico completo de Integração Site Note (p. 902, a sigla SNI já constava, mas sem detalhe — só a lista de benefícios). Além disso, DERMS (Distributed Energy Resource Management, p. 897–898) estava dentro do range de página já citado, mas tinha sido omitido da tabela — provavelmente por não aparecer na lista de siglas original que motivou este catálogo. O mesmo motivo explica por que RLN também não tinha detalhe técnico até agora, apesar de estar dentro do range — agora preenchido. Catálogo passa de 13 para 16 adapters.

Adapter → Sistema — mapeamento completo dos 16, incluindo os sem uso confirmado

Tabela reorganizada em 13/08/2026 para responder diretamente: qual sistema da Energisa corresponde a cada adapter, e para os que não têm uso confirmado, se ao menos existe um sistema plausível do lado Energisa (mesmo sem confirmação de que o adapter é o mecanismo usado).

Adapter (Schneider)	Sistema(s) correspondente(s) na Energisa	Status da evidência	Fonte
WFM	SIGOD (legado, carga full) + eForce (moderno, ApiOntMiddleware)	Confirmado	integracao-wfm-adms.md, integracao-wfm-eforce-ordem-servico.md
CRM/IVR	CRM-Service (SIATE/SIATT) — fluxo WSROT → MsCrmMiddleware	Confirmado	fluxos-atendimento-adms.md, hld-as-is-adms.md
OSR / ONT	Mesmo par CRM-Service, no mesmo fluxo WSROT — OSR no envio (E→S), ONT na notificação de retorno (S→E)	Confirmado — Norberto da Silva Prado (Energisa), mensagem de 27/08/2026, respondendo ao preenchimento da planilha catalogo-adapters-schneider-adms.xlsx; resolve também a ambiguidade "ONT vs. ENT" já registrada em sensedia-f5-siteswitch-adms.md	fluxos-atendimento-adms.md; confirmação de uso — planilha catalogo-adapters-schneider-adms.xlsx
Integração de Arquivos (Claim Check/Monitor/Upload)	Três sistemas plausíveis pelo mesmo mecanismo de pasta SFTP monitorada: GIS (extrato XML por circuito — o fluxo descrito em integracao-gis-adms.md, "ADMS Staging escuta a pasta SFTP e importa os extratos", bate literalmente com a descrição do fabricante para o Adaptador de Monitor de Arquivo), Atendimento (MsAttClienteCsv/MsAttDesligamentoProgramado), WFM/SIGOD (carga full de equipes)	Para o GIS especificamente: confirmado nominalmente em 03/09/2026 — a equipe do GIS respondeu ao follow-up de 31/08/2026 (item 4) que o serviço é o FileMonitoringService, o mesmo nome do Adaptador de Monitor de Arquivo do manual do fabricante — é o adapter padrão Schneider, não uma solução proprietária da Energisa/Minsait (ver seção "Confirmação do adaptador de arquivo do fluxo GIS" abaixo). Norberto da Silva Prado confirmou em 27/08/2026 o uso do mecanismo geral (siglas antigas "FM"/"FU"), mas sem atribuir individualmente a Atendimento ou WFM/SIGOD — para essas duas, segue plausível sem confirmação	integracao-gis-adms.md, fluxos-atendimento-adms.md, integracao-wfm-adms.md
SMR / SMN	SGM (EAM, domínio 2 — Gestão de Ativos) — SMR (E→S) para o envio da ordem de manutenção, SMN (S→E) para o retorno via callback	Confirmado — Norberto da Silva Prado (Energisa), mensagem de 27/08/2026, respondendo ao preenchimento da planilha catalogo-adapters-schneider-adms.xlsx; resolve a pergunta 8 do Bloco 5 do questionário de mitigação de lacunas	integracao-manutencao-dms-adms.md; confirmação de uso — planilha catalogo-adapters-schneider-adms.xlsx
AMI	Sistema AMI existe na Energisa — é o próprio produto do domínio 5 "Proteção à Receita" no framework corporativo	Sistema confirmado, mas sem nenhuma evidência de integração com o ADMS via este ou qualquer outro mecanismo em todo o assessment	framework-dominios-funcionais.md
WDI	Hipótese especulativa: NetClima, produto 3.2 do domínio "Operação de Redes", é o único sistema de dados meteorológicos documentado no assessment	Especulativo, só por semelhança de propósito (WDI = dados de clima) — nenhuma Ata, transcrição ou artefato menciona qualquer integração NetClima↔ADMS; diferente de SMR/SMN, aqui não há nem leitura estrutural de fluxo, só coincidência de tema. Tratar como pergunta a levantar, não como leitura plausível	framework-dominios-funcionais.md
AVL	Sistema/mecanismo específico ainda não identificado — uso confirmado, mas sem sistema Energisa nomeado até o momento	Confirmado o uso — Norberto da Silva Prado (Energisa), mensagem de 27/08/2026; sistema/serviço consumidor específico ainda não detalhado, pendente de resposta mais granular na planilha	Confirmação de uso — planilha catalogo-adapters-schneider-adms.xlsx
NIN, RLN, SNI	Nenhum sistema correspondente identificado em qualquer artefato deste assessment	Sem evidência — nem de uso do adapter, nem de um sistema Energisa que faria sentido no papel. NIN foi avaliado e descartado como candidato ao fluxo GIS (ver nota abaixo)	—
DERMS	Nenhum — DERMS está explicitamente fora do escopo do projeto ADMS	Confirmado fora de escopo (não é lacuna de evidência)	glossario-tecnico.md (Slide 23, Ata 03)
Email	Nenhum sistema correspondente identificado	Sem evidência — nenhuma sessão ou artefato menciona notificação por e-mail via adapter ADMS	—
SSS (Seamless/SiteSwitch)	Nenhum uso confirmado — mas o processo que ele automatizaria (troca de site) já está documentado como manual e como risco Alta	Achado relevante, sem confirmação de uso — ver arquitetura-integracao-esb-adms.md, seção 6, para o cruzamento completo	sensedia-f5-siteswitch-adms.md

Por que NIN não é o adapter do fluxo GIS, apesar da descrição parecer compatível: a direção documentada pelo fabricante para NIN é ADMS → sistema externo ("notifica mudança de estado de extrato/changeset"). O fluxo GIS confirmado é o oposto — GIS → ADMS, unidirecional, sem qualquer retorno do ADMS ao GIS (integracao-gis-adms.md: "NENHUMA atualização cadastral de volta"). A direção não bate, por isso o candidato mais plausível para o fluxo GIS é o Adaptador de Monitor de Arquivo (dentro de "Integração de Arquivos" acima), não o NIN — registrado aqui para que uma leitura futura não repita a tentação de casar os dois só pelo tema "changeset".

Confirmação do adaptador de arquivo do fluxo GIS (03/09/2026)

A equipe do GIS respondeu ao item 4 do follow-up de 31/08/2026 (que até então só havia prometido "verificar o nome correto do serviço e confirmar em seguida" — ver histórico na linha do GIS na tabela acima): o serviço do ADMS que identifica os arquivos no servidor SFTP e os transfere para a área de Staging para processamento posterior é o FileMonitoringService.

O nome bate literalmente com o que o manual do fabricante documenta para o Adaptador de Monitor de Arquivo, dentro de "Integração de Arquivos" (p. 894, tabela do catálogo acima) — fecha, para o caso do GIS, a pergunta que este artefato deixava em aberto desde a extração do manual: não é uma implementação própria da Energisa/Minsait que só coincide na forma, é o adapter padrão do produto Schneider mesmo, usado tal como documentado pelo fabricante. Não confirma, por si só, se Atendimento (MsAttClienteCsv/MsAttDesligamentoProgramado) e WFM/SIGOD usam o mesmo mecanismo — essas duas permanecem como hipótese plausível por semelhança de padrão (pasta SFTP monitorada), não confirmação nominal.

Próximo passo

Confirmar com a Energisa (Norberto/equipe ADMS) quais destes 13 adapters estão de fato ativos em produção — hoje a única fonte é o manual do fabricante, que documenta capacidade disponível, não uso real. Prioridade: ~~resolver definitivamente o adapter de arquivo do fluxo GIS~~ — confirmado em 03/09/2026: FileMonitoringService (ver seção acima); ~~resolver definitivamente OSR/ONT~~ e ~~confirmar ou descartar SMR/SMN no SGM~~ — ambos confirmados em 27/08/2026 por Norberto da Silva Prado, via preenchimento da planilha catalogo-adapters-schneider-adms.xlsx (a mesma resposta confirmou o uso de AVL, ainda sem sistema Energisa específico nomeado); segue em aberto esclarecer se AMI e WDI têm algum uso não capturado nas sessões realizadas — perguntas correspondentes em 080-diagnostico/questionario-mitigacao-lacunas.md.

Adicionado em 07/09/2026, com a leitura completa da seção 19.5: SSS (Seamless/SiteSwitch) não tem uso confirmado, mas o caso de uso documentado pelo fabricante (automatizar a detecção de qual site ADMS está ativo, para um balanceador de carga) coincide diretamente com um risco Alta já levantado pela própria Energisa — troca de site hoje manual, ver arquitetura-integracao-esb-adms.md, seção 6. Vale uma pergunta pontual à equipe ADMS/Schneider sobre viabilidade de adoção, não necessariamente formalizada já no questionário de lacunas (é sugestão de melhoria, não achado de arquitetura em uso).