OrbitQuote
Documentation OrbitQuote / Help Center

OrbitQuote Help Center

From the supplier file to a finished order ready to send, step by step.

Overview

OrbitQuote reads supplier quotes — PDF, spreadsheet, or photo — and builds a table with the items already organized. You review it, adjust whatever you need, and export the order ready to go.

Each quote becomes a "flow". Inside a flow you find the uploaded files, the items the AI extracted, the chat history, the exports generated, and the progress of every processing run.

To get in, create the account with just an email and password, or use Google login (and Microsoft/Apple where available). On the sign-in screen and on the home page there is a PT · EN · ES selector at the top, and the language can also be changed later under "My account".

Day to day always follows the same order: upload, review, adjust, select, and export. The AI does the heavy lifting of reading, but you are the one who decides what goes into the order.

Longer processing runs happen in the background. You track progress through the Task Center and the Notifications while you keep working.

Navigation lives in the sidebar: "My Flows" (/fluxo) lists your quotes with search and the "New Flow" button; /chat is the Orbi assistant in its own workspace; /compare matches suppliers against each other; /agentes automates prospecting (if your access is not enabled yet, the screen itself and the "Agents" card under "My account" send the request); and "My account" (/account) takes care of plan, payment, and credits.

The flow path Input (file or text) → AI extraction → review in the table → bulk or chat adjustments → export. Always in that order.
The buying decision is yours The AI suggests and organizes, but only the item you mark to buy makes it into the order. The final choice stays with you.

First steps

  1. Sign in with your email and password, or use Google login (and Microsoft/Apple where available). To change the language on the sign-in screen, use the PT · EN · ES selector at the top.
  2. Create a flow by uploading a file (PDF, spreadsheet .xlsx/.xls/.ods/.csv/.xml, PNG, or JPG/JPEG). On the empty screen, with no file open, you can also paste text directly.
  3. If you want, write instructions for the AI before uploading — for example, "use the price column with tax" or "ignore freight items".
  4. Track the extraction in the Task Center. It runs in the background, so you can keep working while the reading finishes.
  5. Review the items in the table: check the description, category, quantity, and price, and mark what you are going to buy.
  6. Make quick adjustments through the bulk actions bar or by asking the chat.
  7. Export the order in WhatsApp, PDF, or Excel once everything is right.
The guided tour On your first visit to /fluxo, a welcome guided tour appears automatically and shows where the sidebar, the files, the Task Center, the notifications, and the chat are. It takes less than a minute. When there are already extracted items on screen, the tour also covers the table steps.

Flow files

Accepted formats and limit

  • OrbitQuote reads PDF, spreadsheets (.xlsx, .xls, .ods, .csv, and .xml), and images (.png, .jpg, and .jpeg).
  • Each file can be up to 250 MB. Above that, split the document before uploading.
  • A photo of a quote taken on your phone works, as long as the text is legible.

Start from a file or from text

  • Most of the time you start by uploading a file. Large PDFs open a dialog so you can choose the pages; the rest run the extraction automatically in the background.
  • On the empty screen, with no flow open, you can paste text directly — handy when the supplier sent the list as a message. With a flow already open, pasted text goes to the chat instead of creating a new flow.

Add an extra file to the flow

  • In the files drawer, use "+ Add file" to bring more documents into the same flow.
  • The new extraction joins the queue and runs in the background; track its status through the Task Center.

Select, download, and organize

  • Turn on selection mode to download or delete several files at once.
  • In split view, drag a file from the list onto the preview panel to swap the document shown next to the table.

Deletion and privacy

  • The flow's main file cannot be deleted — it is the basis of the extraction.
  • Files are private: only the account owner can access, download, or see their preview.

Previews and viewers

The preview shows the original document just as it arrived, and the table shows what the AI extracted from it. Looking at the two side by side helps you check that the reading came out faithful before moving on.

PDF
  • Opens in a modal with fullscreen, a new-tab option, download, and a button for split view.
  • Check the description, unit, and values right at the source, without leaving the screen.
Images
  • The gallery has zoom, pan, rotation, and arrow navigation between images.
  • It also offers fullscreen, new tab, and download.
Excel
  • The viewer brings the spreadsheet tabs (when there is more than one) and a navigable grid.
  • It opens in split view so you can check it side by side with the extracted table.
Keyboard shortcuts In the image gallery: Esc closes, the arrows change the image, r rotates clockwise and R (Shift+r) counterclockwise, F enters fullscreen, N opens a new tab, +/- adjust the zoom, and 0 resets. In the PDF: Esc closes, F enters fullscreen, and N opens a new tab.

Items and table

The table is where you review everything the AI extracted and define what goes into the order. Here you check the values, edit whatever you need, and mark the items you want to buy.

Work tabs
  • Shopping cart: the items in use in the current order.
  • Outside the quote (trash): items you removed. They can be restored at any time.
Filters and navigation
  • Search by code, description, or category to find an item quickly.
  • Filter by category, browse through the pages, and sort by clicking the column header (a click toggles between ascending and descending).
Editing fields
  • Edit the description, quantity, and price right in the table, without opening extra screens.
  • Check the "Buy" box on the items that should go into the export.
Dynamic columns
  • Show or hide columns through the "Columns" menu, depending on what you need to see.
  • Several technical columns — tax rates, CST, CFOP, NCM, CEST — and the notes columns come hidden by default; turn them on through the menu when you need them.
The rule that defines the order Only an item with "Buy" checked AND a quantity greater than zero goes into the order. If either of the two is missing, it is not exported.

Bulk actions and dynamic bar

The flow has a control bar at the top, always visible, and a bulk actions bar that appears when you select items. The actions bar applies changes in bulk to several items at once.

How to select
  • "Select page" marks only the items on the current page — through the table header checkbox on desktop or the "Select page" button on mobile.
  • The "Select all N items in the budget" button marks every active item in the entire flow: it crosses all pages and ignores the search and category filters currently active.
  • Hold Shift and click to select a range of items at once.
Bulk adjustments
  • Apply the same quantity or the same price to all selected items in the flow. Quantity accepts whole numbers; price accepts decimals.
  • Remove the selected ones, remove the unselected ones, or restore items from the trash. Restored items come back to the active list keeping the buy flag and quantity they already had — only the removed marker is cleared.
What lives in each bar
  • The order total, the search, the category filter, and the columns menu live in the control bar at the top, always visible.
  • The bulk actions bar, which appears when you select, brings the count of selected items, the quantity and price adjustments, and the remove and restore buttons.
  • In the table header, the checkbox shows a partial state (a dash) when only part of the items on the current page is marked.
Split view
  • Available on desktop, when the flow already has at least one attached file. It shows the table on one side and the preview of the original file on the other.
  • Use the panel swap to flip the sides and put the document in the most comfortable position.
A bulk change within a filter To apply a change to just one group, filter by category and select the items by page (or mark them by hand) within the filtered view. Do not use "Select all N items in the budget" in this case: it ignores the filter and marks the entire flow.

AI chat

The chat is an assistant that already knows the open flow and carries out adjustments from natural-language commands. The more precise the request, the better the result.

Streaming and control
  • Messages without an attachment reply in streaming, appearing on screen bit by bit.
  • Stop the reply at any moment with the "Cancel" button or the Esc key (the key only cancels while the reply is in progress).
  • On chat requests and item adjustments, the AI may show a "Thinking…" block that you expand or collapse.
Attachments and context
  • Messages with an attachment use the traditional send (no streaming), because they need to process the file.
  • The assistant already receives the active items, the removed ones, the files, and the flow history — you do not need to repeat the context.
What the chat does
  • Updates items: price, quantity, category, description, marking or unmarking the buy, removing, and restoring.
  • Adds new items. If an identical item already exists (same code or same description), the quantity is added to the existing item and you are notified — it does not create a duplicate row.
  • Renames the flow or a file and reprocesses the main file. It can delete a file, and actions that erase something usually ask for confirmation before running.
Page extraction
  • In PDFs, ask for the extraction of specific pages instead of the whole document.
  • Page extraction through the chat runs in the background and appears in the Task Center.
How to write a good request
  • Cite the exact reference: the item code, a snippet of the description, or the category name.
  • Ask for 1 to 3 actions per message. Lean commands reduce ambiguity and error.
When the AI did not change anything Redo the request with the exact reference of the item (code or name) and clearly state the action you want. Vague commands like "fix this" usually are not applied.

Ready-made examples (copy and use)

Set quantity 12 for the item with code 45107.
Remove all items in the "Freight" category.
Change the price of item 45107 to 9.90.
Rename this flow to "Downtown Site".
Reprocess the main file.

Bulk recategorization

When several items are in the wrong category, a direct command recategorizes them all at once.

Recategorize all items with "blue" in the description to "Cables".

Extraction of specific pages (PDF)

If the document is long or mixes several subjects, ask only for the pages that matter. The extraction runs in the background and the items join the flow.

  1. Tell it the file and the pages (for example, "extract pages 4, 5, and 6").
  2. State the reading rule: which column is the final price, whether there are taxes, what the unit is.
  3. Track the job in the Task Center while the extraction runs.
  4. Review the added items in the table and adjust whatever is still missing.
Give a real example Whenever you can, cite a real line from the document. That guides the AI much better than a generic instruction.
Extract pages 8 and 9 of the PDF "Supplier-Table.pdf".
Use the "Total w/ tax" column as the price.
If possible, adjust the price of the added items based on that value.

Orbi chat workspace

The /chat is the Orbi assistant outside of a flow: free-form conversations on the same engine as the flow and comparison chat. Use it to ask, draft, and prepare actions before entering a specific flow.

Conversations
  • Each conversation is born untitled; the title is created on the first turn, with up to 60 characters, and can be renamed later.
  • Search by title or message text to find a conversation again, and delete the ones you no longer need.
Reply files
  • When a reply generates a file, it stays on the conversation artifact shelf, ready to download later.
  • Conversation history can be browsed at any time without spending a turn.
Simultaneous-turn limit
  • The number of simultaneous conversations with the AI depends on the plan and is shared across /fluxo, /compare, and /chat.
  • Only the turn (the question that talks to the model) counts toward the limit — browsing history and managing conversations is free.
The same Orbi everywhere Orbi is the assistant identity across the whole app: the same one as in flows, comparisons, and agents. What changes is the context — in the workspace, it is not inside any specific flow.

Supplier comparison

The comparison cross-references quotes from several suppliers and shows, item by item, who has the best price. You build the order by taking the best of each one and export it by supplier.

How to create
  • Click "New Flow" and choose "New Price Comparison".
  • Select 2 or more existing flows, or upload new files — each new file goes through an extraction, which consumes tokens and respects your plan's limit on simultaneous processing. The comparison is saved in the sidebar so you can come back to it anytime.
Reading the table
  • Each row is an item and each column is a supplier, with price, quantity, and the "Lowest" badge on the cheapest item.
  • At the top of each column you see that supplier's total and how many items it covers, in the format "X of Y items".
Building the order
  • On each item, mark which supplier to buy from — the choice is exclusive per item, so selecting one supplier unmarks the others for that item. Use "Select all" to pull an entire supplier at once.
  • The automatic modes — cheapest per item, cheapest total, fewest suppliers, and widest coverage — build the selection with one click, and the "Order" card sums everything in the Grand Total.
Items not quoted
  • The "Items not available per supplier" section shows what each supplier left out of its quote.
  • Use this to negotiate or to complete the order with another supplier.
Fixing the grouping
  • The automatic cross-reference can get it wrong: merging different products into one row or splitting the same product across two. Click "Organize groups" in the comparison bar, tick the items with the checkboxes, and use "Merge" (they become a single row) or "Separate" (each item gets its own row). The fix is instant and consumes no tokens; if two purchased items land on the same row, only one stays selected.
  • The checkbox in the "#" column selects the whole row; the checkbox next to each price selects just that offer. While the mode is on, the view switches to "All" and the purchase selection is paused — click "Done" to go back to normal.
  • Prefer to chat? Ask the assistant — "these two items are the same product", "separate this row", or "deduplicate" — and it applies the same fix. The chat consumes tokens.
Chat, analysis, and export
  • Through the chat you apply a mode, choose a supplier, change the view (buying/all), or remove a flow. The heavier actions — removing a flow, redoing the cross-reference, or exporting — ask for confirmation before going ahead.
  • The "Executive analysis" (a summary of who wins on total and the biggest gap between suppliers) is temporarily unavailable in the interface. It uses AI and consumes tokens when enabled.
  • Each supplier in the Order can be exported in WhatsApp, PDF, or Excel; when you export two or more, a ZIP file comes out.
Before comparing The comparison uses the buy selection of the linked flows. To keep the original flows intact, choose to duplicate them when you compare.

Order export

With the items selected, the export panel generates the order in the format you need. Each format serves a purpose, and only Excel can use AI.

Format Recommended use Consumes tokens
WhatsApp A message ready to send quickly to the supplier. No
PDF A formal document for approval, filing, and printing. No
Excel An editable spreadsheet. Uses AI only when you started from a supplier spreadsheet, to preserve its structure. Sometimes
What goes into the order — and what charges AI The export respects the table selection: only items with "Buy" checked and a quantity greater than zero go through. WhatsApp and PDF never consume tokens. Excel uses AI only when the flow has an original supplier spreadsheet (to preserve its layout); when the input was a PDF, image, or text, the Excel is built from scratch, without AI.

Reprocessing and queue

Reprocessing creates a new extraction job for the main file — the same source is read again. Use it when something came out incomplete or when you changed the instructions, and keep working while the reading runs.

When to reprocess Reprocess when you adjust the AI instructions or suspect the reading came out incomplete. To change the source, add a new file through "+ Add file" or create a new flow — reprocessing always rereads the same main file.
Where to track it The Task Center shows the tasks in progress and those that finished in this session, with the elapsed time and an estimate of the remaining time (once it can be calculated). You can cancel tasks in progress and retry the ones that failed.
Limit of simultaneous processing runs The number of processing runs at the same time depends on the plan (without an active subscription, it is 1 at a time). If the simultaneous-jobs block appears, wait for the active tasks to finish or subscribe to/upgrade a plan with more simultaneous processing runs.

Account, subscription, and payments

The "My account" page brings together plan, renewal, billing, card, financial history, and one-off credits. It is where you keep payment up to date so the AI stays available.

Plan and renewal
  • See the current plan, the cycle, and the subscription status.
  • Turn automatic renewal on or off and upgrade when you need more capacity. The upgrade is always to a plan with more tokens.
Card and billing
  • The account shows the brand and the last 4 digits of the saved card; you can update it there or enter a new card at the time of purchase.
  • Keep the country, tax ID, and billing address up to date to avoid declines.
Payment history
  • Track the status, the amount, and the description of each payment.
  • See the date and the plan associated with each charge.
One-off credits
  • Buy credit packs to keep using the AI when the plan reaches its limit.
  • On the account page, the credits appear in a usage bar separate from the plan.

Tokens, carryover, and credits

A token is the unit that measures AI usage in OrbitQuote. Knowing what consumes them and in what order avoids surprises — on the account page, usage appears across up to three tracks: monthly plan, carryover, and one-off credits.

What consumes tokens
  • AI chat, both in streaming and in the traditional send.
  • Extraction and reprocessing of documents and pages.
  • Excel export, when it uses AI to preserve the original supplier spreadsheet.
  • In the comparison: the chat and the cross-reference (rematch and incremental match) of items. The Executive analysis is temporarily unavailable in the interface.
  • In Agents (/agentes), when access is enabled: conversation turns with suppliers and audio transcription.
What does not consume tokens
  • Manual editing in the table, filters, and sorting.
  • Export in WhatsApp and in PDF.
  • Viewing and downloading files.
Order of consumption
  • Carryover are the tokens left over from the plan that were transferred on an upgrade to a plan with more tokens. Changing only the cycle (monthly to annual on the same plan) does not generate carryover.
  • Consumption always follows this order: first the carryover, then the plan, and last the one-off credits.
  • One-off credits work even without an active plan or with an overdue payment — the AI stays available as long as there is credit with a balance and within its validity.
Reading the bars On the account page, each track that exists has its own bar showing used, available, and the renewal or expiration date — whoever has no carryover or credits sees only the plan bar. In the flow sidebar, the token bar appears only when plan usage passes 90% AND there are no one-off credits available; if you have credit, it stays hidden on purpose.
When the limit is reached Once everything runs out, the AI features stay blocked until the cycle renews, you buy credits, or you upgrade.
Where to adjust Subscription changes and credit purchases are made under "My account".

Quick FAQ

My file is stuck in processing. What now?

Open the Task Center to track the progress, the time estimate, and the final status. You do not have to sit and wait: you can work in another flow in the meantime.

The chat replied, but did not apply the change.

Resend the command with the exact reference (code, description, or category) and a direct action. Generic requests usually are not applied.

I extracted pages, but few items came through.

Repeat it stating the price and unit rule better, and cite a real line from the document to guide the AI.

I cannot generate the Excel.

When the Excel is generated from the original supplier spreadsheet, it uses AI and depends on a token or credit balance. If the flow has no original spreadsheet, the Excel is built from scratch and does not depend on a balance. WhatsApp and PDF never consume tokens and work even without a balance.

Can I use AI without an active plan?

Yes, as long as there are one-off credits with a balance on the account. They work even without a plan or with an overdue payment.

How do I stop a streaming reply?

Use the "Cancel" button in the chat or press the Esc key while the reply is in progress.

What is /chat?

It is the Orbi assistant outside of a flow: a conversation screen using the same tools as the flow and comparison chat. The simultaneous-conversation limit comes from the plan and is shared across /fluxo, /compare, and /chat.

Do I need approval to use /agentes or the API?

Yes. Agents require access to be enabled on your account: if you do not have it yet, request it under "My account" (Agents card) or on the Agents screen itself. With an active subscription it is one click; without one, "Talk to sales" sends your phone number to the team. The API requires the API flag plus a key created under "My account". Without the API flag, the request becomes an email to the team.

Prospecting agents

Agents talk to suppliers for you, over WhatsApp and email, from a campaign. Access is enabled per account: if yours is not enabled yet, the Agents screen shows the access request.

Campaigns
  • A campaign is born from a step-by-step wizard, from your flows or comparisons, with a preview of the contacts before you authorize.
  • You can search suppliers on the internet (you approve the findings before they become conversations), add a supplier you already know, and request a fresh search whenever you want.
Conversations
  • Follow each negotiation: talk to Orbi about the conversation to steer the agent mid-way, pause and resume, take the conversation over yourself, or cancel it.
  • Orbi gives the order to the agent, and the conversation timeline shows whether it is pending, done, returned with a question, or superseded.
Personas and channels
  • The persona sets the agent tone; you can keep several and mark one as default.
  • Connect the WhatsApp number and the sending email under channels before activating the campaign.
  • In the Email tab you can save the mailbox password and also your Google or Microsoft account; agents use only one, and you pick which under "Mailbox your agents use".
Agents consume tokens — and have an emergency brake Conversation turns and audio transcription come out of your balance, in the same order as the rest of the app. And there is a master switch that pauses all agents at once, should you ever need to stop everything.

Public API and integrations

The v1 API lets your ERP, spreadsheet, or agent create documents, read flows and items, build comparisons, and export — with a Bearer key, without opening the browser.

Access keys
  • Create the key under "My account", in the API keys panel. Each key is identified by its NAME, and the secret value is shown exactly once, at creation.
  • Without the API access flag, the access request becomes an email to the team.
Limits
  • Keys carry scopes (quote reading and writing) and traffic is limited to 60 requests per minute.
  • The number of simultaneous processing runs follows the same limit as your plan.
For AI agents
  • The API contract for agents lives at /v1/skills.md, with references the agent opens on demand.
  • There is also an MCP server at /v1/mcp, exposing the Orbi tools over JSON-RPC.
Everything by UUID As in the rest of the app, the API only speaks UUID — no internal numeric id ever appears in routes or responses. Errors come in a standard JSON envelope.