Async Job Status & Results

Correct A Line

Apply a reader's classification to one line, and recompute from it.

WHY THIS IS JOB-SCOPED AND SERVER-SIDE. The PDF is rendered from the STORED report, so a correction applied only in the browser would leave the download -- the artefact that actually goes to a broker -- still carrying the code the reader has just told us is wrong. Recomputing here fixes the table, a later poll, and the PDF in one write.

The client sends a CODE, never a computed line. Everything else is derived from the schedule on this side, so a correction cannot be used to write arbitrary duty figures into a report that carries our name.

WHAT IT DOES NOT DO. It does not decide the reader is right. The line is stamped reader_supplied, carries no confidence score, and is marked wherever it is displayed or printed. We recompute arithmetic on their assertion; we do not adopt it.

post/v1/jobs/{job_id}/corrections

Request

  • Base URL: https://api.vectelos.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.vectelos.com/v1/jobs/{job_id}/corrections
  • Auth: none declared

Path parameters

job_idstring required

Headers

authorizationstring nullable

Bearer <JWT session token>

Cookies

vx_sessionstring nullable

Request body

item_indexinteger required

Which line the reviewer is editing

recompute_from_scheduleboolean

Set by the clarification picker, where the reader CHOSE a tariff line rather than asserting a rate: recompute duty and trade remedies from the published schedule for hts_code. Default false keeps the settled contract that a bare hts_code is a LABEL and does not touch duty. Ignored when tariff_rate_pct is supplied -- an explicit rate is always the reviewer's assertion and always wins.

hts_codestring nullable

HTS code the reviewer assigns (a label; their rate governs the duty)

descriptionstring nullable

Reviewer's amended description / note

quantitynumber nullable
total_value_usdnumber nullable

Reviewer's customs value for the line

tariff_rate_pctnumber nullable

Ad-valorem rate the reviewer applies; duty = value × rate

quantity_unitstring nullable

Unit of the quantity on this line (kg, each, liter, pr, doz, bbl...). Supplied for a specific or compound rate whose duty could not be computed because the invoice did not state one. The published rate still governs; this does not override it.

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.