Formalisation and invoice screens
Formalise invoices manually or automatically, and follow the document status on the admin and client invoice pages.
Manual formalisation
When Official Status → Official is selected on the invoice edit screen, the add-on shows two options:
- Issue with e-Logo (e-Invoice / e-Archive): the default. When you save, the invoice is sent to e-Logo; if the buyer is registered, an e-Invoice (e-Fatura) is issued, otherwise an e-Archive (e-Arşiv) invoice, and the official PDF is attached to the invoice automatically.
- I will upload the PDF myself: e-Logo is not used. If you issued the invoice elsewhere, add the official PDF through WISECP’s upload field.
Automatic formalisation
When Formalize Invoices → Automatically is selected, paid invoices are queued when the Automatic Formalization Day arrives (0–7 days after payment; at most 7 days under the Tax Procedure Law).
The moment you switch to automatic mode and save is recorded as Automatic Since: only invoices paid after that moment are formalised automatically and past invoices are left alone; you can formalise earlier invoices manually. Invoices paid with the methods you select under Excluded Payment Methods are not formalised automatically.
Document type and invoice type
| Buyer | Document | Note |
|---|---|---|
| Registered for e-Invoice with the Revenue Administration (GİB) | e-Invoice | The scenario from the settings (Basic / Commercial) is used. |
| Not registered for e-Invoice | e-Archive | Individual customers and unregistered companies. |
| Customer abroad | e-Archive · exemption (İSTİSNA) | VKN 2222222222, 0% VAT, the export exemption code from the settings (302). |
e-Logo assigns the invoice number and prefix. On foreign-currency invoices, the CBRT foreign exchange buying rate and TL equivalents are written on the document. A corporate customer’s tax number must be a 10-digit tax number (VKN) or an 11-digit national ID number (TCKN).
Admin invoice card
On the admin invoice page, a single-line card shows the document’s status, type, number and PDF status; View opens the official PDF within the page, and Refresh Status queries the document from e-Logo again.
| Status | Meaning |
|---|---|
| Not formalized | The invoice has not been sent to e-Logo yet; you can queue it with Send to e-Logo. |
| Queued | The upload is waiting in the queue. |
| Sent, awaiting confirmation | The document has reached e-Logo; the GİB status is pending. |
| Official | The document is final; once the PDF has been attached, PDF attached appears. |
| Failed | The reason and the stage are shown; fix the problem and click Retry. |
| e-Archive cancelled / Cancelling | The e-Archive document of the refunded or cancelled invoice has been cancelled, or its cancellation is in the queue. |
| Cancellation needed | An e-Invoice cannot be cancelled through the service; use the buyer’s rejection, a return invoice or the GİB portal. |
Client invoice page
On a formalised invoice, the customer sees the Official e-Archive Invoice or Official e-Invoice card at the top of the invoice page; View opens the document within the page and Download downloads the PDF. The card is not included in the page’s print or “Download PDF” output. Documents issued in test mode are not shown to the customer.
Refunds and cancellations
When an invoice is refunded or cancelled in WISECP, its e-Archive document is cancelled on e-Logo automatically. Because an e-Invoice cannot be cancelled through the service, the card switches to Cancellation needed and administrators are told what to do: the buyer’s rejection, a return invoice or the GİB portal.
Notifications and retries
If sending, fetching the PDF or cancellation fails, administrators are notified; the Retry and View Invoice buttons in the notification take you to the relevant action. If the e-Logo / GİB status does not become final within 7 days, an additional warning is issued.
Scheduled tasks
| Task | What it does |
|---|---|
| Invoice upload | Builds the formalised invoice as UBL-TR and uploads it to e-Logo. |
| Document status and PDF | Follows the GİB status of an uploaded document and attaches the invoice number and official PDF to the invoice. |
| e-Archive cancellation | Cancels the e-Archive document of a refunded or cancelled invoice on e-Logo. |
| Automatic formalization sweep | In automatic mode, queues paid invoices whose formalisation day has come; it also renews the licence once a day. |
The tasks run on the WISECP cron; run the cron command every minute, as shown in the WISECP system settings.