¿Necesitas ayuda para usar la integración de Heartland? En este artículo encontrarás soluciones a los errores y problemas más comunes.
Error o problema | Solución |
InvalidProduct: Invalid PLU. | Uno o más artículos del pedido tienen un PLU que no pertenece al TPV (POS) de este local. Sincroniza tus productos y publica tu menú de nuevo, asegurándote de que cada artículo existe para este local. |
X is a variant, but the order does not contain a variation sub item. | A la variante le faltan sus subartículos. Comprueba la configuración de la variante y confirma que no todas sus variaciones estén en pausa. |
Unsuccessful API response - “Internal server error”. | Esto suele indicar una interrupción del servicio de Heartland. Contacta directamente con el soporte de Heartland para conocer una actualización o el plazo estimado de solución, ya que esto depende de ellos. |
POS is not reachable: HEARTLAND BAD_GATEWAY / reachable but slow to respond. | Se trata de un problema de conectividad con el servicio en la nube de Heartland. Contacta con el soporte de Heartland para comprobar tu conectividad. |
Invalid order while parsing: Missing House Account ID in the order payload. | La configuración de tu forma de pago y del destino del pedido no está completa. Contacta con nuestro equipo de soporte para que corrijan estos ajustes en la configuración de tu canal. |
Unsuccessful API response - “Some items in your cart are no longer available and have been removed”. | Uno o más artículos pedidos no superan las comprobaciones de disponibilidad de Heartland. Confirma que cada artículo esté asignado a un grupo de menú, que no esté marcado como agotado y que tenga activado «Available Online» a nivel de artículo, sección y grupo de menú. Si todo es correcto, contacta con el soporte de Heartland. |
Order contains out of stock items: “Some of the items in your cart are out of stock”. | Pausa el artículo agotado en Deliverect para que se elimine de tus tiendas en línea. También puedes activar el ajuste de local «Snooze product if out of stock» para que esto se haga automáticamente. |
Deliverect total does not match Heartland total. | El total del pedido calculado por Deliverect no coincide con el total devuelto por el TPV (POS). Contacta con nuestro equipo de soporte para investigar la discrepancia de precio. |
“Your selected order type is no longer available”. | El tipo de pedido no está programado para estar disponible en el momento en que se realizó el pedido. Asegúrate de que todos los tipos de pedido que ofreces en línea estén disponibles durante todo el horario en que deseas recibir pedidos. |
Unsuccessful API response - “Invalid discount_id”. | El Discount ID no está configurado en los ajustes de tu canal. Contacta con nuestro equipo de soporte para que configuren el Discount ID correcto. |
Unsuccessful API response - “Unknown items[X] id: PLU”. | El artículo no se ha habilitado para pedidos en línea en Heartland. Edita el artículo y activa «Allows this item to be seen by customers online», comprobando las excepciones por local si es necesario. |
Unsuccessful API response - “Delivery is not enabled for this location”. | Activa la entrega a domicilio para el local directamente en los ajustes de tu TPV (POS) de Heartland. |
Unsuccessful API response - “BadRequest” / “Found errors in json: BadRequest”. | Un artículo no está correctamente asignado a una Report Category, Section y Group en el TPV (POS). Reconfigura el artículo bajo la categoría y sección correctas y vuelve a sincronizar. |
Found errors in json: Missing required ingredient for X. | No se seleccionó un modificador, tamaño o componente de combo obligatorio. Comprueba que tu menú de Deliverect coincida con los ajustes Min/Max/Multimax del TPV (POS) para el grupo de modificadores indicado en el error. |
Found errors in json: The order time is not within valid operating hours for the given location. | Compara el horario de apertura de tu TPV (POS) con el configurado en Deliverect y ajústalos. Esto también puede ocurrir si el «Lead Time» de tu TPV redondea la hora de recogida de un pedido más allá del cierre; prueba a eliminar el Lead Time, ampliar el horario de cierre del TPV o reducir el horario de apertura en Deliverect. |
“We have no connection to the restaurant at this time. If the issue persists, please contact the restaurant”. | No se ha designado ninguna caja/tableta para aceptar pedidos en línea, o la tableta está desconectada, en reposo, o la aplicación de Heartland no está en primer plano. Asigna un iPad en los ajustes de tu TPV y asegúrate de que permanezca conectado y de que la aplicación se mantenga abierta. |
Found errors in json: Room of type “table_layout” are not permitted. | El destino del pedido (Order Destination) no está configurado correctamente en el enlace del canal. Contacta con nuestro equipo de soporte para corregir este ajuste. |
Found errors in json: Delivery address could not be found. | Heartland requiere una dirección postal para los pedidos de tipo entrega a domicilio, y los pedidos entregados por terceros no incluyen una. Activa el ajuste de canal «Order with delivery by channel is pickup» para que estos pedidos se envíen a Heartland como recogida en local. |
Found errors in json: Unknown size / Unknown modifier_id / Unknown ingredient_id. | El artículo, modificador o ingrediente ya no existe en tu TPV (POS). Sincroniza tus productos y publica tu menú de nuevo para alinear todo con tu TPV (POS). |