{"openapi":"3.1.0","info":{"title":"QuoAPI – E-Invoice API","version":"1.3.0","description":"Canonical QuoAPI public API contract. Provider details and internal routes are intentionally excluded."},"servers":[{"url":"https://api.quoapi.com"}],"tags":[{"name":"einvoice-api","description":"Send, receive and validate electronic invoices and process status events."}],"paths":{"/v1/einvoice/send":{"post":{"operationId":"einvoice_send","summary":"Send e-invoice","description":"Send a structured e-invoice through the configured network.","tags":["einvoice-api"],"security":[{"BearerAuth":["einvoice.send"]}],"x-quoapi-capability":"einvoice.send","x-quoapi-contract-version":"1.3.0:einvoice.send","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"country":{"type":"string","x-quoapi-widget":"country","title":"Country","default":"DE","x-quoapi-format":"iso-3166-1-alpha-2"},"document":{"type":"string","x-quoapi-widget":"file","title":"Document","format":"binary"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","x-quoapi-widget":"currency","x-quoapi-hidden":true,"description":"Optional ISO 4217 commercial context."}},"additionalProperties":false,"required":["country","document"]},"example":{"country":"DE"}}}},"responses":{"200":{"description":"Canonical response","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true,"description":"Canonical QuoAPI response data for this capability."},"request_id":{"type":"string"}}}}}},"4XX":{"description":"Canonical client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Canonical service error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/einvoice/receive":{"post":{"operationId":"einvoice_receive","summary":"Receive e-invoice","description":"List or retrieve received e-invoices.","tags":["einvoice-api"],"security":[{"BearerAuth":["einvoice.receive"]}],"x-quoapi-capability":"einvoice.receive","x-quoapi-contract-version":"1.3.0:einvoice.receive","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reference":{"type":"string","x-quoapi-widget":"text","title":"Reference","default":"einv_demo_001"},"country":{"type":"string","pattern":"^[A-Z]{2}$","x-quoapi-widget":"country","x-quoapi-hidden":true,"description":"Optional ISO 3166-1 alpha-2 routing context."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","x-quoapi-widget":"currency","x-quoapi-hidden":true,"description":"Optional ISO 4217 commercial context."}},"additionalProperties":false,"required":["reference"]},"example":{"reference":"einv_demo_001"}}}},"responses":{"200":{"description":"Canonical response","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true,"description":"Canonical QuoAPI response data for this capability."},"request_id":{"type":"string"}}}}}},"4XX":{"description":"Canonical client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Canonical service error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/einvoice/status":{"post":{"operationId":"einvoice_status","summary":"Invoice status","description":"Check network processing status.","tags":["einvoice-api"],"security":[{"BearerAuth":["einvoice.status"]}],"x-quoapi-capability":"einvoice.status","x-quoapi-contract-version":"1.3.0:einvoice.status","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reference":{"type":"string","x-quoapi-widget":"text","title":"Reference","default":"einv_demo_001"},"country":{"type":"string","pattern":"^[A-Z]{2}$","x-quoapi-widget":"country","x-quoapi-hidden":true,"description":"Optional ISO 3166-1 alpha-2 routing context."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","x-quoapi-widget":"currency","x-quoapi-hidden":true,"description":"Optional ISO 4217 commercial context."}},"additionalProperties":false,"required":["reference"]},"example":{"reference":"einv_demo_001"}}}},"responses":{"200":{"description":"Canonical response","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true,"description":"Canonical QuoAPI response data for this capability."},"request_id":{"type":"string"}}}}}},"4XX":{"description":"Canonical client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Canonical service error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/einvoice/download":{"post":{"operationId":"einvoice_download","summary":"Download invoice","description":"Retrieve the normalized document.","tags":["einvoice-api"],"security":[{"BearerAuth":["einvoice.download"]}],"x-quoapi-capability":"einvoice.download","x-quoapi-contract-version":"1.3.0:einvoice.download","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reference":{"type":"string","x-quoapi-widget":"text","title":"Reference","default":"einv_demo_001"},"country":{"type":"string","pattern":"^[A-Z]{2}$","x-quoapi-widget":"country","x-quoapi-hidden":true,"description":"Optional ISO 3166-1 alpha-2 routing context."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","x-quoapi-widget":"currency","x-quoapi-hidden":true,"description":"Optional ISO 4217 commercial context."}},"additionalProperties":false,"required":["reference"]},"example":{"reference":"einv_demo_001"}}}},"responses":{"200":{"description":"Canonical response","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true,"description":"Canonical QuoAPI response data for this capability."},"request_id":{"type":"string"}}}}}},"4XX":{"description":"Canonical client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Canonical service error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/einvoice/webhook":{"post":{"operationId":"einvoice_webhook","summary":"E-invoice webhook","description":"Inspect normalized webhook event examples.","tags":["einvoice-api"],"security":[{"BearerAuth":["einvoice.webhook"]}],"x-quoapi-capability":"einvoice.webhook","x-quoapi-contract-version":"1.3.0:einvoice.webhook","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"string","x-quoapi-widget":"select","title":"Event","default":"invoice.accepted","enum":["demo.event"]},"country":{"type":"string","pattern":"^[A-Z]{2}$","x-quoapi-widget":"country","x-quoapi-hidden":true,"description":"Optional ISO 3166-1 alpha-2 routing context."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","x-quoapi-widget":"currency","x-quoapi-hidden":true,"description":"Optional ISO 4217 commercial context."}},"additionalProperties":false,"required":["event"]},"example":{"event":"invoice.accepted"}}}},"responses":{"200":{"description":"Canonical response","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true,"description":"Canonical QuoAPI response data for this capability."},"request_id":{"type":"string"}}}}}},"4XX":{"description":"Canonical client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Canonical service error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"QuoAPI API key"}},"schemas":{"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id","details"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}}