Erro “The call to GetCustomUI for RibbonID ‘Microsoft.Excel.Workbook’ failed” no Excel: causas e soluções

O erro “The call to GetCustomUI for RibbonID ‘Microsoft.Excel.Workbook’ failed” no Excel geralmente indica falhas em suplementos que personalizam a Faixa de Opções (Ribbon). Veja como diagnosticar e corrigir de forma segura e definitiva, com foco em ambientes Microsoft 365/Office.

Visão geral do erro

Ao iniciar o Excel ou criar um novo livro, a aplicação pode exibir a mensagem:

The call to GetCustomUI for RibbonID 'Microsoft.Excel.Workbook' failed

Em seguida, surgem pop‑ups de Custom UI Runtime Error. Em algumas máquinas, a Ribbon deixa de responder ou perde botões adicionados por terceiros.

Sintomas comuns

• Pop‑ups repetidos de erro ao abrir o Excel, ainda que o aplicativo continue carregando.
• Botões personalizados na Ribbon sem ícones, desabilitados ou ausentes.
• Guias adicionais da Ribbon (de ERP, BI, antivírus, etc.) desaparecem.
• Planilhas que dependem de macros de interface deixam de funcionar.
• Carregamento muito lento no splash screen “Iniciando…”.

Por que isso acontece

O Excel permite que suplementos COM, XLL e VBA modifiquem a interface por meio de RibbonX (XML). Se o XML estiver malformado, referenciar controles que não existem, chamar callbacks ausentes ou quando o suplemento está desatualizado/incompatível, o Excel falha ao carregar a interface personalizada e mostra o erro.

Uma causa muito relatada é o componente Microsoft Access Outlook Add‑in for Data Collection and Publishing (às vezes listado como “Microsoft Office/Access Outlook Add‑in for Data Collection and Publishing”). Ele pode ser instalado com o Office mesmo que você não use o Outlook, registrando uma DLL que o Excel tenta carregar.

Como resolver — roteiro rápido

Se preferir um caminho curto, siga esta tabela. Em seguida, abaixo há detalhamento e opções avançadas.

Passo	O que fazer	Observações
1	Iniciar o Excel em Modo de Segurança → Win + R → excel /safe	Se o erro não aparecer em modo seguro, confirma que a origem está em um ou mais suplementos.
2	Rever e desativar suplementos COM Excel: Arquivo → Opções → Suplementos → Gerenciar: Suplementos COM → Ir…	Comece desmarcando Microsoft Outlook Add‑in for Data Collection and Publishing (causa frequente).
3	Desativar suplementos de terceiros	Desmarque todos, reinicie o Excel normalmente; depois reative um a um até identificar o culpado.
4	Remover ou reparar o suplemento problemático	Reinstale a versão mais recente ou contate o fornecedor. Para suplementos em VBA, valide o arquivo customUI.xml.
5	Atualizar e reparar o Office → Arquivo → Conta → Opções de Atualização → Painel de Controle → Programas → Office → Alterar → Reparar	Garante que não haja arquivos corrompidos no mecanismo de carregamento da Ribbon.
6	Verificar políticas de TI/instalações em lote	Em ambientes corporativos, outro app (p. ex. Access, Outlook, ERP) pode reinstalar o add‑in problemático a cada logon.

Passo a passo detalhado

Iniciar o Excel em Modo de Segurança

1. Pressione Win + R, digite excel /safe e confirme.
2. Se o Excel abrir sem erros, a causa é quase certamente um suplemento. Anote.

Inspecionar e desativar Suplementos COM

1. No Excel, acesse Arquivo → Opções → Suplementos.
2. Em Gerenciar, escolha Suplementos COM e clique Ir….
3. Desmarque todos temporariamente para testar; em especial, desmarque:
   • Microsoft Access Outlook Add‑in for Data Collection and Publishing;
   • Suplementos de ERP/BI (SAP, Oracle, TOTVS, Power BI Publisher legados, etc.);
   • Suplementos de antivírus/segurança que injetam botões na Ribbon.
4. Feche e reabra o Excel normalmente. Se o problema sumiu, reative um por vez até o erro reaparecer. O último reativado é o culpado.

Desativar suplementos do Excel (XLL, XLA, XLAM)

1. Em Suplementos, altere o Gerenciar para Suplementos do Excel e clique Ir….
2. Desmarque entradas desconhecidas ou de terceiros para teste.
3. Verifique as pastas de inicialização automática (ver adiante) e mova arquivos suspeitos para uma pasta temporária.

Remover, atualizar ou reparar o suplemento problemático

• Terceiros: obtenha a versão mais recente e compatível com sua edição do Office (32/64 bits). Desinstale a versão antiga antes de instalar a nova.
• Interno/VBA: valide o XML da Ribbon no customUI.xml do arquivo e garanta que todos os callbacks existam no projeto VBA.
• COM desnecessário: desinstale pelo Painel de Controle ou defina o LoadBehavior no Registro para desabilitar (detalhes mais abaixo).

Atualizar e reparar o Office

