Automatiza tus facturas y boletas peruanas con Google y Gemini

  • 14 min de lectura
  • 20-30 min de ejecución
  • Costo: $0
  • Sin tarjeta
Estado
Funcionando
Con
Google Apps Script + Gemini API + ApiPerú + Google Drive + Google Sheets
Última verificación
noviembre 2026
¿Algo falló? Avísanos en Telegram
Mira el video de esta guía

Qué vas a lograr

Al terminar esta guía tendrás tu propio gestor de facturas y boletas. Subes la foto, el PDF o el XML de tu comprobante a una carpeta de Google Drive y, unos minutos después, sus datos aparecen en una hoja de Google Sheets y el archivo queda ordenado por año y mes.

En concreto:

  1. Una hoja de Google Sheets con proveedor, RUC, fecha y montos de cada comprobante.
  2. Un archivo ordenado en tu Drive: los comprobantes procesados quedan en carpetas por año y mes.
  3. Un PDF por cada foto que subas, para tu archivo contable.
  4. Todo sin pagar nada y sin ingresar una tarjeta.

Funciona con fotos (JPG, PNG y HEIC de iPhone), PDF y los XML de SUNAT.

SOBRE ESTA SOLUCIÓN

La instalación se hace una sola vez y se pega código que ya está escrito: no tienes que programar nada. Ver GitHub y un editor de código puede intimidar, pero son solo unos clics. Después, tu tarea diaria es subir archivos a una carpeta.

Qué necesitas antes de empezar

ElementoOpciónCosto
Una cuenta de Googleaccounts.google.com. Si ya tienes Gmail, ya tienes cuenta de Google$0
Una clave de Gemini (Gemini API Key)Se crea en la Fase 5$0
Un token de ApiPerúSe crea en la Fase 5$0
Total$0

Sobre la cuenta de Google: si ya tienes una cuenta de Gmail (un correo que termina en @gmail.com), esa misma cuenta te da acceso a Google Drive, Google Sheets, Apps Script y Google AI Studio, que son todas las herramientas que usa la guía. No necesitas crear nada más. Si no tienes Gmail, puedes crear una cuenta de Google con cualquier otro correo.

El flujo completo

  1. 1Crear tu hoja de Google Sheets
  2. 2Descargar el código desde GitHub
  3. 3Pegar el código en tu hoja
  4. 4Instalar el sistema y autorizar el script
  5. 5Configurar tus llaves (API Keys)
  6. 6Procesar tus facturas

Después: qué esperar, reglas y límites y una advertencia sobre tus datos.

REGLA DEL TUTORIAL

No se avanza a la siguiente fase sin cerrar la actual. Los controles están marcados con la palabra Control.

FASE 1Crear tu hoja de Google Sheets

  1. Entra a Google Drive.
  2. Haz clic en el botón Nuevo (arriba a la izquierda), elige Hojas de cálculo de Google y luego Hoja de cálculo en blanco.
  3. Arriba a la izquierda, haz clic en «Hoja de cálculo sin título» y ponle de nombre: Gestor Automático de Facturas.
  4. Deja esa pestaña abierta.
Secuencia animada: en Google Drive se pulsa Nuevo, se elige Hojas de cálculo de Google y Hoja de cálculo en blanco, y se le pone el nombre Gestor Automático de Facturas
Crear la hoja de Google Sheets en cuatro pasos

Control: ves una hoja de cálculo en blanco llamada «Gestor Automático de Facturas».

FASE 2Descargar el código desde GitHub

El código del gestor es un único archivo, Codigo.gs, que está en el repositorio de GitHub.

  1. Abre el repositorio.
  2. Haz clic en el archivo Codigo.gs.
  3. Arriba a la derecha de la caja de código, haz clic en el icono de copiar (dos cuadros superpuestos), que está justo a la derecha del botón Raw.
  4. Con eso el código completo queda copiado: no hace falta abrirlo ni seleccionarlo.
Repositorio de GitHub Facturas-Boletas con el archivo Codigo.gs en la lista de archivos
El repositorio tiene un solo archivo: Codigo.gs
Vista del archivo Codigo.gs en GitHub con el icono de copiar, marcado con un recuadro rojo, arriba a la derecha de la caja de código, junto al botón Raw
Paso 3: el icono de copiar (marcado en rojo) está arriba a la derecha de la caja de código

