Guía de usuario

Una breve guía para usar Billero.

Inicio rápido

• Rellena Mis datos (IBAN, dirección, número fiscal …).
• Añade clientes (empresas o particulares).
• Crea una nueva factura (simple o con varios artículos).
• Puedes compartir o guardar el PDF. Al editar una factura se regenera el PDF.

Factura con varios artículos

• Cada artículo tiene una descripción, cantidad, unidad, precio y tipo de IVA.
• En pantallas más pequeñas, los campos se reorganizan automáticamente en dos filas para mejorar la legibilidad.

Enviar facturas a un cliente

Desde la ficha de detalle de un cliente puedes seleccionar y enviar rápidamente varias facturas a la vez.

• Abre la pestaña Clientes y toca un cliente.
• Mantén pulsada una factura → entra en modo de selección.
• Toca facturas adicionales para seleccionarlas o deseleccionarlas.
• En la barra de título toca ↗ para compartir los PDF seleccionados.
• Para salir del modo de selección toca ✕ en la barra de título.

Funciona igual para empresas y particulares (incluido el cliente Desconocido).

Facturas recibidas con OCR por IA

Billero puede leer automáticamente el proveedor, el número, la fecha y el importe de una factura en PDF usando IA (Anthropic Claude). La función es opcional y requiere tu propia clave de API.

Obtener una clave de API

1. Ve a console.anthropic.com y crea una cuenta gratuita.
2. En el menú selecciona API Keys → Create Key.
3. Asigna un nombre a la clave (p. ej. Billero) y cópiala. La clave empieza por sk-ant-.
4. Debes añadir un método de pago en la consola de Anthropic. Leer una factura cuesta menos de 0,001 € (modelo Claude Haiku).

Configuración en la aplicación

1. Abre Mis datos (pestaña ⚙) → sección Clave de API de Anthropic (OCR).
2. Pega la clave en el campo y toca Guardar.
3. La clave se almacena en el área segura de tu dispositivo (Android Keystore); nunca se escribe en archivos de la aplicación.

Uso

1. En la pestaña Facturas toca el icono ↑ (importar PDF) y selecciona el PDF de una factura recibida.
2. Se abre un formulario. Toca el botón ✨ Analizar con IA.
3. Espera un momento: los campos de proveedor, número, fecha e importe se rellenan automáticamente.
4. Revísalos y corrígelos si es necesario, luego toca Guardar.

Sin una clave de API el formulario funciona como antes: rellena todos los campos manualmente. El botón de IA no aparecerá.

Copia de seguridad y restauración

Todos tus datos (facturas, clientes, ajustes y PDF) pueden exportarse y restaurarse desde la pestaña Mis datos → sección Copia de seguridad.

Exportar

• Toca Exportar copia de seguridad.
• La aplicación crea un archivo ZIP (billero_backup_YYYY-MM-DD.zip) y abre la hoja de compartir.
• Guarda el archivo en iCloud, Google Drive, correo electrónico o donde prefieras.

Restaurar (p. ej. tras cambiar de teléfono)

• Instala Billero en el nuevo teléfono.
• Abre Mis datos → Restaurar desde copia de seguridad.
• Confirma la advertencia (los datos existentes serán reemplazados).
• Selecciona el archivo ZIP de tu ubicación de almacenamiento.
• Se restauran todas las facturas, clientes, ajustes, PDF, logotipo y firma digital.

Advertencia: la restauración reemplaza todos los datos existentes. Recomendamos exportar una copia de seguridad de tus datos actuales antes de restaurar.

Facturas recurrentes

Billero genera automáticamente facturas periódicas (semanales, mensuales o trimestrales) cada vez que se inicia la aplicación.

1. En la pestaña Facturas toca el icono ↻ (arriba a la derecha) → Facturas recurrentes.
2. Toca + y rellena: nombre de la plantilla, cliente, descripción del servicio, importe (sin IVA), tipo de IVA.
3. Elige la frecuencia: semanal, mensual o trimestral.
4. Para mensual/trimestral elige el día del mes (1–28).
5. En el siguiente inicio de la aplicación en o después de la fecha programada, la factura se crea automáticamente con su PDF.

Las plantillas pueden desactivarse con el interruptor o editarse en cualquier momento. Las facturas generadas aparecen en la lista principal de facturas.

Pagos cripto

Billero admite dos tipos de pagos cripto: códigos QR estáticos en la factura en PDF y un enlace de pago de Coingate para aceptar más de 70 criptomonedas.

Códigos QR en la factura en PDF — criptomonedas admitidas

Configura la dirección o direcciones de tu monedero en Mis datos → Pago cripto. El código QR se añade automáticamente a la página 2 de cada factura en PDF.

• EURC — stablecoin en euros de Circle en Ethereum, Base o Solana. Cotización: 1 EURC = 1 EUR.
• USDC — stablecoin en dólares de Circle en Ethereum, Base, Polygon o Solana. Cotización: obtenida del BCE mediante la API de Frankfurter en el momento de generar el PDF.
• BTC — Bitcoin, formato QR BIP-21. Cotización: obtenida de CoinGecko en el momento de generar el PDF.
• ETH — Ethereum (nativo), formato QR EIP-681. Cotización: CoinGecko.
• SOL — Solana (nativo), formato Solana Pay. Cotización: CoinGecko.
• Token personalizado — introduce el nombre del token y la dirección del monedero; el QR codifica la dirección (importe por acuerdo).

La cotización y la marca de tiempo de obtención se imprimen bajo cada código QR. Sin conexión a internet el código QR no se muestra (la cotización debe estar actualizada).

En Mis datos → Mostrar en la factura puedes activar o desactivar de forma independiente el QR UPN y el QR cripto. El UPN permanece en la página 1, el QR cripto está en la página 2.

Enlace de pago de Coingate (BTC, ETH, SOL y más de 70 monedas)

1. Crea una cuenta en coingate.com y obtén una clave de API.
2. En Mis datos → Coingate, introduce tu clave de API. Activa el modo Sandbox para pruebas.
3. En la pestaña Facturas, toca el icono ₿ junto a la factura.
4. La aplicación crea un enlace de pago: aparecen un código QR y un botón Abrir en el navegador.
5. Comparte el enlace con tu cliente. Paga con cualquier criptomoneda que elija.
6. Recibes EUR en tu cuenta bancaria a través de SEPA (Coingate se encarga de la conversión).
7. Comprueba el estado del pago con el botón Comprobar estado de la aplicación.

Coingate está regulado en la UE (licencia EMI, Lituania) y admite pagos SEPA.

Tailandia — PDF bilingüe (tailandés + inglés)

Cuando tu perfil está configurado como Tailandia (TH), Billero genera automáticamente una factura en PDF bilingüe: cada etiqueta se imprime en escritura tailandesa (arriba) e inglés (abajo) una junto a la otra en la misma página.

• La fuente tailandesa (Noto Sans Thai) viene incluida con la aplicación; no se necesita instalación.
• Funciona para clientes locales tailandeses y para clientes internacionales que no leen tailandés.
• Tipo de IVA: 7 % (Código de Rentas, sección 77). Umbral de registro: 1 800 000 THB/año.

Singapur — factura con GST

Cuando tu perfil está configurado como Singapur (SG), Billero aplica automáticamente las normas del GST:

• Tipo de GST: 9 % (GST Act, capítulo 117A).
• Umbral de registro: 1 000 000 SGD/año; por debajo del umbral se imprime una cláusula de exención.
• Moneda: SGD ($). Condiciones de pago: 30 días.