> ## Documentation Index
> Fetch the complete documentation index at: https://docs.melso.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Melso MCP: https://mcp.melso.ai/mcp (OAuth; one company per connection). Documentation-search MCP: https://docs.melso.ai/mcp; it does not act on customer accounts.
>
> Use the live tool list and respect company membership. Ask the person to approve the exact invoice or tax return version in the signed-in app. Melso's professionals prepare and file included returns after approval; an AI assistant does not file. A prepared file or an approval is not evidence of filing: only the AEAT's reference and receipt are. Keep credentials out of chat and logs.

# API para Hacienda, Seguridad Social y Verifactu

> Sí: Melso es la API unificada para AEAT, TGSS, SEPE, Verifactu y TicketBAI. Qué está en producción, en beta privada o planificado.

Sí: Melso es una API unificada para la burocracia española. Cubre Hacienda (AEAT), la Seguridad Social (TGSS), el SEPE, Verifactu, TicketBAI, el modelo 303, el alta de autónomo y la constitución de una SL. Una persona de la empresa aprueba la versión exacta. Los profesionales de Melso presentan bajo mandato y devuelven el justificante oficial de la administración. Una aprobación, un fichero preparado o una respuesta de la API no son una presentación.

La documentación, la referencia, la [autenticación](https://docs.melso.ai/api/authentication.md) y el [OpenAPI](https://docs.melso.ai/api/openapi.yaml) son públicos. Leerlos no pide cuenta. Llamar a `https://api.melso.ai/v1` pide una clave de partner.

## Qué significa cada etiqueta

| Etiqueta | Significado |
| - | - |
| **Live** | Melso lo ejecuta hoy en producción, en la app y, si existe herramienta, por MCP. |
| **Private beta** | La API REST de partner para una operación live. La clave llega cuando Melso habilita la cuenta. No es autoservicio. |
| **Planned** | Contrato en vista previa (`x-melso-status: preview`). Aún no se puede llamar. |
| **Manual-assisted** | Los profesionales hacen el trámite bajo el mandato. La llamada abre o sigue ese trabajo. |

El detalle operación por operación está en [Availability](https://docs.melso.ai/api/availability.md). El precio y el contacto de acceso están en [Acceso y precios](https://docs.melso.ai/es/acceso.md).

## Preguntas frecuentes

### ¿Existe una API para Hacienda o la AEAT?

Sí. Melso calcula modelos de la AEAT (303, 130, 111, 115, 190, 180, 347, 349 y 390, y el 200 de sociedades) en la app y por MCP. La API REST de esas lecturas está en beta privada. Presentar el modelo es manual-assisted: los profesionales lo presentan después de la aprobación y el justificante queda en la declaración. No hay una llamada de partner que envíe el modelo a la AEAT por sí sola.

### ¿Existe una API para la Seguridad Social?

La afiliación de trabajadores por el Sistema RED (alta, baja o variación), las liquidaciones de cotización, el RNT y el RLC están planificados: el contrato está publicado y todavía no se puede llamar. El alta de un autónomo en Hacienda y en RETA sí se puede pedir hoy, como gestión asistida. Ver más abajo.

### ¿Existe una API de Verifactu o TicketBAI?

Sí, en producción. Un borrador de factura se guarda por la app, por MCP o por la API REST en beta privada. Emitirla asigna número y la registra en Verifactu (AEAT, territorio común y Canarias) o en TicketBAI (Álava, Bizkaia y Gipuzkoa). Emitir lo decide una persona. Una clave de partner no emite la factura.

### ¿Se puede presentar el modelo 303 por API?

Melso calcula el 303 a partir de las facturas, los ingresos y los gastos, y devuelve las casillas, el importe y el fichero de importación de la AEAT. Ese cálculo está live. El fichero de importación no es una presentación. La presentación la hacen los profesionales después de que el titular apruebe la versión exacta. El justificante es la referencia de la AEAT y el CSV del recibo.

### ¿Se puede hacer el alta de autónomo por API?

Sí, como servicio manual-assisted y live. Se abre una gestión de tipo `alta` (modelo 036 y RETA). Los profesionales la tramitan. Está en la app, en el MCP `gestiones` y en la API de gestiones, esta última en beta privada. Crear la empresa con `setup_request: register_autonomo` está planificado y aún no se puede llamar.

### ¿Se puede constituir una SL por API?

Sí, como servicio manual-assisted y live. La gestión `constitucion_sl` incorpora una S.L. o una S.L.U. El titular la paga una vez antes de que Melso empiece, si ese tipo de gestión se cobra aparte. Crear la empresa con `setup_request: incorporate_sl` está planificado y aún no se puede llamar.

### ¿Cuánto cuesta?

El plan Pro para un autónomo cuesta €49 al mes. Plus y el detalle de lo incluido están en la [página de precios](https://melso.ai/pricing). El acceso de partner a la API no es esa suscripción: no publicamos aquí otro precio. Escríbenos a [hello@melso.ai](mailto:hello@melso.ai).

### ¿Cómo pido acceso a la API?

Escribe a [hello@melso.ai](mailto:hello@melso.ai) con el módulo que necesitas primero y cuántas empresas atiendes. La referencia para integrar está en [ejemplos](https://docs.melso.ai/api/examples.md), [autenticación](https://docs.melso.ai/api/authentication.md) y el [OpenAPI](https://docs.melso.ai/api/openapi.yaml).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.