Control: tienes el código copiado en el portapapeles. Es un texto largo que empieza con líneas de código.

FASE 3Pegar el código en tu hoja

  1. Vuelve a la pestaña de tu hoja de Google Sheets.
  2. En el menú superior, haz clic en Extensiones y luego en Apps Script.
  3. Se abrirá el editor de código. Verás un texto por defecto que dice function myFunction() { ... }. Bórralo todo.
  4. Arriba, haz clic en el nombre Proyecto sin título, escribe Gestor Automático de Facturas y pulsa Cambiar nombre.
  5. Pega el código que copiaste de GitHub (Ctrl + V, o Cmd + V en Mac).
  6. Guarda con el icono del disquete o con Ctrl + S (Cmd + S en Mac).
  7. Cierra la pestaña del editor y vuelve a tu hoja. Recarga la página (F5).
Secuencia animada: en la hoja se abre Extensiones y Apps Script, se borra el texto de ejemplo del editor y se cambia el nombre del proyecto a Gestor Automático de Facturas
Pasos 2 a 4: abrir Apps Script, borrar el texto de ejemplo y nombrar el proyecto
Editor de Apps Script con el código pegado y el botón Guardar proyecto en Drive marcado con un recuadro rojo
Pasos 5 y 6: con el código pegado, guarda el proyecto (botón marcado en rojo)
Barra de menús de la hoja con el menú Facturas, junto a Ayuda, marcado con un recuadro rojo
Tras recargar, aparece el menú Facturas (marcado en rojo) junto a Ayuda

Control: en el menú superior de tu hoja aparece una opción nueva llamada ⚙️ Facturas. Si no aparece, espera unos segundos y recarga otra vez.

FASE 4Instalar el sistema y autorizar el script

  1. En el menú ⚙️ Facturas, elige 1. Instalar Sistema.
  2. Aparecerá el mensaje Se requiere autorización. Haz clic en Aceptar.
  3. Se abrirá una ventana de Google que dice Google no ha verificado esta aplicación. Es normal en los scripts personales.
  4. En esa ventana, haz clic en Configuración avanzada (abajo a la izquierda). Luego haz clic en Ir a Gestor Automático de Facturas (no seguro).
  5. Google te mostrará los permisos que pide el script (ver la nota de más abajo). Revísalos, baja hasta el final de la ventana y haz clic en Continuar.
  6. Aparecerá un mensaje que dice ¡Carpetas creadas con éxito!. Haz clic en Aceptar.
Menú Facturas desplegado en la hoja, con las opciones 1. Instalar Sistema y 2. Configurar API Keys marcadas con un recuadro rojo
Paso 1: en el menú Facturas, elige 1. Instalar Sistema (opciones marcadas en rojo)
Ventana Se requiere autorización con el botón Aceptar marcado con un recuadro rojo
Paso 2: acepta la solicitud de autorización
Ventana de Google que dice Google no ha verificado esta aplicación, con el enlace Configuración avanzada marcado con un recuadro rojo
Paso 4: abre la Configuración avanzada (enlace marcado en rojo)
La misma ventana con la configuración avanzada abierta y el enlace Ir a Gestor Automático de Facturas (no seguro) marcado con un recuadro rojo
Paso 4: continúa con el enlace de abajo (marcado en rojo)
Lista de permisos que pide el Gestor Automático de Facturas: Drive, Presentaciones, Hojas de cálculo y servicio externo
Paso 5: la lista de permisos que pide el script
Final de la ventana de permisos con los botones Cancelar y Continuar; este último está marcado con un recuadro rojo
Paso 5: baja hasta el final y pulsa Continuar (botón marcado en rojo)
Mensaje Carpetas creadas con éxito, con el recordatorio de configurar las API Keys
Paso 6: el instalador confirma que creó las carpetas

POR QUÉ APARECE EL AVISO DE «NO SEGURO»

Google muestra ese aviso con cualquier script que no pasó su proceso de verificación, y este es un script personal que corre dentro de tu cuenta. Aun así, estás dando permisos amplios: ver, crear y eliminar archivos de tu Drive, de tus hojas de cálculo y de tus presentaciones, conectarse a servicios externos y ejecutarse cuando no estás presente (por eso revisa tu carpeta cada 15 minutos). El de Presentaciones sirve para algo concreto: el script crea una presentación temporal para convertir tus fotos en PDF. Por todo esto conviene instalarlo solo desde el repositorio de esta guía.

