Menú: Documentación

Pay at table

Sincronizar salas y mesas

Cómo enviar a honei las salas y mesas de tu local para que pueda cobrarlas desde el terminal.

Antes de que honei pueda cobrar una mesa, necesitamos saber qué salas y mesas tiene tu local. Usa este endpoint para enviárnoslas. Puedes llamarlo siempre que añadas, renombres o reorganices salas y mesas, y repetirlo sin problema: es una sincronización, no una importación puntual.

El integrationTableId que envías aquí es el mismo tableId que usarás después en el flujo de Pay at table (GET {yourApiURL}/tab?tableId=...), así que asegúrate de que coincide con el identificador de la mesa en tu TPV.

Flujo de integración

Envía salas y mesas12Crea o actualiza por identificadorOk3TPVhonei

Puedes enviar un único objeto de sala o una lista de salas.

POSTSincronizar salas y mesas/roomsAPI reference

Cómo funciona la sincronización

  • Las salas se identifican por integrationRoomId. Si ya tenemos una sala con ese identificador en tu local, la actualizamos. Si no, la creamos.
  • Dentro de una sala, cada mesa se identifica por integrationTableId. Una mesa existente se actualiza y un integrationTableId nuevo se añade.
  • Las mesas que no incluyas en una llamada no se tocan: este endpoint nunca borra mesas, así que puedes reenviar solo lo que ha cambiado o toda tu lista de salas y mesas en cada sincronización.

Por ejemplo, si reenvías una sala con una mesa nueva y otra existente:

integrationTableIdconocidoMesa existenteActualizaMesaCon los datos nuevosintegrationTableId nuevoMesa que no teníamosAñadeMesa nuevaDentro de la salaNo incluidoMesa que no envíasNo se tocaMesaSe queda como estaba