Requirements for EDI to TMS

From UG

(Difference between revisions)
Jump to: navigation, search
(Figure Integration Points)
(About and See also)
 
(28 intermediate revisions not shown)
Line 2: Line 2:
== About and See also ==  
== About and See also ==  
-
This is a Analysis / Requirements wiki for EDI to TMS proj
+
This is a Analysis / Requirements wiki for EDI to TMS proj Mantis: [http://mantis.jaguarfreight.com/mantis/view.php?id=2183 2183]
=== Related ===
=== Related ===
Line 22: Line 22:
== Introduction ==
== Introduction ==
-
'''Core Business Need:''' Jaguar needs ability to '''optimize''' truck domestic shipments:
+
'''Core Business Need:''' Jaguar needs ability to '''optimize''' truck domestic shipments:  
 +
* create optimal loads and routs (''About Loads and Shipments'' p151, ''Consolidation'' p173 , TM 10.1.3 Users Guide.pdf in mantis http://mantis.jaguarfreight.com/mantis/view.php?id=2183)
 +
** see also http://mantis.jaguarfreight.com/mantis/view.php?id=1920
-
* create optimal loads, cost, routs, etc
+
Above features are normally present in [[TMS]] software. In addition this kind of system can:
-
* automate tariffs, communication with carriers
+
* automate tariffs (''Working with Contracts chapter'')
-
 
+
* communication with carriers
-
Above features are normally present in [[TMS]] software.
+
To achieve that it was decided:
To achieve that it was decided:
Line 36: Line 37:
To complete phase 1 we need to implement:
To complete phase 1 we need to implement:
-
* [[#Vendor evaluation]]
+
* [[#Vendor evaluation]] (completed)
-
* [[#CT2 and TMS integration]]
+
* [[#CT2 and TMS integration]] - arrange data interchange
-
* [[#TMS User interaction and workflow]]
+
* [[#TMS User interaction and workflow]] - how CT2 (Client and Internal) will be used in conjunction with TMS
=== Vendor evaluation ===
=== Vendor evaluation ===
Line 46: Line 47:
* from Lean Logistics
* from Lean Logistics
-
=== CT2 and TMS integration ===
+
=== CT2 and TMS integration in a nutshell ===
In a nutshell:
In a nutshell:
* (shipment record will be created in CT2 and approved)
* (shipment record will be created in CT2 and approved)
-
* '''IP1:''' New CT2 forwarded to TMS through EDI  
+
 
 +
* '''IP1: Shipment Import''' New CT2 forwarded to TMS through EDI  
 +
 
* (in TMS Jag oper will run optimizations and select carrier)
* (in TMS Jag oper will run optimizations and select carrier)
 +
* (TMS sens bids to carriers)
* (TMS sens bids to carriers)
-
* '''IP2:''' TMS sends updates to CT2 (Carrier suggested, estim. pick up date, etc)
+
 
-
* (carrier accepts the bid)
+
* '''IP2: Load Plan, code 990''' TMS sends updates to CT2 (Carrier confirmed, etc)
-
* '''IP3:''' TMS sends updates to CT2 (Carrier confirmed, etc)
+
 
* (start processing shipments)
* (start processing shipments)
-
* '''IP4:''' carrier '''periodically''' submits updates into TMS (example: actual pickup date, etc)
 
-
See Figure below:
+
* '''IP3: Status Message, code 214''' TMS '''periodically''' submits updates into TMS (example: actual pickup date, etc)
-
==== Figure Integration Points as defined by Lean====
+
 
-
[[File:Ip lean 1.JPG]]
+
See Figure below:
-
[[File:Ip lean 2.JPG]]
+
==== Figure Integration Points as defined by Descartes ====
==== Figure Integration Points as defined by Descartes ====
Line 73: Line 75:
Below are some examples of EDI messages used in Transportation
Below are some examples of EDI messages used in Transportation
Manager.
Manager.
-
* 204 – Load tender message from Transportation Manager to the
 
-
carrier. A load tender is a request to pick up a shipment and move it to
 
-
another location.
 
-
* 990 – The carrier’s tender response back to Transportation Manager
 
-
(either a yes for picking up the shipment or no for not picking up the
 
-
shipment).
 
-
* 214 – A status message from the carrier to Transportation Manager
 
-
(e.g., “Delivered”).
 
-
* 210 – An invoice from the carrier to Transportation Manager. The
 
-
invoice will have the cost details of moving the shipment.
 
-
=== User to TMS interaction and workflow ===
+
* '''Shipment Import'''
 +
* 204 – Load tender message from Transportation Manager to the carrier. A load tender is a request to pick up a shipment and move it to another location.
 +
* 990 – '''Load Plan''' - The carrier’s tender response back to Transportation Manager (either a yes for picking up the shipment or no for not picking up the shipment).
 +
* 214 – A '''Status message''' from the carrier to Transportation Manager (e.g., “Delivered”).
 +
* 210 – An invoice from the carrier to Transportation Manager. The invoice will have the cost details of moving the shipment.
-
This is out of scope of this project. Once TMS vendor is selected and workflow design, link will be provided.
+
== Business Requirements ==
-
== IP1 New Order ==
+
== Integration points ==
-
=== Add ===
+
 +
See following wikis:
 +
* [[Shipment Import]]
 +
* [[Load Plan]]
 +
* [[Status Message]]
-
==== Example xml ====
+
== Data dictionary and mapping ==
-
<pre>
+
see [[Data Dictionary for EDI to TMS]]
-
<?xml version="1.0" encoding="iso-8859-1"?>
+
-
<ns0:Envelope xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/03/addressing" xmlns:ns0="http://www.w3.org/2003/05/soap-envelope" xmlns:ebi="http://www.myvan.descartes.com/ebi/2004/r1">
+
-
  <ns0:Header>
+
-
    <wsa:From>
+
-
      <wsa:Address>urn:duns:657589457</wsa:Address>
+
-
    </wsa:From>
+
-
    <wsa:To>urn:duns:657589457</wsa:To>
+
-
    <wsa:Action>urn:myvan:856</wsa:Action>
+
-
    <ebi:Sequence>
+
-
      <ebi:MessageNumber>12117</ebi:MessageNumber>
+
-
    </ebi:Sequence>
+
-
    <wsa:MessageID></wsa:MessageID>
+
-
  </ns0:Header>
+
-
  <ns0:Body>
+
-
    <parmDocEnvelope>
+
-
      <DocShipment ShipmentNo="3161007" LoadNo="3161007" MessagePurpose="1005" CarrierCode="RDWY" EarliestAvailDate="2010-03-11T08:00:00" LatestAvailDate="2010-03-11T16:00:00" TotalWgt="98" WgtUOM="200">
+
-
        <DSGOriginAddress LocationNo="08081831" StreetName="7725 PARKLAWN AVENUE" City="EDINA" State="MN" PostalCode="55439" Country="US" CompanyName="Company ABC"></DSGOriginAddress>
+
-
        <DSGDestinationAddress LocationNo="" StreetName="95 Paquin Road                WINNIPEG&#xA;" City="MANITOBA" State="MB" PostalCode="R2J 3V9" Country="CA" CompanyName="Consumer Products"></DSGDestinationAddress>
+
-
        <DSGReferenceNumbers RefNoType="SBU Unit" Value="XYZ"></DSGReferenceNumbers>
+
-
        <DSGReferenceNumbers RefNoType="System ID" Value="VSC"></DSGReferenceNumbers>
+
-
        <DSGReferenceNumbers RefNoType="GL Account 1" Value="080807114612010000002001000000000000000000"></DSGReferenceNumbers>
+
-
        <DocShpLineItem ContainerQuantity="1" Description="Goods" TotalLineItemWeight="98" WgtUOM="200" ContainerType="15" LineItemNumber="1"></DocShpLineItem>
+
-
      </DocShipment>
+
-
    </parmDocEnvelope>
+
-
  </ns0:Body>
+
-
</ns0:Envelope>
+
-
</pre>
+
-
==== Fields ====
+
== History ==
-
'''CT#CT_Num'''
+
=== 0002346: [EDI to TMS] Shipper role features ===
-
* ''CT2 object and field:'' [[CT#CT_Num]]
+
-
* ''Matching Descartes object and field name:'' '''Shipment No''' of '''Shipment''' object
+
-
* ''Descartes XML tag/attribute:'' '''ShipmentNo''' attribute of '''DocShipment''' tag
+
-
'''Pick up Location'''
+
=== 0002361: [EDI to TMS] Implement FTP-connection functionality ===
-
* ''CT2 object and field:'' [[...]]
+
-
* ''Matching Descartes object and field:'' '''Origin Address''' of '''Shipment''' obj
+
-
* ''Descartes XML tag/attribute:''
+
-
'''Ship to Location'''
+
=== 0002327: [EDI to TMS] (Preliminary) a) proof of concept for ... CT data in the form of XML b) settings in non jag user profile for TMS ===
-
* ''CT2 object and field:'' [[...]]
+
* This task was replaced by M 2418
-
* ''Matching Descartes object and field:'' '''Destination Address''' of '''Shipment''' obj
+
-
* ''Descartes XML tag/attribute:''
+
-
'''...'''
+
=== 0002418: [EDI to TMS] (Client App Admin) (TMS Tab) Add TMS tab with config options ===
-
* ''CT2 object and field:'' [[...]]
+
-
* ''Matching Descartes object and field:''
+
-
* ''Descartes XML tag/attribute:''
+
-
'''...'''
+
=== 0002361: [EDI to TMS] Implement FTP-connection functionality ===
-
* ''CT2 object and field:'' [[...]]
+
-
* ''Matching Descartes object and field:''
+
-
* ''Descartes XML tag/attribute:''
+
-
=== Update ===
+
=== 002493[EDI to TMS] Hide TMS Status on CT record header description for MOT Air&Ocean; if possible pls hide for truck air & truck ocean ===
-
=== Delete ===
+
-
== IP2 Order Sequencing ==
+
=== 0002451: [EDI to TMS] (Client App Admin) (TMS Tab) Changes to accomodate Connecting Production/Demo Environments ===
-
== IP3 Carrier Info ==
+
-
== IP4 Load Status ==
+

Current revision as of 20:17, 20 December 2010


Contents

[edit] About and See also

This is a Analysis / Requirements wiki for EDI to TMS proj Mantis: 2183

[edit] Related

See also: Data Dictionary for EDI to TMS

[edit] Glossary

IP - Integration Point

Tendering - Tendering is the process of offering a load to a carrier and efficiently managing their response.

NOTE: Descartes Transportation Manager enables you to communicate with your contracted carriers electronically or manually. You set the communication method for a carrier when you set up your carrier contracts.

See also: p 205 of TM+10.1.3+Users+Guide.pdf

[edit] Introduction

Core Business Need: Jaguar needs ability to optimize truck domestic shipments:

Above features are normally present in TMS software. In addition this kind of system can:

  • automate tariffs (Working with Contracts chapter)
  • communication with carriers

To achieve that it was decided:

  • buy and use existing TMS solution (phase 1)
  • gradually add these features to CT2 (phase 2)

To complete phase 1 we need to implement:

[edit] Vendor evaluation

Currently there are 2 systems we are considering:

  • from Descartes
  • from Lean Logistics

[edit] CT2 and TMS integration in a nutshell

In a nutshell:

  • (shipment record will be created in CT2 and approved)
  • IP1: Shipment Import New CT2 forwarded to TMS through EDI
  • (in TMS Jag oper will run optimizations and select carrier)
  • (TMS sens bids to carriers)
  • IP2: Load Plan, code 990 TMS sends updates to CT2 (Carrier confirmed, etc)
  • (start processing shipments)
  • IP3: Status Message, code 214 TMS periodically submits updates into TMS (example: actual pickup date, etc)


See Figure below:

[edit] Figure Integration Points as defined by Descartes

File:Descartes IPs.JPG

[edit] Examples

Below are some examples of EDI messages used in Transportation Manager.

  • Shipment Import
  • 204 – Load tender message from Transportation Manager to the carrier. A load tender is a request to pick up a shipment and move it to another location.
  • 990 – Load Plan - The carrier’s tender response back to Transportation Manager (either a yes for picking up the shipment or no for not picking up the shipment).
  • 214 – A Status message from the carrier to Transportation Manager (e.g., “Delivered”).
  • 210 – An invoice from the carrier to Transportation Manager. The invoice will have the cost details of moving the shipment.

[edit] Business Requirements

[edit] Integration points

See following wikis:

[edit] Data dictionary and mapping

see Data Dictionary for EDI to TMS

[edit] History

[edit] 0002346: [EDI to TMS] Shipper role features

[edit] 0002361: [EDI to TMS] Implement FTP-connection functionality

[edit] 0002327: [EDI to TMS] (Preliminary) a) proof of concept for ... CT data in the form of XML b) settings in non jag user profile for TMS

  • This task was replaced by M 2418

[edit] 0002418: [EDI to TMS] (Client App Admin) (TMS Tab) Add TMS tab with config options

[edit] 0002361: [EDI to TMS] Implement FTP-connection functionality

[edit] 002493[EDI to TMS] Hide TMS Status on CT record header description for MOT Air&Ocean; if possible pls hide for truck air & truck ocean

[edit] 0002451: [EDI to TMS] (Client App Admin) (TMS Tab) Changes to accomodate Connecting Production/Demo Environments

Personal tools