vhsys API: what you can do and how to use it with AI agents
vhsys, a Brazilian business management system, offers an API to connect the ERP with online stores, CRMs and other tools, with access to customers, products, orders, invoices, stock and finance. Small and mid-sized Brazilian retail and service companies use it. Access is with tokens from the customer's account.
What the vhsys API offers
Customers and suppliers
Create and look up customers and suppliers.
Products and stock
Create products and look up and adjust balances.
Sales orders
Create and look up orders and quotes.
Invoices
Issue and look up invoices, depending on the account's tax setup.
Finance
Accounts payable and receivable.
How to access the vhsys API
- With your company’s credentialsUses access tokens generated in the vhsys panel (an access token and a secret token) and sent in the request header.
- Issuing an invoice has tax consequences: always with approval.
- Respect the API's rate limits.
- Customer data falls under Brazil's data-protection law (LGPD).
What an iTeam agent does with the vhsys API
WhatsApp order entered in the ERP
The agent confirms items and price with the customer and creates the sales order in vhsys for the team to invoice.
Overdue receivables
The agent lists overdue items, sends reminders to customers and logs their replies.
Invoice copy
The agent finds the invoice the customer asked for and sends the file.
Minimum stock
The agent alerts purchasing about products below the minimum, with a suggested quantity.
From the credential to the agent at work, with approval
Generate the tokens in vhsys
In the vhsys panel, generate the account's integration tokens.
Store it in the iTeam vault
Add the tokens and set, per agent, who can look things up and who can create orders or payables and receivables.
Invoices and orders with approval
Keep invoice issuing and order creation under approval until the process is validated.
Ready-made AI teams for this work
Bank reconciliation team
Bank lines, Stripe payouts and ledger entries are matched each morning. You only see what did not match, with a reason.
Accounts payable team
Invoices arrive by e-mail and in shared folders. The team reads them, checks them and lines them up for your approval before the due date.
Collections team
Before and after each due date, customers get a clear reminder with a payment link. Disputes and promises to pay go to your team.
Cash flow forecast team
Every week the projection is rebuilt from your books, open invoices and bills, with a plain note on what changed and why.
Bookkeeping team
Transactions are categorized as they come in, receipts are matched, and the month-end close starts with a short list of questions.
Inventory planning team
Stock, sales and lead times are checked every day. You get a reorder list per SKU and a warning about what is not selling.
Questions about the vhsys API
Is the vhsys API free?
API access depends on the plan you contracted. Confirm with vhsys whether it is included.
Do I need to write code to use the vhsys API with iTeam?
Not necessarily. The iTeam deployment team sets up the integration from vhsys's documentation.
Does the agent issue invoices on its own?
It can prepare them and, with permission, issue them. We recommend leaving issuing under human approval.
