ARCNM Rank Calculations
arcnm_rank_calculationsRead-onlyIdempotent
Rank 2–20 calculations by offer price (the price each calculation headlines, cost-sheet surcharges included), lowest first, and explain the spread — the N-way generalization of arcnm_compare_calculations. Shows each option's premium over the cheapest with time beside cost, flags when they are not like-with-like (different lot size or costing environment; different currencies are not ranked at all), and lists blocked / unpriced calcs last. Use it to pick between several quotes at once; for the same part(s) across rate environments use arcnm_compare_environments. Read-only — does not re-price.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| calculation_ids | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| ranked | Yes | Priced options by offer price, lowest first (rank 1…k), then any blocked / unpriced calcs and any assembly priced only in part (rank null) in the order given. | |
| guidance | No | What the ranking means and what to do next. | |
| comparable | Yes | True only when there are at least two priced options AND they share a lot size, costing environment and currency. False either because the options are not like-with-like (the spread is then not purely the part) or because fewer than two are priced and there is nothing to compare — read `note` / `incomparable_reasons` for which. | |
| total_count | Yes | How many distinct calculations were ranked. | |
| priced_count | Yes | How many of the inputs carry a price. | |
| best_calculation_id | No | The cheapest priced option's id (the ranking winner), or null if none are priced yet. | |
| incomparable_reasons | No | Why comparable is false: lot_size_mismatch, environment_mismatch and/or currency_mismatch. On currency_mismatch the options are NOT ranked at all (no rank, no deltas, no winner): there is no FX rail, so a cross-currency order would be invented. |