"Preços e margens" (Prices & margins)
The "Preços e margens" (Prices & margins) screen is for deciding the margin on usage for the portfolio and for each account, and the monthly fee for new customers, seeing beforehand, item by item, what the customer will pay and what stays with you.
Address in the dashboard: /revenda/precos
How to get there: Through the menu, through the AI badge in "Carteira" (Client portfolio) and on the account details page (which opens the account directly on the "Por conta" (Per account) tab), through the margin shortcut in "Módulos" (Modules), and through the "Sua marca" (Your brand) notice (which opens the "Mensalidade" (Subscription) tab). The tab and the open account stay in the page address.
Top of the screen
The opening sentence (no price changes until you review and confirm) and the general notices.
Buttons and actions
- "Simular uma margem" (Simulate a margin)
- Appears in the zero default margin notice, on the "Margem sobre o uso" (Margin on usage) tab: takes you to the simulator and puts focus on it.
- "Ver a margem padrão" (View default margin)
- The same notice, on the "Por conta" (Per account) tab: returns to the "Margem sobre o uso" (Margin on usage) tab.
- Zero default margin notice: with accounts using "A IA da plataforma" (The platform's AI), consumption is charged at the platform price and nothing from top-ups stays with you.
What you earn
Three cards showing where your money comes from.
Fields and filters
- "Mensalidades" (Subscriptions)
- Your monthly share of the subscriptions, separating accounts with "IA própria" (Own AI) and with "Nossa IA" (Our AI). It arrives on the payment day.
- "Recargas" (Top-ups)
- Your share of this month's top-ups so far. Only accounts with "Nossa IA" (Our AI) have AI top-ups.
- "Extra por item" (Extra per item)
- The gain from per-item margin, paid at month close. Before the addendum it shows a dash; afterward, the projected total for the month, with "Pago até ‹data›" (Paid through ‹date›) or "Acumulando" (Accumulating) until it exceeds the minimum amount, and the "Ver em Repasses" (View in Payouts) shortcut. During the previous month's close, the final value comes out in moments.
Tabs
The three parts of the screen; arrow keys, Home, and End switch tabs from the keyboard.
Buttons and actions
- "Margem sobre o uso" (Margin on usage)
- Opens the simulator and the portfolio's default margin.
- "Por conta" (Per account)
- Opens the list of accounts with each one's margin; shows how many accounts there are.
- "Mensalidade" (Subscription)
- Opens the price for new customers.
Margin on usage: scope note
The margin on usage applies only to accounts with "Nossa IA" (Our AI), where consumption comes out of the prepaid balance. Accounts with their own AI pay the AI directly to their provider, with no platform consumption to put a margin on.
What if the default margin were…
Simulator: drag and see the effect, without changing anything.
Fields and filters
- "Margem simulada" (Simulated margin)
- Slider with the simulated percentage.
Buttons and actions
- "Usar ‹n›% como margem padrão" (Use ‹n›% as default margin)
- Takes the simulated value to the default margin field below; you still review and confirm.
- Badge "simulação · nada muda" (simulation · nothing changes).
- Three comparisons of today for the simulation: the price of one message for the customer, how much stays with you on an example top-up, and how much this month's usage so far would have earned on the accounts that use the default.
- In the default margin field you can go beyond the simulator's limit.
Default margin on usage
The margin that applies to every account with "Nossa IA" (Our AI) without its own margin and to new customers. On each top-up, the margin is your share and lands in your receiving account immediately.
Fields and filters
- "Margem padrão (%)" (Default margin (%))
- The percentage on top of the platform's price list; the accepted range appears next to it and a value outside it is refused with the reason.
Buttons and actions
- "Ver quais" (See which)
- Opens the "Por conta" (Per account) tab filtered to accounts with their own margin.
- "Gravar margem padrão" (Save default margin)
- Opens the confirmation with the scope and effects of the change.
- "Descartar" (Discard)
- Returns the field to the saved margin.
- "Ver o aditivo" (View the addendum)
- Opens the clause of the contract addendum that unlocks per-item margin and payment of the extra.
- Badge with today's margin and how many accounts use the default or have their own margin.
- Notices as you type: with zero margin your share disappears on accounts that use the default; accounts with their own margin do not change, unless you choose that in the confirmation.
- Default table with Item, "Piso da plataforma" (Platform floor), "Margem do item" (Item margin), "Seu cliente paga" (Your customer pays) (striking through today's price when it changes) and "Fica com você" (You keep).
- "Margem do item" (Item margin) column, with the signed addendum: each row has a percentage field. Empty, the item inherits the default margin; filled in, it becomes an item with its own margin ("item com margem própria" (item with own margin) badge) and gets "Voltar ao padrão" (Reset to default). The item's margin is always equal to or greater than the default margin; below that, the field gives the reason right below the row.
- Without the signed addendum, the column is locked ("Disponível após a assinatura do aditivo ao contrato" (Available after the contract addendum is signed)), with the "margem do item bloqueada" (item margin locked) badge.
- Badge with how many items have their own margin, or "nenhum item com margem própria" (no items with their own margin).
- When the default margin rises above an item's own margin, it starts following the default and the row shows "era X% · passa a seguir a padrão" (was X% · now follows the default).
- Split of an example top-up between "Plataforma" (Platform) and "Fica com você" (You keep).
- Panel "Como você recebe o extra dos itens" (How you receive the extra from items): on the top-up, immediately, the split continues by the account's margin; at month close, what items with a higher margin charge above that is calculated from actual usage and paid under "Repasses" (Payouts). Includes an example with the item's numbers.
- The new price list applies to the following consumption and top-ups; the balance already paid does not change. The delivered message template is only debited when the number is on the platform's WhatsApp account.
Rules for the per-item extra
Rules that appear alongside the "Como você recebe o extra dos itens" (How you receive the extra from items) panel, in "Preços e margens" (Prices & margins) and in "Repasses" (Payouts).
- The extra is paid by the 10th of the following month, to your receiving account.
- Below the minimum payout amount in the month, the amount accumulates and goes out together the next month.
- Chargebacks and refunded top-ups are removed from the calculation; a chargeback that arrives after close is deducted from the next extra.
- Your customer only sees the final price of each item, never the margin or the extra.
Change the default margin to ‹n›%?
Confirmation with the before and after of your share on a top-up, who starts using the new margin, when it applies, and the notice to the customer.
Fields and filters
- "Quem passa a usar ‹n›%" (Who will switch to ‹n›%)
- Only when there are accounts with their own margin: choose between the accounts that use the default (and new customers) or all accounts with "Nossa IA" (Our AI), which makes the own margins stop applying.
- "Avisar o cliente por e-mail" (Notify the customer by email)
- Only when the margin goes down: sends the notice with your brand. When any price goes up, the notice always goes out.
Buttons and actions
- "Agora não" (Not now)
- Closes without saving.
- "Gravar ‹n›% em ‹n› contas" (Save ‹n›% on ‹n› accounts)
- Saves the default margin to the chosen accounts and to new customers.
- An increase applies to consumption from now on; a reduction, from each account's next top-up.
- The balance each customer already has keeps being spent at the current price when the margin goes down.
- Customers see only the final price of each item, with your brand. The plans' monthly fee does not change.
"Por conta" (Per account)
The portfolio with the AI type, the monthly fee, and the usage margin of each account.
Fields and filters
- "Conta" (Account)
- Account name and status.
- "IA" (AI)
- "Nossa IA" (Our AI) or "IA própria" (Own AI).
- "Tamanho" (Size)
- For "Nossa IA" (Our AI), the AI credits included in the monthly fee.
- "Mensalidade" (Subscription)
- Your share and how much the customer pays per month.
- "Margem de uso" (Usage margin)
- The badge "padrão" (default) or "própria" (own) with the percentage; it does not apply to accounts with their own AI. A note warns when the balance already paid continues at a previous margin.
Buttons and actions
- "Todas" (All)
- Shows all accounts, with the count.
- "IA própria" (Own AI)
- Filters accounts that use the customer's own AI.
- "Nossa IA" (Our AI)
- Filters accounts that use the platform's AI.
- "Margem própria" (Own margin)
- Filters accounts with "Nossa IA" (Our AI) that have their own margin.
- "Com itens acima" (With items above)
- Filters accounts with items above the account's margin.
- "Ajustar" (Adjust)
- Opens the account's side panel (only accounts with "Nossa IA" (Our AI)).
- "Adicionar cliente" (Add customer)
- With an empty portfolio, opens the page to create an account.
- Column with how much stays with you on each example top-up.
- A new account starts with "Nossa IA" (Our AI) and the default margin.
- On phones, the table becomes one card per account.
Account panel
Side drawer with the agreement, this account's margin with a table preview, and the history. Esc closes it and focus returns to "Ajustar" (Adjust).
Fields and filters
- "Margem desta conta (%)" (This account's margin (%))
- The percentage of the own margin, when chosen.
- "Margem do item" (Item margin)
- With the signed addendum, an item's margin only for this account, always equal to or higher than the account margin. Left empty, the item inherits the account margin; once you type a value, it becomes an item with its own margin, with "Voltar ao padrão" (Reset to default).
Buttons and actions
- "Alterar preço" (Change price)
- Opens the slider to change this account's subscription and your share.
- "Usar a margem padrão (‹n›%)" (Use the default margin (‹n›%))
- The account follows the portfolio default and changes along with it whenever it changes.
- "Margem própria" (Own margin)
- The margin stays fixed on this account even when the default changes; the percentage field appears and receives focus.
- "Ver a tabela inteira (‹n› itens)" (View the full table (‹n› items))
- Shows all the items in the account's table.
- "Mostrar só os principais" (Show only the main ones)
- Goes back to showing only the main items.
- "Revisar e salvar" (Review and save)
- Opens the confirmation; it is only enabled when something has changed.
- "Descartar" (Discard)
- Goes back to the saved choice and percentage.
- The agreement: "Cliente paga" (Customer pays) and "Você recebe por mês" (You receive per month), with the percentage.
- "Prévia" (Preview) "Como fica a tabela desta conta" (How this account's table looks), with today's price struck through and the new one, and how much you keep per item.
- A badge showing how many of the account's items have their own margin, and the panel "Como você recebe o extra dos itens" (How you receive the extra from items), when some item goes above the account margin.
- An item that the account's new margin has surpassed: the row shows "era X% · passa a seguir a margem da conta" (was X% · now follows the account margin).
- A notice for when the customer's balance was paid at a higher margin: it keeps being spent at that price until it runs out.
- Margin history: each change, when it happened and by whom (by you, automatic, or by support), with the latest highlighted. An item's margin change appears as "Margem do item ‹item›: de X% para Y%" (Item margin ‹item›: from X% to Y%), or as it now following the account margin or the default.
Change the margin of ‹conta›?
Confirmation with the before and after of the main items and of your share on a top-up, when applicable, the balance, and the subscription, which does not change. When items with their own margin change, the "Itens com margem própria" (Items with own margin) list shows each item, before and after.
Fields and filters
- "Avisar o cliente por e-mail" (Notify the customer by email)
- Only when the price the customer pays goes down; when it goes up, the notice is always sent.
Buttons and actions
- "Agora não" (Not now)
- Closes without saving.
- "Salvar margem de ‹n›%" (Save ‹n›% margin)
- Saves the account's own margin.
- "Voltar para ‹n›%" (Revert to ‹n›%)
- Removes the own margin and the account goes back to following the default.
"Mensalidade" (Subscription)
The price for new customers with "Nossa IA" (Our AI): the subscription and the share for whoever creates the account on their own through your address, and the starting point when adding a customer in "Carteira" (Client portfolio). Existing accounts do not change.
Fields and filters
- "O cliente paga por mês" (Customer pays per month)
- The subscription for customers who arrive on their own.
- "Você recebe por mês" (You receive per month)
- Your share within the same charge.
Buttons and actions
- "Mudar em Sua marca" (Change in Your brand)
- Takes you to "Sua marca" (Your brand) to open or close sign-up through your address.
- "Máximo" (Maximum)
- Sets your share to the maximum the price supports.
- "Salvar este preço" (Save this price)
- Saves the price for new customers; it appears when there is a valid change.
- "Descartar" (Discard)
- Goes back to the saved price.
- A notice that the new account with "Nossa IA" (Our AI) follows the current model: a subscription with AI credits included.
- Sign-up status through your address: open or closed.
- The account you sell is a subscription plus top-ups; your share of each top-up lands in your account instantly.
Screen states
- Loading
- The three earnings cards appear with readable labels and the rest as a skeleton; the account panel and the "Mensalidade" (Subscription) tab have their own skeleton.
- Nothing here yet
- On the "Por conta" (Per account) tab, an empty portfolio shows "Sua carteira ainda está vazia" (Your portfolio is still empty) with "Adicionar cliente" (Add customer); a filter with no results shows "Nenhuma conta neste filtro" (No accounts in this filter).
- If something goes wrong
- "Não conseguimos abrir os seus preços e margens" (We could not open your prices and margins): the screen assures you that nothing changed in the portfolio's prices and offers "Tentar de novo" (Try again). Errors when saving appear inside the confirmation, with the reason, and the button becomes "Tentar de novo" (Try again).
- Default margin set to zero with "Nossa IA" (Our AI) accounts
- A warning banner at the top with shortcuts to simulate or view the default margin.
- Feature not enabled for the reseller
- The address takes you to "Carteira" (Client portfolio).