> ## 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.

# FAQ and troubleshooting

> Short answers: an expired WhatsApp code, the wrong company, a refused edit, whether a return is filed, MCP 401 and 403, and missing tools.

## WhatsApp

### My WhatsApp link code expired

A link code lasts 30 minutes. The app shows **El código caducó. Conecta de
nuevo.** (The code expired. Connect again.) Choose **Conectar** again to get a
new code and send that one. See [Use Melso on WhatsApp](/essentials/whatsapp).

### WhatsApp is connected to the wrong company

A chat works with one company at a time. Open **Perfil** (Profile), go to
**Chats con Melso**, and choose the right company for that chat. New messages
go to the company you choose. You do not need to reconnect the phone.

This section appears when you belong to two or more companies.

### I said "yes" on WhatsApp. Is my invoice issued or my return authorized?

No. A message does not issue an invoice or authorize a return. Melso sends you
a link, and you approve in the signed-in app. See
[Approvals and professional filing](/essentials/approvals).

## Records

### An edit or a delete is refused

Check these in order:

1. **Your plan is not active.** The app shows **Tu plan no está activo: puedes
   ver y descargar tus datos, pero no añadir ni cambiar nada.** You can read and
   download, but not add or change. Open **Facturación** (Billing).
2. **The record changed since you opened it.** The app shows **No se ha podido
   guardar. Actualiza antes de reintentar.** Refresh and try again.
3. **You are changing a document's identity.** For an expense read from a
   document, the supplier's tax ID, the document number and the date are fixed.
4. **The invoice is already issued.** An issued invoice cannot be edited.
   Prepare a [corrective invoice](/essentials/invoicing#correct-an-issued-invoice).
5. **A return already uses the record.** An assistant cannot delete an expense
   or an income when a return covering its date was approved or filed. Make the
   correction in the web app, and Melso reviews whether the return needs a
   correction. See
   [Records used by an approved or filed return](/essentials/expenses-income#records-used-by-an-approved-or-filed-return).

### Melso recorded my document as the wrong kind

If Melso cannot tell whether you issued or received a document, it asks. If it
classified one by name only, the record carries the note **Clasificado por el
nombre: comprueba que es correcto.** Open the record and check it.

### My scanned PDF is refused

A PDF with no text cannot be read. Upload a photo of the document instead.

### Is "Deducible" a confirmed deduction?

No. It is the classification you declared, and your returns count it. Melso's
professionals review the return before filing. See
[Classification is not professional review](/essentials/expenses-income#classification-is-not-professional-review).

## Invoices

### I cannot issue an invoice

* Only the company's owner can issue. See [Team and access](/essentials/team).
* The fiscal profile must be complete and the issuer authorization done. See
  [Before your first invoice](/essentials/invoicing#before-your-first-invoice).
* A quote or pro forma cannot be issued. Edit it and choose **Factura**.
* If the draft changed after you opened it, review the current version.

### Issuing failed halfway

The number stays reserved for that invoice. Retry the same invoice. Do not
prepare a replacement.

### I do not see the Invoices section

Invoicing with Melso is switched off for your company. The owner can switch it
on with **Emitir facturas con Melso** under **Configuración**.

## Taxes

### Is my return filed?

It is filed when its state is **Presentado** and the case shows **Presentado.
Aquí tienes el justificante.** with a reference, a filing date and a receipt.

**Autorizado** means you authorized it and Melso's professionals are reviewing
and filing it. It is not filed yet. A draft, an estimate, an import file or an
assistant's message is not proof either. See
[Is my return filed?](/essentials/taxes#is-my-return-filed).

### My return shows "Estimación"

The tax service is not active for your company, so Melso shows an estimate with
no boxes and no approval. Check your plan and your fiscal profile. See
[Estimates](/essentials/taxes#estimates).

### I cannot authorize a return

Only the company's owner can authorize, in the signed-in web app. An estimate
cannot be authorized.

### A form says "Melso aún no lo calcula"

It is a reminder. Melso shows the deadline and a link to the official
instructions, and you file it yourself. See
[Forms that are reminders](/essentials/taxes#forms-that-are-reminders).

### Does Melso pay my taxes?

No. Filing is not paying. The payment follows its own deadline.

### Nothing appears on my calendar

Nothing is due until your activity is registered. Check the registration status
in your [fiscal profile](/essentials/setup#edit-the-profile-later).

## AI assistants (MCP)

### I get a 401

The connection has no valid token for this server. The token is missing or
expired, or it was not issued by Melso's OAuth flow for
`https://mcp.melso.ai/mcp`. Let the client refresh its token, or connect again.
See [Connect Melso MCP](/mcp/connect#reconnect-or-change-access).

### I get a 403

Your access changed. Check that you still belong to the company and that the
action is one your role and plan allow. Connecting again does not add
permissions your Melso account lacks.

### Some tools or actions are missing

The tool list follows the company. Three things narrow it:

| What you see | Why |
| - | - |
| Only `company`, `fiscal_profile` and `support_tickets_create` | An autónomo's setup is pending. Finish the [guided setup](/essentials/setup). |
| Only the read actions, and no `payments` | The company has no plan that includes the tools. See [Plans and service scope](/essentials/plans). |
| No `fiscal_profile` | You are not the owner or an admin. See [Team and access](/essentials/team). |

This is not a connection failure. See
[Permissions and approvals](/mcp/permissions).

### The assistant works in the wrong company

Each connection works in the one company you chose when you authorized it. A
tool cannot switch company. Connect again and choose the right company. Remove
the old connection under **Configuración**, in the **MCP** tab, with
**Desconectar**.

### Can the assistant file my return?

No. No tool issues an invoice, or approves, files or pays a return. See
[What MCP can and cannot do](/mcp/overview#what-mcp-can-and-cannot-do).

## Still stuck

Write to Melso's team. In the app, open **Ayuda** (Help) and choose
**Comentarios** (Feedback). From a connected assistant, use
[`support_tickets_create`](/mcp/tools/support-tickets-create). Never include
passwords, certificates or other secrets.


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