Establecer una conexión para intercambio/sincronización

La integración de la tienda online publicada en la plataforma PrestaShop con MetaKocka permite:

  • transferencias automáticas de pedidos con todos los datos del cliente (destinatario, pagador, tipo de pago, descuentos y artículos pedidos)

  • sincronización de productos (los productos pueden transferirse desde la tienda online a MetaKocka con todos los datos ya introducidos en la tienda online)

  • sincronización automática del stock

Las facturas que se generan sin trabajo adicional a partir de los pedidos transferidos automáticamente también se verifican en FURS/Hacienda para los medios de pago definidos legalmente. Además, para los bienes expedidos, el stock se reduce y se actualiza en la tienda online (si está configurado de esa forma).

Obtención de claves API


Para establecer la conexión con la tienda online de PrestaShop, es necesario obtener los siguientes datos:

  • Dirección de la tienda online

  • Clave de acceso al servicio en línea (PrestaShop WebService Key)


*La clave de acceso al servicio en línea es válida hasta su cancelación.


Procedimiento paso a paso:

1. Inicia sesión en el panel de control de la tienda online PrestaShop y, en el menú de la izquierda, bajo la categoría Configurar, elige Parámetros avanzados.

2. Entre las opciones disponibles, selecciona Webservice.



3. En esa página, en la esquina superior derecha, selecciona Agregar nueva clave de webservice.



4. Se abrirá la página para añadir una nueva clave de acceso al servicio en línea.

5. La Clave es un parámetro obligatorio; se puede insertar manualmente o generar automáticamente haciendo clic en el botón Generar (opción recomendada).


6. Descripción de la clave: nuestra propia descripción del propósito de la clave (en este caso: “Conexión con el servicio MetaKocka”).

7. Luego se debe establecer el Estado de la nueva clave: habilitado (Sí) o deshabilitado (No). Para conectar con MetaKocka, la clave debe estar habilitada, de lo contrario, la conexión no funcionará.

8. El último paso para añadir la nueva clave de acceso al servicio en línea PrestaShop es seleccionar los permisos que tendrá MetaKocka. En nuestro caso, basta con seleccionar todas las opciones de Ver (GET) y Modificar (PUT).



9. Una vez completada la selección, haz clic en Guardar para almacenar la configuración y activar la clave.

10. Finalmente, introduce la dirección de la tienda online y la clave recién creada en la interfaz web de MetaKocka.


Ve a Configuración/Enlaces (1), añade la conexión para PrestaShop (2), introduce la dirección URL de tu tienda online (3), introduce la clave que recibiste en la tienda online (4) y guarda los cambios (5). 

Después de guardar, haz clic en Probar conexión para comprobar si funciona correctamente.




Mapeo de productos por códigos


El campo de referencia se utiliza para el código del producto.




Sincronización de productos (Tienda online <> MetaKocka)

Solo se transferirán los productos activos.

Más información sobre la funcionalidad se puede encontrar aquí.



Problemas de conexión

Error 401 Unauthorized

En caso de recibir el error “401 Unauthorized”, es necesario realizar los ajustes correspondientes en la configuración de Apache. La descripción del problema y la solución están disponibles en los siguientes enlaces:



Respuesta rápida:

Es necesario realizar ajustes en el archivo .htaccess en el directorio raíz de la tienda online.

Antes:


RewriteRule . - [E=REWRITEBASE:/]

RewriteRule ^api$ api/ [L]


Después (las líneas en negrita son las añadidas):


RewriteRule . - [E=REWRITEBASE:/]

RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

RewriteRule ^api$ api/ [L]



Clave incorrecta vs problemas de acceso al API

Si Apache no está correctamente configurado en la tienda, recibirás el error: 401 Unauthorized.

Si la clave es incorrecta, la respuesta también será 401, pero con el siguiente contenido:

{"errors":[{"code":20,"message":"Authentification key is not active"},{"code":21,"message":"No permission for this authentication key"}]}


Simulación de llamada vía cliente REST

La funcionalidad puede comprobarse mediante un cliente REST de la siguiente forma:

    1. Supongamos que la dirección de tu tienda online es http://18.196.116.84, y tiene una clave con valor "1234".

    

    2. Crea la dirección URL para la prueba de conexión: http://18.196.116.84/api/configurations/?display=full&output_format=JSON


    3. Convierte la clave a Base64 (https://www.base64encode.org/) e introdúcela en la cabecera Authorization con el valor:  "Basic NEY2VjgzVDFLRURSQkpLWEkxWlVaRQ=".


    4. Realiza una llamada y deberías recibir una respuesta con los datos.

Ejemplo de la funcionalidad en la imagen siguiente:


¿Todavía no eres usuario de MetaKocka? ¡Regístrate ahora y prueba la funcionalidad gratis durante 30 días!