Articles in this section

Test Cases

Laura Molano
  • Updated
Follow

Below are the written steps to take to complete the test cases. Refer to the Supplier Onboarding Guides for instructions on steps to take before you begin testing.

 

Portal - All test cases are initiated and processed manually in the portal.

EDI - All test cases are initiated in the portal and processed using an AS2 or FTP/SFTP connection.

  • Documents to and from the supplier will be posted to the Stage AS2 endpoint
  • All transactions require a 997 (functional acknowledgement) from the receiving party

CSV/XML/JSON - All test cases are initiated in the portal and processed using an FTP/SFTP connection.

  • Documents are posted to and pulled from the directories listed in the FTP Directories

API - All test cases are initiated in the portal and processed using the API connection.

 

 

Test Case 1: Order Cancellation by Retailer's Request

*Required for all suppliers

 

Purpose: The purpose of this test is to cancel a multi-line purchase order using the change reason: Cancelled at retailer's request. 

Step

Action to Take

Step 1

Create the Order

All Suppliers

  1. Click on Create a New Test Order
  2. Configure order fields > Continue
  3. Open the order in the portal
  4. Confirm the orders is in a Ready to Acknowledge status (it may take a few seconds to reach this status)
  5. EDI/API Suppliers: You will receive the order (EDI 850) in your system within 15 minutes 

Step 2

Create/Send an Acknowledgement

Instructions: Create/send an Acknowledgment (EDI 855) canceling the whole order with the change reason Cancelled at retailer's request using your preferred connection method. To create this document in the portal, see instructions below:

 

Portal Suppliers

  1. Click on Accept/Reject
  2. Under Acknowledgement Items
    • Set Line 1 to Qty cancelled = 3
    • Set Line 2 to Qty cancelled = 1
    • Enter the change reason Cancelled at retailer's request for Line 1 and 2
  3. Under General Information
    • Enter the change reason Cancelled at retailer's request
  4. Submit

 

All Suppliers

Confirm the acknowledgment goes to a Complete status in the portal (this may take a moment)

Tip! Go back to the Testing page in the stage portal to review the results of your tests. It may take a few seconds for the screen to update. Confirm the test case goes to Complete.
 
 
 

Test Case 2: Order Cancellation by Invalid Item Cost

*Required for all suppliers

 

Purpose: The purpose of this test is to cancel a multi-line purchase order using the change reason: Invalid item cost.

Step

Action to Take

Step 1

Create the Order

All Suppliers

  1. Click on Create a New Test Order
  2. Configure order fields > Continue
  3. Open the order in the portal
  4. Confirm the orders is in a Ready to Acknowledge status (it may take a few seconds to reach this status)
  5. EDI/API Suppliers: You will receive the order (EDI 850) in your system within 15 minutes 

Step 2

Create/Send an Acknowledgement

Instructions: Create/send an Acknowledgment (EDI 855) canceling the whole order with the change reason Invalid item cost using your preferred connection method. To create this document in the portal, see instructions below:

 

Portal Suppliers

  1. Click on Accept/Reject
  2. Under Acknowledgement Items
    • Set Line 1 to Qty cancelled = 3
    • Set Line 2 to Qty cancelled = 1
    • Enter the change reason Invalid item cost for Line 1 and 2
  3. Under General Information
    • Enter the change reason Invalid item cost
  4. Submit

 

All Suppliers

Confirm the acknowledgment goes to a Complete status in the portal (this may take a moment)

Tip! Go back to the Testing page in the stage portal to review the results of your tests. It may take a few seconds for the screen to update. Confirm the test case goes to Complete.
 
 
 

Test Case 3: Fulfill a Multi-Line Order

*Required for all suppliers using BBQGuys' carrier account. This test case must be completed in the portal.

 

Purpose: The purpose of this test is to accept, ship (in multiple boxes) and invoice a multi-line order using the merchant's carrier account (to create the shipping label in the portal). 

Step

Action to Take