1. Em Arquivo → Conta, clique em Opções de Atualização e aplique as pendentes.
2. Se persistir, no Painel de Controle → Programas, selecione Microsoft 365/Office → Alterar → Reparo Rápido. Se necessário, faça o Reparo Online.

Verificar políticas de TI, GPO e reinstalações em lote

Em domínios corporativos, um GPO, script de logon ou ferramenta de distribuição (SCCM/Intune) pode reinstalar o add‑in a cada reinício. Depois de identificar o culpado, peça ao time de TI para remover o pacote da imagem padrão ou ajustar a política.

Diagnóstico avançado

Locais e mecanismos pelos quais suplementos carregam

Tipo	Onde gerenciar	Local típico	Notas
COM Add‑in	Arquivo → Opções → Suplementos → COM	Registro: HKCU/HKLM\Software\Microsoft\Office\Excel\Addins<ProgID>	Defina LoadBehavior para 0 para impedir carregamento automático (requer permissão/admin).
XLL/XLA/XLAM	Arquivo → Opções → Suplementos do Excel	Arquivos em disco; frequentemente em XLSTART	Desmarque na lista ou remova o arquivo da pasta de inicialização.
VBA com RibbonX	Arquivo do usuário .xlsm/.xlam	customUI/customUI.xml ou customUI/customUI14.xml dentro do pacote	Erros de XML/callbacks causam o Custom UI Runtime Error.

Pastas de inicialização automática do Excel

Uso	Caminho	Observações
Padrão por usuário	%AppData%\Microsoft\Excel\XLSTART	Arquivos aqui abrem automaticamente em toda inicialização.
Padrão por máquina	%ProgramFiles%\Microsoft Office\root\OfficeXX\XLSTART	Substitua OfficeXX pela sua versão (por exemplo, Office16).
Sistema 64 bits com Office 32 bits	%ProgramFiles(x86)%\Microsoft Office\root\OfficeXX\XLSTART	Verifique ambas as pastas em ambientes mistos 32/64 bits.

Chaves de Registro úteis

Cuidado: edite o Registro apenas se souber o que está fazendo. Faça backup antes.

• HKCU\Software\Microsoft\Office\Excel\Addins<ProgID>
• HKLM\Software\Microsoft\Office\Excel\Addins<ProgID> (para todos os usuários)

Valores comuns:

• LoadBehavior = 0 impede carregamento automático do COM Add‑in.
• FriendlyName e Description ajudam a identificar o fornecedor.

Listar suplementos via macro VBA

Use este snippet para auditar rapidamente o que o Excel está carregando:

' Pressione ALT+F11, insira um Módulo e cole:
Sub ListarSuplementos()
    Dim c As COMAddIn, a As AddIn
    Debug.Print "=== COM Add-ins ==="
    For Each c In Application.COMAddIns
        Debug.Print c.ProgId, "Conectado=" & c.Connect, "Descrição=" & c.Description
    Next c
    Debug.Print "=== Suplementos do Excel (XLL/XLA/XLAM) ==="
    For Each a In Application.AddIns
        Debug.Print a.Name, "Instalado=" & a.Installed, "Caminho=" & a.FullName
    Next a
End Sub

Verificar conflitos de arquitetura

Um Excel de 64 bits não carrega DLLs de 32 bits e vice‑versa. Se o suplemento COM foi compilado para uma arquitetura diferente da sua instalação do Office, ocorrerão falhas de carregamento e erros de Ribbon. Confirme com o fornecedor qual build é suportado.

Corrigindo o XML da RibbonX em arquivos VBA

Onde o arquivo fica

• Dentro de .xlsx/.xlsm/.xlam (que são pacotes ZIP), o XML da Ribbon fica em customUI/customUI.xml ou customUI/customUI14.xml.
• Há referência a esses parts no [Content_Types].xml do pacote.

Exemplo mínimo de XML válido

<customUI xmlns="http://schemas.microsoft.com/office/2006/01/customui">
  <ribbon>
    <tabs>
      <tab id="tabExemplo" label="Minha Guia">
        <group id="grpExemplo" label="Ações">
          <button id="btnEx" label="Executar" size="large" onAction="MacroExecutar"/>
        </group>
      </tab>
    </tabs>
  </ribbon>
</customUI>

Erros típicos que provocam o alerta

• XML malformado: tags abertas sem fechamento, aspas faltando, namespaces errados.
• Callbacks ausentes: por exemplo, onAction="MacroExecutar" sem um procedimento público Sub MacroExecutar(control As IRibbonControl) em um módulo padrão.
• Referência a idMso inválido: usar IDs incorretos de comandos built‑in.
• IDs duplicados: duas tags com o mesmo id.
• CustomUI incorreto para versão: algumas personalizações exigem customUI14 (namespace 2009/07) em versões mais novas.

Como validar rapidamente

1. Faça uma cópia do arquivo .xlsm/.xlam.
2. Renomeie a cópia para .zip e extraia.
3. Abra customUI/customUI.xml em um editor de texto com verificação de XML.
4. Corrija a estrutura e salve. Recompacte mantendo a estrutura original e teste no Excel.

