Skip to main content
POST
Open a case
Live capability. Melso runs this in production today. Partner keys reach it once your partner account is enabled. See Availability.
A kind paid as a one-off service stays a draft until the owner pays, and the response carries payment_url.

Authorizations

Authorization
string
header
required

Your partner secret key, mk_live_… for real companies or mk_test_… for test companies. Keep it on your servers. See Authentication.

Headers

Idempotency-Key
string

A unique key, such as a UUID, that makes a retried create safe. Reusing a key with a different body is refused.

Maximum string length: 255

Path Parameters

company_id
string<uuid>
required

The company's ID. Every company-scoped call works in exactly this company.

Body

application/json
kind
enum<string>
required

modelo: prepare and file one AEAT form for one period (details model, period); an empresa cannot ask for the 130, 131 or 100. alta: register an autónomo with the AEAT and the Social Security (details start_date, activity). renta: an autónomo's annual income tax return, modelo 100 (details year, joint). constitucion_sl: incorporate an S.L. or S.L.U., paid once by the owner before Melso starts. More kinds are added over time; read them from List case kinds.

Available options:
modelo,
alta,
renta,
constitucion_sl
details
object

The kind's details, as its details_schema describes them.

note
string
Maximum string length: 4000
file_ids
string<uuid>[]
Maximum array length: 20
submit
boolean
default:false

Send it to Melso at once when the plan covers it.

Response

The case.

id
string<uuid>
required
kind
enum<string>
required

modelo: prepare and file one AEAT form for one period (details model, period); an empresa cannot ask for the 130, 131 or 100. alta: register an autónomo with the AEAT and the Social Security (details start_date, activity). renta: an autónomo's annual income tax return, modelo 100 (details year, joint). constitucion_sl: incorporate an S.L. or S.L.U., paid once by the owner before Melso starts. More kinds are added over time; read them from List case kinds.

Available options:
modelo,
alta,
renta,
constitucion_sl
status
enum<string>
required

draft: not sent yet. review: Melso's professionals are working on it. info: they asked the company for something (information_request). approval: a draft waits for the company's approval. filing: approved, being filed. done: filed, with the administration's external_reference. cancelled: withdrawn before filing.

Available options:
draft,
review,
info,
approval,
filing,
done,
cancelled
created_at
string<date-time>
required
deadline
string<date> | null
current_version
integer | null
approved_version
integer | null
payment_url
string<uri> | null

Where the owner pays a service kind before Melso starts.

information_request
object | null

What the professionals need from the company, with the items to answer.

messages
object[]
documents
object[]

The professionals' drafts, the company's documents and the filing receipts.

external_reference
string | null

The administration's reference for what was filed. Always present once done.

completed_on
string<date> | null
updated_at
string<date-time>