AS2 Connection setup for Walmart RetailLink GEM

A complete guide to Walmart AS2 connection setup on RetailLink Global Enterprise Mailbox GEM

20 May 2021 by Asankha Perera
Categories | AS2 EDI
Tags | walmart

The Walmart RetailLink application and its Global Enterprise Mailbox (GEM) configuration can be a challenge, especially if you are configuring an AS2 connection with Walmart for the first time. While the user interface could certainly be more intuitive and user-friendly, the use of the word ‘certificate’ throughout the AS2 configuration pages could result in some confusion.

Knowing where each of the AS2 configuration items exist within RetailLink and the Global Enterprise Mailbox will help you can navigate to those pages and help you to successfully configure and test an AS2 connection without hiccups. We will demonstrate the AS2 configuration with a MFTGateway Software as a Service (SaaS) or actually ‘AS2 as a Service’ account, which gives you a one month free trial, with openly published pricing that ensures that you are not charged on how deep your pockets are, and that there are no hidden fees or penalties for your AS2 communications. The lowest package start at $9 per month, and the cost will be based on the volume of messages exchanged, as you pay only for what you use. The complementary service EDIGenerator could optionally allow you to view EDI files received such as X12 850 Purchase Orders, and create 856 ASN and 810 Invoices. This will be covered in a subsequent post.

When you login to your Walmart RetailLink account, you will land on its home page

Walmart RetailLink home page Open image on lightbox

Select ‘EDI-B2B’ under ‘Apps’ and you will see your main page for EDI communications with Walmart.

ED2-B2B App Open image on lightbox

The AS2 communication is configured under the ‘Global Enterprise Mailbox’ or GEM. When you visit the GEM, you will be presented with the Batch Search page as the home. Your main interactions however, will be through the menu item links at the top.

Global Enterprise Mailbox (GEM) Open image on lightbox

Creating a new mailbox

First we will need to create a new mailbox. Navigate to ‘Document Testing’ and then ‘Survey’ and select your vendor account to be used from the dropdown. For the mailbox ID dropdown, select ‘New Mailbox’ and click ‘Next Page’.

How to create a new mailbox Open image on lightbox

Then you will be presented with a few questions, which will allow you to select if you want to proceed with the creation of a new mailbox for AS2 communications. Answer the questions and click ‘Next Page’.

Complete the AS2 questionnaire Open image on lightbox

You are then taken into a page with a Survey, where your intended use is understood. Continue with your answers and click ‘Next Page’.

AS2 and EDI communications intended Open image on lightbox

Your contact information for the new mailbox is then requested. You can leave the already existing information and proceed to the ‘Next Page’.

Enter vendor contact information Open image on lightbox

Finally select the EDI transactions intended to be performed over your AS2 connection, and click the ‘Complete’ button.

Select the intended EDI transactions Open image on lightbox

Creating your AS2 communications infrastructure

Visit the MFTGateway and signup for a new trial account. After completing the registration process and logging into the MFTGateway console, you will see your main menu bar to the left of your screen. The MFTGateway is a very intuitive application with an Inbox and Outbox and operates similarly to a web based email service. However, with AS2, you can only send or receive files with pre-configured trading partners. So you will need to create an AS2 Station in your MFTGateway account and one Partner to represent Walmart. If you want to exchange documents with more partners, you will need to create more configurations under Partners. However, you can, and most possibly should, reuse the same AS2 Station you create as separate Stations and IDs are not required, and one station is enough for one organization.

Creating an AS2 Station

To create your AS2 Station, click ‘Stations’ from the menu and then click ‘New Station’.

Create AS2 station Open image on lightbox

Specify your desired AS2 ID with which you will be identified by Walmart. At this step the MFTGateway will be able to generate a certificate to prove your identity, and to be used for encryption and digital signatures during AS2 communications. Usually AS2 trading partners generate their certificates using the AS2 products they use, like the MFTGateway, and thus these certificates are rarely counter signed by an external Certification Authority - although that is an option, if your trading partner requires it. Walmart does not require such counter signing by a Certification Authority (CA). Provide your organization name, email and other details such as country etc. Make sure to select the key length as 2048 and the validity as 5 years, and remember to also specify a password for the certificate. Walmart will not accept key lengths below 2048 and expects a validity period in the range of ~5 years.

The Partner Configuration of an AS2 Station

After the AS2 Station is created, go into its ‘Partner Configuration’ and you will be presented with all of the information required for your trading partner to setup their side of the AS2 communications. Download your certificate by clicking the ‘Download as PEM’ and then save the file with the file extension ‘.cer’. You can also easily email this information to yourself or anyone else using the email feature at the bottom of the page.

