🔒 Complete production V3

patch

https://{xentralId}.xentral.biz/api/v3/productions/{id}/actions/complete

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

This endpoint requires the following scopes: production:complete.

Complete a production. The produced goods are booked into the given storage location and the production is closed and write protected. Only released or started productions whose materials have been fully retrieved from stock can be completed. productionEndDate is set to the current date when it is still empty.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

Body Params

quantitySuccessful

float

Quantity that was produced successfully and is booked into stock. Defaults to the quantity of the production that is still outstanding, and is capped at it.

quantityScrap

float

Quantity that was scrapped. This is recorded on the production only - scrapped goods are never booked into stock and are therefore no longer traceable. To keep them traceable, book them as quantitySuccessful into a dedicated blocked storage location instead.

autoStore

boolean

Whether the produced goods are booked into storageLocation. Defaults to true. When false the production is completed without any stock movement, for example when the goods were already received through a purchase order.

storageLocation

object

Storage location the produced goods are booked into. Required when autoStore is true.

storeAsProduct

object

Product the produced goods are booked on. Defaults to the product the production produces.

batch

string

Batch number created by this production. Only booked into the batch stock when the stored product is managed in batches.

bestBeforeDate

date

Best-before date of the produced goods. Only booked when the stored product carries a best-before date.

completionComment

string

Free-text note stored on the production together with the completion.

Headers

string

enum

Defaults to application/problem+json

Generated from available response content types

Allowed:

Responses

204

No Content

401

Unauthorized

403

Forbidden

404

Not Found

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/problem+json

application/json

400Failed validation

409Problem occurred

429Too Many Requests