{"openapi":"3.1.0","info":{"title":"SLT-INVOICE API","version":"0.1.0-prototype","description":"API-first invoicing service. The KSeF adapter is not connected in the prototype release."},"servers":[{"url":"/","description":"Current environment"}],"tags":[{"name":"System"},{"name":"Catalog"},{"name":"Validation"},{"name":"Administration"},{"name":"Invoices"},{"name":"Operations"}],"paths":{"/v1/health":{"get":{"tags":["System"],"summary":"Service health","responses":{"200":{"description":"Service is available"}}}},"/v1/meta":{"get":{"tags":["System"],"summary":"Environment and integration status","responses":{"200":{"description":"Environment metadata"}}}},"/v1/openapi.json":{"get":{"tags":["System"],"summary":"OpenAPI document","responses":{"200":{"description":"OpenAPI 3.1 specification"}}}},"/v1/capabilities":{"get":{"tags":["Catalog"],"summary":"Implementation map researched against KSeF 2.0 and common invoicing flows","responses":{"200":{"description":"Capability groups and implementation states"}}}},"/v1/invoices/validate":{"post":{"tags":["Validation"],"summary":"Validate a draft without saving it","requestBody":{"required":true},"responses":{"200":{"description":"Valid invoice draft"},"422":{"description":"Validation error"}}}},"/v1/session":{"get":{"tags":["Administration"],"summary":"Validate a Google session and MASTER_ADMIN role","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Authorized admin session"}}}},"/v1/admin/summary":{"get":{"tags":["Administration"],"summary":"Operational API metrics","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Integration, request and IP summary"}}}},"/v1/admin/access-requests":{"get":{"tags":["Administration"],"summary":"List API access requests","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Access requests"}}},"post":{"tags":["Administration"],"summary":"Create a manual, free or purchase-originated access request","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"Request created"}}}},"/v1/admin/access-requests/{requestId}/approve":{"post":{"tags":["Administration"],"summary":"Approve access and issue an API key once","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"API client activated"}}}},"/v1/admin/clients":{"get":{"tags":["Administration"],"summary":"List API integrations and their activity","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"API clients"}}}},"/v1/admin/activity":{"get":{"tags":["Administration"],"summary":"List recent authorized requests and source IPs","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"API activity"}}}},"/v1/invoices":{"post":{"tags":["Invoices"],"summary":"Create an idempotent invoice draft","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Draft created"},"401":{"description":"Authentication required"}}}},"/v1/invoices/{invoiceId}":{"get":{"tags":["Invoices"],"summary":"Read an invoice","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"responses":{"200":{"description":"Invoice"},"404":{"description":"Invoice not found"}}}},"/v1/invoices/{invoiceId}/issue":{"post":{"tags":["Invoices"],"summary":"Freeze and queue an invoice for KSeF","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"responses":{"202":{"description":"Operation queued"},"409":{"description":"Invalid invoice state"}}}},"/v1/invoices/{invoiceId}/corrections":{"post":{"tags":["Invoices"],"summary":"Create a correction draft","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"responses":{"201":{"description":"Correction draft created"}}}},"/v1/operations/{operationId}":{"get":{"tags":["Operations"],"summary":"Read asynchronous operation status","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"responses":{"200":{"description":"Operation"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Firebase ID token"},"apiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}