Importer: cover duty with scrips

The importer motion covers customs duty with scrips instead of cash. An importer facing a Bill of Entry funds the duty below face value: a credit that settles duty at face is worth nearly face to the buyer, and the difference is the saving.

All calls below use the base URL and header from Authentication: export BASE_URL=https://api.scripxhq.com and X-ScripX-Key: $SCRIPX_KEY. Run the whole flow in the sandbox first with a scripx_test_… key.

1. Connect the importer firm

curl -X POST "$BASE_URL/v1/firms" \
  -H "X-ScripX-Key: $SCRIPX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"iec": "0698765432", "name": "Acme Imports", "role": "importer"}'

Verify and authorize exactly as for an exporter. The firm buys once its state is connected.

2. Quote a duty requirement

Pass the duty amount you need covered as requirement_paise:

curl -X POST "$BASE_URL/v1/quote" \
  -H "X-ScripX-Key: $SCRIPX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"side": "buy", "scheme": "RODTEP", "requirement_paise": 500000000}'

{
  "side": "buy",
  "scheme": "RODTEP",
  "requirement_paise": 500000000,
  "price_bps": 9700,
  "all_in_paise": 485000000,
  "savings_paise": 15000000,
  "scrip_nos": ["SCRIP204188", "SCRIP204190"],
  "covered_paise": 500000000,
  "residual_paise": 0,
  "fully_covered": true,
  "quote_ref": "qt_01J0..."
}

Because scrips transfer whole, the cover is the cheapest whole-credit bundle assembled to meet the requirement. all_in_paise is what the importer pays in cash, savings_paise is the gain versus paying duty in full, and residual_paise is any duty left to settle in cash when a bundle cannot land exactly on the requirement.

3. Place the order with a ceiling

curl -X POST "$BASE_URL/v1/orders" \
  -H "X-ScripX-Key: $SCRIPX_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: acme-boe-88213-1" \
  -d '{"side": "buy", "scheme": "RODTEP", "amount_paise": 500000000, "max_pct_bps": 9750}'

max_pct_bps is the buyer’s structural price ceiling: the order never fills above it.

4. Settlement applies the cover on ICEGATE

Buyer funds are locked before the scrip moves. On match, title transfers to the importer and the cover is applied against the Bill of Entry on ICEGATE. Settlement is delivery-versus-payment: if it cannot complete, it unwinds and refunds in full the same day. Track it with webhooks (order.matched, settlement.settled) or positions.

Get started

Concepts

By role

Essentials

Resources

Importer: cover duty with scrips

1. Connect the importer firm

2. Quote a duty requirement

3. Place the order with a ceiling

4. Settlement applies the cover on ICEGATE

​1. Connect the importer firm

​2. Quote a duty requirement

​3. Place the order with a ceiling

​4. Settlement applies the cover on ICEGATE

​Related

1. Connect the importer firm

2. Quote a duty requirement

3. Place the order with a ceiling

4. Settlement applies the cover on ICEGATE

Related