Centro de desarrolladores / fundamentos

Integración Android y SDK para POS SUNMI

Biblioteca técnica pública para impresoras, escáneres, periféricos, Android, kiosco, MDM y compatibilidad.

Habla de tu proyecto

Centro de desarrolladores / fundamentos

Desarrolla con los datos del dispositivo a la vista.

Consulta guías prácticas sobre impresoras, escáneres, cajones, kioscos, MDM y compatibilidad.

Base de la fuenteFuentes públicas de SUNMI y Android

Referencias públicas27

Documentación oficial de SUNMIAbrir referencia

Centro de desarrolladores / fundamentos

Desarrolla con los datos del dispositivo a la vista.

Consulta guías prácticas sobre impresoras, escáneres, cajones, kioscos, MDM y compatibilidad.

Estado de evidencia: Hasta registrar estos datos, la guía es una nota pública de implementación, no una garantía de compatibilidad.

Kotlin / printer.kt

// Confirm the target model and printer service first
val receipt = "ORDER #1042\nTOTAL  CNY 128.00\n"
sunmiPrinter.printText(receipt)
sunmiPrinter.lineWrap(3)

Estado de evidenciaBase de la fuente

Pasos, repeticiones y resultados brutos y resumidos
Estado de evidencia: Hasta registrar estos datos, la guía es una nota pública de implementación, no una garantía de compatibilidad.
El software sigue el flujo: puede ser tuyo, de una plataforma de terceros cualificada o de una aplicación Android definida con nuestro equipo. Conectamos el flujo con el dispositivo y mantenemos explícitas las responsabilidades de integración, aceptación y soporte.

Superficie de API: Qué cubre la primera revisiónAbrir referencia Documentación oficial de SUNMI

Kotlin / scanner.kt

val intent = Intent("com.sunmi.scanner.ACTION_DATA_CODE_RECEIVED")
intent.putExtra("data", "6921734901042")
registerReceiver(scannerReceiver, intentFilter)

Estado de evidenciaBase de la fuente

Fecha, revisor, entorno y versión de aplicación
Estado de evidencia: Hasta registrar estos datos, la guía es una nota pública de implementación, no una garantía de compatibilidad.
El software sigue el flujo: puede ser tuyo, de una plataforma de terceros cualificada o de una aplicación Android definida con nuestro equipo. Conectamos el flujo con el dispositivo y mantenemos explícitas las responsabilidades de integración, aceptación y soporte.

Superficie de API: Qué cubre la primera revisiónAbrir referencia Documentación oficial de SUNMI

Kotlin / drawer.kt

// Use only after the base and drawer are confirmed
val openSignal = byteArrayOf(0x10, 0x14, 0x00, 0x00, 0x00)
sunmiPrinter.sendRAWData(openSignal)
operatorUi.showDrawerCommandSent()

Estado de evidenciaBase de la fuente

Permisos, errores y limitaciones conocidas
Estado de evidencia: Hasta registrar estos datos, la guía es una nota pública de implementación, no una garantía de compatibilidad.
El software sigue el flujo: puede ser tuyo, de una plataforma de terceros cualificada o de una aplicación Android definida con nuestro equipo. Conectamos el flujo con el dispositivo y mantenemos explícitas las responsabilidades de integración, aceptación y soporte.

Superficie de API: Qué cubre la primera revisiónAbrir referencia Documentación oficial de SUNMI

Estado de evidencia: Hasta registrar estos datos, la guía es una nota pública de implementación, no una garantía de compatibilidad.

01 / Artículo técnico

Integración de impresora Android

Esta guía explica la ruta de implementación para la impresión de recibos y etiquetas. Usa LineApi para texto, columnas, códigos de barras y QR; reserva CommandApi para ESC/POS o TSPL, consulta QueryApi y valida el ancho de papel, la reimpresión y la versión del servicio. Esta nota técnica es un punto de partida estructurado. Confirma modelo, Android, firmware, SDK, versión y accesorios antes de tratarla como un resultado de despliegue.

Alcance del modelo: SUNMI / V2s / V2s PLUS / Android 11. Usa LineApi para texto, columnas, códigos de barras y QR; reserva CommandApi para ESC/POS o TSPL, consulta QueryApi y valida el ancho de papel, la reimpresión y la versión del servicio.

Documentación oficial de SUNMI9 Referencias públicasv1.0.0Publicado

Más información 02 / Artículo técnico

Integración de scanner con Intent y SDK

Esta guía explica la ruta de implementación para la entrada de códigos de barras. Elige Intent, el SDK de cámara o el cabezal de escaneo; valida la codificación, los eventos duplicados y la disponibilidad de com.sunmi.scanner en el dispositivo exacto. Esta nota técnica es un punto de partida estructurado. Confirma modelo, Android, firmware, SDK, versión y accesorios antes de tratarla como un resultado de despliegue.

Alcance del modelo: V2s / V2s PLUS / L2s PRO / SUNMI / Android 11. Elige Intent, el SDK de cámara o el cabezal de escaneo; valida la codificación, los eventos duplicados y la disponibilidad de com.sunmi.scanner en el dispositivo exacto.

