SERVICIO WEB (WEB SERVICE) INVENTARIO DE PRODUCTOS
Introducción Obtención de Cuenta Definición de Catálogo Ejemplos de JSON Formato TXT
Introducción Mi nombre es Juan Pablo Espinosa, soy el Director de PCEL y nos gustaría mucho tener sus inventarios y precios conectados a nuestro sistema como el resto de los mayoristas con los que trabajamos, te comparto algunos puntos en cómo fluye esta información en nuestra empresa: - El mayorista nos dá un acceso a su lista de productos con nuestros costos e inventarios de cada sucursal. - Se Realiza una implementación robusta por medio de un web service (caso Ingram por ejemplo): - Nos publican una lista detallada al inicio del día con todos los productos (20mil+) con precios e inventarios - Durante el día podemos hacer consultas de lotes de 100 Skus para actualizar únicamente precios e inventarios en tiempo real de los productos que nosotros estamos estamos monitoreando - Al día de hoy actualizamos precios e inventarios de 3,000+ Skus - 4 veces diarias en lotes de 100 skus - Una vez recibida esta actualización, la información es procesada y alimentada a nuestro sistema de manera automática, en este momento todos sus productos se vuelven "visibles" para nuestra área de producto y compradores - que se encargan de vincular sus Skus con nuestros Skus o de dar de alta productos exclusivos de ustedes - Nosotros procesamos más de 500 pedidos diarios y durante el día hacemos dos o más cortes, donde nuestra área de compras revisa la mercancía vendida sin stock (de pedidos) y el reabastecimiento de nuestros inventarios, para ello, todos los proveedores ligados a un Sku de PCEL participan en una "subasta interna" que evalúa diferentes atributos: - Costo del producto - Inventario nuestro, del proveedor y forecast - Términos y plazo de crédito - Potencial de negociación o acuerdos realizados con esa marca con algún mayorista - Si resultan los seleccionados "ganadores" de alguna partida (por una buena mezcla de los anteriores atributos) se les hace llegar un requerimiento de cotización para negociar volumen y precio final - que si todo marcha bien puede convertirse en una orden de compra Debido al volumen de transacciones, al número de skus que manejamos, la volatilidad de inventarios, etc. se vuelve imposible trabajar con mayoristas que no nos ofrezcan esta información, en este momento todo está automatizado La guía de referencia JSON para comercio está diseñada para analistas de sistemas y personal de soporte de sistemas. Su servicio de catálogo debe poder ser integrado con cualquier sistema de comercio usando servicios web utilizando formato JSON sobre una conexión TCP/IP empleando protocolo HTTPS obteniendo un catálogo de productos con una autentificación previa.
Obtención de Cuenta Después de que PCEL cubra los requisitos que el proveedor solicite, este último deberá brindar una cuenta para obtener un inventario en linea Elemento Descripción Tipo Valores (Ejemplo) Usuario Usuario entregado por proveedor con permisos para ejecutar servicios web String miusuario@proveedor.com miusuario Contraseña Contraseña entregada por proveedor con permisos para ejecutar servicios web, de máximo 12 caracteres, sensible a mayúsculas y minúsculas. String SDx11$ff123*
Definición de Catálogo Array de elementos con los productos solicitados: Campo Descripción Por PCEL SKU Número de Referencia requerido UPC Código Universal de Producto (UPC-A) recomendado marca Nombre del identificador comercial del producto requerido modelo_fabricante Serie de caracteres proporcionados por el fabricante requerido descripcion Descripción del producto requerido categoria subcategoria garantia disponible Categoría general del producto Subcategoria del producto Duración en tiempo de garantía (en meses) Suma de cantidad de productos disponibles en todos sus almacenes requerido costo_usd Costo en dólares del producto antes de IVA requerido costo_mxn precio_publico_mxn costo_especial_usd_activo costo_especial_usd costo_especial_mxn_activo costo_especial_mxn descripcion_costo_especial inicio_costo_especial vencimiento_costo_especial ficha_tecnica Costo en pesos mexicanos del producto antes de IVA (Requerido si no manejan costo_usd) Precio recomendado para venta al público antes de IVA Valor binario; 1 para activar, 0 para desactivar Costo con descuento en dólares Valor binario; 1 para activar, 0 para desactivar Costo con descuento en pesos MXN Razón del descuento Fecha de inicio de precio especial (Y-m-d H:i:s or Unix TimeStamp) Fecha de finalización de precio especial (Y-m-d H:i:s or Unix TimeStamp) Dirección url de obtención de datasheet del producto requerido
ficha_comercial esta_activo es_restringido imagen peso ancho largo alto eta backorder backorder_eta almacen_mty ALMACENES_FORANEOS Dirección url de obtención de datos comerciales Valor binario; 1 para activar, 0 para desactivar --- Representa si el producto puede o no venderse por razones del proveedor Valor binario; 1 para activar, 0 para desactivar --- Representa si el producto puede o no venderse por cuestiones de certificación Dirección url en JSON para obtención de imagen del producto Peso del producto Ancho del producto Largo del producto Alto del producto Tiempo estimado de llegada (dias/numerico) Si el producto no lo tienen en stock en ese momento (agotado) se coloca reserva del producto (numerico) Si el producto está agotado se coloca el tiempo estimado de llegada a sus bodegas (dias/numerico) Cantidad de productos disponibles en el almacén de Monterrey (0 si no hay disponibilidad) Cantidad de productos disponibles fuera de Monterrey, Organizados por Estados, El código de tres digitos de a utilizar de cada estado es ISO_3166-2:MX requerido requerido almacen_agu -> zac ejemplo: almacen_jal, almacen_bcs, almacen_cmx, almacen_yuc requerido
Ejemplos de JSON { "articulos": [ { "sku": "4564566", "upc": "4656938759823", "marca": "HONEYWELL", "modelo_fabricante": "", "descripcion": "LECTOR 1200G VOYAGER NEGRO KIT USB", "categoria": "Punto de Venta", "subcategoria": "Lectores de Codigos de Barra", "garantia": "12", "costo_usd": "115.16", "costo_mxn": "", "precio_publico_recomendado_mxn": "2599", "costo_especial_usd_activo": "", "costo_especial_usd": "", "costo_especial_mxn_activo": "", "costo_especial_mxn": "", "descripcion_costo_especial": "", "inicio_costo_especial": "", "vencimiento_costo_especial": "", "ficha_tecnica": "", "ficha_comercial": "", "esta_activo": "0", "es_restringido": "", "imagen": "", "peso": "", "ancho": "", "largo": "", "alto": "", "eta": "2", "backorder": "", "backorder_eta": "", "almacen_mty": "10", "almacen_bcs": "0", "almacen_jal": "5" }, { "sku": "5564566", "upc": "4578456787643", "marca": "HP", "modelo_fabricante": "HP-240-LB", "descripcion": "LAPTOP HP 240 Core I5 8GB RAM", "categoria": "Computadoras",
"subcategoria": "Laptops", "garantia": "12", "costo_usd": "", "costo_mxn": "6700", "precio_publico_recomendado_mxn": "8599", "costo_especial_usd_activo": "", "costo_especial_usd": "", "costo_especial_mxn_activo": "1", "costo_especial_mxn": "5700", "descripcion_costo_especial": "Promocion por Introduccion", "inicio_costo_especial": "2018-04-05 09:00:00", "vencimiento_costo_especial": "2018-04-15 11:59:59", "ficha_tecnica": "http://miempresa.com/sku/5564566/ftecnica", "ficha_comercial": "http://miempresa.com/sku/5564566/fcomercial", "esta_activo": "1", "es_restringido": "", "imagen": "http://miempresa.com/sku/5564566/imagenes", "peso": "4", "ancho": "40", "largo": "50", "alto": "10", "eta": "2", "backorder": "", "backorder_eta": "", "almacen_mty": "45", "almacen_bcs": "0", "almacen_jal": "15" }, { "sku": "5564526", "upc": "4578456287643", "marca": "HP", "modelo_fabricante": "HP-240-IJ", "descripcion": "LAPTOP HP 240 Core I5 6GB RAM", "categoria": "Computadoras", "subcategoria": "Laptops", "garantia": "12", "costo_usd": "350", "costo_mxn": "", "precio_publico_recomendado_mxn": "8599", "costo_especial_usd_activo": "1", "costo_especial_usd": "300", "costo_especial_mxn_activo": "", "costo_especial_mxn": "", "descripcion_costo_especial": "Promocion por Introduccion", "inicio_costo_especial": "2018-05-05 09:00:00",
} ] "vencimiento_costo_especial": "2018-05-15 11:59:59", "ficha_tecnica": "http://miempresa.com/sku/5564526/ftecnica", "ficha_comercial": "http://miempresa.com/sku/5564526/fcomercial", "esta_activo": "1", "es_restringido": "", "imagen": "http://miempresa.com/sku/5564526/imagenes", "peso": "4", "ancho": "40", "largo": "50", "alto": "10", "eta": "", "backorder": "200", "backorder_eta": "30", "almacen_mty": "0", "almacen_bcs": "0", "almacen_jal": "0" }
Una buena herramienta para comprobar si tu archivo es válido, es esta página. https://jsonformatter.curiousconcept.com/ Desarrollar un API REST para solicitar especificaciones, precio e inventario por SKU, hacer pedidos, consultar tipo de cambio de dólar, generar tokens de autenticación, es altamente deseable. Nota: es preferible separar las peticiones de productos (información general), de las peticiones de inventario (stock) y costo que cambian continuamente, de esa manera baja la carga de procesamiento de tu servidor. Así una vez al día, se solicitan nuevos productos y datos que no varían (si es que llegasen a cambiar). Y cada [ [X] tiempo se solicita el stock y el costo.
Formato TXT En caso de no contar con herramientas para generarlo en formato JSON, se puede recibir en un archivo de texto separado por Tabulaciones vía SFTP. Donde se deben tener las siguientes consideraciones para el archivo: - No incluyas signos de pesos en los costos. - No incluyas comas en los costos - Por lo tanto los costos deben ser del tipo decimal (numérico) - Las fechas debe estar en formato timestamp preferentemente (YYYY-MM-DD HH:MM:SS) - Tu nombre de archivo no debe contener espacios (puede tener guiones bajos) y preferentemente se debe llamar "tuempresa.csv" - El nombre del archivo siempre debe ser el mismo.