El canal Manual/API

Cuándo usar un canal Manual/API

Un canal Manual/API no está enlazado a ninguna tienda. No se sube nada a ninguna web y no llega ningún pedido por sí solo. Úsalo cuando:

• Vendes en tu propia web, en un marketplace al que no nos conectamos, en redes sociales o por teléfono, y quieres enviarnos cada pedido tú mismo.
• Tienes tu propio sistema o desarrollador y quieres enviarnos pedidos a través de nuestra API.

Si tu tienda está en una plataforma de las que aparecen en la página Agregar canal de ventas, como Shopify, WooCommerce, eBay o TikTok Shop, conecta esa plataforma en su lugar. Entonces los productos se suben por ti y los pedidos llegan por sí solos.

Puedes tener más de un canal Manual/API, por ejemplo uno por cada web.

Crear el canal

1. Abre Canales en el menú. Ves la lista de tus Canales de venta.
2. Pulsa Agregar canal de ventas. La página muestra Seleccione el canal que desea crear.
3. En la tarjeta de Manual/API pulsa Crear.
4. Se abre una ventana Crear manual de plataforma. Escribe un nombre para el canal, por ejemplo el nombre de tu web. El nombre puede tener hasta 28 caracteres.
5. Pulsa Crear.

Ves el mensaje Se ha creado su tienda Manual. y se abre la página del canal.

Cada uno de tus canales necesita su propio nombre. Si el nombre ya lo usa otro de tus canales, la ventana muestra un error. Elige un nombre distinto.

La página de tu canal

La página del canal tiene el nombre de tu canal como título y el encabezado Gestión de pedidos manual/API. Muestra tres recuadros, cada uno con un enlace View all:

• Pedidos: los pedidos que has puesto en este canal.
• Clientes: las personas a las que envías pedidos.
• Productos: los productos de tu lista Mis productos.

En el menú, bajo el nombre del canal, encuentras:

• Cestas: pedidos que empezaste y no pagaste todavía.
• Mis productos: los productos que vendes en este canal. Consulta Gestionar productos en el canal Manual/API.
• Clientes: tus compradores. Consulta Gestionar clientes.
• Pedidos: tus pedidos puestos. Consulta Poner pedidos manualmente.
• API: tokens y documentación para conectar tu propio sistema.

La forma habitual de trabajar es:

1. Añade los productos que vendes a Mis productos con Añadir productos. Esto hace falta para la API. Para los pedidos que escribes tú mismo es opcional: la cesta te deja elegir cualquier producto que vendamos.
2. Cuando recibas un pedido, abre Clientes, busca a tu comprador o añádelo.
3. En la página del cliente pulsa Crear orden, añade los productos y cantidades y paga.

Cambiar el nombre o cerrar el canal

Para renombrar el canal, pulsa Editar en la página del canal y cambia Store name.

Para cerrar un canal, ve a Canales y pulsa el botón de cerrar en la columna Acción (texto emergente Canal cerrado). La ventana pregunta ¿Estás seguro de que quieres cerrar este canal? y avisa Esta operación es irreversible. Un canal cerrado desaparece del menú. Tus pedidos y facturas pasados se conservan.

Conectar tu propio sistema con la API

La API deja que tu web o app haga por sí sola lo que haces en las páginas del canal: leer nuestro catálogo de productos con precios en vivo, añadir productos a Mis productos, crear y cambiar clientes, crear pedidos, añadirles productos, enviarlos y seguirlos. También puedes descargar tu lista de Mis productos como un feed CSV o JSON para cargar productos en tu propia web.

Abre API bajo tu canal. La página tiene estas pestañas:

• Overview: cómo conectar, la dirección base de la API y el botón API documentation. La documentación lista cada endpoint con ejemplos.
• API tokens: los tokens de este canal.
• API calls: las peticiones que hizo tu sistema.
• Historia: cambios hechos en tu cuenta.

