Release Landed Cost Accrual
POST/api/landed-cost-accruals/release
"No more landed cost expected": releases the remaining estimated landed cost (and/or customs duty) still accrued on the chosen receipt lines. Target the lines with receipt_line_ids, or every line of one inbound_shipment_id or purchase_order_id.
purchase-orders:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
The release posts the same entry a landed-cost bill variance does, for (0 − estimate): Dr the accrual account (Accrued Landed Cost / Accrued Customs Duty), Cr Inventory for units still on hand, Cr Cost of Goods Sold (freight) or the customs duty variance account (duty, else Cost of Goods Sold) for units already sold. It is dated today and never inside a closed accounting period. Lines already cleared by a bill or already released are skipped (skipped_count).
A bill that arrives after a release posts as an ordinary landed-cost bill and true-up; the release stays. Undo a release with Undo Landed Cost Accrual Release while no bill has arrived.
Body
| Field | Type | Rules |
|---|---|---|
| receipt_line_ids | integer[] | required unless inbound_shipment_id or purchase_order_id; max 1000; existing receipt line ids |
| inbound_shipment_id | integer | optional; existing inbound shipment |
| purchase_order_id | integer | optional; existing purchase order |
| components | string[] | optional; landed_cost, duty; default both |
| note | string | optional; max 500 |
Authentication: Requires Bearer token (scope purchase-orders:write, permission landed_cost_accruals.release).
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.