Qubit Docs العربية

Qoyod

Connect your Qoyod company with an API key. Qubit imports your chart of accounts, sales, purchases, payments, inventory, and journal entries with read-only access.

Before you start

  • In Qoyod, open Settings, then General Settings, and find the API key. Click Save so the key becomes active, then copy it.
  • Each Qoyod company has its own key. To bring in more than one company, create a connection for each.
  • A Qoyod API key is not limited to reading, so keep it private. Qubit only sends read requests with it.

Connect Qoyod

  1. Open Data Catalog from the sidebar, click Add Data, then choose Connect a database.
  2. On the New Data Source page, click Qoyod. It is under Accounting.
  3. Enter a Connection Name.
  4. Paste the key into API key.
  5. Choose a Sync Schedule. The default is Daily.
  6. Click Create.

What Qubit reads

RecordsWhat they hold
AccountsThe chart of accounts, with codes, types, and balances
Customers and vendorsContact details and tax numbers
ProductsProducts and services, with prices and stock in each warehouse
InventoriesWarehouses and their addresses
Invoices and credit notesSales documents with their line items and payments
Bills and debit notesPurchase documents with their line items and payments
ReceiptsMoney received from customers and paid to vendors
Invoice paymentsThe receipts applied to sales invoices
Journal entriesEvery entry, with its debit and credit lines

Invoice payments are the same records as the receipts received from customers, so do not add the two together. Amounts keep the exact decimal values that Qoyod sends.

After you connect

Qubit checks that the API key is filled in, saves the connection, and starts the first sync. It confirms that the key works during that sync.

To check the connection at any time, open its menu in the Data Catalog and choose Test connection. If Last sync shows Failed, hover over it to see the reason. If Qoyod rejects the key, save a new key in Qoyod, then edit the connection and paste it.

Each sync reads every record again, so edits and deletions in Qoyod appear after the next sync. Qoyod sends all journal entries in one response, so the first sync of a large ledger can take a few minutes.