Integracion Stock

Juntoz <> Merchant

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

Porque juntoz ya no ofrece una solucion instalable de un integrador?

El costo de mantenimiento y correcciones como un ofrecimiento gratuito para merchants es
insostenible para juntoz. Por otro lado, este modelo no permite una integracin en tiempo real
llevando a quiebres de stock.

No tengo recursos de TI o no tienen la capacidad de crear el web service. Qu alternativa

ofrecen?
Bajo nuestra agencia de consultora para merchants, conjuntoz, ofrecemos bajo un costo la
consultora necesaria para la implementacin de tal web service.
Anexo 3: Recomendaciones Tcnicas
En caso sacando el stock de una base de datos SQL, recomendamos
utilizar un Stored Procedure para jalar la data necesaria por razones
de performance, y que esta se pueda modificar en el tiempo sin
necesidad de modificar la aplicacin web.
El Servidor web debera estar detrs de un firewall, puede ser el
router de internet que en muchos casos incluye esta funcionalidad, y
abrir solamente el puerto 443 para conecciones SSL.
Anexo 4: Configuracin de Red
Para poder lograr la coneccin desde el internet al servidor del
cliente, es necesario poder configurar el router de internet a hacer
Port Forwarding del internet a la direccin IP interna del servidor.
Fwd Port: 5000
Ejemplo: Router
IP Publica:
207.183.13.14
Internet
IIS o Apache en
puerto 443

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.

La sincronizacin diaria se programa de madrugada y dura

aproximadamente 20 minutos por cada 1,000 SKUs. Por ende para
que funcione bien se recomienda siempre borrar los productos que
ya no se manejan en la tienda.