Documentación oficial para integración de Stock vía API
Documentación oficial para integración de Stock vía API
En Partsflow contamos con la capacidad de integración via API para realizar búsquedas de inventario con los códigos que el agente Victor encuentra cuando comienza su ejecución.
Esta integración vía API podría, entre otras cosas, ayudarte a:
Acelerar la búsqueda de precios que manejas en tu inventario
Responder cotizaciones de manera automática para los productos con mayor rotación
Permitir a tu equipo de ventas buscar el precio de los productos en un solo lugar, sin tener que depender de la lentitud de tu ERP
Si no cuentas con las capacidades de una API para realizar la integración, pero aún así te interesa conseguir lo anteriormente mencionado, dirigete a integración de stock vía excel
Flujo de la integración
La integración vía API tiene como objetivo utilizar uno o más códigos de partes, y consultar -vía API- la disponibilidad de estos en tu tienda. Básicamente una consulta de stock tipica, para darle un precio al cliente.
El siguiente diagrama describe el proceso de consulta vía API al stock de tu sistema:
Consideraciones:
Esta API que dispongas para hacer la búsqueda de inventario, funcionará mucho mejor si permites hacer la búsqueda por código y por campo de texto libre (por ejemplo, buscar "Filtro Aire Corsa 2009")
Si tienes restricciones de IP para acceder a la API, ponte en contacto con el equipo para ver como solventar este problema.
Estructura de la solicitud
La solicitud que se realizará a tu servidor será una API Request mediante el método POST. Dentro de este POST, se encontrará en el parámetro "search" del body, el valor del string que se buscará en tu sistema (ya sea OEM, código interno, cadena de texto libre, etc.)
Ejemplo solicitud 1: Búsqueda de OEM
URL: https://servidorprueba.api.test/busquedaStock/ 👈 (Esta es la URL que tú nos entregarás)
Method: POST
Body:
{
"search": "1654600QA"
}
En este caso, se está realizando una búsqueda por código OEM
Ejemplo solicitud 2: Búsqueda por texto libre
URL: https://servidorprueba.api.test/busquedaStock/ 👈 (Esta es la URL que tú nos entregarás)
Method: POST
Body:
{
"search": "BOMB AGUA CORSA 2007"
}
En este caso, se está realizando una búsqueda por texto libre, como lo realizan los vendedores de manera típica. Este standard de búsqueda lo defines tú y nosotros adaptaremos nuestro agentes para obedecer ese patrón de búsqueda
Consideraciones de autenticación
Recomendamos implementar un sistema de autenticación vía Bearer Token para poder validar el acceso a la API.
Este sistema de autenticación es estandar en la industria. La forma de realizar la autenticación típicamente es una API POST Request. Si tienes alguna duda de como implementar un sistema de autenticación, no dudes en contactarte con nuestro equipo.
Estructura de la respuesta
Típicamente, la respuesta de la API debe obedecer un estandar de estructura. Se espera que la API retorne un arreglo de objetos, donde cada objeto tiene que contar con los siguientes atributos:
product_type (string?: ENUM['alternative', 'original', 'genuine']): Tipo de producto, original, alternativo o genuino. Es un ENUM que puede tomar valor alternative, original o genuine. Es opcional (puede llegar en NULL).
product_name (string: 1024 chars): Nombre del producto almacenado en inventario. Tipico para cuando se guarda un SKU como "Past Fren Corsa 2008-2015"
product_sku (string?: 1024 chars): SKU interno del producto. Puede ser el mismo OEM, o el mismo código interno de proveedor.
brand (string?: 1024 chars): Marca del producto. Ejemplo: Valeo, DEPO, Netmotors, etc
origin (string?: 1024 chars): Origen del producto. Ejemplo: China, Taiwan, Turquía, etc.
price (int): Precio venta unitario del producto con IVA incluido. Obligatorio
stock_left (int): Stock disponible del producto en la bodega indicada.
warehouse (string: 1024 chars): Bodega donde está el producto
supplier_product_code (string: 1024 chars): Código del producto, puede ser el SKU interno de bodega, OEM, código fabricante, etc. Es de caracter obligatorio.
supplier_oem (string?: 1024 chars): Código OEM del producto. Es opcional
extra_data (json?: {}): JSON de data externa que se quiera agregar (por ejemplo, compatibilidad de vehiculos, stock estimado, etc). Es un campo libre y opcional.
Ejemplo de respuesta
[
{
"product_type": "original",
"product_name": "FILTRO AIRE",
"product_sku": "1654600Q1B",
"brand": null,
"origin": null,
"price": 52360,
"stock_left": 4,
"warehouse": "10 de Julio",
"supplier_product_code": "16546-00Q1B-1",
"supplier_oem": "1654600Q1B",
"extra_data": null
}, ...
]
En este caso, el arreglo de la respuesta tiene 1 objeto en la respuesta.
El objeto de esta respuesta es la representación de un producto en stock.
Para este producto, podemos observar que es un FILTRO DE AIRE, original, a un precio de venta con IVA de 52.360, y quedan 4 unidades en la bodega de 10 de Julio.
Además, podemos ver que el OEM del producto ha sido entregado, es el 15460QQ1B, además del código de producto interno para el proveedor, quien en este caso utiliza el mismo OEM como código identificador del producto, con unos caracteres extras: 16546-00Q1B-1.
Y en el caso del SKU, también utiliza el mismo OEM como identificador de SKU.
También podemos observar que la marca del producto no fue entregada, asi como el origen del producto y el campo personalizado "extra_data".