Integar API proveedor logístico y Shopify

Necesitamos integrar Shopify con nuestro proveedor logístico mediante API. Esta es la documentación que hemos recibido de la API del proveedor logístico:

Aprovecho para pasaros la documentación de la API, y por supuesto si tenéis cualquier pregunta no dudéis en poneros en contacto conmigo.

- Documentación API.

La dirección de la api documentada es: [login to view URL] .

Se trata de una api REST / Json.

En la documentación se pueden ver dos apartados: orders y stores.

Desplegándo cada uno se ven las request que podemos hacer.

Por cada request, se describe el formato de la respuesta esperada, los parámetros necesarios para hacer la petición y los mensajes de la respuesta.

En principio nosotros solo vamos a crear pedidos en Paack, asi que con POST /orders es suficiente.

- Entornos.

Tenemos entorno de test y producción.

Entorno de test.

Test: [login to view URL]

Credenciales: ******* / password: ****

Como clave de seguridad para la comunicación con nuestra api, usamos la clave api, que va incluida en los parámetros de la request.

Desde tu dashboard, en el apartado Apps, puedes crear nuevas claves.

Para el entorno de test, he creado una:

**********

Para hacer un pedido, usaríamos POST al endpoint /orders.

- Pruebas

Empezamos por hacer las pruebas en test.

Apuntar a [login to view URL] con los parámetros siguientes:

* se pueden dejar vacios. Hay que enviarlos, pero se pueden dejar sin rellenar.

* store_id. Ese es el id asociado a las tiendas Waterrevive.

Los ids son diferentes en los entornos.

Hemos creado la tienda en Barcelona:

Waterrevive Barcelona: 1059

La request api:

}

"api": "d119fa4621a9dcebbeb55aa067656fca3cbe1d11",

"name": "string",

"email": "string",

"phone": "string",

"store_id": 1059, // Tienda en Passeig Gràcia

"retailer_order_number": "string",

"sale_number": "string",

"delivery_window": {

"end_time": "2016-10-13T12:09:10.964Z",

"start_time": "2016-10-13T14:09:10.964Z"

},

"delivery_address": {

"address": "string",

"postal_code": "string",

"country": "string",

"city": "string"

},

"packages": [

{

"width": "string",

"weight": "string",

"height": "string",

"length": "string",

"description": "string",

"units": 0

}

]

}

* name Nombre y apellidos del destinatario. Tened en cuenta que solo hay un campo, (por lo que debería de incluir por tanto apellidos.)

* retailer_order_number: Número del pedido en vuestro sistema

* sale_number: No es necesario para nosotros. Normalmente es el número de paquete o número de albarán.

* email. eMail del destinatario. Lo usamos para enviar notificaciones de recogida y entrega al cliente.

* phone. Teléfono del destinatario, para notificaciones sms.

Tambien es útil para que los conductores puedan contactar con el cliente.

* delivery_window es la franja horaria en la que se envia el pedido.

Es de tipo DateTime, y lo almacenados en el estandar horario UTC. (Coordinated Universal Time)

UTC esta 1 hora por detras de CET ( Central Europe Time) que es el nuestro.

Por tanto, lo idóneo es enviar el horario en UTC.

* delivery_address será la dirección del cliente.

address, incluye el nombre de la calle y número.

HTML JavaScript JSON PHP Shopify

Nº del proyecto: #13848292

Sobre el proyecto