Llamada al Hook de Pedidos
Para registrar un pedido se debe realizar una llamada POST a la URL de Naiz Fit habilitada para la recepción de pedidos.
https://backend.production.naiz.fit/api/partners/hook/DOMINIO/HASH
Important
Deberá sustituir el elemento "DOMINIO" de la url por su dominio completo (ej: www.ejemplo.com). Deberá sustituir el elemento "HASH" de la url por el Partner Hash que corresponde a su ecommerce (ej: 12345678123412341234123412341234).
Cuerpo y formato
Como cuerpo de la petición se debe enviar un texto JSON válido con los datos del pedido a registrar.
Estructura
La estructura del JSON puede ser consensuada con Naiz Fit pra adaptarla a sus necesidades siempre que se mantengan los datos no opcionales. Proponemos la siguiente estructura:
Campo | Tipo | Descripción |
---|---|---|
date | String |
Fecha de realización del pedido. |
consumerHash | String |
Identificador de Naiz Fit del cliente que realiza el pedido si lo hubiera (almacenado en la COOKIE o en la variable de LOCALSTORAGE “naiz_consumer_hash” del navegador al haber realizado una recomendación de talla). |
partnerHash | String |
Partner Key proporcionado por Naiz Fit al comercio. |
domain | String |
Dominio completo desde el que se realiza la pedido. |
currency | String |
Código identificador de la moneda en la que se realizo el pedido. |
status | Ìnt |
Estado del pedido (0: Nuevo, 1: Procesado, 2: Enviado). |
total | Double |
Precio total del pedido. |
subtotal | Double |
Opcional. Precio subtotal del pedido. |
taxes | Double |
Opcional. Impuestos. |
shipping | Double |
Opcional. Precio del envío. |
discount | Double |
Opcional. Descuentos. |
internalRef | String |
Referencia interna del pedido. |
internalCartRef | String |
Referencia interna del carrito del pedido. |
lines | Line[] |
Listado de objetos de tipo Line con la información de cada uno de los productos del pedido. |
Estructura del objeto Line
Campo | Tipo | Descripción |
---|---|---|
internalRef | String |
Referencia interna que identifica el producto. |
productName | String |
Nombre del producto. |
naizCode | String |
Opcional. Código de Naiz Fit del producto. |
quantity | Int |
Cantidad de productos pedidos de este modelo. |
price | Double |
Precio del producto. |
size | String |
Talla del producto comprado. |
Ejemplo:
{
"date": "2020-06-01 12:34:56",
"consumerHash": "XXXX-XXXX-XXXX-XXXX-XXXX",
"partnerHash": "XXXX-XXXX-XXXX-XXXX-XXXX",
"domain": "www.dominio.com",
"internalRef": "REF0001",
"internalCartRef": "CART0001",
"status": 1,
"total": 30.0,
"subtotal": 27.5,
"currency": "EUR",
"lines": [
{
"internalRef": "PRODUCTO01",
"productName": "Producto de Calidad superior",
"naizCode": null,
"quantity": 1,
"price": 12.5,
"size": "XL"
},
{
"internalRef": "PRODUCTO02",
"productName": "Producto de Calidad muy superior",
"naizCode": null,
"quantity": 2,
"price": 10.99,
"size": "L"
}
]
}
Resultado
En caso de que el registro haya sdo satisfactorio se recibirá un resultado con código http 200.