Skip to content

ZanardiZZ/GrocyBot

Repository files navigation

🤖 GrocyBot — Integração automática de notas fiscais com Grocy via Telegram

Este bot permite enviar notas fiscais por foto do QR Code via Telegram. Ele extrai os produtos da nota, permite aplicar descontos manualmente por item, calcula validade estimada e insere automaticamente no Grocy via API.


🚀 Funcionalidades

✅ Envio da nota via foto do QR Code no Telegram ✅ Extração dos itens usando Selenium em múltiplas SEFAZ (testado RS, SP e SC) ✅ Estimativa automática de validade dos produtos ✅ Escolha do estabelecimento de compra ✅ Aplicação manual de descontos por item ✅ Inserção direta no estoque do Grocy via API ✅ Suporte a unidades, locais e fallback inteligente ✅ Logs e mensagens informativas no Telegram

Compatível com QR Codes das SEFAZ de RS, SP e SC. Outros estados podem funcionar, mas não foram testados.


🧰 Requisitos

  • Python 3.10+
  • Docker (opcional para facilitar execução)
  • Conta no Grocy com API ativada
  • Bot Telegram com token

🔐 Variáveis de ambiente (.env)

TELEGRAM_TOKEN=seu_token_telegram
GROCY_URL=http://192.168.0.10/grocy
GROCY_API_KEY=suachavegrocy
OPENAI_API_KEY=sua_chave_openai
DEFAULT_LOCATION_ID=1

📦 Instalação via Docker

Crie um docker-compose.yml com:

version: "3"

services:
  grocybot:
    build: .
    volumes:
      - .:/app
    environment:
      - TELEGRAM_TOKEN=${TELEGRAM_TOKEN}
      - GROCY_URL=${GROCY_URL}
      - GROCY_API_KEY=${GROCY_API_KEY}
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - DEFAULT_LOCATION_ID=1

📸 Uso

  1. Inicie o bot:

    python3 bot.py
  2. No Telegram, envie uma foto da nota fiscal com QR Code.

  3. O bot irá:

    • Extrair os itens
    • Perguntar o nome do mercado
    • Exibir os itens com valores
    • Perguntar se algum item teve desconto (por número)
  4. Após confirmação, envia ao Grocy!


🧠 IA utilizada

  • OpenAI GPT-4o para:
    • Estimar validade dos produtos
    • (Opcional) Padronizar nomes dos itens

About

Bot de telegram que adiciona automaticamente as compras no Grocy

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages