BYTE · Accounting · Purchases and tax Coming soon

Customs duty in BYTE: record the import tax on the supplier bill

When goods come in through customs, the declaration sets the taxable value, the duty and the import tax, not the supplier's invoice. BYTE records the declaration on the supplier bill as a customs line, works out the tax at the import code's rate, and dates it the bill's day, so the bill and the declaration agree.

Last updated: 17 November 2026

Customs declarationSavedBillSupplier A, 15 JanDeclarationNo. 2201Import codeJordan 16%Taxable value10,000.000LineJODImport tax at 16%1,600.000Duty, ordinary line300.000Bill owes1,900.000
Illustration of a customs declaration on a supplier bill: the declaration number, the taxable value, the import code, the tax at the rate and the duty line. The figures are examples, not a screenshot.

What it covers

  • A customs line sits on a supplier bill. It names the declaration number, the taxable value, the import code, and the tax the declaration states, if any.
  • The tax is the taxable value times the code's rate, rounded per line. A tax stated on the declaration must match the computed figure to within one minor unit.
  • Each declaration is dated on the bill's day, so the bill and the declaration always agree.
  • Customs lines are recorded in the base currency only.
  • Import codes are offered on purchase bills only. A sales document carries none.
  • Duty and a clearing agent's fee stay ordinary lines on the same bill, beside the customs line, so the bill owes them with the import tax.
  • For a UAE import, the tax is recorded as a reverse charge, so the bill owes nothing for it.
  • A supplier credit note can carry the customs line back, and a void takes the whole bill back.

How it works

  1. Open the purchase bill and add a customs declaration: its number, the taxable value and the import code.
  2. Check the tax worked out at the code's rate. If the declaration states its own tax, type it, and BYTE checks it.
  3. Add the duty and any clearing agent's fee as ordinary lines on the same bill.
  4. Save. The bill takes the declaration's day, and the import value is reported on the customs line, not posted again.

A worked example

A Jordanian declaration with a taxable value of JOD 10,000, duty of JOD 300 as an ordinary line, and the import code at 16%. The figures are examples.

LineJODResult
Import tax at 16% of 10,0001,600.000Owed on the bill
Duty, an ordinary line300.000Owed on the bill
Taxable value on the declaration10,000.000Reported, not posted again
The bill owes1,900.000Duty plus import tax

The bill owes JOD 1,900: the duty and the import tax. The JOD 10,000 is the value the declaration reports, and it is not posted a second time on the bill.

At a glance

Built means the feature is in BYTE's current build. BYTE is coming soon, so ask us for the status of anything you need.

AreaWhat BYTE doesStatus
Customs lineOn the supplier bill: declaration number, taxable value, import code, tax, and the stated tax if anyBuilt
TaxTaxable value times the code's rate, per line; a stated tax within one minor unitBuilt
DateEach declaration dated on the bill's dayBuilt
CurrencyRecorded in the base currencyBuilt
CodesOffered on purchase bills only; a sales document carries noneBuilt
Jordan and UAEJordan: tax at 16% paid at customs. UAE: reverse charge at 5%Built

Ask us before you decide

  • Ask which import codes your team uses, and whether your declarations come from customs or from a clearing agent.
  • Ask who enters declarations, and who checks them against the bill before saving.
  • Ask which VAT return each import belongs to, so the tax lands in the right period.

Questions about customs duty in BYTE

Does BYTE work out the import tax from the declaration?

Yes. The tax is the taxable value times the code's rate, rounded per line. If the declaration states its own tax, BYTE checks it to within one minor unit.

Which date does the bill take?

The bill's own date. Each declaration is saved on the bill's day, so the two always agree.

Do duty and a clearing agent's fee go on the same bill?

Yes. They stay ordinary lines on the same bill, beside the customs line.

How is a UAE import handled?

As a reverse charge at 5%. The bill owes nothing for the tax, and the tax is recorded on both the output and the input side.

Can I correct a customs line?

Yes. A supplier credit note can carry the customs line back, and a void takes the whole bill back.

In which currency is a customs line recorded?

In the base currency. A declaration is valued in dinars or dirhams, so no exchange rate is needed.

Be first to try BYTE.

Send us a short note about your business and the modules you care about. We will tell you when early access opens.

Talk to us See all of BYTE