Document types
| Document | When | Tax |
|---|---|---|
| Receipt | every top-up (card or bank transfer) | no tax; a top-up is not a service yet |
| Invoice (dedicated) | the first month at order time, then every 30-day renewal; the setup fee on quoted orders is a separate line | 20% VAT included for accounts in Türkiye; no VAT for accounts abroad |
| Invoice (cloud usage statement) | at the start of each month, last month's hourly usage as one line per server | same rule |
Document numbers have the form DN-YYYY-000001 and increase within the year. Documents are issued at the moment of payment, so all of them are in the "paid" state.
Document details
A document carries the organization's legal name, address, country and, if present, the tax number and tax office. You enter these during verification (company step) and on the account page; later documents use the updated details, an issued document does not change.
Opening and downloading the PDF
- Click the document on the Billing page; the document page shows the lines, the tax breakdown and the status.
- PDF opens the document in the browser, Download saves it as a file. The file name is the document number (
DN-2026-000012.pdf). - The address has the form
/api/invoices/<document-id>/pdf;?download=1downloads,?lang=enor?lang=trpicks the language of the local PDF. Only a signed-in member of the organization the document belongs to can open it.
e-Invoice and e-Archive
Under Turkish regulations the official document is issued through an e-document integrator (Paraşüt):
- If the recipient is a registered e-Invoice taxpayer an e-Invoice is issued, otherwise an e-Archive invoice; the type is determined automatically from the tax number.
- Service invoices are queued after issue and created at the integrator; the status on the document page goes Pending → Issued and the official number appears. If it fails, our team sees it and retries.
- Once the official document exists, its PDF replaces the local copy; the same PDF button now opens the official document. You receive a notification and an email.
- No e-document is created for receipts (top-ups).
- While the integration is off, documents are served as local PDFs only and the status shows Skipped.
FAQ
- I want invoices in my company's name: set the account type to company and enter the legal name, tax number and tax office; later documents are issued accordingly.
- Correcting an old invoice: an issued document cannot be edited; open a cancellation/refund request through support.
- Bulk download for accounting: documents are downloaded one by one for now; listing through the API is planned.
- Why is there no VAT? No VAT applies to accounts abroad; for accounts in Türkiye the amount includes VAT and the breakdown is shown on the document.