{"openapi":"3.1.0","info":{"title":"Spain Verifactu Readiness Guide API","version":"0.1.0","description":"Spain Verifactu Readiness Guide answers the questions a small business (or the agent working for it) asks about Spain's regulation of invoicing software, the Reglamento de los sistemas informáticos de facturación (SIF) of Real Decreto 1007/2023 and its VERI*FACTU mode. It gives the dated timeline with the status of every milestone on a chosen date, the deadline that applies to a taxpayer type...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://es-verifactu-guide.connectorbay.com/mcp.\n\nDisclaimer: General information only, not legal, tax, accounting or payment advice. Spain Verifactu Readiness Guide is an independent tool: it is not affiliated with, endorsed by or operated by any government body, central bank, standards body or scheme operator. Rates, thresholds and rules change; check the cited official source and confirm with a qualified professional before you rely on a result.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/es-verifactu-guide/docs"},"termsOfService":"https://connectorbay.com/es-verifactu-guide/terms"},"servers":[{"url":"https://es-verifactu-guide.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/es-verifactu-guide/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_verifactu_timeline":{"post":{"operationId":"get_verifactu_timeline","summary":"Dated milestones of Spain's billing-software regime with the status of each on a chosen date and the next deadline. Use ","description":"Dated milestones of Spain's billing-software regime with the status of each on a chosen date and the next deadline. Use for \"What changed with the Verifactu deadlines and what is the next milestone?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date to evaluate, YYYY-MM-DD; today (UTC) when left out. The answer says which date it used.","title":"On Date"}},"title":"get_verifactu_timelineArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/which_deadline_applies":{"post":{"operationId":"which_deadline_applies","summary":"The deadline that applies to a taxpayer type on a date, the instrument that set it, the days left and the superseded ear","description":"The deadline that applies to a taxpayer type on a date, the instrument that set it, the days left and the superseded earlier dates. Use for \"My company files corporate income tax in Spain: by when must its invoicing software comply with Verifactu?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"taxpayer_type":{"description":"corporate_income_tax_filer (an entity that files the Impuesto sobre Sociedades return), other_obligated_taxpayer (any other taxpayer within the regulation) or not_sure (both answers are given)","title":"Taxpayer Type","type":"string"},"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date to evaluate, YYYY-MM-DD, from 2025-04-03; today (UTC) when left out","title":"On Date"}},"required":["taxpayer_type"],"title":"which_deadline_appliesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/explain_modes":{"post":{"operationId":"explain_modes","summary":"The two valid modes, VERI*FACTU and NO VERI*FACTU, with the tax agency's own Spanish sentences, the QR code rule and the","description":"The two valid modes, VERI*FACTU and NO VERI*FACTU, with the tax agency's own Spanish sentences, the QR code rule and the security elements. Use for \"What is the difference between VERI*FACTU and NO VERI*FACTU mode?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"explain_modesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/software_readiness_checklist":{"post":{"operationId":"software_readiness_checklist","summary":"Questions to put to an invoicing-software vendor, each with the sentence of the AEAT page or the Real Decreto it rests o","description":"Questions to put to an invoicing-software vendor, each with the sentence of the AEAT page or the Real Decreto it rests on. Use for \"Give me the questions to ask my invoicing software vendor about Verifactu readiness\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"mode":{"default":"both","description":"verifactu, no_verifactu or both (all questions); default both","title":"Mode","type":"string"}},"title":"software_readiness_checklistArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/legal_basis_links":{"post":{"operationId":"legal_basis_links","summary":"The legal instruments of the regime with date, BOE identifier, link, role and how well each was confirmed. Use for \"Whic","description":"The legal instruments of the regime with date, BOE identifier, link, role and how well each was confirmed. Use for \"Which decrees and orders form the legal basis of Verifactu and where do I read them?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"legal_basis_linksArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}