Introducción
API

SFTP

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 opcional

      • Barcode: 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 obligatorio

      • start_date y end_date: timestamp, campo obligatorio: debe tener el siguiente formato YYYY-MM-DD HH:MM:SS o YYYY-MM-DD

      • campaign_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 original

      • max_no_of_orders: integer, opcional: la cantidad de pedidos que se pueden realizar para esta campaña

      • maximum_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.

  • 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.

Crear su promoción usando un formato de archivo doble (un solo vendedor o multivendedor)#

  1. 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 opcional

      • Barcode: 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 obligatorio

      • start_date y end_date: timestamp, campo obligatorio: debe tener el siguiente formato YYYY-MM-DD HH:MM:SS o YYYY-MM-DD

      • campaign_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 original

      • max_no_of_orders: integer, opcional: la cantidad de pedidos que se pueden realizar para esta campaña

      • maximum_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 poner all en la columna 'vendors' y utilizar la columna 'exclude' para los proveedores que desea excluir de la promoción. Separe a los proveedores usando comas.

  1. 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.

  2. 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.


SFTPCómo integrarteSFTPProbando la Integración