Step 1

Create the Order

All Suppliers

  1. Click on Create a New Test Order
  2. Configure order fields > Continue
  3. Open the order in the portal
  4. Confirm the orders is in a Ready to Acknowledge status (this may take a moment)

Step 2

Create/Send an Acknowledgement

Instructions: Create an Acknowledgment accepting the whole order in the portal, see instructions below:

 

Portal Suppliers

  1. Click on Accept/Reject
  2. Under Acknowledgment Items enter in an Estimated Ship Date
  3. Submit
  4. Confirm the acknowledgment goes to a Complete status (this may take a moment)

Step 3

Create/Send a Shipment

Instructions: Create a Shipment shipping the whole order in 3 boxes (Line 1 split into 2 boxes and Line 2 in another box) in the portal, see instructions below:

 

Portal Suppliers

  1. Go back to the order
  2. Click on Ship
  3. Enter in a Ship-From Address (make sure the country code is 2 characters)
  4. Under Packages
    • Select the merchant's account (BBQGuys)
    • Click on Add Box
  5. In Box 1 include Line 1 Qty 3
  6. In Box 2 include Line 2 Qty 1
  7. Enter in dimensions for both boxes
  8. Submit
  9. Confirm the shipment goes to a Complete status (this may take a moment)

Step 4

Create/Send an Invoice

Instructions: Create an Invoice invoicing the whole order in the portal, see instructions below:

 

Portal Suppliers

  1. From the shipment, click on New Invoice
  2. Under General Information enter in an Invoice Number
  3. Submit
  4. Confirm the invoice goes to a Complete status (this may take a moment)

Tip! Go back to the Testing page in the stage portal to review the results of your tests. It may take a few seconds for the screen to update. Confirm the test case goes to Complete.
 
 
 

Test Case 4: Manual Order Fulfillment

*Required for all suppliers using their own shipping account

 

Purpose: The purpose of this test is to accept, ship (in multiple boxes) and invoice a multi-line order. You will not use the merchant's account to create shipping labels. 

Step

Action to Take

Step 1

Create the Order

All Suppliers

  1. Click on Create a New Test Order
  2. Configure order fields > Continue
  3. Open the order in the portal
  4. Confirm the orders is in a Ready to Acknowledge status (it may take a few seconds to reach this status)
  5. EDI/API Suppliers: You will receive the order (EDI 850) in your system within 15 minutes 

Step 2

Create/Send an Acknowledgement

Instructions: Create/send an Acknowledgment (EDI 855) accepting the whole order using your preferred connection method. To create this document in the portal, see instructions below:

 

Portal Suppliers

  1. Click on Accept/Reject
  2. Under Acknowledgment Items enter in an Estimated Ship Date
  3. Submit

 

All Suppliers

Confirm the acknowledgment goes to a Complete status in the portal (this may take a moment)

Step 3

Create/Send a Shipment

Instructions: Create/send a Shipment (EDI 856) shipping the whole order in 3 boxes (Line 1 split into 2 boxes and Line 2 in another box) using your preferred connection method. To create this document in the portal, see instructions below:

 

Portal Suppliers

  1. Go back to the order
  2. Click on Ship
  3. Enter in a Ship-From Address (make sure the country code is 2 characters)
  4. Under Packages
    • Select another system (manual entry)
    • Click on Add Box twice so you have 3 boxes total
  5. In Box 1 include Line 1 Qty 2
  6. In Box 2 include Line 1 Qty 1
  7. In Box 3 include Line 2 Qty 1
  8. Enter in dimensions and a tracking number for the boxes
  9. Select the Carrier requested on the order
  10. Submit

 

All Suppliers

Confirm the shipment goes to a Complete status in the portal (this may take a moment)

Step 4

Create/Send an Invoice

Instructions: Create an Invoice (EDI 810) invoicing the whole order using your preferred connection method. To create this document in the portal, see instructions below:

 

