Inbound EDI

1. Create a profile.

2. Create an inbound transformer.

3. Create a trading capability for inbound EDI.

4. Create a partnership for inbound EDI.

5. Test your transformation workflow. For details, see the Testing end-to-end topic from our EDI document exchange with AWS B2B Data Interchange workshop.

To create a profile

1. Open the AWS B2B Data Interchange console at https://console.aws.amazon.com/b2bi/ and select Profiles from the navigation pane, then choose Create profile.

2. Enter the profile details, the name of the profile, the name of the business represented, and the contact information (email and phone number).

3. Logging is selected by default. Clear the box to turn off logging (not recommended). The log group is based on the profile ID, for example, /aws/vendedlogs/b2bi/p-ABCDE111122223333.

4. Optionally, add tags as needed.

   

To create a transformer

1. Open the AWS B2B Data Interchange console at https://console.aws.amazon.com/b2bi/ and select Transformers from the navigation pane, then choose Create transformer.

2. Select a transformer name (for example edi-214-json), the direction, the EDI doc number, and version. Then, provide a sample document by selecting a document from Amazon S3. The sample document can preview how your EDI documents get converted.

   1. Enter a name (no spaces).

   2. Ensure that Inbound EDI is selected.

   3. For Input Details, select an EDI document number and X12 version from the dropdown menus.

   4. For Input Details, select JSON or XML.

   5. Optionally, in the Sample documents pane, provide the bucket and prefix in Amazon S3 for the sample input and output files. This is useful for making sure the transformer functions correctly.

   6. Optionally, add tags as needed.

   7. Select Next to proceed to the next step in the wizard.

3. The Mapping configuration screen is displayed. If you provided a sample input document in the previous step, the default representation for your sample is displayed. You can use generative AI-assisted EDI mapping to expedite the mapping configuration. For details, see Generative AI-assisted EDI mapping.

   If you chose not to customize the output format using the Mapping template editor, AWS B2B Data Interchange transforms EDI document inputs using the default, service-defined format shown on the left side of your screen.

   You can also use the Mapping template editor to only include certain pieces of your EDI documents.

   The pieces you select are previewed in the mapping preview pane.

   The items in your mapping editor are the only items that are extracted from the input EDI document, and that are then saved to your output file, located in your Amazon S3 output location.

   This example shows ref ID, shipment ID, and b of lading number, from and to city, and the shipment status code.

4. When you are happy with your mappings, choose Next, which takes you to the review page. Note that newly created transformers are inactive.

   Note

   A status of Inactive indicates that the transformer is not used in any trading capabilities: it is essentially in edit mode. When you are finished editing and updating the transformer, you change the status to Active. Then, you can associate the transformer with a trading capability. At this point, the transformer is essentially locked, and in production mode.

5. After your review is complete, choose Save to create the transformer.

To create a trading capability

1. Open the AWS B2B Data Interchange console at https://console.aws.amazon.com/b2bi/ and select Trading capabilities from the navigation pane, then choose Create trading capability.

2. In the Trading capability settings section, enter the following information.

   • Enter a descriptive, unique name for the trading capability.

   • Select an EDI direction, either Inbound or Outbound.

   • Choose an X12 version and X12 transaction set from the corresponding dropdown menus.

   • In the Apply transformer field, choose a transformer to apply to this trading capability.

3. In the Configure directories section, you configure both the input and output directories that are used to source and store documents.

   • In the Input directory area, enter an Amazon S3 bucket.

   • Choose Browse S3 to navigate to your available Amazon S3 buckets, where you can select a bucket (and optionally a prefix) to specify your input directory.

     Note

     B2B Data Interchange will create and monitor prefixes in your input directory for input X12 documents (for inbound X12) or for input JSON/XML documents (for generating X12).

   • Choose Copy policy to copy a policy that you can then paste into your input directory's bucket policy.

   • Configure your output directory in the Output directory area, similarly to how you configured the input directory.

     Note

     B2B Data Interchange will create prefixes in the specified output directory to store the transformed X12 documents (in the case of inbound X12) or storing the generated X12 documents (in the case of outbound X12).

4. Optionally, add tags as needed.

5. After you have configured all of the settings, choose Create capability.

To create a partnership

1. Open the AWS B2B Data Interchange console at https://console.aws.amazon.com/b2bi/ and select Partnerships from the navigation pane, then choose Create partnership.

2. In the Partnership details section, provide the following information.

   1. Enter a descriptive name for the partnership.

   2. Enter an email address to associate with the partnership. Provide the trading partner's email address.

   3. Choose a profile from the dropdown menu.

   4. Select one or more trading capabilities from the Trading capabilities list.

3. Unless you intend to perform outbound EDI processing with this partner, you can skip the Outbound EDI configuration section.

4. Optionally, add tags as needed.

5. After you have configured all of the settings, choose Create partnership.