Esta guía cubre los errores más frecuentes con la integración entre Shopify y Bsale, y cómo resolverlos sin esperar al equipo de soporte.
Cómo ver el motivo de un error
Cuando un pedido no emitió documento, el motivo aparece en el listado de documentos:
Si tienes más de una tienda, selecciona la tienda que corresponde al pedido.
Ve a Integraciones → Bsale → Documentos emitidos.
En la última columna verás los números de boleta o un mensaje de error en color rojo.
Para ver el detalle del error, presiona el botón “i” de información en esa última columna.
Aparece una ventana con la descripción exacta del problema.
A continuación, los errores más comunes y cómo resolverlos.
Error “No hay stock del producto”
Cuándo aparece: tu integración está configurada en modo Stock Control (“Activar consumos de stock en Bsale por concepto de ventas”) y al momento de emitir, el producto no tenía stock disponible en la sucursal Bsale correspondiente.
Qué hacer:
Recepciona el stock faltante en la sucursal de Bsale correspondiente.
Vuelve a Integraciones → Bsale → Documentos emitidos y presiona el botón de reintentar junto al pedido afectado.
Si el stock ya está en Bsale, el documento se emite y desaparece el error.
Si esto te pasa seguido, considera dejar la sincronización Amplifica → Bsale activa para que el stock se mantenga al día automáticamente. Ver ¿Cómo se sincroniza el stock?.
Error “Invalid variant” o producto no encontrado
Cuándo aparece: el producto del pedido no se encontró en Bsale.
Causa típica: el SKU del producto en Shopify no es idéntico al SKU del producto en Bsale.
Qué hacer:
Identifica el SKU del producto en el pedido de Shopify.
Busca el mismo producto en tu Bsale (Productos → ver detalle).
Asegúrate de que el SKU sea exactamente igual en ambos sistemas (mayúsculas, minúsculas, sin espacios, sin tildes adicionales).
Si los SKUs no coinciden, corrige uno de los dos para que sean idénticos.
En Integraciones → Bsale → Sincronización de stock presiona Descubrir productos para que se cree el vínculo.
Vuelve a Integraciones → Bsale → Documentos emitidos y presiona reintentar.
Si tienes el producto con SKUs ligeramente distintos por casing o tildes, al correr “Descubrir productos” puedes activar las opciones “ignorar mayúsculas/minúsculas” y “ignorar tildes”. Ver ¿Cómo se vinculan mis productos con Bsale?.
Sobre el producto “Despacho” (SKU-DESPACHO)
Al activar la integración, Amplifica crea automáticamente en tu cuenta Bsale un producto especial llamado “Despacho” con SKU SKU-DESPACHO. Este producto representa el cargo por envío que el cliente paga en Shopify y aparece como una línea en cada boleta o factura.
Configuración importante
Para que la emisión funcione correctamente, el producto Despacho debe tener:
SKU exacto:
SKU-DESPACHO(no lo cambies).Opción “Controlar stock”: DESACTIVADA (porque el envío no es un bien físico que se descuente de inventario).
¿Qué pasa si modifico esta configuración?
Si activas accidentalmente “Controlar stock” en el producto Despacho, bloqueas la emisión automática porque el sistema va a intentar descontar stock de un producto que no tiene unidades.
Cómo arreglarlo:
Ve al producto Despacho en tu Bsale.
Desactiva la opción “Controlar stock”.
Verifica que el SKU siga siendo
SKU-DESPACHO.Vuelve a Integraciones → Bsale → Documentos emitidos y reintenta los pedidos fallidos.
“Mi pedido tenía RUT pero salió como boleta”
Causa probable: el sistema no recibió los datos completos de facturación.
Para que salga factura, el pedido debe traer RUT, razón social, dirección y ciudad completos. Si falta alguno, sale boleta.
Qué hacer:
Revisa el detalle del pedido y confirma que todos los datos están.
Si están todos, usa la opción Reemitir — verás el botón con un mensaje de diagnóstico.
“El stock entre Amplifica y Bsale no coincide”
Causa probable: algún producto no está vinculado, o hubo un ajuste manual en uno de los dos sistemas.
Qué hacer:
Revisa que los productos del pedido estén vinculados.
Si están vinculados y aun así hay diferencia, ve a Integraciones → Bsale → Sincronización de stock y presiona Forzar sincronización ahora para reconciliar.
“Una nota de crédito apareció como fallida”
Qué hacer:
Revisa el motivo del error en el detalle del documento.
Contáctanos. Podemos emitirla manualmente desde Bsale, o reintentarla desde nuestro lado según el caso.
“Veo una nota de venta que no se convirtió en boleta”
Si el pedido tenía nota de venta y el pago ya se confirmó, la conversión debe haber ocurrido. Si no aparece la boleta o factura:
Verifica el estado del pago del pedido (que efectivamente esté pagado en el canal de origen).
Si está pagado y la NV sigue sin convertir, contáctanos.
“Mi cliente reclama que no recibió la boleta/factura”
Lo más probable:
El documento se emitió pero no se envió correctamente al cliente. Cada canal (Shopify, MercadoLibre, etc.) tiene su propia forma de mostrar el documento al comprador.
Para Shopify, el sistema agrega el link al PDF en las notas del pedido.
Qué hacer:
Ve a Integraciones → Bsale → Documentos emitidos y confirma que el documento está emitido (color verde).
Descarga el PDF desde el botón Ver en Bsale en el detalle del documento.
Reenvía el PDF a tu cliente directamente, o avísanos para revisar por qué no llegó.
“Veo errores en el monitor de actividad y no entiendo qué pasa”
Revisa el detalle en Integraciones → Bsale → Monitor de actividad.
Algunos errores son temporales (rate limit de Bsale, problemas de red puntuales) y se resuelven solos con los reintentos automáticos.
Si ves errores que persisten o no entiendes el mensaje:
Toma nota del mensaje exacto del error.
Identifica el pedido afectado.
Contáctanos con esos datos.
¿No encuentras tu problema?
Contáctanos por el chat de soporte o con tu Customer Success Manager con:
Tu nombre de empresa.
El número del pedido afectado.
La fecha y hora aproximada del problema.
Una captura o el mensaje de error si lo tienes.