Skip to main content
POST
Register the company as an issuer
Live capability. Melso runs this in production today. Partner keys reach it once your partner account is enabled. See Availability.
A person decides. The company’s owner makes this call, signed in to Melso. Partner keys cannot make it: send the person the approval link instead. See Approvals and filing.
Retrying resumes the same registration. The result is active, or pending with the authorization_url where the owner authorizes the representation for invoice registration.

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.

Path Parameters

company_id
string<uuid>
required

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

Body

application/json
ticketbai_activity_code
string

Bizkaia only, the activity code of its LROE.

Response

The status after registering.

status
enum<string>
required
Available options:
pending,
active,
error
invoicing_ready
boolean
required

The company can issue invoices.

fiscal_network
enum<string>

Empty while the tax territory is unknown.

Available options:
verifactu,
ticketbai,
fiscal_missing
string[]

Fiscal profile fields still missing.

invoicing_missing
string[]

Invoicing fields still missing, such as vat_regime or city.

authorization_url
string<uri> | null

While pending, where the owner authorizes registration. Valid for 24 hours.

error
string | null