new: external idp b2b login setup guide

docs/en/tutorials/b2b/organization-account/PLACEHOLDER-enable-organization-login-via-external-identity-provider-idp.md

@@ -0,0 +1,9 @@
+---
+title: 'Enable organization login via external identity provider (IdP)'
+createdAt: '2026-05-21T14:54:00.000Z'
+updatedAt: '2026-05-21T14:54:00.000Z'
+contentType: tutorial
+productTeam: B2B
+slugEN: enable-organization-login-via-external-identity-provider-idp
+locale: en
+---

docs/es/tutorials/b2b/organization-account/PLACEHOLDER-habilitar-inicio-de-sesion-en-la-organizacion-mediante-proveedor-de-identidad-idp-externo.md

@@ -0,0 +1,9 @@
+---
+title: 'Habilitar inicio de sesión en la organización mediante proveedor de identidad (IdP) externo'
+createdAt: '2026-05-21T14:54:00.000Z'
+updatedAt: '2026-05-21T14:54:00.000Z'
+contentType: tutorial
+productTeam: B2B
+slugEN: enable-organization-login-via-external-identity-provider-idp
+locale: es
+---

docs/pt/tutorials/b2b/organization-account/habilitar-login-na-organizacao-via-provedor-de-identidade-idp-externo.md

