Reglas y límites

Todo lo que aparece en esta página se ha verificado de principio a fin en canales reales. Cuando se incumple una regla, la API responde 422 validation_failed (o el código indicado) con un mensaje que nombra el campo. No se cambia nada sin avisar.

Productos y variantes

• Un SKU por variante. El stock, los pedidos y POST /inventory/batch asocian las variantes por SKU, así que dos variantes de un producto no pueden compartir uno (422, Two variants share the SKU …).
• Todas las combinaciones de opciones. Un producto con Talla S/M y Color Rojo/Azul tiene exactamente 4 variantes. Para añadir un color, añádelo en todas las tallas; para quitar una talla, quítala en todos los colores. Los canales construyen la cuadrícula completa, así que una combinación que falte aparecería allí como una variante fantasma.
• Como máximo 3 opciones y 100 variantes por producto.
• Los precios tienen como máximo 2 decimales; las cantidades son números enteros ≥ 0.
• Imágenes: un producto necesita al menos una imagen para publicarse (photo_required_for_channel). Hasta 20 por producto.
• Se rechaza eliminar un producto que todavía está en un canal (422 product_still_listed), también cuando su anuncio está en error pero sigue publicado allí. Retíralo primero (DELETE /listings/{id}).

Textos por canal

• PATCH /listings/{id} con overrides.title / overrides.description define el texto solo para ese canal; null vuelve al del producto.
• Los títulos más largos de lo que permite el canal se rechazan al momento: Shopify 255, Etsy 140, eBay 80 caracteres.
• Un producto en un solo canal: editar el título o la descripción del producto cambia también los de ese canal, pero solo el campo que has editado (una edición de la descripción mantiene un título definido para el canal).
• Un canal configurado como líder (sus ediciones llegan a Nembol) sobrescribe los textos del producto y los de todos los canales.
• Las descripciones son HTML y llegan a los canales como HTML.

Pedidos

• Un pedido por cada pedido del canal: un pedido con varias líneas vuelve como un solo pedido con todas las líneas en lines y el total completo; order.created se emite una vez por pedido.
• Los pedidos nuevos llegan en segundos por webhook cuando el canal los envía y, si no, en la siguiente consulta. Los cambios de estado hechos en el canal (cancelado, reembolsado, enviado por otra vía) llegan en menos de 10 minutos.
• source_status es el texto de estado propio del canal, tal como se leyó por última vez.

Envío (POST /orders/{id}/fulfillment)

• mark_shipped sin seguimiento actualiza solo Nembol: no se avisa al marketplace.
• Con un número de seguimiento, se avisa al marketplace una vez por pedido. Un seguimiento enviado más tarde (después de mark_shipped) se notifica en ese momento. Una vez que el marketplace tiene un seguimiento, un número distinto se guarda solo en Nembol y la respuesta indica channel_notification.error: channel_already_notified. Corrígelo en el propio marketplace.
• tracking.number ≤ 64, carrier ≤ 64, url ≤ 512 caracteres: si son más largos se rechazan, nunca se recortan.
• Un pedido cancelado o reembolsado no se puede marcar como enviado (order_not_fulfillable).

Conexiones de canales

• Un enlace de conexión funciona una sola vez y durante una hora.

• Amazon: params.country elige la región; params.marketplace debe ser un marketplace de esa región.

• Los canales OAuth (eBay, Etsy, Shopify, WooCommerce, TikTok Shop, Temu, Amazon, Google Merchant Center, Facebook Catalog, Square, Squarespace, Faire, Wix, Facebook, Pinterest, Tumblr) se conectan mediante un enlace.

• Kaufland, OnBuy, PrestaShop y Subito se conectan con credenciales en params (sin enlace).

• Publicar en eBay requiere las Business Policies: si la cuenta no está adherida, POST /channel_accounts/{id}/enable_business_policies (con confirmación).

• Una cuenta de canal nueva recibe la configuración predeterminada del canal al conectarse, igual a través de la API que en el panel.

Tiempos y límites

• Los límites de solicitudes y los Idempotency-Key son por tienda (por empresa para los partners). Consulta Límites de solicitudes.
• Un anuncio suele pasar a listed en segundos; los marketplaces que revisan los productos (Amazon, TikTok Shop) pueden tardar más.

Última actualización el 20 de octubre de 2026