Partner configuration to share with trading partner Open image on lightbox

Now switch to the RetailLink configuration and navigate to ‘Certificate Management’ and then ‘Mailbox maintenance’ by clicking the ‘Start’ link.

Mailbox maintenance page Open image on lightbox

Then click the ‘EDIENT (AS2)’ link at the top.

Mailbox maintenance page Open image on lightbox

For the ‘Supplier’ section, enter the AS2 ID you used for your AS2 Station, and the URL for the AS2 communications, from the ‘Partner Configuration’ of your AS2 station. Note that specifying a HTTPS URL will result in Walmart also selecting a HTTPS URL for its end - but this is not required as AS2 protocol automatically encrypts and digitally signs all message payloads.

EDIINT (AS2) configuration Open image on lightbox

Next click ‘Certificate Details’ link and upload the certificate you saved from the MFTgateway application as a ‘.cer’ file.

Upload vendor certificate Open image on lightbox

Now you will see a successful screen like below, where you will see the certificate you uploaded being correctly assigned to the vendor communications profile. You can now download the Walmart certificate from this screen under the walmart communications profile, by clicking the download icon.

Certificate exchange Open image on lightbox

Once the above is complete, if you navigate back to ‘Mailbox Maintenance’ and then ‘EDIINT (AS2)’ and then click ‘Certificate Details’, You can see the configured digital certificates and the details as follows.

AS2 Connection test Open image on lightbox

Creating an AS2 Partner on the MFTGateway

You will now create a Partner in your MFTGateway account to represent Walmart, and use the configuration from RetailLink to populate this information. Use the AS2 ID and the URL from the last screen, and use the certificate downloaded.

Create AS2 partner Open image on lightbox

Initiating a test message from Walmart

Now click the ‘Certificate Connectivity’ link in the RetailLink window.

AS2 Connection test Open image on lightbox

Click ‘Test Connection’ to request Walmart to send a test AS2 file transmission to your AS2 Station.

AS2 Connection report Open image on lightbox

If successful, a detailed report is presented, and if an issue is encountered, the detailed report will help you rectify the issue. This step could be a bit complicated when using HTTPS as Walmart will need to trust the HTTPS or SSL certificate of the MFTGateway or any other AS2 application used. It is recommended to use HTTP for the reasons detailed earlier. You can also see the MDN or Message Disposition Note sent by the remote AS2 station.

AS2 Connection report Open image on lightbox

Your AS2 connection with Walmart is now complete and tested to be successful.

AS2 Connection test complete Open image on lightbox

Looking at the received message from the MFTGateway

Go to the Inbox of the MFTGateway, and you will see the message sent by Walmart.

Received AS2 test message Open image on lightbox

The file sent is usuall called sendTest_X12.txt and contains a message similar to whats shown below.

ISA*00* *00* *ZZ*SENDER *ZZ*RECEIVER *110412*1438*:*00501*864000001*0*T*>~GS*TX*SENDER*RECEIVER*20110412*1438*864000001*X*005010~ST*864*0001~BMG*00*CONNECTIVITY TEST*03~N1*FR*WAL-MART HOME OFFICE 8053*UL*0078742000008~N1*TO*VALUED SUPPLIER PARTNER~REF*IA*000000~MIT*MESSAGE*THIS IS A CONNECTIVITY TEST*175*60~MSG*WE HOPE YOU RECEIVED THIS MESSAGE.*SS~MSG*HAVE A GREAT DAY!*SS~MSG*WAL-MART SUPPLIER SUPPORT*SS~MSG*479-273-8888*SS~MSG*GEM@WAL-MART.COM*SS~SE*12*0001~GE*1*864000001~IEA*1*864000001~

Received AS2 test message detail Open image on lightbox

Sending a test message to Walmart

Click the ‘Compose’ button at the top left side of the MFTGateway and select the Walmart Partner created and the AS2 station pair. You can select the file to be sent as the content, and click ‘Send’.

How to create an AS2 message to be sent Open image on lightbox

Once the test message is transmitted, it will appear on the ‘Sent’ box and will show a green color (i.e. everything ok) state and the received MDN.

Sent box containing the messages sent Open image on lightbox

Navigate to the ‘Mailbox’ and then ‘Batch Search’. Ensure the proper mailbox is selected on the dropdown, and check the direction ‘To Walmart’ and then click ‘Search’.

Received message appearing in the Walmart GEM Open image on lightbox

EDI X12 configuration for Walmart

Follow through our articles to find out how to perform EDI testing through the RetailLink Global Enterprise Mailbox.