Imprime en tu ticketera
desde cualquier web o app

API

Todo en JSON, con Content-Type: application/json. Sin clave: solo responde dentro de tu red local.

Elegir la impresora

Campo "printer" con el id o el nombre que devuelve /printers. Si no lo mandas, se usa la predeterminada.

Opción 1 · Ticket con formato (recomendada)

Una lista de commands que se ejecutan en orden:

POST http://192.168.1.50:8080/print

{
  "printer": "1792025459847",
  "commands": [
    "ALIGN:center", "SIZE:2", "BOLD:ON", "TEXT:MI NEGOCIO", "BOLD:OFF", "SIZE:1",
    "TEXT:Ticket #123  -  14/10/2026", "NEWLINE",
    "ALIGN:left",
    "TEXT:2 x Producto A           10.00",
    "TEXT:1 x Producto B            5.50",
    "TEXT:--------------------------------",
    "ALIGN:right",
    "TEXT:Subtotal: 13.14",
    "TEXT:Impuesto:  2.36",
    "BOLD:ON", "TEXT:TOTAL: 15.50", "BOLD:OFF",
    "FEED", "CUT"
  ]
}

En 80 mm caben unos 48 caracteres por línea con letra normal (32 en 58 mm). Para columnas, rellena con espacios.

Opción 2 · Texto simple

{ "text": "Línea 1\nLínea 2\nTOTAL 15.50" }

Imprime el texto tal cual y corta.

Opción 3 · Tus propios bytes ESC/POS

{ "base64": "G0AbYQFIb2xhCh1WQQA=" }

Se envían sin tocar a la impresora: logos, códigos de barras, QR o lo que tu impresora soporte.

Respuesta

{ "success": true, "message": "Print job completed successfully", "printer": "Caja 1", "timestamp": 1792025459847 }

Ejemplo en JavaScript (sirve en Bubble con un plugin o "Run javascript")

fetch('http://192.168.1.50:8080/print', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    commands: ['ALIGN:center', 'BOLD:ON', 'TEXT:MI NEGOCIO', 'BOLD:OFF',
               'ALIGN:left', 'TEXT:1 x Cafe            3.00', 'FEED', 'CUT']
  })
}).then(r => r.json()).then(r => console.log(r.success ? 'Impreso' : r.message));

Bueno saber

• •Autoriza tu página (versión 1.1.3 o más nueva): por seguridad, la app solo acepta pedidos de navegador de los sistemas Astos y de tu red. Si tu sistema web está en internet (por ejemplo miapp.bubbleapps.io), agrégalo en la app: Menú → Páginas autorizadas. Si lo olvidas, la respuesta es 403 con el mensaje "Origen no permitido" y la app te ofrece autorizarla con un toque.
• •Sin encabezados especiales: CORS listo; solo Content-Type: application/json. Los pedidos desde otro equipo de tu red (PHP, Python, Node) no necesitan autorización.
• •Páginas https: algunos navegadores bloquean pedidos de una web https:// a http://192.168… ("contenido mixto"). Si /test-print te funciona desde tu sistema, /print también.
• •Tildes y ñ: el texto se manda en UTF-8. Si tu impresora las muestra raras, quítalas o usa la opción 3 con su página de códigos.
• •IP fija: reserva la IP de la tablet en tu router para que la dirección no cambie.
• •Deja la app abierta (o con el servidor activo) en la tablet mientras vendes.