Grupos de totems
Un grupo de totems (totem_group) es el conjunto de puntos de acceso físico — básculas, barreras, pantallas — que gestionan las entradas y salidas de una instalación concreta. Es el "dónde" de cada autorización: toda autorización está vinculada a exactamente un grupo de totems.
Qué es un totem
Un totem es un dispositivo físico instalado en la entrada o salida de una instalación (almacén, cooperativa, silo, puerto…). Cuando un conductor llega, interactúa con el totem para identificarse y registrar la operación. El totem valida en tiempo real si existe una autorización activa para ese transportista y produce la operación correspondiente.
Qué es un grupo de totems
Una instalación puede tener varios totems (p. ej., varias básculas o carriles de acceso). Un grupo de totems agrupa todos los puntos de acceso de una misma instalación bajo un único identificador — el totemGroupId. Cuando creas una autorización para ese grupo, el conductor puede operarla en cualquier totem del grupo.
Cada grupo pertenece a una sola empresa logística (logistics_company_id). No puedes acceder a grupos de otras empresas logísticas con tu API Key.
Cómo obtener el totemGroupId
Usa el endpoint de listado para obtener los grupos disponibles para tu empresa logística:
GET /partner/totem-groups
X-Partner-API-Key: dpk_live_...
La respuesta incluye el id (UUID) de cada grupo y su nombre descriptivo. Guarda esos UUIDs en tu sistema — son los que pasarás como totemGroupId al crear autorizaciones.
También puedes consultar un grupo concreto por su UUID:
GET /partner/totem-groups/{id}
X-Partner-API-Key: dpk_live_...
Campos del TotemGroupDto
| Campo | Tipo | Descripción |
|---|---|---|
id | uuid | Identificador único del grupo. Úsalo como totemGroupId en las autorizaciones. |
name | string | Nombre descriptivo de la instalación (p. ej. "Almacén Sevilla Norte"). |
logisticsCompanyId | uuid | Empresa logística propietaria del grupo. |
createdAt | datetime | Fecha de creación (ISO 8601). |
updatedAt | datetime | Fecha de última actualización (ISO 8601). |
Uso en el flujo de integración
El totemGroupId es un campo obligatorio al crear una autorización. El flujo recomendado para tu integración ERP es:
- Al configurar la integración (una sola vez), llama a
GET /partner/totem-groupsy mapea cada grupo al almacén o instalación correspondiente en tu ERP. - Almacena la correspondencia
instalación ERP → totemGroupIden tu configuración. - Al crear cada autorización, usa el
totemGroupIdque corresponda a la instalación de la operación.
Los grupos de totems cambian raramente — se crean cuando DigiAnt instala nuevos equipos en una instalación. No necesitas consultarlos en cada push; basta con sincronizarlos periódicamente o cuando la instalación confirme un cambio.
Aislamiento por empresa logística
La API filtra automáticamente por tu empresa logística: solo verás los grupos que te pertenecen. No es posible listar ni usar grupos de otras empresas logísticas, aunque conozcas su UUID.
Si intentas crear una autorización con un totemGroupId que no pertenece a tu empresa logística, recibirás un error 422.
Ver también Entidades clave y La autorización.