API de integracionesCuota App
Integración de
dispositivos iOS
Guía de capacidades para que un comercio gestione remotamente su flota de iPhones — enrolamiento, bloqueo remoto, restricciones y más — usando su propia API key.
Tu flota de iPhones, desde tu propio sistema
Cuota App administra los iPhones enrolados de un comercio con un sistema de gestión remota propio del ecosistema Apple. Esta integración expone esas capacidades por API, para que un comercio con su propio sistema de cobranza o CRM pueda ejecutar los mismos comandos que el panel administrativo, sin depender de él.
El flujo de un iPhone es distinto al de un Android: en vez de un bloqueo de pantalla genérico, el equipo entra en un estado de bloqueo remoto con mensaje de contacto en pantalla y rastreo de ubicación; y el enrolamiento queda completo de forma automática al vincular el equipo, sin instalar ningún cliente adicional. Cada acción de esta guía respeta ese flujo nativo.
Los comandos de esta guía son específicos de iPhones y no son intercambiables con los de Android: cada plataforma tiene su propio set de acciones, reflejando cómo cada fabricante gestiona sus equipos.
Todo id de dispositivo (id) acepta indistintamente el identificador numérico o el IMEI/serial registrado.
Qué se puede hacer con un iPhone registrado
La tabla siguiente resume cada capacidad disponible, en el orden natural del ciclo de vida del equipo: primero el alta y enrolamiento, después la operación diaria (bloqueo, restricciones, ubicación) y por último la baja. Todas se ejecutan como llamadas HTTP simples, autenticadas con la API key del comercio.
| Capacidad | Qué permite hacer |
|---|---|
| Listar y consultar dispositivos | Ver todos los iPhones registrados del comercio, con su estado y datos completos del equipo. Mismo endpoint que Android. |
| Registrar iPhone por número de serie | Dar de alta el equipo a partir de su número de serie. Si ya está preconfigurado para enrolamiento automático, la vinculación se completa sola. |
| Activar bloqueo remoto | Bloquear el iPhone remotamente: muestra un mensaje y teléfono de contacto en la pantalla de bloqueo y habilita el rastreo de ubicación. Equivalente iOS del bloqueo por mora. |
| Solicitar ubicación | Pedir la ubicación del equipo mientras está bloqueado remotamente. |
| Desactivar bloqueo remoto | Revertir el bloqueo y devolver el equipo a uso normal. |
| Quitar código del iPhone | Remover el código de acceso de la pantalla de bloqueo, para que el cliente pueda volver a acceder al equipo. |
| Cambiar nombre del iPhone | Renombrar el dispositivo administrado — el nuevo nombre queda visible en Ajustes del equipo. |
| Ver y actualizar restricciones | Consultar y modificar las restricciones activas del equipo: bloqueo de restablecer de fábrica, emparejamiento con computadoras, bloqueo de activación del comercio, entre otras. |
| Desvincular iPhone | Sacar el equipo de la gestión remota del comercio, por ejemplo cuando el cliente terminó de pagar. Equivalente iOS de desprovisionar. |
| Borrar iPhone remotamente | Borrar todo el contenido y ajustes del equipo. Irreversible — pensado para baja definitiva o equipo perdido sin recuperación posible. |
Todas estas acciones quedan acotadas a los dispositivos iOS del propio comercio y se ejecutan mediante llamadas simples a la API con su API key, sin necesidad de acceso al panel administrativo. Los comandos que modifican el equipo exigen además un header Idempotency-Key: un reintento con la misma clave nunca vuelve a ejecutar el comando dos veces.