Integración E-Comerce Externo

En este sitio usted conocerá la forma de comunicar e integrar el software WinnerPOS con aplicaciones externas.
Esta Documentación está a disposición de los clientes que tengan contratado el servicio en la Nube.
Para que un cliente pueda comenzar a utilizarlos, debe pasar por un proceso de pruebas que validan que está en condiciones de utilizar correctamente los servicios ofrecidos.
Para consultas más detalladas contáctese a nuestro chat de soporte.

Chat en Línea »

Términos y Condiciones

Antes de iniciar cualquier actividad de integración y desarrollo para la integración de WinnerPOS, es importante que el cliente integrador tenga pleno conocimiento de los términos y condiciones del servicio.

WinnerPOS pone a disposición de sus clientes las herramientas necesarias para que puedan desarrollar software de integración con el sistema WinnerPOS, bajo las condiciones establecidas en este documento.

La administración y control de la información contenida en las bases de datos de WinnerPOS es de exclusiva responsabilidad del cliente integrador. El cliente integrador es responsable de verificar que el proceso funcione correctamente y que los datos traspasados entre las distintas plataformas sean los correctos.

WinnerPOS e Innovaplus declinan expresamente toda responsabilidad derivada del manejo de la información que el cliente manipule, ya sea de manera masiva o individual, y no asumen responsabilidad alguna por los datos ingresados a través del software de escritorio o mediante software propio o de terceros.

El cliente reconoce y asume íntegramente la responsabilidad por cualquier daño o perjuicio que pudiera sufrir como consecuencia del uso de estas herramientas, incluyendo fallas del software WinnerPOS o sus librerías, errores en los datos o cualquier otro motivo que afecte la integridad de la información.

El cliente exime de toda responsabilidad a WinnerPOS e Innovaplus, declarando y aceptando que es su obligación revisar y verificar los procesos luego de cada transacción de información, ya sea ejecutada en forma masiva o individual.

El uso de estas herramientas por parte del cliente implica su aceptación tácita y expresa de los presentes términos y condiciones, obligándose a su cumplimiento en todo momento.

Recomendaciones

Si es primera vez que usted está integrando el software, recomendamos hacer el proceso de testeo por etapas.

1) Etapa Inicial:
Probar 1 Orden de Compra y hacer todo su seguimiento.
Esta etapa es para verificar que el código desarrollado por el integrador está funcionando y hace lo que tiene que hacer.

2) Marcha Blanca:
Probar set limitado 1 a 10 Ordenes en 1 Sola Sucursal.
Esta etapa es para comprobar que al vender los artículos no se producen diferencias de precios, errores u otas dificultades.
Deben ser artículos de salida frecuente y se recomienda un plazo de pruebas de uso no menor a una semana.

3) Piloto:
Probar maestro completo en 1 Sola Sucursal.
Una vez superadas las otras etapas en forma exitosa, ya se está en condiciones de probar con el maestro completo.
Se recomienda un plazo de pruebas de uso no menor a un mes.

4) Producción:
Una vez superadas las otras etapas en forma exitosa, ya se está en condiciones de implementar la solución en las demás sucursales.

Conceptos Iniciales

WinnerPOS es un sistema diseñado especificamente para el rubro del comercio, por lo tanto su principal objetivo es la continuidad operacional, es decir, no falle nunca en el local en que está instalado. Por este motivo, el sistema está dividido en 2 partes.

a) Frente de Caja:
Aplicación de escritorio instalada localmente en cada sucursal, con base de datos SQL Server local.
Esta aplicación es la encargada de generar todas las transacciones.
b) Administración:
Aplicación en la nube, es un repositorio de los datos de las sucursales.
El objetivo de esta aplicación es consultar la información de las sucursales, y administrar los maestros de Clientes y Artículos.

Especificaciones técnicas de integración

Para integrar una plataforma de comercio electrónico con WinnerPOS, el e-commerce debe exponer los siguientes endpoints de su API, los cuales serán consumidos por la aplicación WinnerPOS instalada en cada sucursal:

• Captura de órdenes de compra (GET): permite a WinnerPOS consultar y obtener las órdenes de compra generadas en el e-commerce.
• Actualización de precios (POST): permite actualizar los precios de los productos, según las necesidades de la integración.
• Actualización de stock (POST): permite actualizar la disponibilidad de inventario de los productos.

Estructura Captura de Órdenes de Compra

Valores Posibles

Cliente

Los datos del cliente son opcionales si se trata de Boleta Electrónica, pero obligatorios si es Factura.

Items

Por cada item de la orden de compra debe venir un registro.

WinnerPOS calculará el precio unitario del artículo, para evitar errores de aproximación.

Pagos

Corresponde a la forma de pago de la Orden. Como es Pago por E-Comerce, se esperan los datos del proveedor de pagos (WebPay u otro)

NOTA: Todos Los campos en Rojo son campos obligatorios, el resto son opcionales.

Requisitos:

1) Solo deben venir SKU que existen en la base de datos de WinnerPOS.
2) La Orden debe venir completamente Pagada.
3) Para Factura los datos del cliente son obligatorios.

Si no se cumple alguno de los requisitos la Orden será rechazada.

Estructura Actualización de Precios

Valores Posibles

Estructura Actualización de Stocks

Valores Posibles

¿Como Seguimos?

El cliente integrador debe enviar un correo a soporte@innovaplus.cl con la siguiente información:

1) EndPoint para captura de Ordenes de Compra en Ambiente de pruebas
a) OC Para Boleta sin Cliente
b) OC Para Factura con Cliente y CodCiudad, CodComuna Validos
c) OC Para Factura con Cliente sin CodCiudad ni CodComuna
d) OC Con SKUs Inválidos
e) OC Sin Pagos
f) OC Con Pagos
2) EndPoint para actualización de Precios, debe indicarnos al menos 3 SKUs de prueba.
3) EndPoint para actualización de Stocks, debe indicarnos al menos 3 SKUs de prueba.