{"openapi":"3.0.0","paths":{"/v1/invoices":{"post":{"operationId":"InvoicesController_create_v1","parameters":[{"name":"Idempotency-Key","in":"header","description":"Safe retries: the same key with the same body answers from the first call for 24 h.","required":false,"schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"Create a draft invoice or credit note (canonical JSON)","tags":["invoices"]},"get":{"operationId":"InvoicesController_list_v1","parameters":[{"name":"Idempotency-Key","in":"header","description":"Safe retries: the same key with the same body answers from the first call for 24 h.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"List invoices (status, issued date range, cursor)","tags":["invoices"]}},"/v1/invoices/{id}":{"get":{"operationId":"InvoicesController_get_v1","parameters":[{"name":"Idempotency-Key","in":"header","description":"Safe retries: the same key with the same body answers from the first call for 24 h.","required":false,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"One invoice with its lifecycle status","tags":["invoices"]}},"/v1/invoices/{id}/submit":{"post":{"operationId":"InvoicesController_submit_v1","parameters":[{"name":"Idempotency-Key","in":"header","description":"Safe retries: the same key with the same body answers from the first call for 24 h.","required":false,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"Validate, approve and send (Peppol) or register (India IRP) in one call","tags":["invoices"]}},"/v1/invoices/{id}/status":{"get":{"operationId":"InvoicesController_status_v1","parameters":[{"name":"Idempotency-Key","in":"header","description":"Safe retries: the same key with the same body answers from the first call for 24 h.","required":false,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"Lifecycle status: validation, network, MLS, tax authority / IRN","tags":["invoices"]}},"/v1/invoices/{id}/document":{"get":{"operationId":"InvoicesController_document_v1","parameters":[{"name":"Idempotency-Key","in":"header","description":"Safe retries: the same key with the same body answers from the first call for 24 h.","required":false,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"The frozen document: UBL XML (Peppol countries) or INV-01 JSON (India)","tags":["invoices"]}},"/v1/invoices/{id}/cancel":{"post":{"operationId":"InvoicesController_cancel_v1","parameters":[{"name":"Idempotency-Key","in":"header","description":"Safe retries: the same key with the same body answers from the first call for 24 h.","required":false,"schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"Cancel: a draft/approved invoice, or a cleared Indian invoice at the IRP within 24 h","tags":["invoices"]}},"/v1/invoices/{id}/credit-note":{"post":{"operationId":"CreditNotesController_raise_v1","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"Raise a credit note against an approved or delivered invoice (all lines, or the lines given)","tags":["credit-notes"]}},"/v1/received-invoices":{"get":{"operationId":"ReceivedInvoicesController_list_v1","parameters":[],"responses":{"200":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"List received invoices and credit notes (AP), newest first","tags":["received-invoices"]}},"/v1/received-invoices/{id}":{"get":{"operationId":"ReceivedInvoicesController_get_v1","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"One received document with its business content and status","tags":["received-invoices"]}},"/v1/received-invoices/{id}/accept":{"post":{"operationId":"ReceivedInvoicesController_accept_v1","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"Accept a received document (issues the positive MLS to the sender)","tags":["received-invoices"]}},"/v1/received-invoices/{id}/reject":{"post":{"operationId":"ReceivedInvoicesController_reject_v1","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"Reject a received document with a reason (issues the negative MLS)","tags":["received-invoices"]}},"/v1/reports/transactions":{"get":{"operationId":"ReportsController_transactions_v1","parameters":[],"responses":{"200":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"Every e-invoice lifecycle: validation, Peppol, MLS, tax-authority status (range, direction, statuses, q, page, pageSize, sort)","tags":["reports"]}},"/v1/reports/tax-data":{"get":{"operationId":"ReportsController_taxData_v1","parameters":[],"responses":{"200":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"Tax-data documents handed to the authority (FTA / OTA)","tags":["reports"]}},"/v1/reports/peppol":{"get":{"operationId":"ReportsController_peppol_v1","parameters":[],"responses":{"200":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"Peppol exchange: discovery, submission, AS4 delivery, response","tags":["reports"]}},"/v1/reports/mls":{"get":{"operationId":"ReportsController_mls_v1","parameters":[],"responses":{"200":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"Message level statuses, both directions","tags":["reports"]}},"/v1/reports/failures":{"get":{"operationId":"ReportsController_failures_v1","parameters":[],"responses":{"200":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"Failed transactions with error codes and retry state","tags":["reports"]}},"/v1/reports/dashboard":{"get":{"operationId":"ReportsController_dashboard_v1","parameters":[],"responses":{"200":{"description":""}},"security":[{"apiKey":[]},{"bearer":[]}],"summary":"The ASP dashboard counts for a period","tags":["reports"]}}},"info":{"title":"OneInvoice Integration API","description":"One host for every country. The country comes from your credential's tenant; country-specific fields (TRN / VATIN / GSTIN, HSN, channel, IRN) ride on the same resources.","version":"1","contact":{}},"tags":[],"servers":[{"url":"https://api.oneinvoice.com"}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"},"apiKey":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Created on the portal: Administration → Integration"}},"schemas":{}}}