Control: en tu Google Drive existe la carpeta Facturas y Boletas Perú, con tres subcarpetas: 01 Entrada, 02 Procesados y 03 Revisar.

Carpeta Facturas y Boletas Perú en Google Drive con las subcarpetas 03 Revisar, 02 Procesados y 01 Entrada
Las tres carpetas que crea el instalador

El instalador también crea dos pestañas nuevas en tu hoja: Registro_Facturas, donde se anotan los comprobantes, y Observaciones, donde se guardan los avisos de cada uno.

Pestaña Registro_Facturas con la fila de títulos de las columnas y los nombres de las pestañas, ambos marcados con un recuadro rojo
La pestaña Registro_Facturas, lista y vacía: en rojo, los encabezados y las pestañas que creó el instalador

FASE 5Configurar tus llaves (API Keys)

El gestor necesita dos llaves gratuitas: una de Gemini, que lee tus comprobantes, y un token de ApiPerú. Primero las consigues y luego las pegas en el panel del gestor.

5.1 — Crear tu clave de Gemini

  1. Entra a Google AI Studio con tu cuenta de Google.
  2. Acepta los términos si es la primera vez que entras.
  3. Haz clic en Crear clave de API (arriba a la derecha; en inglés, Create API key).
  4. En la ventana que se abre, ponle un nombre a la clave (por ejemplo, Gemini API Key), elige un proyecto de la lista y haz clic en Crear clave.
  5. Copia la clave y guárdala por un momento. Es personal: no la compartas.
Lista de claves de API en Google AI Studio con el botón Crear clave de API, marcado con un recuadro rojo, arriba a la derecha
Paso 3: el botón para crear la clave (marcado en rojo) está arriba a la derecha
Ventana Crea una clave nueva con el nombre de la clave, el proyecto elegido y el botón Crear clave marcado con un recuadro rojo
Paso 4: nombre de la clave y proyecto; luego pulsa Crear clave (marcado en rojo)

SOBRE LOS NOMBRES DE LOS MENÚS

Los nombres de los menús de Google cambian de vez en cuando. Si algo no coincide, busca la opción con un nombre parecido.

5.2 — Crear tu token de ApiPerú

ApiPerú es el servicio que consulta los datos del RUC (por ejemplo, el nombre del proveedor). Su plan gratuito alcanza para este uso.

  1. Entra a apiperu.dev y haz clic en Registrarse.
  2. Completa tu nombre, tu correo y una contraseña, y haz clic en Registrarme.
  3. En el panel, elige Api Tokens en el menú de la izquierda y haz clic en Crear primer Api token.
  4. Ponle un nombre (por ejemplo, Facturas y Boletas) y haz clic en Crear Api token.
  5. Aparecerá el token una sola vez. Haz clic en Copiar Api token y guárdalo por un momento. Es personal: no lo compartas.
Formulario Crear cuenta de ApiPerú con nombre, correo y contraseña
Paso 2: crea tu cuenta en ApiPerú
Sección Api Tokens del panel de ApiPerú, con el botón Crear primer Api token marcado con un recuadro rojo
Paso 3: entra a Api Tokens y pulsa Crear primer Api token (marcado en rojo)
Ventana Nuevo Api token con el nombre Facturas y Boletas escrito y el botón Crear Api token marcado con un recuadro rojo
Paso 4: ponle un nombre al token y pulsa Crear Api token (marcado en rojo)
Ventana Api token generado con el aviso de que no podrás verlo de nuevo; el token está tapado y el botón Copiar Api token, marcado con un recuadro rojo
Paso 5: copia el token con el botón marcado en rojo (aquí está tapado)

5.3 — Pegar las llaves en el gestor

  1. En tu hoja, haz clic en ⚙️ Facturas y elige 2. Configurar API Keys.
  2. Se abrirá una ventana a la derecha de la pantalla.
  3. Pega tu clave de Gemini en el primer campo y tu token de ApiPerú en el segundo. Si aún no las tienes, usa los enlaces que aparecen en esa misma ventana.
  4. Haz clic en Guardar y Activar Robot.