Documentación oficial de SUNMI6 Referencias públicasv1.0.0Publicado

Más información 03 / Artículo técnico

Cajón de dinero y display de cliente

Esta guía explica la ruta de implementación para el cajón de efectivo y la pantalla del cliente. Controla el cajón mediante IWoyouService o ESC/POS y crea la pantalla secundaria con DisplayManager y Presentation; prueba conexión, desconexión y recuperación. Esta nota técnica es un punto de partida estructurado. Confirma modelo, Android, firmware, SDK, versión y accesorios antes de tratarla como un resultado de despliegue.

Alcance del modelo: SUNMI / T1. Controla el cajón mediante IWoyouService o ESC/POS y crea la pantalla secundaria con DisplayManager y Presentation; prueba conexión, desconexión y recuperación.

Documentación oficial de SUNMI7 Referencias públicasv1.0.0Publicado

Más información 04 / Artículo técnico

Checklist de kiosco y MDM

Esta guía explica la ruta de implementación para el bloqueo de quiosco y el aprovisionamiento MDM. Registra la inscripción MDM, la política de paquete, lock task y la ruta de salida administrativa; prueba actualización, pérdida de red, bloqueo y recuperación. Esta nota técnica es un punto de partida estructurado. Confirma modelo, Android, firmware, SDK, versión y accesorios antes de tratarla como un resultado de despliegue.

Alcance del modelo: K2 / SUNMI / MDM / Android 7.1 / V2s / V2s PLUS / Android 11 / L2s PRO / Android 12. Registra la inscripción MDM, la política de paquete, lock task y la ruta de salida administrativa; prueba actualización, pérdida de red, bloqueo y recuperación.

Documentación oficial de SUNMI9 Referencias públicasv1.0.0Publicado

Más información 05 / Artículo

Checklist de migración de POS

Esta guía explica la ruta de implementación para la migración de un POS o ERP existente. Mapea pedidos, pagos, inventario, cola sin conexión y rollback entre la aplicación existente y las interfaces SUNMI; conserva cada límite como evidencia separada. Esta nota técnica es un punto de partida estructurado. Confirma modelo, Android, firmware, SDK, versión y accesorios antes de tratarla como un resultado de despliegue.

Alcance del modelo: SUNMI / SDK / K2. Mapea pedidos, pagos, inventario, cola sin conexión y rollback entre la aplicación existente y las interfaces SUNMI; conserva cada límite como evidencia separada.

Síntesis seleccionada de fuentes oficiales7 Referencias públicasv1.0.0Publicado

Más información 06 / Artículo técnico

Notas de Flutter y React Native

Esta guía explica la ruta de implementación para un puente nativo para Flutter o React Native. Mantén un puente Android nativo pequeño mediante method channel o módulo nativo; controla el ciclo de vida y expón estados tipados para impresión, escaneo y pantalla. Esta nota técnica es un punto de partida estructurado. Confirma modelo, Android, firmware, SDK, versión y accesorios antes de tratarla como un resultado de despliegue.

Alcance del modelo: SUNMI / SDK. Mantén un puente Android nativo pequeño mediante method channel o módulo nativo; controla el ciclo de vida y expón estados tipados para impresión, escaneo y pantalla.

Síntesis seleccionada de fuentes oficiales7 Referencias públicasv1.0.0Publicado

Más información 07 / Artículo técnico

Matriz de compatibilidad multi-dispositivo

Esta guía explica la ruta de implementación para la compatibilidad entre varios modelos SUNMI. Usa una fila por modelo, Android, firmware, accesorio e interfaz; registra método, resultado y estado de evidencia en la matriz, sin inferir compatibilidad por familia. Esta nota técnica es un punto de partida estructurado. Confirma modelo, Android, firmware, SDK, versión y accesorios antes de tratarla como un resultado de despliegue.

Alcance del modelo: V2s / V2s PLUS / P3 / L2s PRO / K2 / Android 11 / Android 12 / V3 / V3 MIX / Android 13 / L3 / Android 14. Usa una fila por modelo, Android, firmware, accesorio e interfaz; registra método, resultado y estado de evidencia en la matriz, sin inferir compatibilidad por familia.

Síntesis seleccionada de fuentes oficiales6 Referencias públicasv1.0.0Publicado

Más información 08 / Artículo

Puesta en escena y entrega

Esta guía explica la ruta de implementación para la preparación y entrega del despliegue. Congela lote, hash del paquete, política MDM, red, proceso de reemplazo y responsable de aceptación; entrega excepciones y rollback junto con la documentación de cierre. Esta nota técnica es un punto de partida estructurado. Confirma modelo, Android, firmware, SDK, versión y accesorios antes de tratarla como un resultado de despliegue.

Alcance del modelo: TMS / MDM / SUNMI. Congela lote, hash del paquete, política MDM, red, proceso de reemplazo y responsable de aceptación; entrega excepciones y rollback junto con la documentación de cierre.

Síntesis seleccionada de fuentes oficiales9 Referencias públicasv1.0.0Publicado

Más información