Embedded Files
Beneficios
Beneficios
A través de una integración SFTP, podrás automatizar y autogestionar tus promociones. Ten en cuenta que actualmente solo contamos con promociones de precio final. Puedes consultar a tu Representante de cuenta sobre los próximos tipos de promociones que estaremos incorporando.
Proceso
Proceso
PASO 1
Contacto
Leer la documentación y solicitar las credenciales a tu Ejecutivo de cuenta
PASO 2
Acceso
Comparte a tu Ejecutivo de Cuenta un correo al que tengas acceso pero NO exista en Pedidosya.
Recibirás tus credenciales del SFTP, la dirección y nombre de tu tienda de pruebas y acceso a ella desde Vendor Portal.
Te llegará un email del equipo de Soporte de Integraciones para tener el primer contacto con ellos.
PASO 3
Desarrollo
Podrás consultarle al equipo de Soporte de Integraciones las dudas que tengas y deberás compartir el archivo generado para que validen su estructura.
PASO 4
Test + Homologación
Deberás probar todas las funcionalidades y comunicarle al equipo de Soporte para que te den feedback. Coordinar una reunión de homologación con el equipo de Soporte de Integraciones a través del siguiente link.
PASO 5
Live
Puesta en marcha de la integración en todas tus tiendas online.
PASO 6
Issues
Puedes contactar a tu Ejecutivo de Cuenta o comunicarte con Ayuda en línea a través del Vendor Portal.
Accesos
Accesos
Para la integración mediante SFTP, solicita tus credenciales a tu Representante de cuenta:
Nombre de usuario
Contraseña
Ten en cuenta que las credenciales se manejan a nivel de razón social, por lo que tendrás tantas credenciales como razones sociales tengas registradas en PedidosYa. Tienes que considerar estos datos para realizar la conexión:
Número de puerto: 22
Servidor: vendor-automation-sftp-live-us.prod.aws.qcommerce.live
Comparte a tu Ejecutivo de Cuenta un correo al que tengas acceso pero NO exista en Pedidosya.
El equipo de Soporte de Integraciones creará un usuario de pruebas con el correo compartido, que sólo podrá ser utilizado para pruebas (no se podrán realizar pedidos reales). Podrás ver tu tienda de pruebas desde el Vendor Portal y en la aplicación de PedidosYa, buscándola con la dirección y el nombre que te compartirá tu Representante de cuenta (ingresando a la app con el usuario de pruebas). Allí podrás verificar que todo lo que gestiones se vea impactado correctamente.
Casos de uso
Casos de uso
a. Creación de promociones en las que se indica precio final con descuento aplicado
Para crear una promoción deberás enviar el archivo que te mostramos a continuación con el campo campaign_status = 1 en todos los productos que quieres promocionar.
b. Actualización de promociones creadas a través de la integración (activación/ desactivación a nivel de producto, actualización del precio de descuento de los productos):
Para actualizar una promoción, deberás enviar los datos de la campaña creada originalmente con las modificaciones en los campos que necesites: campaign_status o discounted_price.
Para gestionar tus promociones y campañas, deberás depositar en la carpeta /promotions en un archivo .CSV con una de las siguientes estructuras:
Un archivo por tienda
Un archivo por tienda
Ten en cuenta las siguientes indicaciones para cargar tu archivo:
Estructura y nombre:
Nombra el archivo con el siguiente patrón: Prefijo_iddetienda.csv (por ej: Promociones_213456.csv). Puedes elegir el Prefijo que desees, manteniendo el patrón del nombre del archivo.
Deberás cargar un archivo distinto para cada tienda.
El archivo debe ser .CSV. La codificación del archivo debe ser en UTF-8. Los separadores de columnas deben ser comas (“,”) y los decimales puntos (“.”).
Los campos booleanos pueden ser enviados como “1” y “0” o “TRUE” y “FALSE”.
No necesitas poner un orden obligatorio en las columnas, pero los encabezados se deben respetar.
Se admite solo un juego de comillas en los campos, pero no son obligatorias.
Los separadores de columnas deben ser comas ",".
Tamaño:
El tamaño máximo es de hasta 19.999 SKUs. Si el tamaño de tu archivo es mayor, deberás subir varios archivos por separado.
Si tienes dudas, puedes tomar este .CSV como ejemplo:
Un archivo para más de una tienda (archivo multivendor)
Un archivo para más de una tienda (archivo multivendor)
Ten en cuenta las siguientes indicaciones para cargar tu archivo:
Estructura y nombre:
Nombra el archivo con el siguiente patrón: Prefijo.csv (por ej: Promociones.csv). Puedes elegir el Prefijo que desees, manteniendo el patrón del nombre del archivo.
Deberás cargar un archivo para cada combinación de tiendas que compartan promociones.
El archivo debe ser .CSV. La codificación del archivo debe ser en UTF-8. Los separadores de columnas deben ser comas (“,”) y los decimales puntos (“.”).
Los campos booleanos pueden ser enviados como “1” y “0” o “TRUE” y “FALSE”.
No necesitas poner un orden obligatorio en las columnas, pero los encabezados se deben respetar.
Se admite solo un juego de comillas en los campos, pero no son obligatorias (en los campos vendors y exclude sí son obligatorias).
Los campos "vendors" y "exclude" al igual que los datos de la campaña, pueden ser cargados sólo en la primera línea, pero si se cargan en todas, deben ser siempre iguales.
Tamaño:
El tamaño máximo es de hasta 19.999 SKUs. Si el tamaño de tu archivo es mayor, deberás subir varios archivos por separado.
No puedes superar los 300.000 productos por campaña (multiplicando la cantidad de SKUs de la campaña x la cantidad de tiendas involucradas).
Si tienes dudas, puedes tomar estos .CSV como ejemplo:
Archivo que aplique a todas las tiendas de una razón social:
Archivo que aplique a algunas tiendas de una razón social:
Archivo que excluya algunas tiendas de una razón social:
Frecuencia:
No tienes límites en la frecuencia de carga. Puedes cargar un archivo siempre que necesites agregar una nueva promoción o sobreescribir una existente.
El tiempo de procesamiento para crear una campaña es de alrededor de 90 minutos.
Restricciones:
Una vez que creas una campaña, si envías un archivo con los mismos datos de campaña original (campaign_name, reason, start_date, end_date, max_no_of_orders), la campaña se sobreescribirá.
Por ello, si deseas modificar el precio promocional de un producto de la campaña original o eliminar la promoción de algún producto, deberás enviar la información de todos los productos que deseas conservar en la promoción y sus nuevos precios promocionales.
Así se ven las promociones en la aplicación:
Homologación
Homologación
Para dejar tu integración lista y activa en todas tus tiendas operativas, debes realizar una homologación.
Sigue estos pasos:
Envía el archivo generado para la tienda de pruebas a nuestro equipo de Soporte de Integraciones a este e-mail: soporteintegraciones@pedidosya.com.
Nuestro equipo validará que la estructura del archivo sea la correcta. El equipo de Soporte te dará el feedback correspondiente y te guiará para que el archivo sea adecuado.
Una vez que el archivo esté validado por nuestro equipo, impacta el mismo archivo en la tienda de pruebas que te compartieron.
Coordina aquí una reunión con el equipo de Soporte de Integraciones para certificar el correcto funcionamiento de la integración y la periodicidad con la se envían las actualizaciones.
Luego de esta reunión, la integración podrá quedar live en las tiendas reales.
Preguntas frecuentes
Preguntas frecuentes
¿Debo realizar las pruebas de la integración en una tienda real?
No, las pruebas se realizarán en una tienda de pruebas que creará tu Ejecutivo de Cuentas. De esta forma, nos aseguramos de no afectar las tiendas operativas.
Luego de que la integración sea homologada, podrás impactar información en las tiendas reales.
¿La tienda de pruebas tendrá las mismas credenciales que las tiendas reales?
Sí. Las credenciales (nombre de usuario y contraseña) se manejan a nivel de razón social y tu tienda de pruebas tendrá credenciales asociadas a una de tus razones sociales en Pedidosya.
Si tienes sólo una razón social en Pedidosya, las credenciales de la tienda de pruebas serán iguales a la que usarás para todas las tiendas reales.
¿Cómo me puedo conectar al servidor de SFTP?
Puedes conectarte usando un programa como Cyberduck, FileZilla, WinSCP o realizando un desarrollo por comandos.
¿En cuánto tiempo queda lista la creación o el cambio de una campaña de promociones?
¿En cuánto tiempo queda lista la creación o el cambio de una campaña de promociones?
Después de recibir el archivo, nos tomará alrededor de 90 minutos crear una campaña de promociones o sobreescribir una campaña ya creada.
¿Qué formato debo utilizar para las fechas y horas de inicio y final de la campaña?
¿Qué formato debo utilizar para las fechas y horas de inicio y final de la campaña?
En los campos de inicio (start_date) y final (end_date) de la campaña de promociones debes colocar la fecha y la hora juntas, utilizando los siguientes formatos:
Coloca primero la Fecha y luego la Hora, separadas por un espacio:
AAAA-MM-DD HH:MM:SS
¿El nombre (campaign_name) y la razón (reason) de la campaña serán visibles en la aplicación?
¿El nombre (campaign_name) y la razón (reason) de la campaña serán visibles en la aplicación?
No. Tanto el nombre como la razón de la campaña de promociones tienen fines operativos, y solo serán visibles en la sección de Promociones en el Vendor Portal. Te servirán a ti para que puedas identificar tu campaña.
¿Qué no puedo modificar después de crear una campaña?
¿Qué no puedo modificar después de crear una campaña?
Una vez que creas una campaña de promociones, no podrás:
Modificar las fechas de inicio y de final de la campaña
Modificar un SKU de una campaña a otra
Asignar un SKU a varias campañas
Modificar el máximo número de órdenes para la promoción
Si tienes alguna duda, consulta a tu Representante de cuenta.
¿Existe una verificación de superposición de promociones para un mismo producto?
¿Existe una verificación de superposición de promociones para un mismo producto?
Sí. Si cargas 2 o más promociones para un mismo producto en las que se superpone la fecha, la que impactará será la promoción con la última fecha.
Si un producto está inactivo, ¿se crea igualmente la promoción de ese producto?
Si un producto está inactivo, ¿se crea igualmente la promoción de ese producto?
Sí, crearemos la promoción. Pero ten en cuenta que si el producto está inactivo, la promoción no será visible en la app hasta que se active ese producto.
No crearemos la promoción de un producto solo si el mismo no se encuentra en tu catálogo o si tiene algún error de sincronización en Global Catalog.
¿Cómo cambio el precio de promoción de un producto?
¿Cómo cambio el precio de promoción de un producto?
Para modificar el precio de promoción de un producto debes enviar el .CSV con toda la información de la campaña existente, indicando el nuevo precio de descuento para ese producto.
¿Si no envío un producto en un archivo, su promoción se desactiva?
¿Si no envío un producto en un archivo, su promoción se desactiva?
Sí, como los archivos se sobreescriben, si envías los datos de la campaña original y no indicas el producto, el mismo se eliminará de la campaña.
¿Cómo desactivo una campaña o una promoción?
¿Cómo desactivo una campaña o una promoción?
Para desactivar una campaña o promoción, debes enviar el .CSV con valor “0” en el campo campaign_status en el SKU cuya promoción quieres desactivar. Si quieres desactivar una campaña completa, deberás enviar el valor campaign_status con valor "0" en todos los productos.
¿Qué pasa si cargo un producto con precio de descuento mayor o igual al precio original?
¿Qué pasa si cargo un producto con precio de descuento mayor o igual al precio original?
En el caso en que el precio de descuento sea mayor o igual al precio original, el producto aparecerá en la sección “Promociones” del catálogo pero no tendrá ninguna promoción visible.
¿Qué pasa si cargo más de un start_date y end_date o max_no_orders en el archivo?
¿Qué pasa si cargo más de un start_date y end_date o max_no_orders en el archivo?
En el caso de que cargues más de un campo igual en el archivo .CSV, tomaremos la primera línea para toda la información general de la campaña: nombre de campaña, razón, fechas y max_no_orders.
¿Qué pasa si coloco un SKU más de una vez en una campaña (en más de una línea del .CSV)?
¿Qué pasa si coloco un SKU más de una vez en una campaña (en más de una línea del .CSV)?
Los productos que aparecen más de una vez, no son tenidos en cuenta.
¿Qué vendors pueden estar dentro de un mismo archivo de promociones (archivos multivendor)?
¿Qué vendors pueden estar dentro de un mismo archivo de promociones (archivos multivendor)?
Los vendors deben pertenecer a la misma chain (razón social) para poder estar en un mismo archivo de promociones. Además, deben contar con los mismos productos en promoción y su precio promocional debe ser igual en las tiendas.
¿Puedo crear una promoción para todos los partners de una razón social?
¿Puedo crear una promoción para todos los partners de una razón social?
Sí, al enviar un archivo multivendor indicando “all” en la columna vendors, todos los vendors de la razón social participarán de la promoción.
¿Cuándo debo completar la columna exclude del archivo multivendor?
¿Cuándo debo completar la columna exclude del archivo multivendor?
Debes completarlo únicamente si en la columna vendors colocaste "all" y quieres excluir ciertas tiendas. En este caso, debes colocar los id de tiendas a excluir separados por coma. De lo contrario, puedes dejar la columna vacía.
¿Puedo actualizar una promoción multivendor para una o algunas de las tiendas originales de la promoción?
¿Puedo actualizar una promoción multivendor para una o algunas de las tiendas originales de la promoción?
No, si se crea una promoción para las tiendas “A,B”, entonces todos los archivos de actualización de dicha promoción afectarán a las tiendas "A,B".
Si se envía un conjunto diferente de tiendas en la columna vendors, el archivo aún procesará, pero actualizará la promoción para todas las tiendas en la promoción.
¿Qué sucede si en una promoción multivendor se indica la misma tienda en las columnas vendors y exclude?
¿Qué sucede si en una promoción multivendor se indica la misma tienda en las columnas vendors y exclude?
Se ignorará la tienda tanto en la columna vendors como de la columna exclude.
Si un producto tiene una promoción, ¿debo informarlo en la integración de catálogo?
Si un producto tiene una promoción, ¿debo informarlo en la integración de catálogo?
Sí, la integración de catálogo y la de promociones son independientes. Debes seguir informando el producto en la integración de catálogo ya que puede tener cambios en su precio original o disponibilidad.
Contacto
Contacto
Si tienes alguna duda o consulta durante el proceso de integración, contacta a nuestro equipo de Soporte de Integraciones vía e-mail: soporteintegraciones@pedidosya.com
Y si surge cualquier inconveniente después de que la integración esté activa, contacta a tu Representante de cuenta o reporta el issue aquí.
Page updated
Report abuse