Panel lateral Configuración de API Keys con los dos campos vacíos y el botón Guardar y Activar Robot
Paso 2: el panel se abre a la derecha de la hoja
El mismo panel con las dos llaves pegadas, ocultas con puntos, y el botón Guardar y Activar Robot marcado con un recuadro rojo
Paso 3: pega las dos llaves y pulsa Guardar y Activar Robot (botón marcado en rojo)

Control: en el panel aparece ¡Guardado con éxito! y, enseguida, un mensaje que dice ¡Robot activado con éxito!.

Con esto terminó la instalación. A partir de aquí no necesitas volver a GitHub ni al código, salvo que algo cambie.

FASE 6Procesar tus facturas

Esta es tu tarea del día a día.

  1. Entra a tu Google Drive y abre la carpeta Facturas y Boletas Perú.
  2. Abre la subcarpeta 01 Entrada.
  3. Arrastra y suelta tus fotos de facturas (JPG, PNG o HEIC de iPhone), tus archivos PDF o los XML de SUNAT.
  4. Cierra Drive. El sistema revisa la carpeta solo, cada 15 minutos, en segundo plano.

Control: pasados unos 15 minutos, tus archivos ya no están en 01 Entrada y aparece una fila nueva por cada uno en la hoja Registro_Facturas.

Ejemplo real con una boleta en PDF

Así se ve el proceso completo con una boleta electrónica en PDF. En la captura de la boleta se taparon el nombre del cliente, su DNI y el nombre del vendedor.

Boleta de venta electrónica en PDF abierta en Google Drive, con el nombre del cliente, el DNI y el nombre del vendedor tapados
La boleta de ejemplo: solo trae el total, sin base imponible ni IGV desglosados
Carpeta 01 Entrada de Google Drive con el PDF de la boleta recién subido
Paso 3: el PDF ya está en 01 Entrada
Pestaña Registro_Facturas con una fila nueva, donde las celdas Base e IGV están marcadas con un recuadro rojo y pintadas de amarillo
Pasados unos 15 minutos aparece la fila; Base e IGV quedan en amarillo (recuadro rojo) porque la boleta no los trae
Pestaña Observaciones con la advertencia Base no visible e IGV no visible, marcada con un recuadro rojo
En Observaciones queda el aviso de lo que faltó (marcado en rojo)
Carpeta 10-Octubre de Google Drive con el PDF de la boleta ya procesado; en el espacio en blanco, el esquema de carpetas que crea el instalador y qué significa cada nivel
El PDF quedó guardado en 02 Procesados, en la carpeta de su año y de su mes; abajo, el esquema de carpetas

Cada nivel de la estructura tiene un significado:

  • Facturas y Boletas Perú: la carpeta principal del sistema. Todo lo demás vive dentro de ella.
  • 01 Entrada: donde tú subes tus comprobantes. El sistema la revisa cada 15 minutos y la deja vacía al terminar.
  • 02 Procesados: los comprobantes que ya se leyeron y se registraron en la hoja.
  • 2026: dentro de 02 Procesados, una carpeta por año, según el año del comprobante.
  • 10-Octubre: dentro del año, una carpeta por mes, también según la fecha del comprobante. Ahí queda tu archivo.
  • 03 Revisar: los comprobantes que no se pudieron procesar. Revísalos a mano y vuelve a subirlos.

Qué esperar

Pasados los 15 minutos:

  • En tu hoja de Google Sheets: en la pestaña Registro_Facturas verás los datos extraídos (proveedor, RUC, fecha y montos). Si la IA no encontró la base imponible o el IGV, pinta la celda de amarillo para que la revises.
  • En tu Drive: los archivos pasan a la carpeta 02 Procesados, ordenados por año y mes.
  • El PDF: si subiste una foto, el sistema crea un PDF de esa foto para tu archivo contable. Si subiste un PDF original, solo lo mueve.
  • Si algo falla: el archivo va a la carpeta 03 Revisar y en Registro_Facturas aparece una fila roja con el motivo en la columna Estado (por ejemplo, «Revisar: No es factura ni boleta»).
  • Avisos: la pestaña Observaciones guarda una línea por cada comprobante con advertencias, como una base o un IGV que no se vio, o un RUC que no tiene 11 dígitos.

