Skip to content
Developersskuflo.iov1Changelog

Log a return you already have in hand

POST/v1/returnsFactory API keyBase URL api.skuflo.io
Try it now

Body parameters#

NameTypeDescription
retailer_idrequiredstring (uuid)·
order_idoptionalstring (uuid)·
barcodesoptionalstring, max 64[]·
barcodeoptionalstring, max 64The label barcode as your scanner reads it. Send it raw: control characters, symbology prefixes and our QR link are cleaned up for you.
descriptionoptionalstring, max 500·
reasonoptionalstring, max 60·
noteoptionalstring, max 1000·
conditionoptionalstring·
One of "new", "needs_repair", "unrepairable"
locationoptionalstring, max 8·

Responses#

StatusMeaning
200Success. An example body is in the column on the right.

Other errors#

StatusMeaning
401No key, or the key is not recognised.
402billing_required. Reading always works, but this is a write and stops once a trial ends or a plan is cancelled.
403The key is valid but its role cannot do this.
422The body failed validation. The response lists every problem at once.
429More than 600 requests a minute. Wait retry-after seconds.