TOTVS Protheus API: What You Can Do and How to Use It with AI Agents
Protheus, the ERP from the Brazilian company TOTVS, offers REST services that can be enabled in the company's own environment, along with standard APIs and custom code in AdvPL/TL++. Access depends on the setup done by IT or the responsible consultancy. Mid-size and large companies use it to connect the ERP to e-commerce, CRM and automations.
What the TOTVS Protheus API offers
Records
Customers, suppliers, products and price tables.
Sales and purchase orders
Create and look up orders.
Stock
Balances and movements per warehouse.
Finance
Accounts payable and receivable.
Invoicing
Tax invoices and outbound documents.
Custom services
REST endpoints the company built for its own rules.
How to access the TOTVS Protheus API
- With your company’s credentialsUsually basic or token authentication with a Protheus integration user, on the REST server configured in the company's environment.
- Every Protheus installation is different: confirm which services are available in your environment.
- Limit the integration user by routine and branch.
- Creating or changing ERP records should go through staging and approval.
Official documentation: tdn.totvs.com
What an iTeam agent does with the TOTVS Protheus API
Order status without opening the ERP
Salespeople ask the agent on WhatsApp about orders, invoicing and delivery, and it queries Protheus.
Overdue receivables tracked
The agent lists overdue receivables by customer and organizes the collection approved by finance.
Portal order into the ERP
Orders received through a portal or email are checked by the agent and entered into Protheus after approval.
Critical stock
The agent alerts purchasing about items below the reorder point at each branch.
From the credential to the agent at work, with approval
Enable REST with IT
IT or the consultancy enables the Protheus REST server and creates an integration user with access only to the routines needed.
Register it in the iTeam vault
The address and credentials stay in the vault. Reading is allowed, and creating records goes through approval.
Test in staging first
Flows are tested in the Protheus staging environment before going to production.
Ready-made AI teams that use TOTVS Protheus
Management reporting team
Revenue, margin, pipeline and cash in one report, built from your systems, with a short note on what changed and why.
Procurement and quotes team
Requests go out to suppliers, quotes come back into one table, and the approver sees price, terms and past orders before saying yes.
Questions about the TOTVS Protheus API
Is the TOTVS Protheus API free?
The APIs are part of Protheus, but enabling services, usage licenses and custom work may carry a cost depending on the contract with TOTVS or the consultancy.
Do I need to write code to use the TOTVS Protheus API with iTeam?
Not necessarily. iTeam reads the services' documentation and the deployment team sets it up with your IT. AdvPL custom code is needed only if the process requires it.
Does it work with Protheus in the TOTVS cloud?
Yes, as long as the REST services are enabled and reachable. This is checked in the diagnosis.
