Retrofit an ECO
POST
/ecos/{id}/retrofit
const url = 'https://app.buildtrace.eu/api/ecos/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/retrofit';const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://app.buildtrace.eu/api/ecos/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/retrofit \ --header 'Authorization: Bearer <token>'Required scope: service:write.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”id
required
string format: uuid
Responses
Section titled “Responses”OK
Media typeapplication/json
object
openedOrders
required
Array<object>
object
serialId
required
string format: uuid
reworkOrderId
required
string format: uuid
skippedUnits
required
Target units the campaign opened no order for, and why. Running the retrofit again once the cause is gone opens their orders.
Array<object>
object
serialId
required
string format: uuid
serialNumber
required
string
reason
required
RESERVED: the unit is reserved for a build order, which will build it in as it is.
string
message
required
Why the unit was skipped, for display.
string
Example
{ "skippedUnits": [ { "reason": "RESERVED" } ]}Unauthorized
Not found
The ECO may not be retrofitted: it is not EFFECTIVE, or it does not apply to existing units. Serial targets may be recorded from DRAFT onward, so their presence does not imply the ECO can be executed.
Media typeapplication/json
object
error
required
string
Example generated
{ "error": "example"}