Portal Suppliers

  1. From the shipment, click on New Invoice
  2. Under General Information enter in an Invoice Number
  3. Submit

 

All Suppliers

Confirm the invoice goes to a Complete status in the portal (this may take a moment)

Tip! Go back to the Testing page in the stage portal to review the results of your tests. It may take a few seconds for the screen to update. Confirm the test case goes to Complete.
 
 
 
 

Test Case 5: Partial Order Fulfillment

*Required for all suppliers using BBQGuys' carrier account. This test case must be completed in the portal.

 

Purpose: The purpose of this test is to accept and backorder, ship (in multiple shipments) and invoice (in multiple invoices) a multi-line order using the merchant's carrier account (to create the shipping label in the portal).   

Step

Action to Take

Step 1

Create the Order

All Suppliers

  1. Click on Create a New Test Order
  2. Configure order fields > Continue
  3. Open the order in the portal
  4. Confirm the orders is in a Ready to Acknowledge status (this may take a moment)

Step 2

Create/Send an Acknowledgement

Instructions: Create an Acknowledgment backordering Line 1 and accepting Lines 2 and 3 in the portal, see instructions below:

 

Portal Suppliers

  1. Click on Accept/Reject
  2. Under Acknowledgement Items
    • Set Line 1 to Qty backordered = 3
    • Add an Estimated Ship Date for Line 1
  3. Under Acknowledgment Items enter in an Estimated Ship Date
  4. Submit
  5. Confirm the acknowledgment goes to a Complete status (this may take a moment)

Step 3

Create/Send a Shipment

Instructions: Create a Shipment shipping the accepted Lines 2 and 3 in the portal, see instructions below:

 

Portal Suppliers

  1. Go back to the order
  2. Click on Ship
  3. Enter in a Ship-From Address (make sure the country code is 2 characters)
  4. Under Packages select the merchant's account (BBQGuys)
  5. In Box 1 include Line 2 Qty 1 and Line 3 Qty 2
  6. Enter in dimensions for the boxes
  7. Submit
  8. Confirm the shipment goes to a Complete status (this may take a moment)

Step 4

Create/Send an Invoice

Instructions: Create an Invoice invoicing the accepted Lines 2 and 3 in the portal, see instructions below:

 

Portal Suppliers

  1. From the shipment, click on New Invoice
  2. Under General Information enter in an Invoice Number
  3. Submit
  4. Confirm the invoice goes to a Complete status (this may take a moment)

Step 5

Create/Send a Shipment

Instructions: Create a Shipment shipping the backordered Line 1 in the portal, see instructions below:

 

Portal Suppliers

  1. Go back to the order
  2. Click on Ship
  3. Enter in a Ship-From Address (make sure the country code is 2 characters)
  4. Under Packages select the merchant's account (BBQGuys)
  5. In Box 1 include Line 1 Qty 3
  6. Enter in dimensions for the boxes
  7. Submit
  8. Confirm the shipment goes to a Complete status (this may take a moment)

Step 6

Create/Send an Invoice

Instructions: Create an Invoice invoicing the backordered Line 1 in the portal, see instructions below:

 

Portal Suppliers

  1. From the shipment, click on New Invoice
  2. Under General Information enter in an Invoice Number
  3. Submit
  4. Confirm the invoice goes to a Complete status (this may take a moment)

Tip! Go back to the Testing page in the stage portal to review the results of your tests. It may take a few seconds for the screen to update. Confirm the test case goes to Complete.

 

 

Test Case 6: Freight Order Partial Shipments

*Required for all suppliers using their own shipping account

 

Purpose: The purpose of this test is to accept and backorder, ship (in multiple shipments) and invoice (in multiple invoices) a multi-line order. You will not use the merchant's account to create shipping labels. 

Step

Action to Take

Step 1

Create the Order

All Suppliers

  1. Click on Create a New Test Order
  2. Configure order fields > Continue
  3. Open the order in the portal
  4. Confirm the orders is in a Ready to Acknowledge status (it may take a few seconds to reach this status)
  5. EDI/API Suppliers: You will receive the order (EDI 850) in your system within 15 minutes 

