Nesting API (nesting)

The nesting module serves nesting jobs with approval, costing, material reservation, export and result import, part pulls, summaries, and SVG and DXF output, plus nesting parts, remnants, and a KPI read. All 27 endpoints sit under /api/v1/nesting. For business meaning see the Nesting module page.

Group facts¶

Endpoint summary¶

One row per sub-module folder. The router prefix is added to the base path.

Nesting KPI endpoints¶

One KPI read under /nesting-jobs/kpi.

Nesting jobs endpoints¶

Job records, approve, calculate costs, reserve material, export, import a result, pull parts from orders, summary, SVG, and DXF.

Nesting parts endpoints¶

Nesting part records.

Remnants endpoints¶

Remnant records, available remnants, and scrap.

Error codes¶

The table lists the error codes that code under src/cluster_erp/modules/nesting/ raises, found by a syntax-tree scan for AppError(...), the factories in src/cluster_erp/core/errors.py (not_found, conflict, protected, permission_denied, privilege_escalation, check_version), and HTTPException(...). A status of 400 is the AppError default (src/cluster_erp/core/errors.py:23). Guard errors (401, 403), the entitlement codes, and validation errors (422) apply to every route and are listed on Errors.

Events emitted¶

The table lists the contract classes that code under src/cluster_erp/modules/nesting/ passes directly to EventBus.emit, found by a syntax-tree scan. Events built in a variable first are not counted. The contracts are described in Contracts reference.

Related pages¶

• API reference
• Nesting module
• API conventions
• Errors
• Authentication and headers

Verified against commit 92f8051 on 2026-11-13.