GoSmarter Logo
GoSmarter API Gateway

ProductionPlans


List production plans

GET
https://api.gosmarter.ai
/api/company/{companyId}/production-plans

Lists production plans for the specified company, most recent first, paged.

List production plans › path Parameters

companyId
​string · uuid · required

The company GUID.

List production plans › query Parameters

offset
​integer · int32

Zero-based row offset for pagination. Example: 0

limit
​integer · int32

Maximum number of rows to return (capped at 200). Example: 50

List production plans › Headers

GoSmarter-Api-Key
​string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

List production plans › Responses

Payload of Array of ProductionPlanDto

planId
​string · uuid
companyId
​string · uuid
runId
​string · uuid
name
​string
status
​integer · int32
totalBars
​integer · int32
totalCuts
​integer · int32
totalWastePct
​number · double
totalOffcutMm
​number · double
approvedBy
​string · uuid
approvedByName
​string
approvedAt
​string · date-time
createdAt
​string · date-time
updatedAt
​string · date-time

Get a production plan

GET
https://api.gosmarter.ai
/api/company/{companyId}/production-plans/{planId}

Retrieves a single production plan with its bars, cuts, and conflicts.

Get a production plan › path Parameters

companyId
​string · uuid · required

The company GUID.

planId
​string · uuid · required

The production plan GUID.

Get a production plan › Headers

GoSmarter-Api-Key
​string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Get a production plan › Responses

Payload of ProductionPlanDetailsResponse


Accept or reject production plan cut pairings

POST
https://api.gosmarter.ai
/api/company/{companyId}/production-plans/{planId}/review

Sets ReviewStatus (Accepted=20/Rejected=30) on one or more cuts within a plan.

Accept or reject production plan cut pairings › path Parameters

companyId
​string · uuid · required

The company GUID.

planId
​string · uuid · required

The production plan GUID.

Accept or reject production plan cut pairings › Headers

GoSmarter-Api-Key
​string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Accept or reject production plan cut pairings › Request Body

cutId
​string · uuid
reviewStatus
​integer · int32

Accept or reject production plan cut pairings › Responses

Payload of ReviewCutsResponse

updatedCount
​integer · int32

Approve a production plan

POST
https://api.gosmarter.ai
/api/company/{companyId}/production-plans/{planId}/approve

Atomic, first-approval-wins: creates OrderLineItemInventoryLinks for each Accepted cut's pairing where valid, records conflicts for failures. Returns 200 even when some bars conflict — conflicts are informational, not a request error.

Approve a production plan › path Parameters

companyId
​string · uuid · required

The company GUID.

planId
​string · uuid · required

The production plan GUID.

Approve a production plan › Headers

GoSmarter-Api-Key
​string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Approve a production plan › Responses

Payload of ApproveProductionPlanResult

planId
​string · uuid
planStatus
​integer · int32
barsApproved
​integer · int32
barsConflict
​integer · int32

Discard a production plan

POST
https://api.gosmarter.ai
/api/company/{companyId}/production-plans/{planId}/discard

Marks a Draft or Approved plan as Discarded and, in the same transaction, releases the stock reservations the plan's approval created (plan-owned links are deleted and their inventory returns to Available unless another reservation still holds it). Reservations that existed before approval are left untouched. Rejected with 400 if the plan has already advanced to InProgress/Completed or any bar has started.

Discard a production plan › path Parameters

companyId
​string · uuid · required

The company GUID.

planId
​string · uuid · required

The production plan GUID.

Discard a production plan › Headers

GoSmarter-Api-Key
​string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Discard a production plan › Responses

No description

No data returned

Un-approve a production plan (Preview)

POST
https://api.gosmarter.ai
/api/company/{companyId}/production-plans/{planId}/unapprove

Preview: this operation may change or be removed without a new versioned route or notice period until it is announced as stable (see the API Versioning Policy). Returns an Approved plan to Draft and, in the same transaction, releases the stock reservations the plan's approval created (same release rules as discard). Bars go back to Proposed (Excluded bars stay Excluded), conflicts are cleared and cut review decisions are kept, so the plan can be reviewed and approved again. Only allowed before any bar has started; rejected with 400 otherwise.

Un-approve a production plan (Preview) › path Parameters

companyId
​string · uuid · required

The company GUID.

planId
​string · uuid · required

The production plan GUID.

Un-approve a production plan (Preview) › Headers

GoSmarter-Api-Key
​string · required

The GoSmarter-Api-Key header is used to authenticate with the API using your API key. Value is of the format YOUR_KEY_HERE.

Un-approve a production plan (Preview) › Responses

Payload of ReleaseProductionPlanResult

planId
​string · uuid
planStatus
​integer · int32
releasedLinkCount
​integer · int32