Obtener un token

1. Pulsa Generate API token.
2. Si el token es solo para leer datos, marca Read only (cannot create, change or submit orders).
3. Pulsa Click to Generate.
4. Copia el token con el icono de copiar y guárdalo bien. La ventana dice Put this token in a safe place, you won't be able to see it again. La etiqueta corta en la lista de tokens es solo un nombre, no el token.

Envía el token en cada petición en la cabecera Authorization: Bearer seguida de tu token. Cada token pertenece a un canal: los productos, clientes y pedidos que crea tu sistema van a ese canal. Para que un token deje de funcionar, bórralo en la pestaña API tokens.

Probar primero en staging

La pestaña Overview también tiene Open staging mirror. Staging es una copia aparte del sitio donde puedes probar sin pedidos ni pagos reales. Inicia sesión con el mismo correo y contraseña. Staging se restablece regularmente con una copia nueva, lo que borra lo que hayas creado ahí. Los tokens del sitio real no funcionan en staging: genera un token aparte en staging, y uno nuevo tras cada reinicio. La dirección base de staging se muestra en la pestaña Overview.

Cómo se pagan los pedidos de la API

Cuando tu sistema envía un pedido, lo pagamos primero de tu saldo de cuenta, luego de tus tarjetas guardadas. Añade una tarjeta antes de empezar. En cuanto tienes un token, el menú muestra Tarjetas guardadas. Mientras no haya ninguna tarjeta guardada, la página API muestra Aún no tienes tarjetas guardadas con un botón Añadir tarjeta.

Si ni tu saldo ni tus tarjetas cubren el pedido, el pedido se marca No pagado y no pasa al almacén. Añade dinero a tu saldo con Recargar Saldo, abre el pedido y pulsa Pay … with balance. El botón aparece cuando tu saldo cubre la cantidad debida.

Cuando algo va mal

• El nombre ya está en uso cuando creo el canal. Otro de tus canales abiertos tiene ese nombre. Escribe un nombre distinto. El nombre de un canal cerrado se puede volver a usar.
• Mis pedidos no llegan por sí solos. Un canal Manual/API nunca recoge pedidos de una web. Créalos en la página del cliente, o envíalos desde tu sistema a través de la API. Si vendes en una plataforma de las que aparecen en la página Agregar canal de ventas, conecta esa plataforma como su propio canal.
• Mis productos no están en mi web. No subimos nada desde un canal Manual/API. Cárgalos tú mismo en tu web, con la descarga CSV de Mis productos o a través de la API.
• Perdí mi token de API. No se puede volver a mostrar. Genera un token nuevo, ponlo en tu sistema y borra el antiguo.
• La API responde que no puedo crear ni cambiar pedidos. El token es solo de lectura. Genera un token sin marcar Read only.
• La API rechaza mis peticiones durante un rato. Cada token puede hacer hasta 120 peticiones por minuto. Ralentiza tu sistema e inténtalo de nuevo pasado un minuto.
• La API dice "This order has no products yet". Añade al menos un producto al pedido antes de enviarlo.
• La API dice "Unable to find related portfolio item". A través de la API añades un producto a un pedido por su artículo de Mis productos, no por el producto en sí. Añade primero el producto a Mis productos y usa el id de ese artículo.
• La API dice que ya existe otra transacción con el mismo producto. El producto ya está en el pedido. Cambia la cantidad de esa línea en lugar de añadirlo de nuevo.
• La API dice que el pedido "is already in the 'submitted' state and cannot be updated". Los pedidos enviados no se pueden cambiar ni borrar a través de la API. Contáctanos si el pedido debe cambiar.
• Mi pedido de la API aparece como Unpaid. Tu saldo y tus tarjetas guardadas no lo cubrieron. Recarga tu saldo, abre el pedido y pulsa Pay … with balance, y comprueba que tu tarjeta guardada sigue siendo válida.