API
Gestionar pedidos entrantes
Gestionar tu catálogo de productos
SFTP
Gestionar tu catálogo de productos
Gestionar tus promociones
Casos de uso#
Esta sección cubrirá los casos de uso de la integración y el formato/configuración de archivos para llevar a cabo estas operaciones.
Existen varias formas de actualizar y administrar campañas a través de una integración SFTP; todas las operaciones se pueden llevar a cabo utilizando diferentes formatos de archivo generados por su cliente SFTP.
Crear su promoción usando un formato de archivo único#
Cree un archivo CSV que incluya todos los productos para los que desea crear la promoción. El archivo debe contener
Identificador del producto
SKU: string, campo opcionalBarcode: string, campo opcional: si desea utilizar códigos de barras como identificador de producto, infórmenos con anticipación para que podamos configurarlo en nuestras herramientas internas.Se pueden usar ambos
Datos a nivel de campaña
reason: string, campo obligatoriostart_dateyend_date: timestamp, campo obligatorio: debe tener el siguiente formatoYYYY-MM-DD HH:MM:SSoYYYY-MM-DDcampaign_status: boolean, opcional: 1 para activo o 0 para inactivo. Si no envía el estado de la campaña, el sistema asumirá que es '1' (para habilitar la promoción)discounted_price: double, campo obligatorio: precio final, debe ser menor que el precio originalmax_no_of_orders: integer, opcional: la cantidad de pedidos que se pueden realizar para esta campañamaximum_sales_quantity: integer, opcional: se refiere al número máximo de unidades de un producto específico que puede vender un vendedor o una tienda.
Aquí hay un ejemplo de cómo podría verse el archivo. En este ejemplo, también se incluyen las actualizaciones de Catalog. Esto se analiza con más detalle en la sección SFTP: Catalog.

Si envía los datos de la promoción en un formato diferente, por ejemplo, utilizando "status" en lugar de "active" o un formato de fecha diferente, informe a su Account Manager. Si bien esto está permitido, primero debemos configurarlo en el backend.
Cuando tenga su archivo listo, puede enviarlo al servidor central a la carpeta
Assortmentutilizando las credenciales recibidas de su Account Manager. Más sobre esto en la Sección Credenciales y acceso.Verifique las actualizaciones en el Partner Portal en la sección Integraciones de tiendas en Actualizaciones de archivo único. También puede descargar el archivo que ha subido recientemente y revisar los errores si se produce alguno.
Crear su promoción usando un formato de archivo doble (un solo vendedor o multivendedor)#
Cree un archivo CSV que incluya todos los productos para los que desea crear la promoción. El archivo debe contener
Identificador del producto
SKU: string, campo opcionalBarcode: string, campo opcional: si desea utilizar códigos de barras como identificador de producto, infórmenos con anticipación para que podamos configurarlo en nuestras herramientas internas.Se pueden usar ambos
Datos a nivel de campaña
reason: string, campo obligatoriostart_dateyend_date: timestamp, campo obligatorio: debe tener el siguiente formatoYYYY-MM-DD HH:MM:SSoYYYY-MM-DDcampaign_status: boolean, opcional: 1 para activo o 0 para inactivo. Si no envía el estado de la campaña, el sistema asumirá que es '1' (para habilitar la promoción)discounted_price: double, campo obligatorio: precio final, debe ser menor que el precio originalmax_no_of_orders: integer, opcional: la cantidad de pedidos que se pueden realizar para esta campañamaximum_sales_quantity: integer, opcional: se refiere al número máximo de unidades de un producto específico que puede vender un vendedor o una tienda.

Si desea crear la promoción para dos o más proveedores en el mismo archivo, puede utilizar la opción Multivendedor. Para eso, puede agregar 2 columnas más al archivo existente:
vendors: en esta columna puede agregar todos los proveedores para los que desea ejecutar esta promoción separados por una coma. Si desea ejecutar la promoción para todos los proveedores, simplemente puede poner 'all' en esa columna.exclude: para utilizar esta columna, debe ponerallen la columna 'vendors' y utilizar la columna 'exclude' para los proveedores que desea excluir de la promoción. Separe a los proveedores usando comas.

Cuando tenga su archivo listo, puede enviarlo al servidor central a la carpeta Assortment utilizando las credenciales recibidas de su Account Manager. Más sobre esto en la Sección Credenciales y acceso.
Verifique las actualizaciones en el Partner Portal en la sección Integraciones de tiendas en Actualizaciones de archivo único. También puede descargar el archivo que ha subido recientemente y revisar los errores si se produce alguno.