Step 2

Create/Send an Acknowledgement

Instructions: Create/send an Acknowledgment (EDI 855) backordering Line 1 and accepting Lines 2 and 3 using your preferred connection method. To create this document in the portal, see instructions below:

 

Portal Suppliers

  1. Click on Accept/Reject
  2. Under Acknowledgement Items
    • Set Line 1 to Qty backordered = 3
    • Add an Estimated Ship Date for Line 1
  3. Under Acknowledgment Items enter in an Estimated Ship Date
  4. Submit

 

All Suppliers

Confirm the acknowledgment goes to a Complete status in the portal (this may take a moment)

Step 3

Create/Send a Shipment

Instructions: Create/send a Shipment (EDI 856) shipping the accepted Lines 2 and 3 using your preferred connection method. To create this document in the portal, see instructions below:

 

Portal Suppliers

  1. Go back to the order
  2. Click on Ship
  3. Enter in a Ship-From Address (make sure the country code is 2 characters)
  4. Under Packages select another system (manual entry)
  5. In Box 1 include Line 2 Qty 1 and Line 3 Qty 2
  6. Enter in dimensions and a tracking number for the box
  7. Select the Carrier requested on the order
  8. Submit

 

All Suppliers

Confirm the shipment goes to a Complete status in the portal (this may take a moment)

Step 4

Create/Send an Invoice

Instructions: Create/send an Invoice (EDI 810) invoicing the accepted Lines 2 and 3 using your preferred connection method. To create this document in the portal, see instructions below:

 

Portal Suppliers

  1. From the shipment, click on New Invoice
  2. Under General Information enter in an Invoice Number
  3. Submit

 

All Suppliers

Confirm the invoice goes to a Complete status in the portal (this may take a moment)

Step 5

Create/Send a Shipment

Instructions: Create/send a Shipment (EDI 856) shipping the backordered Line 1 using your preferred connection method. To create this document in the portal, see instructions below:

 

Portal Suppliers

  1. Go back to the order
  2. Click on Ship
  3. Enter in a Ship-From Address (make sure the country code is 2 characters)
  4. Under Packages select another system (manual entry)
  5. In Box 1 include Line 1 Qty 3
  6. Enter in dimensions and a tracking number for the boxes
  7. Select the Carrier requested on the order
  8. Submit

 

All Suppliers

Confirm the shipment goes to a Complete status in the portal (this may take a moment)

Step 6

Create/Send an Invoice

Instructions: Create/send an Invoice (EDI 810) invoicing the backordered Line 1 using your preferred connection method. To create this document in the portal, see instructions below:

 

Portal Suppliers

  1. From the shipment, click on New Invoice
  2. Under General Information enter in an Invoice Number
  3. Submit

 

All Suppliers

Confirm the invoice goes to a Complete status in the portal (this may take a moment)

Tip! Go back to the Testing page in the stage portal to review the results of your tests. It may take a few seconds for the screen to update. Confirm the test case goes to Complete.

 

 

Test Case 7: Freight Shipment

*Required for all suppliers using BBQGuys' freight provider, CONVEY. This test case must be completed in the portal.

 

Purpose: The purpose of this test is to accept, ship (in multiple pallets) and invoice a multi-line order using the merchant's freight provider, Convey. This method will be used to coordinate freight pickups for LTL shipments.

Step

Action to Take

Step 1

Create the Order

All Suppliers

  1. Click on Create a New Test Order
  2. Configure order fields > Continue
  3. Open the order in the portal
  4. Confirm the orders is in a Ready to Acknowledge status (this may take a moment)

Step 2

Create/Send an Acknowledgement

Instructions: Create an Acknowledgment accepting the whole order in the portal, see instructions below:

 

