Spain Bureaucracy API: Hacienda, Seguridad Social & SL Incorporation
Melso is the unified API for Spanish bureaucracy: Hacienda (AEAT), Social Security, SEPE, Verifactu, TicketBAI and forming an S.L. It is not the AEAT’s official API. The app and MCP already cover invoicing, bookkeeping and tax calculation. Filing and company procedures are done by Melso professionals after you approve. Partner REST access is a private beta.
What you can do, and how it is available.
Each row is live, private beta, planned or manual-assisted. Private beta is a design-partner REST key over capabilities that already run in the app and MCP. Planned operations are not callable, and their fields can change. A partner key does not approve, pay or file.
| Operation | Status | Available through | Access |
|---|---|---|---|
| VERI*FACTU and TicketBAI invoicing | live | App and MCP. Issuing and sending need the owner to authorize the exact saved version. Partner REST is private beta. | A fiscal company in Melso. Partner keys: hello@melso.ai. |
| Bookkeeping, VAT books and financial statements | live | Documents, reconciliation, the journal, VAT books and statements in the app and MCP. Listing bank movements is live. Connecting or pushing a bank is planned. | App and MCP. Partner REST: private beta, via hello@melso.ai. |
| VAT and withholding calculation, and the AEAT file | live | Calculation for forms 303, 390, 349, 347, 111, 115, 190 and 180. An AEAT import file for 303, 130, 111 and 115. The file is not a filing. | App and MCP. Partner REST: private beta. |
| Form 130 and corporate tax calculation | live | Calculation of form 130 and corporate tax forms 200 and 202 in the app and MCP. Filing them is a separate step. | App and MCP. |
| Employee records | live | Employee records in the app and MCP. Payroll and the RED system are not this row. | App and MCP. |
| Partner REST over what is already live | private beta | Keys, test mode, pagination and Idempotency-Key, over the live app and MCP capabilities. It does not turn planned operations on. A key does not approve, pay or file. | Write to hello@melso.ai. There is no public API price. |
| Filing included returns | manual-assisted | Melso professionals file after you approve the exact version in the app. The API and MCP do not approve, pay or file. A gestoría on the Melso console files its own clients’ returns. | Pro: €49 per month or €490 per year. Scope depends on the activity. |
| Autónomo registration and S.L. incorporation | manual-assisted | Live professional procedures. Not an unattended call to Hacienda or the companies registry. Creating an account does not register you or form the company. | Registration is priced per case. Incorporating an S.L. is €750, a one-off paid in the app. That is not an API price. |
| Mandates, webhooks and tax set-aside | planned | Preview. Not callable. Partner REST conventions (keys, test mode, pagination, Idempotency-Key and webhooks) ship with the first design partners and do not turn preview operations on. | Write to hello@melso.ai. |
| Payroll, Sistema RED, Contrat@ and Certific@2 | planned | Payroll, registrations, deregistrations, Social Security settlements and SEPE employment procedures. There is no callable Seguridad Social API yet. | Write to hello@melso.ai. |
| Administration mailbox and certificates | planned | Preview. Not callable. | Write to hello@melso.ai. |
live: in production in the app and MCP. private beta: partner REST, not general access. planned: not callable yet. manual-assisted: Melso professionals do it after you authorize it.
From your data to the official receipt.
Preparation is not approval. Approval is not filing. Only the administration’s receipt proves filing.
You send the data
The company, its invoices, expenses and documents.
Melso calculates
Drafts, books and, where it exists, the AEAT import file.
You approve the exact version
The owner decides in the app. A partner key does not make that decision.
Professionals file
Under the mandate. The official receipt comes back in the app and, once it exists, by webhook.
Tax-service pricing, and how to ask for the API.
There is no public API price. Design-partner REST access is by email. The tax service is a separate contract: Pro includes professional preparation and filing of the included returns.
- Pro: €49 per month, or €490 per year.
- Incorporating an S.L.: €750, one-off. Autónomo registration is confirmed per case.
- Partner REST access: hello@melso.ai.
Hacienda API, Seguridad Social API and Spanish company formation.
Melso is a Spain bureaucracy API for Hacienda (AEAT), Social Security, SEPE, Verifactu and TicketBAI. It is not the AEAT’s official service. What already runs in the app and MCP, what is private beta, what is planned and what professionals do is in the table on this page.
Not one you can call yet. RED registrations, deregistrations and settlements, Contrat@ and Certific@2 are planned. Social Security work today is manual-assisted when the case needs it.
Forming an S.L. is a manual-assisted service at €750, paid once, done by Melso professionals after you authorize it in the app. It is not a call that registers the company on its own, and it is not the API price.
The API and MCP calculate form 303 and can produce the AEAT import file. Producing that file is not filing the tax. On Pro, professionals file the included returns after you approve the exact version. Only the AEAT receipt proves filing.
Yes, with that boundary. The API and MCP prepare the gestoría’s data and drafts. They do not approve, pay or file. A gestoría using the Melso console files its own clients’ returns; Melso does not file those.
There is no public API price. Design-partner REST access is requested at hello@melso.ai. The Pro tax service is €49 per month or €490 per year.
Want an API key?
Email us. We’ll tell you what is live, what is private beta and what is still planned.