{"id":309,"date":"2020-03-16T11:25:18","date_gmt":"2020-03-16T11:25:18","guid":{"rendered":"https:\/\/zedinet.com\/?page_id=309"},"modified":"2020-03-17T14:58:07","modified_gmt":"2020-03-17T14:58:07","slug":"eadapater-part-1-video-transcript","status":"publish","type":"page","link":"https:\/\/zedinet.com\/index.php\/eadapater-part-1-video-transcript\/","title":{"rendered":"eAdapater Part 1 Video Transcript"},"content":{"rendered":"
\r\n\t
\r\n\t\t
\r\n\t\t\t

Transcript of “eAdaptor Part 1” video<\/h1>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<\/div><\/div><\/div><\/div><\/div><\/section>
\r\n\t
\r\n\t\t
\r\n\t\t\t

Hello<\/p>\n

This is the first of two tutorials that describe how to configure ZEDI so that it can exchange transactions with your CargoWise system. The topics covered are:<\/p>\n

    \n
  1. Configuring ZEDI to exchange transactions with CargoWise<\/li>\n
  2. Using metadata extracts to make life easier when handling CargoWise transactions<\/li>\n<\/ol>\n

    This tutorial deals with the first one.<\/p>\n

    We\u2019re going to work through an example based on two CargoWise environments, one for live transactions and the other for test transactions.<\/p>\n

    CargoWise sends and receives transactions via an interface called eAdaptor. It\u2019s useful to understand a little about how it works before we start.<\/p>\n

    In this example, our live CargoWise environment licence code is \u201cZBLWOKPRD\u201d and the test environment licence is \u201cZBLWOKTST\u201d.<\/p>\n

    Each of these has an eAdaptor interface attached to it. These interfaces have a URL like those shown here.<\/p>\n

    Your ZEDI environment also has an eAdaptor interface and again, it has a URL like this.<\/p>\n

    When one of your CargoWise environments has a transaction it needs ZEDI to process, it connects to the ZEDI URL and delivers the file.<\/p>\n

    Similarly, when ZEDI has a transaction for CargoWise, it will use the appropriate URL to deliver it.<\/p>\n

    The connections between CargoWise and ZEDI make use of the https: protocol, so the transactions are securely encrypted as they pass between the two systems.<\/p>\n

    If the eAdaptors in your CargoWise environments have not yet been configured, then this will need to be done as a first step.<\/p>\n

    Instructions for doing this can be found in the CargoWise document \u201cTechnical Guide \u2013 eAdapter SDK.pdf\u201d, or you may choose to ask your CargoWise supplier to set it up for you. Either way, the things you need to determine are:<\/p>\n

      \n
    1. The user ID that ZEDI will need to use in order to connect to your eAdaptor<\/li>\n
    2. The password ZEDI will need to use.<\/li>\n
    3. The URLs for the production and test eAdapters.<\/li>\n<\/ol>\n

      The first two are specified in the \u201ceServices\\eAdapter Inbound Authentications\u201d section of the CargoWise registry. For this example, we\u2019re going to say that the user ID will be \u201cZEDI\u201d and the password will be \u201cCar0Emer@ld\u201d.<\/p>\n

      The URL is commonly in this format:<\/p>\n

      [Enterprise] is the first three characters of your CargoWise licence, and [origin] is the last three characters. In our case, the licence is \u201cZBLWOKPRD\u201d so the URL for the production licence would be:<\/p>\n

      We\u2019re going to set up ZEDI so that it will be able to deliver transactions into the two eAdaptors on CargoWise.<\/p>\n

      The first thing we need is a trading partner to represent CargoWise as a whole. It will look something like this:<\/p>\n

      Note that the default communications method is set to \u201ceAdaptor\u201d.<\/p>\n

      The details of the eAdaptors on your CargoWise environments are entered in the \u201cCommunications\u201d section.<\/p>\n

      Set the communications method to \u201ceAdapter\u201d and complete the URL in the \u201cProduction\u201d section.<\/p>\n

      The \u201crecipient\u201d is ZBLWOKPRD for our live environment, and the \u201csender\u201d will be the user ID that was setup in the CargoWise registry.<\/p>\n

      Now enter the corresponding password in the \u201cpassword\u201d field<\/p>\n

      Do the same thing for the test CargoWise environment in the \u201cTest\u201d section using the test URL, recipient, sender and password.<\/p>\n

      Once this has been done, ZEDI has everything it needs to be able to send transactions into CargoWise, so save the changes.<\/p>\n

      We now need to configure ZEDI it so that it can receive transactions FROM CargoWise.<\/p>\n

      This is done on the \u201ceAdaptor\u201d section of the \u201cCommunications\u201d page.<\/p>\n

      Invent a suitable password for the \u201cCargoWise password\u201d field. This will be the password that your CargoWise environments will need to provide in order to successfully deliver a transaction into ZEDI, so make a note of it.<\/p>\n

      Now use the \u201cAdd\u201d row to add your production licence code to the list of IDs.<\/p>\n

      The ID Type will be \u201cInternal\u201d as this is an ID that is owned by your business. IDs can also be defined as \u201cExternal\u201d, these would be used when using ZEDI as an eAdaptor gateway, that\u2019s the subject of another video.<\/p>\n

      We don\u2019t need to provide a password for Internal IDs because ZEDI will expect the one entered at the top of the page to be used.<\/p>\n

      Since this is the live ID, we\u2019ll set the mode to \u201cPROD\u201d. Now select the trading partner you created to represent CargoWise as a whole, and click the \u201cAdd\u201d button.<\/p>\n

      Do the same thing for the test licence code, but this time set the mode to \u201cTEST\u201d.<\/p>\n

      You\u2019ll now need to setup the outbound eAdaptor in CargoWise. Again, instructions for doing this can be found in the CargoWise document \u201cTechnical Guide \u2013 eAdapter SDK.pdf\u201d, or you may choose to ask your CargoWise supplier to set it up for you.<\/p>\n

      Whoever does this will need the password, the one you just entered on the eAdapter settings screen in ZEDI, and the URL for your eAdaptor. The URL will be in this format:<\/p>\n

      So, if your service provider\u2019s domain was \u201czirconblue.com\u201d, and your environment code was \u201cZB\u201d, the URL would be this:<\/p>\n

      Note that the URL begins with https:\/\/ rather than http:\/\/. This is important as it ensures that the transactions are sent securely between CargoWise and ZEDI.<\/p>\n

      In CargoWise, the eAdapter Outbound Messages service task needs to be enabled and running.<\/p>\n

      The password needs to be entered in the CargoWise registry under \u201ceServices\\eAdapter Outbound Password\u201d.<\/p>\n

      The URL also needs to be entered in the CargoWise registry under \u201ceServices\\Outbound eAdapter Service URL\u201d.<\/p>\n

      Within CargoWise, you can now trigger a test message by setting up a trigger which sends a Universal XML to the ZEDI eAdaptor. Once again, information on how to do this can be found in the CargoWise document \u201cTechnical Guide \u2013 eAdapter SDK.pdf\u201d.<\/p>\n

      CargoWise will always use the nine-character licence code as the user ID to logon to the ZEDI eAdaptor.<\/p>\n

      ZEDI will validate that user ID by comparing it to the list of valid licence codes you setup in the \u201ceAdaptor\u201d section. If the user ID is not recognised, then the file will be rejected and it will appear in CargoWise as a \u201cTransmission error\u201d or something similar.<\/p>\n

      ZEDI will also check the password CargoWise provided to ensure it matches the one entered in the \u201cSettings\u201d section within ZEDI.<\/p>\n

      If everything is okay, then the file will be added to the list of transactions as a file from the partner you selected when you added the licence code in the \u201ceAdaptor\u201d section.<\/p>\n

      ZEDI can then perform whatever sequence of actions need to be done in order to process the transaction. Typically the first of these will be a \u201cMetadata Extract\u201d which will identify the final recipient of the transaction, the consignee for example, and the type of data the transaction contains such as \u201cForwardingConsol\u201d.<\/p>\n

      This metadata will then allow the transaction to be accurately processed through ZEDI and is the subject of the next tutorial.<\/p>\n

      Transactions can be sent TO your CargoWise system by setting up a \u201cPost transaction\u201d action.<\/p>\n

      In this example, we\u2019re going to send an inbound \u201cAccountingInvoice\u201d transaction from ACE Vegetables that has a condition of \u201cMapped\u201d.<\/p>\n

      The action we\u2019re using is called \u201cPost transaction\u201d and we\u2019ve selected our CargoWise partner as the trading partner it will be sent to.<\/p>\n

      You may remember that we setup two CargoWise licence codes when we created this partner, once for the live system and the other for test. ZEDI will choose which to use based on the mode of the transaction. So live transactions go to the live licence, and test transactions go to the test licence.<\/p>\n

      We\u2019ve left the communications method as [Partner default].<\/p>\n

      When we created the CargoWise partner we set the default communications type to eAdaptor, so the transaction will be delivered using the recipient, sender and password entered on the partner definition.<\/p>\n

      If we change this from [Partner default] to \u201ceAdaptor\u201d, then a button called \u201cAdditional settings\u201d will appear. This allows us to override the recipient and sender This can be useful when you have multiple licences and need to ensure that the costs are assigned correctly within CargoWise.<\/p>\n

      The recipient and sender can either be set explicitly, or you can use fields from the metadata to set them. For example, if the transactions have an item of metadata called \u201cCWRecipient\u201d which contains the required recipient ID, then you can set the recipient to \u201c[meta:CWRecipient]\u201d rather than set it to a fixed value.<\/p>\n

      Once the action has been performed, the history of the transaction will record whether or not it was accepted by CargoWise.<\/p>\n

      If it was then an AED0002 entry will record the tracking ID that was used.<\/p>\n

      If the file could not be delivered then the history will record detailed information about the cause of the problem.<\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<\/div><\/div><\/div><\/div><\/div><\/section>\n<\/div>","protected":false},"excerpt":{"rendered":"Transcript of \"eAdaptor Part 1\" video Hello This is the first of two tutorials that describe how to configure ZEDI so that it can exchange transactions with your CargoWise system. The topics covered are: Configuring ZEDI to exchange transactions with CargoWise Using metadata extracts to make life easier when handling CargoWise transactions This tutorial deals...","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-309","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/zedinet.com\/index.php\/wp-json\/wp\/v2\/pages\/309","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/zedinet.com\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/zedinet.com\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/zedinet.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/zedinet.com\/index.php\/wp-json\/wp\/v2\/comments?post=309"}],"version-history":[{"count":3,"href":"https:\/\/zedinet.com\/index.php\/wp-json\/wp\/v2\/pages\/309\/revisions"}],"predecessor-version":[{"id":349,"href":"https:\/\/zedinet.com\/index.php\/wp-json\/wp\/v2\/pages\/309\/revisions\/349"}],"wp:attachment":[{"href":"https:\/\/zedinet.com\/index.php\/wp-json\/wp\/v2\/media?parent=309"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}