Portal Suppliers

  1. Click on Accept/Reject
  2. Under Acknowledgment Items enter in an Estimated Ship Date
  3. Submit
  4. Confirm the acknowledgment goes to a Complete status (this may take a moment)

Step 3

Create/Send a Shipment

Instructions: Create a Shipment shipping the whole order in 2 pallets in the portal, see instructions below:

 

Portal Suppliers

  1. Go back to the order
  2. Click on Ship
  3. Enter in a Ship-From Address (make sure the country code is 2 characters)
  4. Under Packages
    • Select another system (manual entry)
    • Click on Add Pallet twice so you have 2 pallets
  5. Delete the first Box
  6. In Pallet 1 include Line 1 Qty 3
  7. In Pallet 2 include Line 2 Qty 1
  8. Enter in dimensions for both boxes
  9. Leave Carrier and Tracking Number blank
  10. Under General Information enter in a Pickup Date
  11. Submit
  12. Confirm the shipment goes to a Complete status (this may take a moment)

Step 4

Create/Send an Invoice

Instructions: Create an Invoice invoicing the whole order in the portal, see instructions below:

 

Portal Suppliers

  1. From the shipment, click on New Invoice
  2. Under General Information enter in an Invoice Number
  3. Submit
  4. Confirm the invoice goes to a Complete status (this may take a moment)

Tip! Go back to the Testing page in the stage portal to review the results of your tests. It may take a few seconds for the screen to update. Confirm the test case goes to Complete.

 

 

Test Case 8: Single-Line Fulfillment

*Required for all suppliers using their own shipping account

 

Purpose: The purpose of this test is to accept, ship (in multiple boxes) and invoice a single-line order. The order is to be shipped in multiple boxes to test your ability to send a single shipment while indicating multiple boxes on the shipment for a single item. You will not use the merchant's account to create shipping labels. 

Step

Action to Take

Step 1

Create the Order

All Suppliers

  1. Click on Create a New Test Order
  2. Configure order fields > Continue
  3. Open the order in the portal
  4. Confirm the orders is in a Ready to Acknowledge status (it may take a few seconds to reach this status)
  5. EDI/API Suppliers: You will receive the order (EDI 850) in your system within 15 minutes 

Step 2

Create/Send an Acknowledgement

Instructions: Create/send an Acknowledgment (EDI 855) accepting the order using your preferred connection method. To create this document in the portal, see instructions below:

 

Portal Suppliers

  1. Click on Accept/Reject
  2. Under Acknowledgment Items enter in an Estimated Ship Date
  3. Submit

 

All Suppliers

Confirm the acknowledgment goes to a Complete status in the portal (this may take a moment)

Step 3

Create/Send a Shipment

Instructions: Create/send a Shipment (EDI 856) shipping the order in 2 boxes (1 box with Qty 1 and the other bo with Qty 0) using your preferred connection method. To create this document in the portal, see instructions below:

 

Portal Suppliers

  1. Go back to the order
  2. Click on Ship
  3. Enter in a Ship-From Address (make sure the country code is 2 characters)
  4. Under Packages
    • Select another system (manual entry)
    • Click on Add Box
  5. In Box 1 include Line 1 Qty 1
  6. In Box 2 include no items
  7. Enter in dimensions and a tracking number for both boxes
  8. Submit

 

All Suppliers

Confirm the shipment goes to a Complete status in the portal (this may take a moment)

Step 4

Create/Send an Invoice

Instructions: Create/send an Invoice (EDI 810) invoicing the order using your preferred connection method. To create this document in the portal, see instructions below:

 

Portal Suppliers

  1. From the shipment, click on New Invoice
  2. Under General Information enter in an Invoice Number
  3. Submit
  4. Confirm the invoice goes to a Complete status (this may take a moment)

All Suppliers

Confirm the invoice goes to a Complete status in the portal (this may take a moment)

Tip! Go back to the Testing page in the stage portal to review the results of your tests. It may take a few seconds for the screen to update. Confirm the test case goes to Complete.
 

Related articles

Powered by Zendesk