Receive a returned piece by hand, set its condition, mark it repaired, or give it its outcome
PATCH
/v1/returns/pieces/{id}Factory API keyBase URL api.skuflo.ioreceive: true with a condition receives an outstanding piece without a scan. condition: new, needs_repair, repaired or unrepairable (repaired is only for a needs repair piece). outcome: back_in_stock (needs location, a stock bay; not for a needs repair or unrepairable piece) or written_off.
Try it nowPath parameters#
| Name | Type | Description |
|---|---|---|
idrequired | string (uuid) | · |
Body parameters#
| Name | Type | Description |
|---|---|---|
receiveoptional | boolean | · |
conditionoptional | string | · One of "new", "needs_repair", "repaired", "unrepairable" |
condition_noteoptional | string, max 500 | · |
outcomeoptional | string | · One of "back_in_stock", "written_off" |
locationoptional | string, max 8 | · |
Responses#
| Status | Meaning |
|---|---|
| 200 | Success. An example body is in the column on the right. |
Other errors#
| Status | Meaning |
|---|---|
| 401 | No key, or the key is not recognised. |
| 402 | billing_required. Reading always works, but this is a write and stops once a trial ends or a plan is cancelled. |
| 403 | The key is valid but its role cannot do this. |
| 404 | Nothing with that id in your factory. |
| 422 | The body failed validation. The response lists every problem at once. |
| 429 | More than 600 requests a minute. Wait retry-after seconds. |