{
"error": "Review and approve in the authenticated web application",
"code": "person_required",
"request_id": "req_01JAB3K9X2"
}
{
"error": "invoice not found",
"code": "not_found",
"request_id": "req_01JAB3K9X2"
}
{
"error": "The tax return changed or is not ready for approval",
"code": "version_conflict",
"request_id": "req_01JAB3K9X2"
}
Planned. A preview contract for design partners. It is not callable yet, and fields can still change. See Access and pricing and Availability.
Access: REST, not callable yet · manual-assisted.
Manual-assisted when it ships. This planned workflow would support work by professionals under the company’s mandate. The operation is not callable yet.
You attest that the person who must approve it read exactly
expected_version in your interface and approved it, and you send the
evidence. Melso records the attestation with the evidence and treats it
as that person’s approval, the same as on Melso’s approval page; you
receive case.approved. A case whose version changed is refused.For an incorporation this approves the deed draft. It never stands in
for signing the deed before the notary. Requires a signed partner
agreement that defines who may approve and how evidence is kept.
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 (036) and the Social
Security (RETA), details in CaseDetailsAlta; it has no draft to
approve. renta: an autónomo's annual income tax return, modelo 100
(details year, joint). constitucion_sl: incorporate an S.L. or
S.L.U., details in CaseDetailsConstitucionSL, paid once before Melso
starts; the owner approves the deed draft. It opens only in a company
in incorporation, which holds nothing else until the S.L. is
registered. More kinds are added over time; read them from List case
kinds.
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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Melso","public":true,"description":"Melso is the unified API for Spanish bureaucracy: Hacienda (AEAT), Seguridad Social (TGSS), SEPE, Verifactu, TicketBAI and constituting an SL. Professionals file under mandate and return the official receipt. API unificada para la burocracia española.","colors":{"primary":"#F04E42","light":"#F48171","dark":"#C84037"},"logo":{"light":"https://mintcdn.com/melso/M0EJxJd5v0DQ3VCv/logo/light.svg?fit=max\u0026auto=format\u0026n=M0EJxJd5v0DQ3VCv\u0026q=85\u0026s=b734d43a59ba6bc24e866a6b71d37541","dark":"https://mintcdn.com/melso/M0EJxJd5v0DQ3VCv/logo/dark.svg?fit=max\u0026auto=format\u0026n=M0EJxJd5v0DQ3VCv\u0026q=85\u0026s=9dcda5c15c4d9423fc981e4f1cf9d980","href":"https://melso.ai/en"},"favicon":"https://mintcdn.com/melso/M0EJxJd5v0DQ3VCv/favicon.svg?fit=max\u0026auto=format\u0026n=M0EJxJd5v0DQ3VCv\u0026q=85\u0026s=5eda48321a2659d5e371a8c737a494cc","api":{"playground":{"display":"simple"},"examples":{"languages":["bash","python","javascript"]}},"background":{"color":{"light":"#FFFFFF","dark":"#0A0A0A"}},"navbar":{"links":[{"href":"https://melso.ai/en","label":"Melso"}],"primary":{"type":"button","label":"Open Melso","href":"https://app.melso.ai"}},"footer":{"socials":{"website":"https://melso.ai/en"}},"search":{"prompt":"Search Melso docs..."},"seo":{"metatags":{"canonical":"https://docs.melso.ai","og:site_name":"Melso Docs","og:locale":"en_US","og:locale:alternate":"es_ES","theme-color":"#F04E42","og:image":"https://docs.melso.ai/images/og/home.png","og:image:width":"1200","og:image:height":"630","og:image:alt":"Melso documentation: learn the product, connect your AI assistant, or build on the API.","twitter:card":"summary_large_image","twitter:image":"https://docs.melso.ai/images/og/home.png"},"paths":[{"path":"es","metatags":{"og:locale":"es_ES","og:locale:alternate":"en_US"}}],"organization":{"name":"Melso","url":"https://melso.ai","logo":"https://docs.melso.ai/logo/light.svg","sameAs":["https://melso.ai","https://docs.melso.ai","https://app.melso.ai"]},"indexing":"navigable"},"fonts":{"family":"Geist"},"contextual":{"options":["copy","view","chatgpt","claude",{"title":"Connect your AI","description":"Connect your AI assistant to Melso.","icon":"plug","href":"/mcp/connect"}],"display":"header"},"markdown":{"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.\n\nUse 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."},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":""},{"language":"es","href":"es/api-hacienda"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"melso","hasAudioNarration":false,"actualSubdomain":"melso","customDomains":["docs.melso.ai"],"gitSource":{"type":"github","owner":"melso-ai","repo":"melso-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae62c353db8daa467975c7c","collectionId":"4d93bf2e-cb92-4e90-b50f-2c93d961f02e","liveDeploymentHistoryId":"6ae62c353db8daa467975c7c","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ae62c353db8daa467975c7c","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"en","tag":"API","count":126},{"language":"en","tag":"MCP","count":42},{"language":"en","tag":"Bookkeeping","count":35},{"language":"en","tag":"Taxes","count":30},{"language":"en","tag":"Tools","count":26},{"language":"en","tag":"Companies and access","count":17},{"language":"en","tag":"Payroll and Social Security","count":16},{"language":"en","tag":"Guides","count":14},{"language":"en","tag":"Invoicing","count":14},{"language":"en","tag":"Accounting","count":12},{"language":"es","tag":"API","count":2},{"language":"es","tag":"Para quién busca la API","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"#navbar img[src*=\"logo/\"],#sidebar img[src*=\"logo/\"]{height:26px!important;width:auto!important;min-width:88px;object-fit:contain}:root{--melso-coral:#F04E42;--melso-cream:#FDF8DF;--melso-maroon:#3B0D11}#navbar a[href=\"https://app.melso.ai\"]{background:0 0!important;border:0!important;box-shadow:none!important;color:var(--melso-maroon)!important}#navbar a[href=\"https://app.melso.ai\"]>span.absolute{background:var(--melso-coral)!important}#navbar a[href=\"https://app.melso.ai\"] *{color:var(--melso-maroon)!important}#navbar a[href=\"https://app.melso.ai\"]:hover>span.absolute{background:#d9443a!important;opacity:1!important}@media (prefers-reduced-motion:reduce){*,::after,::before{scroll-behavior:auto!important}}"}],"page":{"pagePath":"api/reference/cases/attest-case-approval","slug":"/api/reference/cases/attest-case-approval","pageMetadata":{"title":"Aprobación de una gestión en tu producto — Attest a case approval from your interface","sidebarTitle":"Attest a case approval from your interface","description":"Aprobación de una gestión en tu producto. Planned preview contract, not callable yet.","og:image":"https://docs.melso.ai/images/og/api-reference.png","og:image:alt":"Melso API reference: every operation with its request and response.","twitter:image":"https://docs.melso.ai/images/og/api-reference.png","openapi":"api/openapi.yaml POST /companies/{company_id}/cases/{case_id}/attested-approvals","href":"/api/reference/cases/attest-case-approval"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Aprobación de una gestión en tu producto. Planned preview contract, not callable yet.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Info,Note}=_components;if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Planned.`}),` A preview contract for design partners. It is not callable yet, and fields can still change. See `,_jsx(_components.a,{href:`/api/access`,children:`Access and pricing`}),` and `,_jsx(_components.a,{href:`/api/availability`,children:`Availability`}),`.`]})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Access:`}),` REST, not callable yet · manual-assisted.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Manual-assisted when it ships.`}),` This planned workflow would support work by professionals under the company’s mandate. The operation is not callable yet.`]})}),`\n`,_jsxs(_components.p,{children:[`You attest that the person who must approve it read exactly\n`,_jsx(_components.code,{children:`expected_version`}),` in your interface and approved it, and you send the\nevidence. Melso records the attestation with the evidence and treats it\nas that person’s approval, the same as on Melso’s approval page; you\nreceive `,_jsx(_components.code,{children:`case.approved`}),`. A case whose version changed is refused.`]}),`\n`,_jsx(_components.p,{children:`For an incorporation this approves the deed draft. It never stands in\nfor signing the deed before the notary. Requires a signed partner\nagreement that defines who may approve and how evidence is kept.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Aprobación de una gestión en tu producto — Attest a case approval from your interface","sidebarTitle":"Attest a case approval from your interface","description":"Aprobación de una gestión en tu producto. Planned preview contract, not callable yet.","og:image":"https://docs.melso.ai/images/og/api-reference.png","og:image:alt":"Melso API reference: every operation with its request and response.","twitter:image":"https://docs.melso.ai/images/og/api-reference.png","openapi":"api/openapi.yaml POST /companies/{company_id}/cases/{case_id}/attested-approvals","href":"/api/reference/cases/attest-case-approval"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"attestCaseApproval","summary":"Attest a case approval from your interface","description":"Aprobación de una gestión en tu producto. Planned preview contract, not callable yet.","tags":["Cases"],"x-melso-status":"preview","parameters":["753628b7-d71a-447a-9373-520149fb36f8"],"requestBody":"a26d9afe-d1ab-48d6-a831-3e6139c86f47","responses":{"200":"d685f84c-ddc2-47bb-9187-8f4eb5f8a722","400":"6e357943-5b6c-4a9e-8c73-f68cf34e5b0f","401":"9c59df00-51df-4f76-885d-61a48256004c","403":"be247cb5-8d37-42ed-9be8-558e0bfd1e1e","404":"cc9489e9-5df2-40ca-b1cf-f2bcc0957182","409":"e9ad3573-291c-4835-bc28-aebff9da2330"},"method":"post","type":"path","servers":["e764a2e3-706a-4b6d-8c4d-5174c9aaaad3"],"security":["b8f96d16-f36e-4d4c-803f-899df97e21f5"],"path":"/companies/{company_id}/cases/{case_id}/attested-approvals","baseUrlOptions":["https://api.melso.ai/v1"],"title":"Attest a case approval from your interface","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"753628b7-d71a-447a-9373-520149fb36f8":{"name":"Idempotency-Key","in":"header","description":"A unique key, such as a UUID, that makes a retried create safe. Reusing a key with a different body is refused.","schema":{"type":"string","maxLength":255,"description":"A unique key, such as a UUID, that makes a retried create safe. Reusing a key with a different body is refused.","uniqueKey":"","typeLabel":"string"}},"676ae92e-f270-4423-8ecb-b33030f3779c":{"name":"company_id","in":"path","required":true,"description":"The company's ID. Every company-scoped call works in exactly this company.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"The company's ID. Every company-scoped call works in exactly this company.","uniqueKey":"","typeLabel":"string\u003cuuid>"}},"6873fe4a-d9db-453f-98df-7e378d800d1c":{"name":"case_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["expected_version","approver","evidence"],"additionalProperties":false,"properties":{"expected_version":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"expected_version","typeLabel":"integer"},"approver":{"type":"object","required":["name","email","role"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"approver.name","typeLabel":"string"},"email":{"type":"string","format":"email","isRequired":true,"uniqueKey":"approver.email","typeLabel":"string\u003cemail>"},"role":{"type":"string","enum":["owner","legal_representative"],"isRequired":true,"uniqueKey":"approver.role","typeLabel":"enum\u003cstring>"},"tax_id":{"type":"string","description":"The person's DNI or NIE.","uniqueKey":"approver.tax_id","typeLabel":"string"},"external_user_id":{"type":"string","description":"The person's ID in your product.","uniqueKey":"approver.external_user_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"approver","typeLabel":"object"},"evidence":{"type":"object","required":["approved_at","ip_address","shown_document_sha256"],"properties":{"approved_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"evidence.approved_at","typeLabel":"string\u003cdate-time>"},"ip_address":{"type":"string","isRequired":true,"uniqueKey":"evidence.ip_address","typeLabel":"string"},"shown_document_sha256":{"type":"string","description":"SHA-256 of the document as you rendered it to the person, from the return's preview document or the case version's draft.","isRequired":true,"uniqueKey":"evidence.shown_document_sha256","typeLabel":"string"},"user_agent":{"type":"string","uniqueKey":"evidence.user_agent","typeLabel":"string"},"authentication":{"type":"string","enum":["strong_customer_authentication","password","other"],"description":"How your product authenticated the person for this approval. The partner agreement says which methods are accepted.","uniqueKey":"evidence.authentication","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"evidence","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"expected_version":2,"approver":{"name":"Pablo Ruiz Ortega","email":"pablo@example.com","role":"owner","tax_id":"12345678Z","external_user_id":"usr_3k9d2"},"evidence":{"approved_at":"2026-11-20T16:03:12Z","ip_address":"203.0.113.24","user_agent":"Mozilla/5.0","authentication":"strong_customer_authentication","shown_document_sha256":"4b1e7c9a2d5f8e0b3c6a9d2f5e8b1c4a7d0e3f6b9c2a5d8e1f4b7c0a3d6e9f2b"}},"examples":{"Example":{"title":"Example","value":{"expected_version":2,"approver":{"name":"Pablo Ruiz Ortega","email":"pablo@example.com","role":"owner","tax_id":"12345678Z","external_user_id":"usr_3k9d2"},"evidence":{"approved_at":"2026-11-20T16:03:12Z","ip_address":"203.0.113.24","user_agent":"Mozilla/5.0","authentication":"strong_customer_authentication","shown_document_sha256":"4b1e7c9a2d5f8e0b3c6a9d2f5e8b1c4a7d0e3f6b9c2a5d8e1f4b7c0a3d6e9f2b"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"d685f84c-ddc2-47bb-9187-8f4eb5f8a722":{"description":"The case, approved, with the attestation recorded.","content":{"application/json":{"schema":{"type":"object","required":["id","kind","status","created_at"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["modelo","alta","renta","constitucion_sl"],"description":"`modelo`: prepare and file one AEAT form for one period (details\n`model`, `period`); an empresa cannot ask for the 130, 131 or 100.\n`alta`: register an autónomo with the AEAT (036) and the Social\nSecurity (RETA), details in `CaseDetailsAlta`; it has no draft to\napprove. `renta`: an autónomo's annual income tax return, modelo 100\n(details `year`, `joint`). `constitucion_sl`: incorporate an S.L. or\nS.L.U., details in `CaseDetailsConstitucionSL`, paid once before Melso\nstarts; the owner approves the deed draft. It opens only in a company\nin incorporation, which holds nothing else until the S.L. is\nregistered. More kinds are added over time; read them from List case\nkinds.\n","isRequired":true,"uniqueKey":"kind","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["draft","review","info","approval","filing","done","cancelled"],"description":"`draft`: not sent yet. `review`: Melso's professionals are working on\nit. `info`: they asked the company for something\n(`information_request`). `approval`: a draft waits for the company's\napproval. `filing`: approved, being filed. `done`: filed, with the\nadministration's `external_reference`. `cancelled`: withdrawn before\nfiling.\n","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"deadline":{"oneOf":[{"type":"string","format":"date","uniqueKey":"deadline.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","uniqueKey":"deadline.oneOf.1","typeLabel":"null"}],"uniqueKey":"deadline","typeLabel":"string\u003cdate> | null"},"current_version":{"oneOf":[{"type":"integer","uniqueKey":"current_version.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"current_version.oneOf.1","typeLabel":"null"}],"uniqueKey":"current_version","typeLabel":"integer | null"},"approved_version":{"oneOf":[{"type":"integer","uniqueKey":"approved_version.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"approved_version.oneOf.1","typeLabel":"null"}],"uniqueKey":"approved_version","typeLabel":"integer | null"},"approvals":{"type":"array","description":"Preview. Who approved which version, and how.\n","items":{"type":"object","required":["version","approver","method","approved_at"],"properties":{"version":{"type":"integer","isRequired":true,"uniqueKey":"approvals.items.[INDEX].version","typeLabel":"integer"},"approver":{"type":"object","properties":{"name":{"type":"string","uniqueKey":"approvals.items.[INDEX].approver.name","typeLabel":"string"},"role":{"type":"string","enum":["owner","legal_representative"],"uniqueKey":"approvals.items.[INDEX].approver.role","typeLabel":"enum\u003cstring>"},"tax_id":{"type":"string","uniqueKey":"approvals.items.[INDEX].approver.tax_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"approvals.items.[INDEX].approver","typeLabel":"object"},"method":{"type":"string","enum":["melso","attested"],"description":"`melso`: on Melso's approval page. `attested`: attested by your partner account.","isRequired":true,"uniqueKey":"approvals.items.[INDEX].method","typeLabel":"enum\u003cstring>"},"approved_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"approvals.items.[INDEX].approved_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"approvals.items.[INDEX]","typeLabel":"object"},"uniqueKey":"approvals","typeLabel":"object[]"},"payment_url":{"oneOf":[{"type":"string","format":"uri","description":"Where the owner pays a service kind before Melso starts.","uniqueKey":"payment_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"Where the owner pays a service kind before Melso starts.","uniqueKey":"payment_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"payment_url","typeLabel":"string\u003curi> | null"},"information_request":{"oneOf":[{"type":"object","description":"What the professionals need from the company, with the items to answer.","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"information_request.oneOf.0.id","typeLabel":"string\u003cuuid>"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"information_request.oneOf.0.\\items.items.[INDEX].id","typeLabel":"string"},"kind":{"type":"string","enum":["document","question"],"uniqueKey":"information_request.oneOf.0.\\items.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"label":{"type":"string","uniqueKey":"information_request.oneOf.0.\\items.items.[INDEX].label","typeLabel":"string"}},"uniqueKey":"information_request.oneOf.0.\\items.items.[INDEX]","typeLabel":"object"},"uniqueKey":"information_request.oneOf.0.\\items","typeLabel":"object[]"}},"uniqueKey":"information_request.oneOf.0","typeLabel":"object"},{"type":"null","description":"What the professionals need from the company, with the items to answer.","properties":{"id":{"type":"string","format":"uuid"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["document","question"]},"label":{"type":"string"}}}}},"uniqueKey":"information_request.oneOf.1","typeLabel":"null"}],"uniqueKey":"information_request","typeLabel":"object | null"},"messages":{"type":"array","items":{"type":"object","properties":{"author":{"type":"string","enum":["company","melso"],"uniqueKey":"messages.items.[INDEX].author","typeLabel":"enum\u003cstring>"},"content":{"type":"string","uniqueKey":"messages.items.[INDEX].content","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","uniqueKey":"messages.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"messages.items.[INDEX]","typeLabel":"object"},"uniqueKey":"messages","typeLabel":"object[]"},"documents":{"type":"array","description":"The professionals' drafts, the company's documents and the filing receipts.","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"documents.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"filename":{"type":"string","uniqueKey":"documents.items.[INDEX].filename","typeLabel":"string"},"content_type":{"type":"string","uniqueKey":"documents.items.[INDEX].content_type","typeLabel":"string"},"size_bytes":{"type":"integer","uniqueKey":"documents.items.[INDEX].size_bytes","typeLabel":"integer"},"url":{"type":"string","format":"uri","description":"A short-lived download URL.","uniqueKey":"documents.items.[INDEX].url","typeLabel":"string\u003curi>"}},"uniqueKey":"documents.items.[INDEX]","typeLabel":"object"},"uniqueKey":"documents","typeLabel":"object[]"},"external_reference":{"oneOf":[{"type":"string","description":"The administration's reference for what was filed. Always present once `done`.","uniqueKey":"external_reference.oneOf.0","typeLabel":"string"},{"type":"null","description":"The administration's reference for what was filed. Always present once `done`.","uniqueKey":"external_reference.oneOf.1","typeLabel":"null"}],"uniqueKey":"external_reference","typeLabel":"string | null"},"completed_on":{"oneOf":[{"type":"string","format":"date","uniqueKey":"completed_on.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","uniqueKey":"completed_on.oneOf.1","typeLabel":"null"}],"uniqueKey":"completed_on","typeLabel":"string\u003cdate> | null"},"updated_at":{"type":"string","format":"date-time","uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","kind":"modelo","status":"draft","created_at":"2023-11-07T05:31:56Z","deadline":"2023-12-25","current_version":123,"approved_version":123,"approvals":[{"version":123,"approver":{"name":"\u003cstring>","role":"owner","tax_id":"\u003cstring>"},"method":"melso","approved_at":"2023-11-07T05:31:56Z"}],"payment_url":"\u003cstring>","information_request":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","items":[{"id":"\u003cstring>","kind":"document","label":"\u003cstring>"}]},"messages":[{"author":"company","content":"\u003cstring>","created_at":"2023-11-07T05:31:56Z"}],"documents":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","filename":"\u003cstring>","content_type":"\u003cstring>","size_bytes":123,"url":"\u003cstring>"}],"external_reference":"\u003cstring>","completed_on":"2023-12-25","updated_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"6e357943-5b6c-4a9e-8c73-f68cf34e5b0f":{"description":"The request is malformed or a field is invalid. Unknown fields are refused.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, for a person to read.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to branch on, such as `invoicing_not_ready` or `version_conflict`.","uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when you contact Melso.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"lines[0].vat_rate must be 21, 10, 4 or 0","code":"invalid_invoice","request_id":"req_01JAB3K9X2"},"examples":{"Example":{"title":"Example","value":{"error":"lines[0].vat_rate must be 21, 10, 4 or 0","code":"invalid_invoice","request_id":"req_01JAB3K9X2"}}},"exampleType":"examples"}},"exampleType":"examples"},"9c59df00-51df-4f76-885d-61a48256004c":{"description":"The key is missing, revoked or invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, for a person to read.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to branch on, such as `invoicing_not_ready` or `version_conflict`.","uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when you contact Melso.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"invalid token","code":"unauthorized","request_id":"req_01JAB3K9X2"},"examples":{"Example":{"title":"Example","value":{"error":"invalid token","code":"unauthorized","request_id":"req_01JAB3K9X2"}}},"exampleType":"examples"}},"exampleType":"examples"},"be247cb5-8d37-42ed-9be8-558e0bfd1e1e":{"description":"The key cannot do this in this company, or the step needs a person.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, for a person to read.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to branch on, such as `invoicing_not_ready` or `version_conflict`.","uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when you contact Melso.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Review and approve in the authenticated web application","code":"person_required","request_id":"req_01JAB3K9X2"},"examples":{"Example":{"title":"Example","value":{"error":"Review and approve in the authenticated web application","code":"person_required","request_id":"req_01JAB3K9X2"}}},"exampleType":"examples"}},"exampleType":"examples"},"cc9489e9-5df2-40ca-b1cf-f2bcc0957182":{"description":"No such object in this company, or the company is not one of yours.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, for a person to read.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to branch on, such as `invoicing_not_ready` or `version_conflict`.","uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when you contact Melso.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"invoice not found","code":"not_found","request_id":"req_01JAB3K9X2"},"examples":{"Example":{"title":"Example","value":{"error":"invoice not found","code":"not_found","request_id":"req_01JAB3K9X2"}}},"exampleType":"examples"}},"exampleType":"examples"},"e9ad3573-291c-4835-bc28-aebff9da2330":{"description":"The object changed or is not in a state that allows this. Read it again and decide.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"What went wrong, for a person to read.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"A stable code to branch on, such as `invoicing_not_ready` or `version_conflict`.","uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","description":"Quote it when you contact Melso.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"The tax return changed or is not ready for approval","code":"version_conflict","request_id":"req_01JAB3K9X2"},"examples":{"Example":{"title":"Example","value":{"error":"The tax return changed or is not ready for approval","code":"version_conflict","request_id":"req_01JAB3K9X2"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"b8f96d16-f36e-4d4c-803f-899df97e21f5":{"partnerKey":{"type":"http","scheme":"bearer","description":"Your partner secret key, `mk_live_…` for real companies or `mk_test_…`\nfor test companies. Keep it on your servers. See\n[Authentication](/api/authentication).\n","scopes":[],"schemeName":"partnerKey"}}},"servers":{"e764a2e3-706a-4b6d-8c4d-5174c9aaaad3":{"url":"https://api.melso.ai/v1","description":"API. Keys and access are issued per partner."}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your partner secret key, `mk_live_…` for real companies or `mk_test_…`\nfor test companies. Keep it on your servers. See\n[Authentication](/api/authentication).\n","scopes":[],"schemeName":"partnerKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your partner secret key, `mk_live_…` for real companies or `mk_test_…`\nfor test companies. Keep it on your servers. See\n[Authentication](/api/authentication).\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"partnerKey","name":"Authorization"}],"title":"partnerKey"}]},"originalFileLocation":"api/openapi.yaml"},"subdomain":"melso","siteName":"Melso","title":"Aprobación de una gestión en tu producto — Attest a case approval from your interface - Melso","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api/reference/cases/attest-case-approval","matchLevel":0},"es":{"href":"/es/api-hacienda","matchLevel":4}}},"lastModified":"2026-10-31T17:57:34.973Z","originalFileLocation":"api/reference/cases/attest-case-approval.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Aprobación de una gestión en tu producto. Planned preview contract, not callable yet.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Melso\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/melso/ZyaT6es4tklDWaYK/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/melso/ZyaT6es4tklDWaYK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/melso/ZyaT6es4tklDWaYK/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/melso/ZyaT6es4tklDWaYK/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/melso/ZyaT6es4tklDWaYK/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/melso/ZyaT6es4tklDWaYK/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/melso/ZyaT6es4tklDWaYK/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/melso/ZyaT6es4tklDWaYK/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/melso/ZyaT6es4tklDWaYK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Aprobación de una gestión en tu producto — Attest a case approval from your interface - Melso\">\u003cmeta data-mint-head property=\"og:description\" content=\"Aprobación de una gestión en tu producto. Planned preview contract, not callable yet.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Melso Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.melso.ai/api/reference/cases/attest-case-approval\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.melso.ai/images/og/api-reference.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Aprobación de una gestión en tu producto — Attest a case approval from your interface - Melso\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Aprobación de una gestión en tu producto. Planned preview contract, not callable yet.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.melso.ai/images/og/api-reference.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/melso/ZyaT6es4tklDWaYK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Melso\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F04E42\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"og:locale:alternate\" content=\"es_ES\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#F04E42\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"Melso API reference: every operation with its request and response.\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.melso.ai/api/reference/cases/attest-case-approval\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/reference/cases/attest-case-approval.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://melso.ai/#organization\",\"name\":\"Melso\",\"url\":\"https://melso.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://docs.melso.ai/logo/light.svg\"},\"sameAs\":[\"https://melso.ai\",\"https://docs.melso.ai\",\"https://app.melso.ai\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.melso.ai#website\",\"name\":\"Melso\",\"url\":\"https://docs.melso.ai\",\"publisher\":{\"@id\":\"https://melso.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.melso.ai/api/reference/cases/attest-case-approval#webpage\",\"url\":\"https://docs.melso.ai/api/reference/cases/attest-case-approval\",\"name\":\"Aprobación de una gestión en tu producto — Attest a case approval from your interface\",\"description\":\"Aprobación de una gestión en tu producto. Planned preview contract, not callable yet.\",\"dateModified\":\"2026-10-31T17:57:34.973Z\",\"isPartOf\":{\"@id\":\"https://docs.melso.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.melso.ai/api/reference/cases/attest-case-approval#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.melso.ai/api/reference/cases/attest-case-approval#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Taxes\",\"item\":\"https://docs.melso.ai/api/reference/tax-calendar/get-tax-calendar\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Cases\",\"item\":\"https://docs.melso.ai/api/reference/cases/list-case-kinds\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Aprobación de una gestión en tu producto — Attest a case approval from your interface\",\"item\":\"https://docs.melso.ai/api/reference/cases/attest-case-approval\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.melso.ai/api/reference/cases/attest-case-approval#apireference\",\"headline\":\"Aprobación de una gestión en tu producto — Attest a case approval from your interface\",\"name\":\"Aprobación de una gestión en tu producto — Attest a case approval from your interface\",\"description\":\"Aprobación de una gestión en tu producto. Planned preview contract, not callable yet.\",\"url\":\"https://docs.melso.ai/api/reference/cases/attest-case-approval\",\"mainEntityOfPage\":{\"@id\":\"https://docs.melso.ai/api/reference/cases/attest-case-approval#webpage\"},\"image\":\"https://docs.melso.ai/images/og/api-reference.png\",\"dateModified\":\"2026-10-31T17:57:34.973Z\",\"publisher\":{\"@id\":\"https://melso.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.melso.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Melso\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Melso","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"API","groups":[{"group":"Get started","pages":[{"title":"API unificada AEAT, TGSS, SEPE, Verifactu y TicketBAI — Melso API","sidebarTitle":"Overview","href":"/api/overview"},{"title":"Quickstart del modelo 303 por API — Quickstart","sidebarTitle":"Quickstart","href":"/api/quickstart"},{"title":"Autenticación de la API partner — Authentication","sidebarTitle":"Authentication","href":"/api/authentication"},{"title":"OpenAPI público de la API Melso — OpenAPI document","sidebarTitle":"OpenAPI","href":"/api/openapi"},{"title":"Ejemplos de integración: 303, Verifactu y SL — Examples","sidebarTitle":"Examples","href":"/api/examples"},{"title":"API access and Pro pricing — Acceso y precios","sidebarTitle":"Access and pricing","href":"/api/access"},{"title":"Empresas, autónomos y mandatos AEAT — Companies","sidebarTitle":"Companies","href":"/api/companies"},{"title":"Aprobación y justificante de presentación — Approvals","sidebarTitle":"Approvals","href":"/api/approvals"},{"title":"Webhooks de la API Melso (planificado) — Webhooks","sidebarTitle":"Webhooks","href":"/api/webhooks"},{"title":"Convenciones de la API Melso — Conventions","sidebarTitle":"Conventions","href":"/api/conventions"},{"title":"Disponibilidad de la API — Availability","sidebarTitle":"Availability","href":"/api/availability"}]},{"group":"Solutions","pages":[{"title":"API nóminas, Sistema RED y SEPE — HR and payroll","sidebarTitle":"HR and payroll","href":"/api/solutions/hr-payroll"},{"title":"API fiscal para banca: modelo 303 — Business banking","sidebarTitle":"Business banking","href":"/api/solutions/business-banking"},{"title":"API Verifactu y modelo 303 para ERP — ERP and invoicing","sidebarTitle":"ERP and invoicing","href":"/api/solutions/erp-invoicing"}]},{"group":"Guides","pages":[{"title":"Alta de autónomo por API — Register an autónomo","sidebarTitle":"Register an autónomo","href":"/api/guides/register-autonomo"},{"title":"Constituir una SL por API — Incorporate an S.L.","sidebarTitle":"Incorporate an S.L.","href":"/api/guides/incorporate-sl"}]},{"group":"Companies and access","pages":[{"group":"Companies","pages":[{"title":"Listar empresas por API — List companies","sidebarTitle":"List companies","openapi":"api/openapi.yaml GET /companies","href":"/api/reference/companies/list-companies"},{"title":"API para crear una empresa o un autónomo — Create a company","sidebarTitle":"Create a company","openapi":"api/openapi.yaml POST /companies","href":"/api/reference/companies/create-company"},{"title":"Ficha de empresa por API — Get a company","sidebarTitle":"Get a company","openapi":"api/openapi.yaml GET /companies/{company_id}","href":"/api/reference/companies/get-company"},{"title":"Perfil fiscal AEAT por API — Get the fiscal profile","sidebarTitle":"Get the fiscal profile","openapi":"api/openapi.yaml GET /companies/{company_id}/fiscal-profile","href":"/api/reference/companies/get-fiscal-profile"},{"title":"Actualizar el perfil fiscal por API — Update the fiscal profile","sidebarTitle":"Update the fiscal profile","openapi":"api/openapi.yaml PATCH /companies/{company_id}/fiscal-profile","href":"/api/reference/companies/update-fiscal-profile"},{"title":"Onboarding fiscal por API — Create an onboarding link","sidebarTitle":"Create an onboarding link","openapi":"api/openapi.yaml POST /companies/{company_id}/onboarding-links","href":"/api/reference/companies/create-onboarding-link"}]},{"group":"Mandates","pages":[{"title":"Listar mandatos AEAT, TGSS y SEPE — List mandates","sidebarTitle":"List mandates","openapi":"api/openapi.yaml GET /companies/{company_id}/mandates","href":"/api/reference/mandates/list-mandates"},{"title":"Pedir un mandato AEAT, TGSS o SEPE — Request a mandate","sidebarTitle":"Request a mandate","openapi":"api/openapi.yaml POST /companies/{company_id}/mandates","href":"/api/reference/mandates/create-mandate"},{"title":"Consultar un mandato — Get a mandate","sidebarTitle":"Get a mandate","openapi":"api/openapi.yaml GET /companies/{company_id}/mandates/{mandate_id}","href":"/api/reference/mandates/get-mandate"},{"title":"Revocar un mandato — Revoke a mandate","sidebarTitle":"Revoke a mandate","openapi":"api/openapi.yaml POST /companies/{company_id}/mandates/{mandate_id}/revoke","href":"/api/reference/mandates/revoke-mandate"}]},{"group":"Webhook endpoints","pages":[{"title":"Webhooks de la API Melso — List webhook endpoints","sidebarTitle":"List webhook endpoints","openapi":"api/openapi.yaml GET /webhook-endpoints","href":"/api/reference/webhook-endpoints/list-webhook-endpoints"},{"title":"Webhooks de la API Melso — Create a webhook endpoint","sidebarTitle":"Create a webhook endpoint","openapi":"api/openapi.yaml POST /webhook-endpoints","href":"/api/reference/webhook-endpoints/create-webhook-endpoint"},{"title":"Webhooks de la API Melso — Replace a webhook endpoint","sidebarTitle":"Replace a webhook endpoint","openapi":"api/openapi.yaml PUT /webhook-endpoints/{endpoint_id}","href":"/api/reference/webhook-endpoints/update-webhook-endpoint"},{"title":"Webhooks de la API Melso — Delete a webhook endpoint","sidebarTitle":"Delete a webhook endpoint","openapi":"api/openapi.yaml DELETE /webhook-endpoints/{endpoint_id}","href":"/api/reference/webhook-endpoints/delete-webhook-endpoint"},{"title":"Webhooks de la API Melso — Rotate the signing secret","sidebarTitle":"Rotate the signing secret","openapi":"api/openapi.yaml POST /webhook-endpoints/signing-secret/rotate","href":"/api/reference/webhook-endpoints/rotate-webhook-signing-secret"},{"title":"Webhooks de la API Melso — List webhook deliveries","sidebarTitle":"List webhook deliveries","openapi":"api/openapi.yaml GET /webhook-deliveries","href":"/api/reference/webhook-endpoints/list-webhook-deliveries"},{"title":"Webhooks de la API Melso — Resend a delivery","sidebarTitle":"Resend a delivery","openapi":"api/openapi.yaml POST /webhook-deliveries/{delivery_id}/resend","href":"/api/reference/webhook-endpoints/resend-webhook-delivery"}]}]},{"group":"Invoicing","pages":[{"group":"Invoicing setup","pages":[{"title":"Estado Verifactu y TicketBAI — Get the invoicing status","sidebarTitle":"Get the invoicing status","openapi":"api/openapi.yaml GET /companies/{company_id}/invoicing","href":"/api/reference/invoicing-setup/get-invoicing-status"},{"title":"Alta como emisor Verifactu o TicketBAI — Register the company as an issuer","sidebarTitle":"Register the company as an issuer","openapi":"api/openapi.yaml POST /companies/{company_id}/invoicing/registration","href":"/api/reference/invoicing-setup/register-invoicing-issuer"}]},{"group":"Customers","pages":[{"title":"Listar clientes de facturación — List customers","sidebarTitle":"List customers","openapi":"api/openapi.yaml GET /companies/{company_id}/customers","href":"/api/reference/customers/list-customers"},{"title":"Crear o actualizar un cliente — Create or update a customer","sidebarTitle":"Create or update a customer","openapi":"api/openapi.yaml POST /companies/{company_id}/customers","href":"/api/reference/customers/upsert-customer"}]},{"group":"Invoices","pages":[{"title":"Listar facturas — List invoices","sidebarTitle":"List invoices","openapi":"api/openapi.yaml GET /companies/{company_id}/invoices","href":"/api/reference/invoices/list-invoices"},{"title":"Crear un borrador de factura — Create an invoice draft","sidebarTitle":"Create an invoice draft","openapi":"api/openapi.yaml POST /companies/{company_id}/invoices","href":"/api/reference/invoices/create-invoice"},{"title":"Consultar una factura — Get an invoice","sidebarTitle":"Get an invoice","openapi":"api/openapi.yaml GET /companies/{company_id}/invoices/{invoice_id}","href":"/api/reference/invoices/get-invoice"},{"title":"Sustituir un borrador de factura — Replace an invoice draft","sidebarTitle":"Replace an invoice draft","openapi":"api/openapi.yaml PATCH /companies/{company_id}/invoices/{invoice_id}","href":"/api/reference/invoices/replace-invoice-draft"},{"title":"PDF de una factura — Download the invoice PDF","sidebarTitle":"Download the invoice PDF","openapi":"api/openapi.yaml GET /companies/{company_id}/invoices/{invoice_id}/pdf","href":"/api/reference/invoices/get-invoice-pdf"},{"title":"Enlace para emitir una factura — Create an invoice approval link","sidebarTitle":"Create an invoice approval link","openapi":"api/openapi.yaml POST /companies/{company_id}/invoices/{invoice_id}/approval-link","href":"/api/reference/invoices/create-invoice-approval-link"},{"title":"Emitir factura Verifactu o TicketBAI — Issue an invoice","sidebarTitle":"Issue an invoice","openapi":"api/openapi.yaml POST /companies/{company_id}/invoices/{invoice_id}/issue","href":"/api/reference/invoices/issue-invoice"},{"title":"Enviar una factura — Send an invoice","sidebarTitle":"Send an invoice","openapi":"api/openapi.yaml POST /companies/{company_id}/invoices/{invoice_id}/send","href":"/api/reference/invoices/send-invoice"},{"title":"Factura rectificativa — Draft a corrective invoice","sidebarTitle":"Draft a corrective invoice","openapi":"api/openapi.yaml POST /companies/{company_id}/invoices/{invoice_id}/correct","href":"/api/reference/invoices/correct-invoice"},{"title":"Marcar una factura como cobrada — Mark an invoice as paid","sidebarTitle":"Mark an invoice as paid","openapi":"api/openapi.yaml POST /companies/{company_id}/invoices/{invoice_id}/mark-paid","href":"/api/reference/invoices/mark-invoice-paid"}]}]},{"group":"Bookkeeping","pages":[{"group":"Expenses","pages":[{"title":"Gastos (AEAT) — List expenses","sidebarTitle":"List expenses","openapi":"api/openapi.yaml GET /companies/{company_id}/expenses","href":"/api/reference/expenses/list-expenses"},{"title":"Gastos (AEAT) — Record an expense","sidebarTitle":"Record an expense","openapi":"api/openapi.yaml POST /companies/{company_id}/expenses","href":"/api/reference/expenses/create-expense"},{"title":"Gastos (AEAT) — Get an expense","sidebarTitle":"Get an expense","openapi":"api/openapi.yaml GET /companies/{company_id}/expenses/{expense_id}","href":"/api/reference/expenses/get-expense"},{"title":"Gastos (AEAT) — Update an expense","sidebarTitle":"Update an expense","openapi":"api/openapi.yaml PATCH /companies/{company_id}/expenses/{expense_id}","href":"/api/reference/expenses/update-expense"},{"title":"Gastos (AEAT) — Delete an expense","sidebarTitle":"Delete an expense","openapi":"api/openapi.yaml DELETE /companies/{company_id}/expenses/{expense_id}","href":"/api/reference/expenses/delete-expense"}]},{"group":"Income","pages":[{"title":"Ingresos (AEAT) — List income","sidebarTitle":"List income","openapi":"api/openapi.yaml GET /companies/{company_id}/income","href":"/api/reference/income/list-income"},{"title":"Ingresos (AEAT) — Record an income","sidebarTitle":"Record an income","openapi":"api/openapi.yaml POST /companies/{company_id}/income","href":"/api/reference/income/create-income"},{"title":"Ingresos (AEAT) — Get an income","sidebarTitle":"Get an income","openapi":"api/openapi.yaml GET /companies/{company_id}/income/{income_id}","href":"/api/reference/income/get-income"},{"title":"Ingresos (AEAT) — Replace an income","sidebarTitle":"Replace an income","openapi":"api/openapi.yaml PUT /companies/{company_id}/income/{income_id}","href":"/api/reference/income/replace-income"},{"title":"Ingresos (AEAT) — Delete an income","sidebarTitle":"Delete an income","openapi":"api/openapi.yaml DELETE /companies/{company_id}/income/{income_id}","href":"/api/reference/income/delete-income"}]},{"group":"Documents","pages":[{"title":"Documentos fiscales — List documents","sidebarTitle":"List documents","openapi":"api/openapi.yaml GET /companies/{company_id}/documents","href":"/api/reference/documents/list-documents"},{"title":"Documentos fiscales — Upload a document","sidebarTitle":"Upload a document","openapi":"api/openapi.yaml POST /companies/{company_id}/documents","href":"/api/reference/documents/upload-document"},{"title":"Documentos fiscales — Read a fiscal document","sidebarTitle":"Read a fiscal document","openapi":"api/openapi.yaml POST /companies/{company_id}/documents/extract","href":"/api/reference/documents/extract-fiscal-document"}]},{"group":"Banking","pages":[{"title":"Banca y conciliación — List bank accounts","sidebarTitle":"List bank accounts","openapi":"api/openapi.yaml GET /companies/{company_id}/bank-accounts","href":"/api/reference/banking/list-bank-accounts"},{"title":"Banca y conciliación — Connect a bank account","sidebarTitle":"Connect a bank account","openapi":"api/openapi.yaml POST /companies/{company_id}/bank-accounts","href":"/api/reference/banking/create-bank-account"},{"title":"Banca y conciliación — Push bank movements","sidebarTitle":"Push bank movements","openapi":"api/openapi.yaml POST /companies/{company_id}/bank-accounts/{bank_account_id}/movements","href":"/api/reference/banking/push-bank-movements"},{"title":"Banca y conciliación — List bank movements","sidebarTitle":"List bank movements","openapi":"api/openapi.yaml GET /companies/{company_id}/bank-movements","href":"/api/reference/banking/list-bank-movements"},{"title":"Banca y conciliación — Get a bank movement","sidebarTitle":"Get a bank movement","openapi":"api/openapi.yaml GET /companies/{company_id}/bank-movements/{bank_movement_id}","href":"/api/reference/banking/get-bank-movement"},{"title":"Banca y conciliación — Reconcile a bank movement","sidebarTitle":"Reconcile a bank movement","openapi":"api/openapi.yaml POST /companies/{company_id}/bank-movements/{bank_movement_id}/reconciliation","href":"/api/reference/banking/reconcile-bank-movement"},{"title":"Banca y conciliación — Undo a reconciliation","sidebarTitle":"Undo a reconciliation","openapi":"api/openapi.yaml DELETE /companies/{company_id}/bank-movements/{bank_movement_id}/reconciliation","href":"/api/reference/banking/undo-bank-reconciliation"},{"title":"Banca y conciliación — List bank statements","sidebarTitle":"List bank statements","openapi":"api/openapi.yaml GET /companies/{company_id}/bank-statements","href":"/api/reference/banking/list-bank-statements"},{"title":"Banca y conciliación — Save a bank statement","sidebarTitle":"Save a bank statement","openapi":"api/openapi.yaml POST /companies/{company_id}/bank-statements","href":"/api/reference/banking/save-bank-statement"},{"title":"Banca y conciliación — Read a bank statement","sidebarTitle":"Read a bank statement","openapi":"api/openapi.yaml POST /companies/{company_id}/bank-statements/read","href":"/api/reference/banking/read-bank-statement"}]},{"group":"Accounting","pages":[{"title":"Contabilidad — List journal entries","sidebarTitle":"List journal entries","openapi":"api/openapi.yaml GET /companies/{company_id}/journal-entries","href":"/api/reference/accounting/list-journal-entries"},{"title":"Contabilidad — List journal imports","sidebarTitle":"List journal imports","openapi":"api/openapi.yaml GET /companies/{company_id}/journal-imports","href":"/api/reference/accounting/list-journal-imports"},{"title":"Contabilidad — Import a journal","sidebarTitle":"Import a journal","openapi":"api/openapi.yaml POST /companies/{company_id}/journal-imports","href":"/api/reference/accounting/save-journal-import"},{"title":"Contabilidad — Read a journal file","sidebarTitle":"Read a journal file","openapi":"api/openapi.yaml POST /companies/{company_id}/journal-imports/read","href":"/api/reference/accounting/read-journal-import"},{"title":"Contabilidad — Delete a journal import","sidebarTitle":"Delete a journal import","openapi":"api/openapi.yaml DELETE /companies/{company_id}/journal-imports/{import_id}","href":"/api/reference/accounting/delete-journal-import"},{"title":"Contabilidad — List VAT book imports","sidebarTitle":"List VAT book imports","openapi":"api/openapi.yaml GET /companies/{company_id}/vat-book-imports","href":"/api/reference/accounting/list-vat-book-imports"},{"title":"Contabilidad — Import a VAT book","sidebarTitle":"Import a VAT book","openapi":"api/openapi.yaml POST /companies/{company_id}/vat-book-imports","href":"/api/reference/accounting/save-vat-book-import"},{"title":"Contabilidad — Read a VAT book file","sidebarTitle":"Read a VAT book file","openapi":"api/openapi.yaml POST /companies/{company_id}/vat-book-imports/read","href":"/api/reference/accounting/read-vat-book-import"},{"title":"Contabilidad — Delete a VAT book import","sidebarTitle":"Delete a VAT book import","openapi":"api/openapi.yaml DELETE /companies/{company_id}/vat-book-imports/{import_id}","href":"/api/reference/accounting/delete-vat-book-import"},{"title":"Contabilidad — Get the trial balance","sidebarTitle":"Get the trial balance","openapi":"api/openapi.yaml GET /companies/{company_id}/reports/trial-balance","href":"/api/reference/accounting/get-trial-balance"},{"title":"Contabilidad — Get the profit and loss account","sidebarTitle":"Get the profit and loss account","openapi":"api/openapi.yaml GET /companies/{company_id}/reports/profit-and-loss","href":"/api/reference/accounting/get-profit-and-loss"},{"title":"Contabilidad — Get the balance sheet","sidebarTitle":"Get the balance sheet","openapi":"api/openapi.yaml GET /companies/{company_id}/reports/balance-sheet","href":"/api/reference/accounting/get-balance-sheet"}]}]},{"group":"Taxes","pages":[{"group":"Tax calendar","pages":[{"title":"Calendario fiscal AEAT por API — Get the tax calendar","sidebarTitle":"Get the tax calendar","openapi":"api/openapi.yaml GET /companies/{company_id}/tax-calendar","href":"/api/reference/tax-calendar/get-tax-calendar"},{"title":"Marcar un modelo recordatorio como presentado — Mark a reminder form as filed","sidebarTitle":"Mark a reminder form as filed","openapi":"api/openapi.yaml POST /companies/{company_id}/tax-calendar/mark-filed","href":"/api/reference/tax-calendar/mark-obligation-filed"}]},{"group":"Tax returns","pages":[{"title":"Modelo 303 por API (AEAT) — List tax returns","sidebarTitle":"List tax returns","openapi":"api/openapi.yaml GET /companies/{company_id}/tax-returns","href":"/api/reference/tax-returns/list-tax-returns"},{"title":"Modelo 303: casillas y justificante — Get a tax return","sidebarTitle":"Get a tax return","openapi":"api/openapi.yaml GET /companies/{company_id}/tax-returns/{tax_return_id}","href":"/api/reference/tax-returns/get-tax-return"},{"title":"Fichero AEAT del modelo 303 — Download the AEAT import file","sidebarTitle":"Download the AEAT import file","openapi":"api/openapi.yaml GET /companies/{company_id}/tax-returns/{tax_return_id}/aeat-file","href":"/api/reference/tax-returns/get-tax-return-aeat-file"},{"title":"Aprobación del modelo 303 — Create a tax return approval link","sidebarTitle":"Create a tax return approval link","openapi":"api/openapi.yaml POST /companies/{company_id}/tax-returns/{tax_return_id}/approval-link","href":"/api/reference/tax-returns/create-tax-return-approval-link"},{"title":"Autorizar el modelo 303 — Approve a tax return","sidebarTitle":"Approve a tax return","openapi":"api/openapi.yaml POST /companies/{company_id}/tax-returns/{tax_return_id}/approve","href":"/api/reference/tax-returns/approve-tax-return"},{"title":"Aprobar el modelo 303 en tu producto — Attest an approval from your interface","sidebarTitle":"Attest an approval from your interface","openapi":"api/openapi.yaml POST /companies/{company_id}/tax-returns/{tax_return_id}/attested-approvals","href":"/api/reference/tax-returns/attest-tax-return-approval"},{"title":"Marcar un modelo presentado por la empresa — Mark a return as filed by the company","sidebarTitle":"Mark a return as filed by the company","openapi":"api/openapi.yaml POST /companies/{company_id}/tax-returns/{tax_return_id}/mark-filed","href":"/api/reference/tax-returns/mark-tax-return-filed"},{"title":"Importar un 303 o 130 ya presentado — Record a return filed elsewhere","sidebarTitle":"Record a return filed elsewhere","openapi":"api/openapi.yaml POST /companies/{company_id}/tax-returns/imports","href":"/api/reference/tax-returns/import-filed-tax-return"}]},{"group":"Corporate tax","pages":[{"title":"Modelo 200 por API — Get the corporate tax","sidebarTitle":"Get the corporate tax","openapi":"api/openapi.yaml GET /companies/{company_id}/corporate-tax/{year}","href":"/api/reference/corporate-tax/get-corporate-tax"},{"title":"Datos del modelo 200 — Save the corporate tax inputs","sidebarTitle":"Save the corporate tax inputs","openapi":"api/openapi.yaml PUT /companies/{company_id}/corporate-tax/{year}","href":"/api/reference/corporate-tax/save-corporate-tax-inputs"}]},{"group":"Tax estimates","pages":[{"title":"Estimación para reservar impuestos — Get the tax set-aside estimate","sidebarTitle":"Get the tax set-aside estimate","openapi":"api/openapi.yaml GET /companies/{company_id}/tax-estimates","href":"/api/reference/tax-estimates/get-tax-estimate"}]},{"group":"Cases","pages":[{"title":"Tipos de gestión: alta, renta y SL — List case kinds","sidebarTitle":"List case kinds","openapi":"api/openapi.yaml GET /companies/{company_id}/case-kinds","href":"/api/reference/cases/list-case-kinds"},{"title":"Listar gestiones — List cases","sidebarTitle":"List cases","openapi":"api/openapi.yaml GET /companies/{company_id}/cases","href":"/api/reference/cases/list-cases"},{"title":"API para constituir una SL o el alta de autónomo — Open a case","sidebarTitle":"Open a case","openapi":"api/openapi.yaml POST /companies/{company_id}/cases","href":"/api/reference/cases/create-case"},{"title":"Consultar una gestión y su justificante — Get a case","sidebarTitle":"Get a case","openapi":"api/openapi.yaml GET /companies/{company_id}/cases/{case_id}","href":"/api/reference/cases/get-case"},{"title":"Enviar una gestión a los profesionales — Submit a case","sidebarTitle":"Submit a case","openapi":"api/openapi.yaml POST /companies/{company_id}/cases/{case_id}/submit","href":"/api/reference/cases/submit-case"},{"title":"Mensaje en una gestión — Add a message to a case","sidebarTitle":"Add a message to a case","openapi":"api/openapi.yaml POST /companies/{company_id}/cases/{case_id}/messages","href":"/api/reference/cases/add-case-message"},{"title":"Responder un requerimiento — Answer an information request","sidebarTitle":"Answer an information request","openapi":"api/openapi.yaml POST /companies/{company_id}/cases/{case_id}/answers","href":"/api/reference/cases/answer-case-request"},{"title":"Aprobación de una gestión — Create a case approval link","sidebarTitle":"Create a case approval link","openapi":"api/openapi.yaml POST /companies/{company_id}/cases/{case_id}/approval-link","href":"/api/reference/cases/create-case-approval-link"},{"title":"Aprobar el borrador de una gestión — Approve a case draft","sidebarTitle":"Approve a case draft","description":"Aprobar el borrador de una gestión. Live in the app; partner REST is private beta.","openapi":"api/openapi.yaml POST /companies/{company_id}/cases/{case_id}/approve","href":"/api/reference/cases/approve-case"},{"title":"Aprobación de una gestión en tu producto — Attest a case approval from your interface","sidebarTitle":"Attest a case approval from your interface","openapi":"api/openapi.yaml POST /companies/{company_id}/cases/{case_id}/attested-approvals","href":"/api/reference/cases/attest-case-approval"},{"title":"Cancelar una gestión — Cancel a case","sidebarTitle":"Cancel a case","description":"Cancelar una gestión. Live in the app; partner REST is private beta. Withdraws a case Melso has not filed.","openapi":"api/openapi.yaml POST /companies/{company_id}/cases/{case_id}/cancel","href":"/api/reference/cases/cancel-case"}]},{"group":"Administration notifications","pages":[{"title":"Notificaciones de Hacienda, TGSS y DGT — List administration notifications","sidebarTitle":"List administration notifications","openapi":"api/openapi.yaml GET /companies/{company_id}/notifications","href":"/api/reference/administration-notifications/list-administration-notifications"},{"title":"Leer una notificación de la administración — Get an administration notification","sidebarTitle":"Get an administration notification","openapi":"api/openapi.yaml GET /companies/{company_id}/notifications/{notification_id}","href":"/api/reference/administration-notifications/get-administration-notification"}]},{"group":"Certificates","pages":[{"title":"Certificado de estar al corriente (AEAT o TGSS) — Request a certificate","sidebarTitle":"Request a certificate","openapi":"api/openapi.yaml POST /companies/{company_id}/certificates","href":"/api/reference/certificates/request-certificate"},{"title":"Consultar un certificado — Get a certificate","sidebarTitle":"Get a certificate","openapi":"api/openapi.yaml GET /companies/{company_id}/certificates/{certificate_id}","href":"/api/reference/certificates/get-certificate"}]}]},{"group":"Payroll and Social Security","pages":[{"group":"Employees","pages":[{"title":"Listar empleados — List employees","sidebarTitle":"List employees","openapi":"api/openapi.yaml GET /companies/{company_id}/employees","href":"/api/reference/employees/list-employees"},{"title":"Alta de empleado por API — Add an employee","sidebarTitle":"Add an employee","openapi":"api/openapi.yaml POST /companies/{company_id}/employees","href":"/api/reference/employees/create-employee"},{"title":"Actualizar un empleado — Update an employee","sidebarTitle":"Update an employee","openapi":"api/openapi.yaml PATCH /companies/{company_id}/employees/{employee_id}","href":"/api/reference/employees/update-employee"},{"title":"Historial de un empleado — List an employee's changes","sidebarTitle":"List an employee's changes","openapi":"api/openapi.yaml GET /companies/{company_id}/employees/{employee_id}/changes","href":"/api/reference/employees/list-employee-changes"},{"title":"Certificado de retenciones del trabajador — Get an employee's withholding certificate","sidebarTitle":"Get an employee's withholding certificate","openapi":"api/openapi.yaml GET /companies/{company_id}/employees/{employee_id}/withholding-certificates/{year}","href":"/api/reference/employees/get-withholding-certificate"}]},{"group":"Payroll runs","pages":[{"title":"Listar nóminas — List payroll runs","sidebarTitle":"List payroll runs","openapi":"api/openapi.yaml GET /companies/{company_id}/payroll-runs","href":"/api/reference/payroll-runs/list-payroll-runs"},{"title":"Enviar una nómina (modelo 111 y 190) — Submit a payroll run","sidebarTitle":"Submit a payroll run","openapi":"api/openapi.yaml POST /companies/{company_id}/payroll-runs","href":"/api/reference/payroll-runs/create-payroll-run"},{"title":"Consultar una nómina — Get a payroll run","sidebarTitle":"Get a payroll run","openapi":"api/openapi.yaml GET /companies/{company_id}/payroll-runs/{payroll_run_id}","href":"/api/reference/payroll-runs/get-payroll-run"}]},{"group":"Social Security","pages":[{"title":"Altas, bajas y variaciones en el TGSS — List affiliation requests","sidebarTitle":"List affiliation requests","openapi":"api/openapi.yaml GET /companies/{company_id}/social-security/affiliations","href":"/api/reference/social-security/list-affiliations"},{"title":"Alta en el Sistema RED por API — Request an alta, baja or variación","sidebarTitle":"Request an alta, baja or variación","openapi":"api/openapi.yaml POST /companies/{company_id}/social-security/affiliations","href":"/api/reference/social-security/create-affiliation"},{"title":"Estado de un alta, baja o variación — Get an affiliation request","sidebarTitle":"Get an affiliation request","openapi":"api/openapi.yaml GET /companies/{company_id}/social-security/affiliations/{affiliation_id}","href":"/api/reference/social-security/get-affiliation"},{"title":"Liquidaciones de cotización TGSS — List contribution settlements","sidebarTitle":"List contribution settlements","openapi":"api/openapi.yaml GET /companies/{company_id}/social-security/settlements","href":"/api/reference/social-security/list-contribution-settlements"},{"title":"RNT y RLC de una liquidación — Get a contribution settlement","sidebarTitle":"Get a contribution settlement","openapi":"api/openapi.yaml GET /companies/{company_id}/social-security/settlements/{settlement_id}","href":"/api/reference/social-security/get-contribution-settlement"}]},{"group":"Employment notifications","pages":[{"title":"Contrat@ del SEPE por API — Notify a contract (Contrat@)","sidebarTitle":"Notify a contract (Contrat@)","openapi":"api/openapi.yaml POST /companies/{company_id}/employment/contracts","href":"/api/reference/employment-notifications/notify-contract"},{"title":"Certific@2 del SEPE por API — Send a company certificate (Certific@2)","sidebarTitle":"Send a company certificate (Certific@2)","openapi":"api/openapi.yaml POST /companies/{company_id}/employment/certificates","href":"/api/reference/employment-notifications/send-company-certificate"},{"title":"Estado de un aviso al SEPE — Get an employment notification","sidebarTitle":"Get an employment notification","openapi":"api/openapi.yaml GET /companies/{company_id}/employment/notifications/{notification_id}","href":"/api/reference/employment-notifications/get-employment-notification"}]}]}]}]},{"language":"es","pages":[{"title":"es","href":"/es/api-hacienda"}]}]},"basePath":"","title":"Aprobación de una gestión en tu producto — Attest a case approval from your interface - Melso","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}