e-Arşiv Asistanı documentation

Documentation for e-Arşiv Asistanı. It describes the extension as it exists today, before any store listing, and will be extended as it changes.

Requirements

Chrome 116 or newer, or another Chromium-based browser of the same version such as Edge, Brave or Opera.
Until the extension is listed, it is installed from its folder: open the browser's extensions page, turn on Developer mode, choose Load unpacked and select the folder that contains manifest.json.
A user for the e-Arşiv portal (earsivportal.efatura.gov.tr). The GİB test portal (earsivportaltest.efatura.gov.tr) gives out throwaway test users for trying it: drafts work there, SMS signing does not.

Sign in to the portal and press the Asistan button at the bottom right.
Choose a buyer from the customer book, or type a VKN or TCKN and press GİB to fill in the name and tax office.
Add the lines. Saved items are suggested as you type, and the totals follow the portal's own rounding.
Press Taslağı hazırla, check the summary and press Taslağı oluştur. The draft appears under Düzenlenen Belgeler, where you check it and sign it with SMS.

Choose Hizmet ihracatı (302), the buyer's country and the currency.
The TCMB rate from the last bulletin before the invoice date is filled in; the TCMB button fetches it again after the date changes.
The exemption reason, the amount in words and the TL equivalent are added to the note.

They are kept in the browser's extension storage, one book per portal user.
Back them up and restore them as JSON from the toolbar popup. Customers can also be imported from issued invoices and from CSV.
Removing the extension removes them, so make a backup first.