Version 1.1. How to use. Onetrail Self connect via TPN Manager. Page 1 of 10

Transcription

1 Version 1.1 How to use Onetrail Self connect via TPN Manager Page 1 of 10

2 A guidance to new Trading Partners This Document is designed to give guidance to new trading partners, using the Onetrail TPN Manager to assist in connecting to their customers via Onetrail TPN. Be aware that functionality and screenshots might differ due to your rights to the respective application. By using the Onetrail Manager you can manually validate the format of your messages and automatically validate your messages on business rules in Onetrail TPN. The validation is done for Onetrail XML version 3.1, EDIFACT D97A and EDIFACT D96A. Please read this Manual carefully before you start using the app. This document contains 5 chapters: 1. User Account and URL to login 2. Start screen TPN Manager 3. Upload and validate a file on format 4. Business rules validation 5. Go live Page 2 of 10

3 1. User Account and URL to login Welcome to the TPN Manager of Onetrail. Onetrail has setup a user account to login in the TPN Manager. Your Company role is set to either Seller or Buyer. You received an from Onetrail to confirm your account. You must create your own password by confirming within 24 hours. After the confirmation, you can login on the online TPN Manager Application. When the link has expired click on "Recover your password?" to (re-)set your password. Your address is also your username in lowercase. Page 3 of 10

4 Please use this link: Page 4 of 10

5 2. Start screen TPN Manager After you logged in, you see the start screen. You see an overview of all steps and possibilities on the left side of the screen. Page 5 of 10

6 3. Upload and validate a file on format When you created or generated via your system a XML or EDIFACT file you can validate it via our format checker. On the left side please choose the option Messages. In the middle you ll see the messages activated for you. Depending on your Company role you can choose and validate the following messages: Buyer: Order Request Standard Seller: Acknowledgement Order Response Despacth Advice Invoice When you select Messages you ll see different tabs, select tab Validate Fomat first. Page 6 of 10

7 On the left bottom you ll see a button also called Validate Format. Click on this button and select the Choose file button. Select the file for which you want the format to be validated. Next click the Submit button. Your file is now uploaded and validated against the format validator in the Onetrail TPN environment. Remark: For XML we use the XSD and for EDIFACT we use the directory structure. You can use XML and TXT files, also txt files containing the XML structure. The Result of the validation will be shown in the middle. You see different columns: Input Message Contains the file you ve uploaded o When the file is correct format it will be shown via a stylesheet view. At the bottom of the screen you can switch layouts via which when clicked changes to File name File name of the file you ve uploaded Date The date and time when you uploaded this file and back. You can also download (Original format) the message via Result - = OK, = Not OK. Page 7 of 10

8 Report Contains the validation result. Either the Error or the OK. Be aware that only the first error is shown as the validation can t continue till that error is solved. You might need several uploads to get all errors out one by one. For XML you can validate against the XSD locally which should give you the same result. Uploading can be done as final check. Page 8 of 10

9 4. Business rules validation Once passed the format validation you can continue with the next step, the Business rules validation. You need to send your messages to our Onetrail Test Seller or Test Buyer, their GLN s will be provided through the Onetrail TPN Delivery department. You need to use the in Onetrail TPN Network configured communication method. The connector should already be activated for you. When in doubt contact the Onetrail TPN Delivery department via or via TPN.Delivery@Onetrail.com. As soon as the message(s) are / is send and processed you ll see the Validation report in the TPN Manager app. On request we can also activate sending the report via . The validation report shows you the Errors and Warnings on Business level. The Onetrail TPN Validator is used to validate your messages on both technical and business process level. The required constraints are set by the XSD and the Business rules are defined by the Onetrail TPN Delivery department. More detail information about this process can be found on our ODC. For Buyers the Order Request Standard validator service is extended with a Simulator which generates retrun messaging based on scenario s. See our ODC for more detail. Page 9 of 10

10 You see different columns: Input Message Contains the file you ve uploaded Scenario Displays the secenario used Ref reference of the file you ve uploaded, i.e. the order number or Invoicenumber. Date The date and time when you uploaded this file Result - = OK, = Not OK. Report Contains the validation report. Either the Error or the OK. o All the Errors and Warnings are shown. You might need several uploads to get all errors out. At the bottom of the screen you can switch 5. Go live layouts via which when clicked changes to and back. You can also download (XML format) the Validation Report via Once passed the business validation you can ask the Onetrail TPN Delivery department for approval to go live. Tel: or via TPN.Delivery@Onetrail.com Page 10 of 10