Skip to content
  • There are no suggestions because the search field is empty.

XML/JSON Test Cases

Below are the written steps to take to complete the test cases via XML or JSON.

NOTE: You would use the Stage Portal Testing module to create your test orders as well as see the results on the files you send back (Acknowledgement, Shipment, Invoice).
 
Test Case Summary (see further below for the steps to take for each test):
  • Test Case 1: Single Line PO
    • The purpose of this test is to fulfill a single line purchase order by creating a shipment and an invoice.
  • Test Case 2: Multi Line PO
    • The purpose of this test is to fulfill a multi line purchase order by creating a shipment and an invoice for all line items.
  • Test Case 3A - Accept/Cancel Line Items on a Multi Line PO
    • The purpose of this test is to cancel line item 1 and then ship and invoice line item 2.
  • Test Case 3B - Accept/Cancel Lines on Multi Line PO via a Shipment
    *NOTE* You only need to complete this test case if you are processing a cancellation via a Shipment.
    • The purpose of this test case is to cancel line 1 from the order and ship line 2 in a single Shipment file (856). The only vendors who need to complete this test case are the ones who need to process a cancellation via a shipment file (by EDI, API, etc).
  • Test Case 4: Accept/Return Single Line PO
    • The purpose of this test case is to fulfill a single line purchase order by creating a shipment and an invoice, and then creating a return for the line item.

NOTE: When you pick up an order from FTP/SFTP, you should either pick it up and delete it from the FTP folder location OR move it to a folder under /APIXML/Archive or /JSON/Archive.

Test Case 1: Single Line PO

Step

Document

Description

FTP/SFTP

1

Order

Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the order through the established connection. The order will contain one line item.

The order file is sent to Logicbroker's Stage FTP/SFTP site:

/APIXML/Inbound/Order or

/JSON/Inbound/Order

2

Shipment

The shipment file will need to make sure to ship the line item and contain the shipping carrier as well as the tracking information.

The shipment file is posted to: 

/APIXML/Outbound
/Shipment

or
/JSON/Outbound
/Shipment

3

Invoice

The invoice will be for the item that shipped on the order.

The invoice file is posted to: 

/APIXML/Outbound
/Invoice

or
/JSON/Outbound
/Invoice

4

Review Test Results

NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

 

Test Case 2: Multi Line PO

Step

Document

Description

FTP/SFTP

1

Order

Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the order through the established connection. The order will contain two lines of items.

The order file is sent to Logicbroker's Stage FTP/SFTP site:

/APIXML/Inbound/Order or

/JSON/Inbound/Order

2

Shipment

You will need to create the shipment for both lines on the purchase order using the requested Shipping Method on the order.

The shipment file is posted to: 

/APIXML/Outbound
/Shipment

or
/JSON/Outbound
/Shipment

3

Invoice

The invoice will be for the items that shipped on the order.

The invoice file is posted to: 

/APIXML/Outbound
/Invoice

or
/JSON/Outbound
/Invoice

4

Review Test Results

NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

 

 

Test Case 3A: Accept/Cancel Line Items on a Multi Line PO

Step

Document

Description

FTP/SFTP

1

Order

Vendor/Supplier will create the order and it will contain two lines of items, then Logicbroker will send the order through the established connection.

The order file is sent to Logicbroker's Stage FTP/SFTP site:

/APIXML/Inbound/Order or

/JSON/Inbound/Order

2

Acknowledgment

The acknowledgement file should cancel quantity 1 (of 1 ordered) from the first line and accept the second line of the order. One of the following cancellation codes should be used:

  • Administrative Request
  • Bad Address
  • Cancelled at retailer's request
  • Cannot ship to PO box
  • Discontinued Item
  • Invalid SKU
  • Out of stock
  • Other

The acknowledgement file is posted to: 

/APIXML/Outbound
/Acknowledgement

or
/JSON/Outbound
/Acknowledgement

3 Shipment You will need to create a shipment for the remaining items from line 2 on the purchase order using the requested Shipping Method on the order.

The shipment file is posted to: 

/APIXML/Outbound
/Shipment

or
/JSON/Outbound
/Shipment

4

Invoice

The invoice file will be for all shipped items on the order.

 

The invoice file is posted to: 

/APIXML/Outbound
/Invoice

or
/JSON/Outbound
/Invoice

5

Review Test Results

NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

 

Test Case 3B: Accept/Cancel Line Items on a Multi Line PO via a Shipment

Step

Document

Description

FTP/SFTP

1

Order

Vendor/Supplier will create the order and it will contain two lines of items, then Logicbroker will send the order through the established connection.

 

The order file is sent to Logicbroker's Stage FTP/SFTP site:

/APIXML/Inbound/Order or

/JSON/Inbound/Order

2

Shipment/ Acknowledgment

The shipment/acknowledgement

should cancel the first line and ship the second line of the order. Make sure to use one of the accepted Cancellation Codes:

  • Administrative Request
  • Bad Address
  • Cancelled at retailer's request
  • Cannot ship to PO box
  • Discontinued Item
  • Invalid SKU
  • Out of stock
  • Other

As well as the requested Shipping Method on the order.

The shipment file is posted to: 

/APIXML/Outbound
/Shipment

or
/JSON/Outbound
/Shipment

3

Invoice

The invoice file will be for all shipped items on the order.

 

The invoice file is posted to: 

/APIXML/Outbound
/Invoice

or
/JSON/Outbound
/Invoice

4

Review Test Results

NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.

 

Test Case 4: Accept/Return Single Line PO

Step

Document

Description

FTP/SFTP

1

Order

Vendor/Supplier will create the order in Stage Portal, then Logicbroker will send the order through the established connection. The order will contain one line item.

The order file is sent to Logicbroker's Stage FTP/SFTP site:

/APIXML/Inbound/Order or

/JSON/Inbound/Order

2

Shipment

The shipment file will need to make sure to ship the line item and contain the shipping carrier as well as the tracking information.

The shipment file is posted to: 

/APIXML/Outbound
/Shipment

or
/JSON/Outbound
/Shipment

3

Invoice

The invoice will be for the item that shipped on the order.

The invoice file is posted to: 

/APIXML/Outbound
/Invoice

or
/JSON/Outbound
/Invoice

4

Return

You will need to create a return for the line item shipped and invoiced from the PO. Make sure you are using a valid Return Reason:

Wrong item shipped
Damaged shipment
Product quality issue
Product not as described
Defective product
Too small
Too large
Too short
Too long
Not satisfied with sizing
Not satisfied with color

The return file is posted to: 

/APIXML/Outbound
/Return

or
/JSON/Outbound
/Return

5

 

Review Test Results

NOTE: Go back to the Testing module in Stage Portal to review the results of your tests.