Marketplace recipes

Marketplace recipes are guided, step-by-step workflows for common Marketplace integration scenarios. Each recipe combines implementation guidance, ready-to-run code samples, and validation checkpoints to help you complete a workflow and verify the expected results.

Recipes walk you through the required APIs in the order they should be called and include sample requests, validation checkpoints, and links to related documentation. Examples include order fulfillment, returns and refunds, and inventory management.

A recipe is a structured guide for validating a specific Marketplace scenario. Whether you're validating order fulfillment, processing returns and refunds, or managing inventory, recipes walk you through the required APIs in the order they should be called and provide the guidance needed to complete each workflow.

---

How to use a recipe

Start with the recipe that matches the workflow you want to test. Review the prerequisites, then complete each step in order. Each step includes the endpoint, requirements, sample request, and expected result.

Every recipe includes:

• Step-by-step guidance for completing a Marketplace workflow
• Copy-ready code samples in cURL, Python, and Java
• Validation checkpoints to verify expected behavior
• Related guides and API references for additional information

---

Using the code samples

The sample requests are designed to be copied and adapted for your sandbox environment. Replace the placeholder values with the resources generated during your workflow or your own sandbox resources before sending the request.

Common placeholders include:

• {{token}}
• {{sku}}
• {{purchaseOrderId}}
• {{returnOrderId}}
• {{shipNode}}

---

Dynamic sandbox recipes

Choose a recipe based on the Marketplace workflow you want to validate.

Validate order fulfillment

Create a test order and validate the complete fulfillment lifecycle from acknowledgment through delivery.

You'll validate

• Order creation
• Order acknowledgment
• Shipment updates
• Delivery confirmation

Open recipe

---

Validate returns and refunds

Simulate a customer return, issue a refund, and verify the complete returns lifecycle.

You'll validate

• Return initiation
• Return shipment
• Return delivery
• Refund processing

Open recipe

---

Validate non-WFS inventory

Validate inventory reservation, inventory decrement, and stockout behavior for non-WFS inventory.

You'll validate

• Inventory reservation
• Inventory decrement
• Stockout scenarios

Open recipe