> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wisepim.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración con Medusa

> Conecta tu tienda Medusa a WISEPIM. Crea un token de API de administrador, agrégalo en WISEPIM y empieza a sincronizar tu catálogo.

Conecta tu tienda Medusa a WISEPIM para gestionar todo tu catálogo desde un solo lugar. Medusa es una plataforma de comercio headless de código abierto. Una vez conectada, puedes importar productos, enriquecerlos con AI y enviar el contenido mejorado de vuelta a Medusa.

La configuración tiene dos pasos: crea un token de API de administrador en Medusa y luego agrégalo en WISEPIM.

<Info>
  Necesitas acceso de administrador a tu backend de Medusa y una cuenta de WISEPIM con un proyecto activo. WISEPIM se conecta a través de la Medusa Admin API.
</Info>

## Crea un token de API en Medusa

<img className="block dark:hidden" src="https://mintcdn.com/swiftsyncai/JPDjQoRySb31h-7U/images/marketing-screenshots/integrations/integration-configure-medusa-light-transparent.webp?fit=max&auto=format&n=JPDjQoRySb31h-7U&q=85&s=d33d3215866b79d33921ff7073381622" alt="Connecting Medusa to WISEPIM, store URL, API token, locale mapping and a live connection test" width="1478" height="1782" data-path="images/marketing-screenshots/integrations/integration-configure-medusa-light-transparent.webp" />

<img className="hidden dark:block" src="https://mintcdn.com/swiftsyncai/JPDjQoRySb31h-7U/images/marketing-screenshots/integrations/integration-configure-medusa-dark-transparent.webp?fit=max&auto=format&n=JPDjQoRySb31h-7U&q=85&s=4aae9e281b64e5bdc57a9eb4bf8456c9" alt="Connecting Medusa to WISEPIM, store URL, API token, locale mapping and a live connection test" width="1478" height="1782" data-path="images/marketing-screenshots/integrations/integration-configure-medusa-dark-transparent.webp" />

Medusa emite un token de API para un usuario administrador con acceso a tu catálogo.

<Steps>
  <Step title="Abre tu admin de Medusa">
    Inicia sesión en tu panel de administración de Medusa con una cuenta que pueda gestionar productos.
  </Step>

  <Step title="Crea un API key token">
    Abre **Settings** > **API Key Management** y crea una nueva API key **Secret** (de administrador) con el nombre WISEPIM.
  </Step>

  <Step title="Copia el token">
    Copia el token generado ahora. Solo se muestra una vez.
  </Step>

  <Step title="Anota la URL de tu tienda">
    La URL de tu tienda es la dirección de tu backend de Medusa, por ejemplo `https://your-store.medusajs.com`.
  </Step>
</Steps>

## Agrega tus credenciales en WISEPIM

Ingresa los valores de Medusa para completar la conexión.

<Steps>
  <Step title="Abre Integraciones">
    Inicia sesión en WISEPIM y ve a **Configuración** > **Integraciones**.
  </Step>

  <Step title="Selecciona Medusa">
    Busca y haz clic en el tile de la integración **Medusa**.
  </Step>

  <Step title="Ingresa tus credenciales">
    Completa los siguientes campos:

    * **Medusa URL**: la URL de tu backend de Medusa, incluido `https://` (por ejemplo, `https://your-store.medusajs.com`)
    * **API Token**: el token de administrador que creaste en Medusa
  </Step>

  <Step title="Prueba la conexión">
    Haz clic en **Probar conexión** para confirmar que tus credenciales funcionan.
  </Step>

  <Step title="Guarda">
    Si la prueba es exitosa, haz clic en **Guardar**.
  </Step>
</Steps>

<Check>
  Tu tienda Medusa ya está conectada. Puedes empezar a importar productos.
</Check>

<Warning>
  Tu API token da acceso completo a tu catálogo a través de la Admin API. Nunca lo compartas públicamente ni lo incluyas en el control de versiones. Si crees que quedó expuesto, revócalo en Medusa y crea uno nuevo.
</Warning>

## Solución de problemas

<AccordionGroup>
  <Accordion title="La prueba de conexión falla">
    Revisa primero tu Medusa URL. Debe ser correcta, empezar por `https://` y apuntar a tu backend (no al storefront). Después, confirma que copiaste el API token exactamente, sin espacios de más.
  </Accordion>

  <Accordion title="La autenticación es rechazada">
    Asegúrate de haber creado una API key **Secret** (de administrador), no una publishable key. Las publishable keys no pueden leer ni escribir el catálogo completo.
  </Accordion>
</AccordionGroup>

## Relacionado

<CardGroup cols={2}>
  <Card title="Importar productos" icon="download" href="/es/essentials/importing-products">
    Trae tu catálogo de Medusa a WISEPIM.
  </Card>

  <Card title="Enriquecer productos" icon="sparkles" href="/es/essentials/enriching-products">
    Mejora títulos, descripciones y SEO con AI.
  </Card>

  <Card title="Exportar productos" icon="upload" href="/es/essentials/exporting-products">
    Envía el contenido mejorado de vuelta a Medusa.
  </Card>

  <Card title="Todas las plataformas" icon="layout-grid" href="/es/integrations/supported-platforms">
    Mira cada plataforma con la que WISEPIM se conecta.
  </Card>
</CardGroup>