Академический Документы
Профессиональный Документы
Культура Документы
Diciembre 2016
Resumen
Objetivo: juntoz.com pueda validar el stock de un SKU contra web
service que exponga el Merchant desde sus sistemas
Actualmente, para merchants que tienen esta integracin activada, al
momento que se agrega uno de sus productos al carrito se hace la
validacin de stock, logrando as reducir quiebres considerablemente.
Merchant debe exponer un HTTP GET endpoint que responda con
JSON siguiendo estructura:
{
"SKU":"5139455",
"Price":189,
"TotalQuantity":3,
"StockByWarehouse":[
{
"WarehouseIdentifier":"4",
"Name":"TIENDA OUTLET",
"Quantity":3
}
]
}
Conceptos alto nivel
La integracin es via Web Service
El cliente debe exponer un Web Service segun las caracteristicas
expuestas por juntoz:
Encripcion via HTTPS con certificado SSL SHA256 (puedo ser auto-cifrado).
Autorizacion via el Authorization Header con esquema Bearer.
Peticion tipo GET a ruta que incluye el SKU.
Respuesta en formato JSON que incluye cantidad por almacen > 0 y precio.
Web Service debe ser accessible va el internet.
Juntoz ofrece Codigo Fuente de Web Service de ejemplo
Responsabilidad del buen funcionamiento del Web Service es responsabilidad
del merchant partner.
URL: https://github.com/Juntoz/dotnet-webapi-integration
Diagrama de Integracin Stock y Precio Juntoz
Llave Compartida
Infraestructura Merchant Infraestructura Juntoz
HTTPS
Authorization
Aplicacin Web Service Bearer Security
Juntoz.com
de Consulta por SKU
Internet
Servidor: IIS,
nginx, apache, Publico
etc
HTTPS
Authorization Proxy
Bearer Security
Consulta directa BD o
va interfaces a sistema
de inventarios
*Aunque juntoz provee ejemplos de aplicacion web service el mantenimiento y *direccin de flecha muestra
buen funcionamiento de lado del cliente es su responsabilidad iniciador de peticin
Anexo 1: Formato de respuesta JSON
{
"SKU":"5139455",
"Price":189,
"TotalQuantity":3,
"StockByWarehouse":[
{
"WarehouseIdentifier":"4",
"Name":"TIENDA OUTLET",
"Quantity":3
}
]
}
Anexo 2: Preguntas Frecuentes
Que es un web service?
Un web service es cualquier pieza de software que se hace disponible sobre el internet y utiliza un
mecanismo estandar de mensajeria en XML o JSON
Servidor IP Interna:
*** Los puertos y IPs son solo de 192.168.1.10
ejemplo, dependen de la configuracin
de red local del merchant.
Anexo 5: Soporte
Juntoz incluye una (1) consultora en sitio de 1 hora sin costo para el
Merchant Partner
Juntoz incluye una (1) segunda consultora via remoto (Google
Hangout, Skype y/o RDP) sin costo
Consultoras adicionales llevaran un costo de S/ 249 la hora
Anexo 6: Sincronizacin diaria
Opcionalmente se puede habilitar una opcin para recorrer todos los
SKUs en juntoz una vez al da y compararlos contra el web service.
De esta manera se mantiene el stock actualizado y se reduce la
posibilidad de que un usuario se encuentre constantemente sin stock
al agregar al carrito.