yayloh has a two-way integration owned and managed by Shelfless WMS. When a customer initiates a return, yayloh automatically pushes event details to Shelfless. Once warehouse personnel inspect the returned products in Shelfless, inspection updates are posted back to yayloh, making real-time status visible to customer support teams via the yayloh dashboard.
Note: This integration is owned and set up by Shelfless. yayloh provides the outbound event pipeline, while Shelfless uses yayloh’s API documentation to post inspection results via the endpoint titled "Create a return item inspection".
With the yayloh x Shelfless integration, retailers will be able to:
Automatically push return creation events to Shelfless's receiving endpoint.
Automatically receive real-time inspection updates in yayloh when Shelfless warehouse staff inspect and process incoming returns.
Set-up
Configure Shelfless Receiving Endpoint in yayloh
Obtain the Shelfless receiving endpoint URL from your Shelfless representative and share it to integration@yayloh.com.
Register yayloh Inspection Webhook in Shelfless
Shelfless requires yayloh's generic webhook to trigger the API endpoint "Create a return item inspection":
[https://prod-generic-webhook-valines.yayloh.com]Provide this webhook URL to your Shelfless technical contact for completing the inspection callback setup.
Managing returns in Shelfless (warehouse personnel use)
When a customer registers a return in yayloh, expected return order details are pushed directly to Shelfless. Upon receiving the return at the warehouse, staff will follow these steps:
Locate the incoming return using the Order Number or tracking identifier.
Inspect each item and update item condition (accept/discard/cancel) within the Shelfless back office.
Finalize the return inspection. Shelfless will automatically trigger a POST request to yayloh’s "Create a return item inspection" endpoint.
Managing inspected returns in yayloh dashboard
Open yayloh dashboard and select “Manage".
Click on “In progress” to see ongoing return orders.
Click on the drop down on upper left side.
Select “inspected” from the drop down.
Click on the return request's order ID to see the inspection status.
Status OK: The warehouse inspected and accepted/restocked the returned item in Shelfless.
Status Not OK: The warehouse marked the item as cancelled, damaged, or rejected in Shelfless.
