OS

From UG

(Difference between revisions)

Jump to: navigation, search

Revision as of 14:15, 29 October 2013

Info

Mantis parent: 4172

Mantis Category: Ocean Status

Wiki category: Category:Ocean Status - see all related wikis there

Definitions

VAN - A Value-added Network (VAN) is a hosted service offering that acts as an intermediary between business partners sharing standards based or proprietary data. In the context of this project we use VAN as an intermediary between Jaguar and all carriers for message exchange.

GLN - VAN owned by Descartes

Descartes - EDI vendor

Cargosmart - EDI vendor

Business Need

Core needs is to automate the following:

booking ocean with carrier
sending Shipping Instructions to carrier
receiving updates from carrier

Business Analysis and Requirements

Current Biz Process

Currently operators book with and get updates from ocean carriers manually. After that they manually update CT/Master record with the information they received.

Phases

Phase one will cover OOCL carrier only.

Solution

General and Preliminary

General Ocean Status Admin

Add UI Admin for:

FTP credentials: url, uname, pwd
- outbound and inbound
- for test and prod envir

Period (min)

on/off switch for transmission/receiving each of four types of messages

list of steamshiplines participating: On/Off switch

email notification groups

Location:
- Admin > EDI > Ocean Status
- move all EDIs to Admin > EDI (EUAN/Air Status, D2L, Trendset)

Access: restrict access (add line to access table)

Message Transport Level and Scheduled Process

Message Transport level

FTP protocol will be used on a transport level.

Location of Inbound and Outbound folders TBD.

FTP credentials are defined in Admin.

Message process

One process will send/receive all messages accordingly to frequency defined in Admin.

HTS Feature

What:

Add this field to commodity table (for each line): HTS Number

(commodity customs code). See http://www.foreign-trade.com/reference/hscode.htm

This field should be presented and (be required only) for records that will be booked/processed through EDI
For both ASN and CT records

How: (ideas):

UI: combobox? tree?
how to upload into system and how to maintain it there?
for ASN recs entered by Shipper on Client

HTS Automation

postpone for phase 2?
remember link btw HTS and SKU as it gets entered so we can do "auto-suggest"?
upload xls with link btw SKU and xls? (PO Issued By specific?)

Container Type Admin

Container Type ISO Code

In Admin > Transportation > Container Size/Type

If D2L codes are same as ISO then:

Rename "D2L codes" into "ISO code"

If D2L codes are NOT same as ISO then:

add additional field "ISO code", same format/validation

In both cases:

Steamshipline Admin

Add new attributes to Steamshipline object - see below.

Account Bullet

Additional info related to #Contract Number.

This is lane (Country or Region) specific.

UI: Add to Admin > Carriers > Steamshiplines

Format: TBD

In Steamshipline Admin or Ocean Status Admin.

Misc Constants

AMS SCAC Code

AMS SCAC Code - SCAC/ACI Code. For USA trade, this is a code with normally 4 digits for AMS filing, we need this code to submit AMS filing and Jaguar is registered. Our AMS SCAC code is JAFR.

Jaguar Id In Cargosmart

Office specific:

Office // Id
NY // BJINUS106971518
LON // JAGUGB1610342265
HK // JAGUHK1927007552

PartyType codes in Cargosmart

Code // Description
CA // Carrier 
SH // Shipper
CN // Consignee
FW // Forwarder
BR // Broker
NP // Notify Party
AP // Also Notify Party
BP // Booking Party

Changes in Master Object and Master Profile

New Master Fields

Add new attributes to Master Entity:

Documentation Cut Off Date // Date+Time // Last possible date documentation can be sent.
- Read only, M Det Tab

CY open date // Date+Time // First possible date cargoes may be delivered to a ship or designated point.

CY cutoff date // Date+Time // Last possible date cargoes may be delivered to a ship or designated point.
- Read only, M Det Tab

MBL Type // "original" or "express" // Defines what type of MBL is used. Takes one of two values: "original" or "express"
- UI: add to Master Gen Tab below "2. Move type/MBL", default to "original"

AES Number // AN, 15 digits // aka Internal Transaction Number (ITN), id received from Automated Export System. The ITN consists of the letters “AES” followed by the ITN: for example, “AES X20080930987654. See also http://en.wikipedia.org/wiki/Automated_Export_System

Wood packing // "used" or "not used" // Any wooden packaging material is used or not, this is what we have to declare to the shipping line for every single booking to USA and Canada.

Master Context Menu

Add Booking Request button to initiate 300 Booking Request message.

Message will be sent immediately and confirmation pop-up will be shown.

Master Doc Tab

detect that given master is a subject to EDI transmission (carrier is on the EDI list)
modify MBL template to accommodate EDI case (add new fields)
on "generate report" send 304 Shipping Instructions and generate pdf, show confirmation
Master Bill Of Lading

Master Comments Tab

Post all events/updates related to all messages here:

Every time message was sent or received, content of the message, operator who initiated

All Message Types

This is a list of EDI messages being used here to exchange info between Jaguar and Steamshiline through Descartes GLN - see below.

Message Exchange Scenarios

Example 1

day 1: (Booking Request 300)          JAG -> VAN -> CARRIER
.
day 1:  (Booking Confirmation 301)    JAG <- VAN <- CARRIER 
.
day 4:  (Shipping Instructions 304)   JAG -> VAN -> CARRIER 
.
day 15: (Shipment Status 315)         JAG <- VAN <- CARRIER
.
day 35: (Shipment Status 315)         JAG <- VAN <- CARRIER

Example 2

Reporting and Notifications

Email Notifications

Notify group defined in Admin when these messages are received:

Booking Conf 301
Status 315

Reports

Option 1

Increment existing List Masters report to enable operator to look at EDI activity for desired group of Masters singled out by applying certain filters such as Steamshipline and Estimated day of Departure or port.

Add these filters to List Masters:

Add these output fields:

300 message Status: yet, sent
301 message Status: confirmed, rejected, conditionally accepted, pending
304 message Status: yet, sent
315 message status: there are 10-20 possible values, show the last received
more fields TBD

Option 2

Dashboard for exceptions (rejected messages, etc).

Details TBD.

Option 3

Impending cargo cut off report/dashboard.

Impending documents cut off report/dashboard

Log

Log all related events.

Human initiated:

send 300
send 304

EDI initiated:

received 301
received various 315

@@ Line 122: / Line 122: @@
 Add new attributes to Steamshipline object - see below.
-===== Contract Number =====
-Contract number for contract between Jaguar and Steamshipline.
-UI: Add to Admin > Carriers > Steamshiplines
-Format: TBD
 ===== Account Bullet =====

OS