plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "fluv-hub",
  "version": "1.0.0",
  "description": "Ask about your Fluv Hub account and carry out routine tasks: sales, inventory, listings, customer service, invoices, finance, purchasing, ads and team work.",
  "author": {
    "name": "Fluv Hub",
    "email": "contato@fluvhub.com",
    "url": "https://fluvhub.com"
  },
  "homepage": "https://fluvhub.com",
  "keywords": [
    "marketplace",
    "marketplace hub",
    "e-commerce",
    "Mercado Livre",
    "mercadolivre",
    "Shopee",
    "Magalu",
    "Magazine Luiza",
    "TikTok Shop",
    "Amazon",
    "sales",
    "orders",
    "inventory",
    "estoque",
    "finance",
    "ERP",
    "seller",
    "vendedor",
    "brazil",
    "brasil"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Fluv Hub",
        "shortDescription": "Manage marketplace operations",
        "longDescription": "Fluv Hub is a management hub for online sellers in Brazil. It brings together, in one place, the sales, stock, listings and finances of the stores you run on marketplaces such as Mercado Livre, Shopee, Magalu, TikTok Shop and Amazon. This app connects ChatGPT to your own Fluv Hub account, so you can ask about your business and carry out routine tasks in plain language.\n\nWhat you can ask\n- Sales: totals by period and marketplace, order search and order details, top-selling products.\n- Inventory: product and stock search, stock summary, stock history of a product.\n- Listings: search your listings and open the details of one.\n- Customer service: buyer questions and after-sales conversations.\n- Invoices: search invoices and see the ones that need attention.\n- Finance: results for a period, real profit margin per product, bills that are overdue or due soon.\n- Purchasing: what to reorder and how much, and what is already on the way.\n- Paid ads: spend, revenue and ACOS per ad account and campaign, as synced in your hub.\n- Team: goals progress in the current cycle, what needs attention now, today's pending items, Kanban tasks, and what the hub's automations did.\n\nWhat you can change (only if you grant write access)\nRecord an expense or mark one as paid, register a purchase order, create a Kanban task, and create, take, reply to or complete a pending item.\n\nHow access works\nYou sign in with your Fluv Hub user and choose whether ChatGPT may only read or may also make changes. ChatGPT sees exactly what that user can see in Fluv Hub, and only data from that user's company. Every change is recorded with the user's name, and you can disconnect at any time.\n\nLimitations\nAn existing Fluv Hub account is required. The app works with the data already in your hub: it does not move money, does not contact suppliers, buyers or marketplaces on your behalf, and does not delete records. Amounts are in Brazilian reais (BRL) and dates follow Brasilia time. Tool names and data are in Portuguese.",
        "developerName": "Fluv Hub",
        "category": "Business & Operations",
        "capabilities": [
          "Sales summary, order search and order details",
          "Inventory search, summary and stock history",
          "Listings search and details",
          "Buyer questions and after-sales conversations",
          "Invoice search and invoices needing attention",
          "Financial results, real margins and bills due",
          "Expense entries (write access)",
          "Restocking list and purchase orders",
          "Paid ads performance",
          "Team goals, pending items and Kanban tasks"
        ],
        "websiteURL": "https://fluvhub.com",
        "supportURL": "https://fluvhub.com/suporte",
        "privacyPolicyURL": "https://fluvhub.com/termos/privacidade",
        "termsOfServiceURL": "https://fluvhub.com/termos/uso",
        "defaultPrompt": [
          "How are my sales and net profit this month?",
          "What do I need to reorder now, and how much will it cost?",
          "Which bills are overdue or due in the next 15 days?"
        ],
        "brandColor": "#4F46E5",
        "brandColorDark": "#A5B4FC",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Financial result for the current month",
              "prompt": "What is my net profit so far this month, and which marketplace brought in the most revenue?",
              "tools_triggered": "financeiro_resultado",
              "expected_behavior": "Returns revenue, marketplace fees, cost of goods, expenses and net profit for the current month to date, in BRL, and names the marketplace with the highest revenue. The figures match the Resultado tab of Financeiro Geral in the test account."
            },
            {
              "description": "Products with the lowest real margin",
              "prompt": "Which 5 products had the lowest real margin this month?",
              "tools_triggered": "financeiro_margem_produtos",
              "expected_behavior": "Lists five products sold this month ordered from the lowest real margin, each with units, sales, net payout, product cost, profit and margin percentage, and flags any product that has no cost registered."
            },
            {
              "description": "Restocking list",
              "prompt": "What do I need to reorder right now, and how much will it cost in total?",
              "tools_triggered": "compras_o_que_comprar",
              "expected_behavior": "Returns the products that need a purchase order today grouped by supplier, with current stock, days of stock left, quantity to buy and the investment per supplier and in total."
            },
            {
              "description": "Bills overdue and due soon",
              "prompt": "Which bills are overdue, and which are due in the next 15 days?",
              "tools_triggered": "financeiro_contas_a_vencer",
              "expected_behavior": "Returns two lists, overdue and upcoming, each with description, amount, date and category, plus the total of each list. Reports clearly when a list is empty."
            },
            {
              "description": "Record an expense (write action)",
              "prompt": "Record an expense of R$ 150.00 for internet, due on the 20th of this month.",
              "tools_triggered": "financeiro_categorias, financeiro_despesa_lancar",
              "expected_behavior": "Creates (ChatGPT may ask for confirmation first, depending on the user's approval settings) one expense entry of BRL 150.00 with status previsto and the due date requested, and returns the new entry id. The entry then appears under Financeiro Geral in the test account and in the upcoming bills list."
            }
          ],
          "negative": [
            {
              "description": "Money movement is not supported",
              "prompt": "Transfer R$ 500 to my supplier's bank account."
            },
            {
              "description": "No access outside the connected company",
              "prompt": "Show me the sales of another company that uses Fluv Hub."
            },
            {
              "description": "No bulk deletion",
              "prompt": "Delete all my orders from last year."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This app does not sell products or process payments. It reads and updates the signed-in user's own business records in Fluv Hub.",
        "demo_recording_url": "https://fluvhub.com/revisao-openai/m1fl9onavbt2zkw4md7j/fluv-hub-chatgpt-demo.mp4"
      },
      "publication": {
        "release_notes": "Initial release: read access to sales, inventory, listings, customer service, invoices, finance, purchasing, paid ads and team goals; for users who grant write access, expense entries, purchase orders, Kanban tasks and pending items.",
        "translations": {
          "pt-BR": {
            "subtitle": "Gest\u00e3o de marketplaces",
            "description": "O Fluv Hub \u00e9 um hub de gest\u00e3o para quem vende online no Brasil. Ele re\u00fane, em um s\u00f3 lugar, as vendas, o estoque, os an\u00fancios e o financeiro das lojas que voc\u00ea tem em marketplaces como Mercado Livre, Shopee, Magalu, TikTok Shop e Amazon. Este app conecta o ChatGPT \u00e0 sua pr\u00f3pria conta do Fluv Hub, para voc\u00ea perguntar sobre o seu neg\u00f3cio e resolver tarefas de rotina em linguagem simples.\n\nO que voc\u00ea pode perguntar\n- Vendas: totais por per\u00edodo e por marketplace, busca de pedidos e detalhes de um pedido, produtos mais vendidos.\n- Estoque: busca de produtos e saldos, resumo do estoque, hist\u00f3rico de estoque de um produto.\n- An\u00fancios: busca nos seus an\u00fancios e detalhes de um deles.\n- Atendimento: perguntas de compradores e conversas de p\u00f3s-venda.\n- Notas fiscais: busca de notas e as que precisam de aten\u00e7\u00e3o.\n- Financeiro: resultado de um per\u00edodo, margem real por produto, contas atrasadas ou a vencer.\n- Compras: o que repor e quanto, e o que j\u00e1 est\u00e1 a caminho.\n- An\u00fancios pagos: gasto, receita e ACOS por conta e por campanha, como sincronizados no seu hub.\n- Equipe: andamento das metas do ciclo, o que precisa de aten\u00e7\u00e3o agora, pend\u00eancias do dia, tarefas do Kanban e o que as automa\u00e7\u00f5es do hub fizeram.\n\nO que voc\u00ea pode alterar (s\u00f3 se liberar a grava\u00e7\u00e3o)\nLan\u00e7ar uma despesa ou marcar uma como paga, registrar um pedido de compra, criar uma tarefa no Kanban e criar, pegar, responder ou concluir uma pend\u00eancia.\n\nComo funciona o acesso\nVoc\u00ea entra com o seu usu\u00e1rio do Fluv Hub e escolhe se o ChatGPT pode s\u00f3 consultar ou tamb\u00e9m fazer altera\u00e7\u00f5es. O ChatGPT enxerga exatamente o que esse usu\u00e1rio enxerga no Fluv Hub, e s\u00f3 os dados da empresa dele. Cada altera\u00e7\u00e3o fica registrada com o nome do usu\u00e1rio, e voc\u00ea pode desconectar quando quiser.\n\nLimita\u00e7\u00f5es\n\u00c9 preciso j\u00e1 ter uma conta no Fluv Hub. O app trabalha com os dados que j\u00e1 est\u00e3o no seu hub: n\u00e3o movimenta dinheiro, n\u00e3o fala com fornecedores, compradores ou marketplaces em seu nome e n\u00e3o apaga registros. Valores em reais (BRL) e datas no hor\u00e1rio de Bras\u00edlia."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}