Casos práticos e soluções rápidas

Suplemento de coleta de dados do Access/Outlook

Se encontrar na lista de COM Add‑ins algo como Microsoft Access Outlook Add‑in for Data Collection and Publishing, desative. Em muitas máquinas, isso encerra o problema imediatamente, pois o componente tenta ajustar a Ribbon do Excel sem necessidade.

Suplementos corporativos de ERP/BI

Esses add‑ins geralmente dependem de versões específicas do Excel. Quando a organização atualiza para um build mais novo do Microsoft 365, o XML ou as DLLs ficam incompatíveis. Procure versões certificadas para sua edição e arquitetura.

Complementos XLL de análise

XLLs antigos podem inserir botões na Ribbon por meio de wrappers em VBA. Ao migrar de 32 para 64 bits, substitua o XLL pelo build correto e refaça a instalação.

Prevenção e boas práticas

• Governança de add‑ins: mantenha um catálogo aprovado com versão, fornecedor e arquitetura.
• Ambientes de teste: valide suplementos após atualizações do Office antes de levar à produção.
• Assinatura digital: assine .xlam/.xlsm e DLLs quando possível.
• Callbacks estáveis: evite renomear procedimentos usados por onAction, getVisible, getEnabled e similares.
• Documentação interna: registre quais guias da Ribbon cada equipe instala para acelerar o suporte.

Perguntas frequentes

Desativar add‑ins afeta minhas regras de Formatação Condicional?
Não. Regras de formatação moram no arquivo da planilha (.xlsx/.xlsm). Desativar COM add‑ins não as remove.

Não encontro o suplemento listado, mas o erro persiste.
Tente:

1. Arquivo → Opções → Suplementos → Gerenciar: Suplementos do Excel e remova XLL/XLA/XLAM.
2. Verificar as pastas XLSTART (tabela acima) e mover arquivos suspeitos.
3. Examinar o Registro em HKCU\Software\Microsoft\Office\Excel\Addins (e HKLM), ajustando LoadBehavior para 0 no add‑in problemático.

Não tenho Outlook; por que esse add‑in aparece?
Alguns componentes do Office (especialmente do Access) instalam o coletor de dados do Outlook por padrão. A DLL fica registrada no sistema e o Excel tenta carregá‑la.

É seguro usar regsvr32 /u para desregistrar DLLs?
Somente se tiver certeza do impacto. Prefira desabilitar via Excel ou ajustar LoadBehavior. Em estações gerenciadas, peça ao TI para remover o pacote.

O erro ocorre ao abrir apenas um arquivo específico.
O arquivo provavelmente contém customUI.xml com erro. Valide e corrija o XML e os callbacks no projeto VBA associado.

Checklist rápido para suporte

• Abrir em modo seguro (excel /safe) e confirmar se o erro some.
• Desabilitar todos os COM Add‑ins e reativar um a um.
• Checar Suplementos do Excel (XLL/XLA/XLAM) e pastas XLSTART.
• Remover/atualizar o add‑in culpado; alinhar arquitetura 32/64 bits.
• Executar reparo do Office se necessário.
• Validar customUI.xml em arquivos próprios.
• Garantir que políticas de TI não reinstalem o add‑in automaticamente.

Modelos de ação para ambientes corporativos

Solicitação ao time de TI

Assunto: Remoção/atualização de COM Add‑in que causa erro no Excel
Detalhes: "The call to GetCustomUI for RibbonID 'Microsoft.Excel.Workbook' failed"
Culpado: <Nome do add‑in e versão>
Ação solicitada: remover do pacote padrão / atualizar build compatível (32/64 bits) / bloquear via GPO
Impacto: pop‑ups de erro, Ribbon quebrada, produtividade afetada

Política recomendada

• Catálogo de add‑ins aprovados com controle de versão.
• Validação obrigatória após Patch Tuesday ou mudanças de canal do Microsoft 365.
• Monitoramento de erros de aplicativo com coleta de eventos.

Erros relacionados que costumam aparecer juntos

• “Custom UI Runtime Error in <Workbook>”
• Mensagens sobre onLoad e getImage com callback não encontrado.
• Falhas “Não é possível inicializar a biblioteca” vindas de DLLs de terceiros.

Exemplos de correções que costumam funcionar

• Desativar o Access Outlook Add‑in for Data Collection e reiniciar: resolve imediatamente em muitas estações.
• Atualizar um add‑in de ERP antigo para build 64 bits compatível com o canal atual do Microsoft 365.
• Corrigir um customUI.xml com tags não fechadas e adicionar o procedimento VBA de callback ausente.

Resumo executivo

O erro quase sempre é um problema de suplemento. Inicie o Excel em modo seguro e desabilite sistematicamente os add‑ins para isolar o responsável. O caso mais comum envolve o Microsoft Outlook Add‑in for Data Collection and Publishing, mas qualquer add‑in que personalize a Ribbon pode causar a falha. Após identificar o culpado, mantenha‑o desativado, atualize‑o ou remova‑o para eliminar definitivamente o erro.

---