Saltar al contenido

Crear una clave de API y elegir sus permisos

Cómo crear una clave para tu web o tu programa de gestión, qué permite cada permiso y cómo revocarla.

Antes de empezar

  • La API pública es un servicio adicional: actívalo en el plan y servicios de la tienda.
  • Hace falta el permiso «Crear y revocar claves de API». El propietario lo tiene siempre.

Crear la clave

  1. Ve a Configuración › Productos y datos › API y desarrolladores.
  2. Pulsa Nueva clave y ponle un nombre que diga para qué es (por ejemplo, «Web de la tienda»).
  3. Marca solo los permisos que necesite la integración.
  4. Si la integración llama siempre desde las mismas máquinas, escribe sus IPs o redes (por ejemplo 203.0.113.0/24). Vacío = desde cualquier IP.
  5. Si es para una prueba, pon una fecha de caducidad.
  6. Pulsa Crear clave y después Copiar. La clave entera solo se enseña esta vez: guárdala en un sitio seguro.

Qué permite cada permiso

  • products:read: productos, variantes y precios.
  • stock:read: existencias vendibles y unidades por almacén.
  • customers:read y customers:write: ver clientes; crearlos y modificarlos.
  • orders:read y orders:write: ver pedidos con sus documentos; crear pedidos, que quedan aparcados para que los confirmes.
  • documents:read: facturas, tickets, rectificativas y albaranes con su PDF.

Una clave nunca puede más que la persona que la creó: si a esa persona le quitas un permiso, la clave también lo pierde.

Revocar

Pulsa Revocar junto a la clave. Deja de funcionar al momento y no se puede reactivar: crea otra si la necesitas. Crear y revocar claves queda en el registro de auditoría y en Operaciones sensibles. Puedes tener hasta 10 claves activas por tienda.

Volver al centro de ayuda