Instalar PrestaShop

Requisitos previosCopy Anchor Link

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 PrestaShopCopy Anchor Link

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)Copy Anchor Link

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 seguraCopy Anchor Link

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ásicaCopy Anchor Link

• 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 necesariosCopy Anchor Link

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 opcionalesCopy Anchor Link

Solo son necesarios si utiliza estas funciones:

• stock_availables — Ver + Editar (PUT) si sincroniza el stock de su herramienta de facturación con PrestaShop. Sin él, cada actualización de stock aparece como fallida en las actualizaciones de stock del conector, con el permiso que debe conceder, y no se reintenta
• 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 de pedidos sigue funcionando — el tipo se deduce de los totales. La sincronización del catálogo, en cambio, necesita tax_rules para conocer el tipo de IVA de cada producto: sin él, un producto que ya existe en Sellsy conserva su tipo y un producto nuevo no se crea allí (la lista de productos indica el motivo).
• categories, configurations — Ver (GET) si sincroniza su catálogo con su software de facturación: la categoría por defecto del producto, el país por defecto de la tienda (PS_COUNTRY_DEFAULT) para elegir el tipo de IVA de una regla de impuestos que cubre varios países, y las unidades de peso y dimensiones (PS_WEIGHT_UNIT, PS_DIMENSION_UNIT). Sin estos permisos, los productos se sincronizan igualmente — sin categoría, sin peso ni dimensiones, y sin tipo de IVA cuando la regla de impuestos es ambigua.

Configuración multitienda (si procede)Copy Anchor Link

• 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ónCopy Anchor Link

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ónCopy Anchor Link

Prueba de la APICopy Anchor Link

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 habitualesCopy Anchor Link

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.

Descripción de los productos sincronizadosCopy Anchor Link

Los productos de PrestaShop tienen una descripción corta y una descripción larga. En la tarjeta Productos de su tienda, elija en Descripción enviada cuál envía la sincronización de productos a su software de facturación:

• Descripción corta o, si no hay, la larga (por defecto): la descripción corta, o la larga cuando el producto no tiene descripción corta.
• Solo la descripción corta: la descripción corta. Un producto sin descripción corta no envía ninguna descripción y su software de facturación conserva la que ya tiene.
• Solo la descripción larga: la descripción larga, con la misma regla cuando está vacía.
• Ninguna descripción: la sincronización no envía ninguna descripción.

La descripción se envía sin formato y limitada a 255 caracteres. Algunos programas, como Axonaut, la copian en las líneas de sus facturas: elija Solo la descripción corta para mantener esas líneas cortas.

SoporteCopy Anchor Link

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 pasosCopy Anchor Link

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.