@@ -0,0 +1,70 @@
+---
+title: 'Habilitar login na organização via provedor de identidade (IdP) externo'
+createdAt: '2026-05-21T14:54:00.000Z'
+updatedAt: '2026-05-21T14:54:00.000Z'
+contentType: tutorial
+productTeam: B2B
+slugEN: enable-organization-login-via-external-identity-provider-idp
+locale: pt
+---
+
+> ⚠️ Esta funcionalidade está disponível apenas para lojas que usam [B2B Buyer Portal](https://help.vtex.com/pt/docs/tutorials/b2b-buyer-portal-pt), atualmente disponível para contas selecionadas.
+
+Organizações compradoras podem autenticar seus membros utilizando um provedor de identidade (IdP) externo por meio de Single Sign-On (SSO). Para que esse fluxo funcione, a organização compradora precisa habilitar o login com o provedor de identidade externo na interface do Buyer Portal, como descrito neste guia.
+
+## Pré-requisitos
+
+Antes de habilitar o login via IdP externo no Buyer Portal, verifique se:
+
+* O lojista já configurou o provedor de identidade no Admin VTEX em **Configurações da conta > Autenticação**, conforme as instruções presentes em [Login (SSO)](https://developers.vtex.com/docs/guides/login-integration-guide) e [Webstore (OAuth 2.0)](https://developers.vtex.com/docs/guides/login-integration-guide-webstore-oauth2).  
+* Você tem o perfil **Organizational Unit Admin** na organização compradora.
+
+## Habilitar o login via IdP externo no Buyer Portal
+
+Siga o passo a passo para habilitar o login via IdP externo:
+
+1. Acesse a loja pelo navegador e faça login com seu usuário.  
+2. No menu superior, clique em **Company**. O painel da organização será exibido.  
+3. Clique em **Manage**.  
+4. Se você quiser habilitar o login para a organização, prossiga para a etapa 5. Se você quiser escolher uma organização filha para habilitar, clique em **Organizational Units** e depois no nome da unidade organizacional.  
+5. Clique no menu **⋮** e, em seguida, em **Authentication**.  
+
+   ![habilitar-login-na-organizacao-via-provedor-de-identidade-idp-externo_1](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/b2b/organization-account/habilitar-login-na-organizacao-via-provedor-de-identidade-idp-externo_1.png)
+
+6. Na seção **Authentication methods**, selecione uma ou mais opções desejadas (no exemplo da imagem abaixo, a opção de IdP externo é o PingFederate (SSO). Lembre-se de desmarcar métodos de autenticação que não serão utilizados.
+
+![habilitar-login-na-organizacao-via-provedor-de-identidade-idp-externo_2](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/b2b/organization-account/habilitar-login-na-organizacao-via-provedor-de-identidade-idp-externo_2.png)
+
+7. Clique em `Save`. 
+
+> ℹ️ Também é possível gerenciar as opções de autenticação da organização via API. Consulte a [referência da API VTEX ID](https://developers.vtex.com/docs/api-reference/vtex-id-api#post-/api/vtexid/organization-units/-unitId-/settings) para mais detalhes. 
+
+## Fluxo de autenticação
+
+Após a habilitação, o fluxo de autenticação para membros da organização ocorre da seguinte forma:
+
+1. O usuário informa seu nome de usuário no login do storefront.  
+2. A plataforma VTEX identifica a organização associada ao usuário.  
+3. O usuário é redirecionado para o provedor de identidade configurado.  
+4. O provedor autentica o usuário.  
+5. Após a autenticação, o usuário retorna ao storefront com acesso autorizado. O diagrama abaixo ilustra esse fluxo:
+
+```mermaid
+sequenceDiagram
+participant U as Usuário
+participant S as Storefront
+participant I as IdP
+
+U->>S: Inicia login com nome de usuário
+S->>S: Resolve organização/método
+S->>I: Redireciona para autenticação
+I-->>S: Retorna resultado
+S->>S: Valida retorno (identidade/username)
+S-->>U: Acesso autorizado
+```
+
+## Saiba mais
+
+* [Login (SSO)](https://developers.vtex.com/docs/guides/login-integration-guide)   
+* [Webstore (OAuth 2.0)](https://developers.vtex.com/docs/guides/login-integration-guide-webstore-oauth2)  
+* [Login para B2B](https://help.vtex.com/docs/tutorials/login-para-b2b)

public/navigation.json

@@ -17410,6 +17410,21 @@
                   "type": "markdown",
                   "children": []
                 },
+                {
+                  "name": {
+                    "en": "Enable organization login via external identity provider (IdP)",
+                    "es": "Habilitar inicio de sesión en la organización mediante proveedor de identidad (IdP) externo",
+                    "pt": "Habilitar login na organização via provedor de identidade (IdP) externo"
+                  },
+                  "slug": {
+                    "en": "placeholder-enable-organization-login-via-external-identity-provider-idp",
+                    "es": "placeholder-habilitar-inicio-de-sesion-en-la-organizacion-mediante-proveedor-de-identidad-idp-externo",
+                    "pt": "habilitar-login-na-organizacao-via-provedor-de-identidade-idp-externo"
+                  },
+                  "origin": "",
+                  "type": "markdown",
+                  "children": []
+                },
                 {
                   "name": {
                     "en": "Organization account",
@@ -58344,6 +58359,21 @@
               "type": "markdown",
               "children": []
             },
+            {
+              "name": {
+                "en": "Scenarios Involving Goodwill Following an Order Modification",
+                "es": "Situaciones relacionadas con el fondo de comercio tras una modificación de la orden",
+                "pt": "Cenários envolvendo ágio após uma modificação de pedido"
+              },
+              "slug": {
+                "en": "scenarios-involving-goodwill-following-an-order-modification",
+                "es": "situaciones-relacionadas-con-el-fondo-de-comercio-tras-una-modificacion-de-la-orden",
+                "pt": "cenarios-envolvendo-agio-apos-uma-modificacao-de-pedido"
+              },
+              "origin": "",
+              "type": "markdown",
+              "children": []
+            },
             {
               "name": {
                 "en": "Seller's order invoiced with problem in the payment capture",
@@ -67656,6 +67686,21 @@
               "type": "markdown",
               "children": []
             },
+            {
+              "name": {
+                "en": "Sitemap retains ghost products from categories removed via full cleanup",
+                "es": "El mapa del sitio conserva los productos fantasma de las categorías eliminadas mediante una limpieza completa",
+                "pt": "O mapa do site mantém produtos fantasmas de categorias removidas por meio de uma limpeza completa"
+              },
+              "slug": {
+                "en": "sitemap-retains-ghost-products-from-categories-removed-via-full-cleanup",
+                "es": "el-mapa-del-sitio-conserva-los-productos-fantasma-de-las-categorias-eliminadas-mediante-una-limpieza-completa",
+                "pt": "o-mapa-do-site-mantem-produtos-fantasmas-de-categorias-removidas-por-meio-de-uma-limpeza-completa"
+              },
+              "origin": "",
+              "type": "markdown",
+              "children": []
+            },
             {
               "name": {
                 "en": "Sitemap returns \"Error fetching sitemap data\"",