Si necesitas tus datos en un archivo de Excel, en Google Sheets elige Archivo, luego Descargar y Microsoft Excel (.xlsx).

Reglas y límites

SOLO COMPROBANTES DEL AÑO ACTUAL

Si subes un comprobante de un año anterior, el sistema lo rechaza y lo envía a la carpeta 03 Revisar. Se hace así para evitar errores contables.

SI FALTA UN DATO, QUEDA EN BLANCO

Si Gemini no encuentra impreso el IGV o la base, el gestor no inventa ni calcula: deja el dato en blanco y pinta la celda de amarillo para que lo completes tú. La única excepción es la lectura del código QR: como el QR no trae la base, el gestor la calcula restando el IGV al total.

SI GEMINI ESTÁ SATURADO (ERROR 503)

El sistema reintenta hasta 3 veces con cada modelo, esperando 10 segundos entre intentos, y si el modelo principal no responde, prueba con el de respaldo. Si los servidores de Google siguen sin responder, mueve el archivo a 03 Revisar. Espera unos minutos y vuelve a subirlo. No es un fallo del gestor, sino de los servidores de Google.

Un archivo muy borroso también termina en 03 Revisar, para que lo revises a mano.

Cómo lee cada tipo de archivo

ArchivoCómo se leeSe envía a servicios externos
XML de SUNATLee los datos directo del archivo, sin IANo
Foto (JPG, PNG o HEIC)Primero intenta leer el código QR del comprobante. Si no hay un QR legible, la lee con Gemini. Las fotos HEIC se convierten antes a JPGuseqr.app (QR) y, si hace falta, Gemini
PDFLo lee Gemini directamente, sin probar el QRGemini
  • Cada llamada a Gemini espera hasta 90 segundos una respuesta.
  • ApiPerú se consulta solo cuando el comprobante trae RUC pero no se leyó el nombre del proveedor, algo habitual al leer el QR. En el panel de ApiPerú, el plan Gratuito mostraba un tope de 100 consultas por ciclo (mensual). Revisa el tuyo, porque los planes pueden cambiar.
  • Solo las fotos se convierten a PDF. Los PDF que subes se mueven tal cual a la carpeta del mes.

MODELOS DE GEMINI SUGERIDOS

El código usa dos modelos: gemini-3.1-flash-lite como principal y gemini-3.8-flash como respaldo. Son los modelos que se sugieren y con los que se probó esta solución. Si Google los renombra o los retira, cambia sus nombres en el bloque CONFIG que está al inicio del código en Apps Script (MODELO_PRIMARIO y MODELO_FALLBACK).

Revisa siempre lo que registra. Una IA puede equivocarse al leer un comprobante, así que compara los montos con el original antes de usarlos para tu contabilidad.

Una advertencia sobre tus datos

Para leer tus comprobantes, el gestor envía las imágenes y los archivos a la API de Gemini, envía las fotos a useqr.app (un servicio externo que lee códigos QR) y consulta los RUC en ApiPerú. Eso significa que esos datos salen de tu cuenta de Google hacia esos servicios. No es motivo de alarma, pero conviene que lo sepas antes de subir documentos:

  • Las fotos pasan primero por useqr.app, para intentar leer su código QR. Los PDF y los XML no pasan por ese servicio.
  • Revisa los términos de uso del plan gratuito de Gemini: en los planes gratuitos, lo que envías puede usarse para mejorar los productos de Google.
  • Evita subir comprobantes con datos sensibles que no quieras compartir con terceros.
  • No compartas tus llaves con nadie. Si crees que se filtraron, créalas de nuevo.

Si algo no funciona

Ninguna solución es eterna: los servicios cambian sus planes, sus menús y sus límites. Si algo de esta guía dejó de funcionar, avísanos en la comunidad de Telegram y lo corregimos.

Instalas el gestor una vez y después solo subes tus comprobantes a una carpeta. Lo que registra, lo revisas tú.

¿Listo para empezar?

Crea tu hoja de Google Sheets en la Fase 1 y sigue los pasos. Lo instalas una sola vez y después solo subes tus comprobantes a una carpeta.

FRASE DE VIGENCIA

Esto funciona a fecha de noviembre 2026. Si algo cambia o deja de funcionar, visita la comunidad de Telegram. Únete para estar al día.