For Agents
Manage Spanish accounting records — providers, customers, invoices, and expenses — on the Cuentica platform. Useful for AI agents that automate freelancer or small-business bookkeeping.
Get started with Cuentica API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"create an invoice in Cuentica"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Cuentica API API.
Read company profile and invoicing series via GET /company and GET /company/serie
Create, update, and delete provider records via /provider operations
Create, update, and delete customer records via /customer operations
Issue and update invoices via the /invoice endpoints
Record and categorise business expenses via the /expense endpoints
GET STARTED
Use for: I want to create a new invoice in Cuentica for a customer, Add a new provider to my Cuentica account, Update the contact details of an existing customer, Record a business expense from a supplier receipt
Not supported: Does not handle payment processing, payroll, or tax filing — use for Cuentica invoices, expenses, customers, and providers only.
The Cuentica API exposes the Spanish online accounting platform aimed at freelancers and small businesses (autonomos and pymes). It covers the core accounting entities of company profile and invoicing series, bank accounts, providers, customers, invoices, and expenses. The API is REST-style with JSON bodies and uses an X-AUTH-TOKEN header for authentication. Agents can read company configuration, manage CRM-style provider and customer records, and create or update invoices and expenses to keep books in sync with operational systems.
List bank accounts attached to the Cuentica company
Patterns agents use Cuentica API API for, with concrete tasks.
★ Automated Invoice Issuance from a CRM
An agent can listen for closed-won deals in a CRM and create the matching invoice in Cuentica. It looks up or creates the customer record via /customer, then posts the invoice via the /invoice endpoint with the right invoicing series from /company/serie. The result is books that stay in sync with sales without a human re-entering data.
Look up the customer with GET /customer filtered by NIF, then POST /invoice with the deal value and the correct invoicing series.
Receipt-to-Expense Capture
A bookkeeping agent can ingest receipts from email or a mobile app, extract the supplier, amount, and VAT with an LLM, then create or match the provider via /provider and post the expense via the /expense endpoints. This keeps expense records up to date without manual data entry, which is often the bottleneck for autonomos using Cuentica.
Match the supplier with GET /provider by name, create the provider via POST /provider if missing, then POST /expense with amount, date, and VAT.
Customer and Provider Master Data Sync
An agent can keep Cuentica's customer and provider lists in sync with another system of record such as a CRM or e-commerce platform. By calling GET /customer and GET /provider on a schedule and reconciling against the source system, the agent prevents duplicate records and broken invoices caused by mismatched NIFs.
Reconcile customers between the source CRM and Cuentica by calling GET /customer, comparing on NIF, and updating diffs via PUT /customer/{id}.
AI Agent Integration via Jentic
A bookkeeping agent can use Jentic to discover Cuentica operations rather than hand-coding twenty endpoints. It searches for an intent like 'create an invoice in Cuentica', loads the /invoice schema, and executes the call with the auth token managed by Jentic so the freelancer's accounting credentials never enter the agent context.
Use Jentic search for 'create an invoice in Cuentica' and execute the matching POST /invoice operation with the customer ID and line items.
20 endpoints — the cuentica api exposes the spanish online accounting platform aimed at freelancers and small businesses (autonomos and pymes).
METHOD
PATH
DESCRIPTION
/company
Retrieve company business data
/company/serie
Retrieve invoicing series
/customer
List customers
/provider
List providers
/provider
Create a provider
/provider/{id}
Update a provider
/provider/{id}
Delete a provider
/company
Retrieve company business data
/company/serie
Retrieve invoicing series
/customer
List customers
/provider
List providers
/provider
Create a provider
/provider/{id}
Three things that make agents converge on Jentic-routed access.
Credential isolation
The Cuentica X-AUTH-TOKEN is stored encrypted in the Jentic MAXsystem vault. Jentic injects it into the request header at execution time so the agent's prompt and outputs never contain the raw token.
Intent-based discovery
Agents search Jentic by intent (for example 'create an invoice in Cuentica') and Jentic returns the matching operation with its input schema, so the agent does not need to read the Cuentica API documentation to choose between /invoice, /expense, and /customer.
Time to first call
Direct integration is two to three days to map twenty endpoints, handle the auth header, and reconcile customers and providers. Through Jentic the integration is under 30 minutes because each operation is a discoverable tool.
Alternatives and complements available in the Jentic catalogue.
Xero Accounting API
Xero is an international accounting alternative covering similar invoice and expense flows.
Choose Xero for international or English-language books; choose Cuentica for Spanish autonomos with localised tax handling.
Sage Business Cloud Accounting API
Sage covers accounting for small businesses in many regions, overlapping with Cuentica's scope.
Use Sage for multi-region SMB accounting; use Cuentica when the customer is a Spanish freelancer or small company.
Stripe API
Stripe processes the payments that Cuentica then records as invoiced and paid.
Use Stripe to collect a payment online; then use Cuentica to record the invoice and payment for accounting in Spain.
Specific to using Cuentica API API through Jentic.
What authentication does the Cuentica API use?
Cuentica uses an API key sent in the X-AUTH-TOKEN header on every request. Through Jentic the token is held in the encrypted MAXsystem vault and injected at request time, so a bookkeeping agent never sees the raw key.
Can I create an invoice with the Cuentica API?
Yes. POST /invoice creates a new invoice tied to a customer and an invoicing series. Look up the series with GET /company/serie and the customer with GET /customer first so the invoice attaches to the right entities.
What are the rate limits for the Cuentica API?
Cuentica does not publish specific rate limits in the OpenAPI spec. Cap automated batches at a few requests per second per token and back off on 429 responses to avoid being throttled.
How do I record a business expense with the Cuentica API through Jentic?
Run pip install jentic, search Jentic for 'record a business expense in Cuentica', load the schema for POST /expense, and execute it with the supplier ID, amount, and VAT. Jentic handles the X-AUTH-TOKEN header from your stored credentials.
How do I keep customer records in sync with Cuentica?
Call GET /customer to list current records, compare against your source system on NIF, and use POST /customer or PUT /customer/{id} to add or update entries. Avoid duplicate NIFs because invoices reference the customer ID.
Is the Cuentica API free?
The API is included with a paid Cuentica subscription. Cuentica plans are aimed at autonomos and small businesses in Spain, with pricing on cuentica.com rather than in the OpenAPI spec.
Update a provider
/provider/{id}
Delete a provider