Instalar PrestaShop

Requisitos previos

Antes de comenzar la instalación, asegúrese de que:

• Utiliza PrestaShop 1.6 o posterior — se admiten todas las versiones, desde la 1.6 hasta las últimas versiones 8.x y 9.x (se recomienda mantener su tienda actualizada)
• Tiene acceso al back office de administrador
• Su sitio es accesible a través de HTTPS

Generar una clave de acceso a la API en PrestaShop

Para utilizar la API de servicios web (Webservice) de PrestaShop con Order Invoicer, primero debe activar la función y luego generar una clave de acceso segura.

1. Activar el servicio web (Webservice)

1. Acceda al back office de PrestaShop con sus credenciales de administrador
2. Vaya a Parámetros avanzados > Webservice (denominado Servicio web en PrestaShop 1.6)
3. Active la opción Activar el servicio web de PrestaShop seleccionando «Sí»
4. Haga clic en Guardar para aplicar los cambios

Importante: activar el servicio web es necesario para que Order Invoicer pueda recuperar sus pedidos y los datos de sus clientes.

2. Crear una clave de acceso segura

1. Todavía en Parámetros avanzados > Webservice, haga clic en Añadir nueva clave de servicio web
2. Configure la clave con los siguientes ajustes:

Configuración básica

• Clave: haga clic en Generar para obtener una clave única de 32 caracteres (o introduzca una personalizada)
• Descripción de la clave: añada una descripción clara (por ejemplo, «Order Invoicer - Integración con Sellsy»)
• Estado: active la clave seleccionando «Activado»

Permisos necesarios

Order Invoicer comprueba estos permisos en la conexión y rechaza la configuración si falta alguno. Marque al menos Ver (GET) para cada uno de los siguientes recursos:

• ✅ addresses — direcciones de facturación y de envío
• ✅ carriers — transportistas utilizados en los pedidos
• ✅ combinations — combinaciones de productos (tallas, colores, etc.)
• ✅ countries — países de las direcciones de los clientes
• ✅ currencies — monedas de los pedidos
• ✅ customers — clientes
• ✅ order_details — líneas de pedido
• ✅ order_payments — pagos de los pedidos
• ✅ order_slip — facturas rectificativas / reembolsos
• ✅ orders — pedidos
• ✅ products — productos
• ✅ shops — tiendas (necesario para identificar su instalación)
• ✅ taxes — impuestos aplicados a los pedidos

Consejo: en la pantalla de PrestaShop, utilice el enlace Seleccionar todo en la parte superior de la columna Ver (GET) para ahorrar tiempo y, a continuación, desmarque únicamente los recursos a los que no desea dar acceso.

Permisos opcionales

Solo son necesarios si utiliza estas funciones:

• stock_availables — Ver + Editar (PUT) si sincroniza el stock de su herramienta de facturación con PrestaShop
• customer_threads, customer_messages, contacts — Ver + Añadir (POST) si desea que Order Invoicer cree tickets de atención al cliente en los eventos de facturación
• groups — Ver (GET) si utiliza los grupos de clientes de PrestaShop como tarifas y desea sincronizarlos con sus clientes (se muestran en los pedidos). Sin este permiso, la sincronización sigue funcionando — los grupos simplemente se omiten.
• tax_rule_groups, tax_rules — Ver (GET) para registrar el tipo de IVA que su tienda aplica realmente, en lugar de deducirlo de los importes del pedido. Sin estos permisos, la sincronización sigue funcionando — el tipo se deduce de los totales.

Configuración multitienda (si procede)

• Asociación de tiendas: en modo multitienda, elija las tiendas a las que da acceso la clave
• Si tiene varias tiendas, seleccione únicamente las que desea conectar

3. Haga clic en Guardar para crear la clave

3. Recuperar los datos de conexión

Después de crear la clave, anote los siguientes datos:

• La URL de su tienda: https://su-tienda.com
• Clave de API: la clave generada (32 caracteres)

Importante: mantenga esta información segura. La necesitará para configurar el conector en Order Invoicer.

Verificar la configuración

Prueba de la API

Para verificar que su clave funciona, solicite un único recurso con ella — pase la clave en el parámetro de consulta ws_key:

https://su-tienda.com/api/orders?ws_key=SU_CLAVE&limit=1

Debería obtener una respuesta XML que contenga un pedido. Si obtiene:

• 401 o 403: la clave está desactivada o le falta el permiso Ver (GET) sobre ese recurso — vuelva a comprobar el estado de la clave y sus permisos.
• Un error en https://su-tienda.com/api/ (la raíz): esto por sí solo no significa que la clave esté defectuosa. En muchas instalaciones, la raíz del servicio web devuelve un 500 o una página HTML aunque los endpoints de los recursos individuales funcionen correctamente, así que pruebe siempre un recurso específico como se muestra arriba en lugar de la URL /api/ a secas.

Resolución de problemas habituales

Error «Servicio web no activado»

• Compruebe que el servicio web esté activado en Parámetros avanzados
• Reinicie la caché de PrestaShop si es necesario

Error «Clave de API no válida»

• Compruebe que la clave tenga exactamente 32 caracteres
• Asegúrese de que la clave esté activa
• Compruebe los permisos concedidos

Error «Acceso denegado»

• Compruebe que la URL de su tienda sea correcta
• Asegúrese de que su sitio sea accesible a través de HTTPS
• Compruebe los permisos de la clave de API

Error «Faltan permisos: …» Order Invoicer indica exactamente qué recursos faltan. Vuelva a la clave del servicio web y marque Ver (GET) para cada uno de los recursos indicados y, a continuación, reinicie la configuración.

Soporte

Si encuentra dificultades:

1. Consulte la sección de resolución de problemas anterior
2. Consulte la documentación oficial de PrestaShop
3. Póngase en contacto con nuestro soporte: contact@orderinvoicer.com

Próximos pasos

Una vez configurada su clave y creado el conector en Order Invoicer:

• Instale el módulo de PrestaShop para una sincronización de pedidos casi instantánea (opcional).
• Desactive las facturas de PrestaShop para que su herramienta de facturación gestione la numeración de las facturas.