Skip to content
Basmtak Books
Direct pull with an API key

Moving from Qoyod to Basmtak Books

Qoyod is the one source we pull from directly. You paste the API key from your account, and we read the chart of accounts, customers, suppliers, products, account balances and open documents in minutes — no export and no files.

Balances are read as they stand on the day of the pull, so pull on your changeover date. If you need an earlier date, upload a trial balance as at that date instead.

The migration wizard in Basmtak Books: choosing the source and the opening-balance date
What moves from Qoyod
Chart of accounts Direct pull Customers and suppliers Direct pull Items Direct pull Fixed assets By file Opening balances By file Open invoices Direct pull Open supplier bills Direct pull
The wizard

How it works with Qoyod

  1. Copy the API key from Qoyod

    From General settings → API key in your Qoyod account. The key is used for the pull request alone and is never stored with us.

  2. Paste it and pull

    We read the chart of accounts with each account's balance, customers, suppliers, products, and the open invoices and bills. Drafts and voided documents are not carried, and neither are settled ones.

  3. Pull on the changeover day

    Qoyod gives each account's balance as it stands on the day of the pull, so pull on the changeover date itself. Upload the asset register as a file if you have one.

  4. Preview and apply

    The preview names every problem before anything is written. Applying is one transaction, and the undo is complete.

What you export from Qoyod

  • Fixed asset register, if you have one (CSV file)

The wizard lives inside the product: Settings → Data migration.

Automatic mapping

What we understand in your files

The mapping rules are the same for every source, and these are them as they are in the code:

  • Column headings are read in Arabic and English regardless of case and punctuation: «الرقم الضريبي», VAT Number and TRN are all the VAT number.
  • Values too: Customer, Client, عميل and مدين mean a customer; Vendor, Supplier, مورد and دائن mean a supplier.
  • Numbers with either separator: 1,234.56, 1.234,56, (1,234.56) for a negative, and Arabic-Indic digits ١٢٣٤ are all read.
  • Dates: dd/mm/yyyy, yyyy-mm-dd, «12 Mar 2026» and Excel's serial number.
  • An account's type is read from its whole phrase: «تكلفة المبيعات» and Cost of Sales are an expense, not revenue, and Bank Loan is a liability, not an asset. Anything inferred from a word inside the name is shown to you to confirm before applying.
  • A customer or supplier you already have is matched by code, VAT number or name and updated, never duplicated.
  • Whatever is skipped is told to you: an existing account code, an item with a registered code, a settled invoice with a zero balance.
What comes over

Seven things move, none of them halfway

01

Chart of accounts

Your tree with its codes, Arabic and English names, the type of every account and its parent. A code you already have here is skipped, never duplicated.

02

Customers and suppliers

With their names, VAT numbers, commercial registrations, email, mobile, payment terms and credit limit. A company that both buys from you and sells to you is recorded once, on both sides.

03

Items

Stocked products and services, with their codes, sale and purchase prices, cost and unit. An opening quantity becomes real stock, valued at its cost.

04

Fixed assets

The register with the purchase date, cost, salvage value and useful life, plus the accumulated depreciation up to the changeover date — so no asset is depreciated twice.

05

Opening balances

The opening trial balance becomes one balanced opening journal on the changeover date, and any difference is named for what it is in the opening-balance equity account.

06

Open invoices

Whatever your customers have not paid yet comes across as a real document with its balance and due date, so aging and statements work from day one.

07

Open supplier bills

Whatever you still owe your suppliers, with its numbers, references and balance, so your payables and their aging are right immediately.

Bring your accountant

The preview was written for an accountant to read: whether the trial balance balances, which account sits on which side, and where the trial balance and the open invoices might count receivables twice. Invite your accountant into your business with their own permissions, or let their firm run it from the firm dashboard.

Accountants and firms

Move your books, and see them before they are written

The trial is 14 days with no card, and migration is included in every plan.

No credit card. We activate your account within business hours, and your 14 free days start the moment we do.