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
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
- Open the purchase bill and add a customs declaration: its number, the taxable value and the import code.
- Check the tax worked out at the code's rate. If the declaration states its own tax, type it, and BYTE checks it.
- Add the duty and any clearing agent's fee as ordinary lines on the same bill.
- 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.
| Line | JOD | Result |
|---|---|---|
| Import tax at 16% of 10,000 | 1,600.000 | Owed on the bill |
| Duty, an ordinary line | 300.000 | Owed on the bill |
| Taxable value on the declaration | 10,000.000 | Reported, not posted again |
| The bill owes | 1,900.000 | Duty 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.
| Area | What BYTE does | Status |
|---|---|---|
| Customs line | On the supplier bill: declaration number, taxable value, import code, tax, and the stated tax if any | Built |
| Tax | Taxable value times the code's rate, per line; a stated tax within one minor unit | Built |
| Date | Each declaration dated on the bill's day | Built |
| Currency | Recorded in the base currency | Built |
| Codes | Offered on purchase bills only; a sales document carries none | Built |
| Jordan and UAE | Jordan: 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.