Integration Testing allows you to validate your integration with a demo retail partner inside of Orderful before going live. This guide walks through setting up and completing a Retail Leader Standard Order integration test.

Prerequisites

Before starting integration testing:

✅ Partnership created with retail leader
From the left navigation menu, click on Integration Testing to check the partnership is created.
✅ Inbound and Outbound Communication channels configured From the left navigation menu, click on Communication Channels to check the channels are configured.
✅ Your system can receive 850 Purchase Orders
✅ Your system can generate 855, 856, and 810 transactions

What is the Retail Leader Standard Order Integration Test?

This integration test - tests the complete order-to-cash workflow:

Step	Transaction	Direction	Description
1	850 Purchase Order	Retail Leader → You	Order received from demo retail partner
2	855 PO Acknowledgment	You → Retail Leader	Confirm order acceptance
3	856 Ship Notice	You → Retail Leader	Notify shipment details
4	810 Invoice	You → Retail Leader	Bill for shipped good

Step-by-Step Guide

Step 1: Enable Testing for Your Partnership

Sign in to your Orderful account:
- Orderful US: https://ui.orderful.com
- Orderful EU: https://ui-eu.orderful.com
From the left navigation menu, click on Integration Testing.
Add the Demo Partner Retail Leader

The integration test will appear, showing all four required steps.

🚧
Integration Testing is compatible with all integration types. Confirm you have configured your 850 inbound relaitonship with Retail leader to the appropriate data format and configured the appropriate communicaiton channel for the relationship before proceeding.

Step 2: Receive Test Purchase Order (850)

Once you start the integration test retail leader will send a test 850 Purchase Order to your system.

What to verify:

From the left navigation menu, click on Transactions and check the transaction appears in your Orderful inbox
Your system successfully receives and processes the PO
All line items are readable

Action: Accept the delivery of the transaction via the accept delivery endpoint.

📘
Customizing the 850
You can define up to five customized products and product identifiers for this test to use when generating an 850 Purchase order. To do so, from the left navigation menu, click on Products and create products one at a itme or via CSV upload. with IDs that match the products in your system of record. Enable the product for testing by clicking "Include this product in sample transactions"
More details on how to upload products can be found here.

Step 3: Send PO Acknowledgment (855)

Generate and send an 855 Purchase Order Acknowledgment for the test PO.

Requirements

Requirement	Description
Line items	Include all line items from the original 850
Status code	Use `"AC"` (Accepted) for each line
Product IDs	Must exactly match the 850 (including qualifiers)
Quantities & UOM	Must match the 850
PO reference	Reference the PO number from the 850

Validation Checks

Check	Description
✓ Line count	Matches the original PO
✓ Status codes	All lines use `"IA"`
✓ Product IDs	Match with correct qualifiers
✓ Quantities & UOMs	Match the original PO

Step 4: Send Ship Notice (856)

Generate and send an 856 Advanced Ship Notice when the test order ships.

Requirements

Requirement	Description
Line items	Match the acknowledged items from the 855
Product data	Product IDs, quantities, and UOMs must match
PO reference	Reference the PO number
Shipment details	Include carrier, tracking number, and ship date

Validation Checks

Check	Description
✓ Item match	Shipped items match acknowledged items
✓ Product IDs	Consistent across documents
✓ Quantities	Match the 855
✓ UOMs	Consistent across documents

Step 5: Send Invoice (810)

Generate and send an 810 Invoice for the shipped goods.

Requirements

Requirement	Description
Line items	Include all line items from the original 850
Quantities	Invoiced quantities must match shipped quantities
Product IDs	Must match previous documents
Pricing	Accurate line-level and total pricing
PO reference	Reference the PO number

Understanding Validation Results

Passed Status (✓)

All validation checks succeeded. The step is marked complete.

Failed Status (✗)

One or more validation checks failed.

What to do:

Click the transaction link in the validation message
Review the transaction data
Correct the issues in your integration
Regenerate and resend the transaction
The integration step will auto-refresh with the latest message and re-run validation

Restarting the Test

You can restart the entire integration test at any time by clicking "Restart Test" which will trigger a new PO to be sent by Retail leader with a fresh PO identifier, it will also bring the integration test back to the first step.