CHƯƠNG 3 YÊU CẦU KỸ THUẬT CỦA HỆ THỐNG
2. Bảng tổng hợp các hạng mục trao đổi dữ liệu giữ ePORT, cổng container tự
động và Catos.
2.1 Module giao tiếp giữa cổng tự động Autogate/ ePORT và CATOS (quản lý xe giao nhận container qua cổng, tạo lệnh giao nhận container trên hệ thống, cập nhật thông tin container, API các tác nghiệp nhập tàu, hoàn thành các job tại kho CFS/bãi)
2.1.1 Check planned position - Kiểm tra vị trí container đã lập kế hoạch:
Autogate gửi yêu cầu thông báo này để kiểm tra sơ đồ bãi cho container trước khi container đến bãi cảng. Nếu CATOS trả về mà khơng có kế hoạch, ePORT sẽ thơng báo cho Người lậậ̣p kế hoạch bãi để lậậ̣p tọa độ cho container.
Hiện tại, người dùng luôn lậậ̣p kế hoạch với danh sách Phân công trước và Kế hoạch phân bổ trước, hiện tại thông báo giao diện chỉ xem xét kế hoạch bãi này.
Phạm vi tích hợp với Autogate như bên dưới. 1) Autogate gửi số container tới CATOS.
2) CATOS trả về ID kế hoạch và vị trí khả dụng nếu container được lên kế hoạch.
2.1.2 Submit Gate In Job - Tương tác Gate IN tại cổng
Autogate sẽ gửi thông báo job tại Cổng vào lệnh hạ/bốc tới CATOS.
- Drop Off – Lệnh hạ: lấy vị trí bãi, cậậ̣p nhậậ̣t ghi chú, số seal, tình trạng container -Pick Up – Lệnh bốc: để lấy container từ CATOS (Nếu khơng được chỉ định). Phạm vi tích hợp với Autogate như bên dưới.
1) Autogate gửi Gate Drop Off / Pick up Job tới CATOS.
2) CATOS trả về thông báo kết quả giao dịch tới Autogate (thành công/ thất bại) a.Đối với Drop Off – hạ container: trả lại vị trí.
2.1.3 Submit Gate Out Job - Tương tác Gate Out tại cổng.
Autogate sẽ gửi thông báo job Cổng ra (Gate out) tới CATOS khi xe đầu kéo đi đến Cổng ra.
Phạm vi tích hợp với Autogate như sau:
1) Autogate gửi thơng báo job Cổng ra tới CATOS.
2) CATOS trả về thông báo kết quả giao dịch tới Autogate (thành công/ thất bại)
2.1.4 Container Information - API số seal, remark tình trạng container
Autogate sẽ gửi Seal, Remark và tình trạng container để cậậ̣p nhậậ̣t lên CATOS khi thơng tin container cần được cậậ̣p nhậậ̣t.
Phạm vi tích hợp với Autogate như bên dưới.
1) Autogate gửi thông báo Thông tin container tới CATOS.
2) CATOS trả về thông báo kết quả giao dịch tới Autogate (thành công/ thất bại)
2.1.5 Request Quay Job List - API container đã lập/chưa lập nhập tàu.
ePORT sẽ gửi tin nhắn này để hỏi danh sách container tại tàu khi cần thiết.
CATOS sẽ trả lời tin nhắn khi có yêu cầu từ ePORT hoặc bất cứ khi nào người dùng Active / Deactive / Cancel job trong TM (terminal mornitoring) - Control Quay Job. Phạm vi tích hợp với ePORT như bên dưới.
ePORT gửi Request Quay Job List tới CATOS.
CATOS trả về danh sách container trong Công việc Control Quay
CATOS gửi tin nhắn bất cứ khi nào có lệnh cậậ̣p nhậậ̣t thơng tin trong TM> Control Quay Job.
2.1.6 Complete Quay Job - API tương tác để hồn thành cơng việc tại tàu
ePORT sẽ thông báo cho CATOS để hồn thành Quay job với vị trí số xe đầu kéo/romooc, vị trí tàu.
Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi thông báo Complete Quay Job tới CATOS.
2)CATOS nhậậ̣n thơng tin và hồn thành quay job sau đó trả lại thơng báo kết quả cho ePORT.
2.1.7 Update Yard Truck Number - Cập nhật Yard truck trong quá trình làm tàu.
ePORT sẽ thơng báo cho CATOS để cậậ̣p nhậậ̣t số lượng xe đầu kéo. Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi tin nhắn Số xe đầu kéo tới CATOS.
2)CATOS nhậậ̣n thông tin và cậậ̣p nhậậ̣t số xe đầu kéo sau đó trả về thơng báo kết quả cho ePORT.
2.1.8 Cancel Pre-Gate Job - API gửi hủy lệnh đặt chỗ tại cổng
Trong trường hợp tài xế đăng ký sai thông tin, Autogate sẽ thông báo tới CATOS để hủy cơng việc trước cổng.
Phạm vi tích hợp với Autogate như bên dưới.
1) Autogate gửi thông báo CancelPreGateJob tới CATOS.
2)CATOS nhậậ̣n thơng tin và XĨA pre gate job sau đó trả về thông báo kết quả cho Autogate.
2.1.9 Cancel gate job order - API gửi hủy lệnh khi qua cổng
Xe đầu kéo đã vào cổng để giao/nhậậ̣n container nhưng tài xế yêu cầu hủy lệnh bốc/hạ container. Autogate sẽ thông báo cho CATOS để hủy lệnh gate job order. Phạm vi tích hợp với Autogate như bên dưới.
1) Autogate gửi thông báo CancelGateJobOrder tới CATOS.
2) CATOS nhậậ̣n thông tin và hủy gate job sau đó trả lại thơng báo kết quả cho Autogate.
2.1.10 Out gate reject - API hủy lệnh bốc, nguyên nhân: chủ hàng ko nhận container, đổi cont.
Công việc bãi đã hoàn thành, container ở trạng thái “Đang chuyển đi”, sau khi kiểm tra, tài xế sẽ không lấy container này.
Phạm vi tích hợp với Autogate như bên dưới.
1) Autogate gửi thông báo OutGateReject tới CATOS.
2)CATOS nhậậ̣n thông tin và tạo cơng việc hạ container sau đó trả lại thơng báo kết quả cho Autogate.
2.1.11 CFS Operation - Hoàn thành job tại kho CFS - đóng/rút hàng.
Người dùng tại trang web hồn thành thao tác đóng/rút hàng, ePORT thơng báo thơng tin này cho CATOS để thay đổi container rỡỗ̃ng thành có hàng hoặc có hàng thành rỡỗ̃ng. Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi thông báo CFSOperation tới CATOS.
2)CATOS nhậậ̣n thông tin và chuyển từ container rỡỗ̃ng thành có hàng cho tác nghiệp đóng hàng hoặc có hàng thành rỡỗ̃ng cho tác nghiệp rút hàng sau đó trả lại thông báo kết quả cho ePORT.
2.1.12 Tally PDA
Xác nhậậ̣n tính hợp lệ số seal nhậậ̣p tàu khi xác nhậậ̣n container nhậậ̣p tàu.
2.1.13 Gate - update shipper/consignee after pass In Gate - Phục vụ tính lưu bãi cho khách hàng lớn, hàng giấy.
Người dùng muốn cậậ̣p nhậậ̣t người gửi hàng / người nhậậ̣n hàng lên trạng thái container chỉ dành cho container rỡỗ̃ng. Mục tiêu hỡỗ̃ trợ tính lưu bãi cho chủ hàng có sản lượng lớn. Điều kiện đầu tiên: nhậậ̣n đơn hàng với thông tin người nhậậ̣n hàng
Bước tiếp theo:
1.Đăng ký công việc: số xe đầu kéo và số container/ job order no. 2.Cổng vào> Pass
Nguyên trạng: cậậ̣p nhậậ̣t người gửi hàng / người nhậậ̣n hàng lên mức container cho có hàng và rỡỗ̃ng
Thực hiện: chỉ cậậ̣p nhậậ̣t người gửi hàng / người nhậậ̣n hàng cho container có hàng.
2.2 Module giao tiếp giữa ePORT và CATOS – Thủ tục giao nhận hàng 2.2.1 Vessel Schedule- API về tạo/cập nhật/hủy lịch tàu.
CATOS gửi thơng tin lịch trình tàu tới ePORT. Phạm vi tích hợp với ePORT như bên dưới.
1) CATOS gửi thơng tin lịch trình tàu khi tạo / cậậ̣p nhậậ̣t / hủy 2) ePORT nhậậ̣n được tin nhắn và khơng có phản hồi.
2.2.2 Inquire Booking Info - API truy vấn thông tin booking.
ePORT gửi yêu cầu đến CATOS để hỏi thông tin đặt chỗỗ̃ để kiểm tra trước khi gửi tin nhắn để tạo / cậậ̣p nhậậ̣t đặt chỡỗ̃.
Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi tin nhắn tới CATOS để hỏi thông tin đặt chỗỗ̃ (booking) 2)CATOS gửi lại thông báo kết quả giao dịch cho ePORT (thành công/ thất bại) và thông tin của đặt chỗỗ̃ này.
2.2.3 Booking Info - API tạo booking/ cập nhật nếu booking đã có
Sau khi hỏi thông tin đặt chỗỗ̃, ePORT sẽ gửi yêu cầu tới CATOS - Để tạo mới nếu booking không tồn tại
- Để cậậ̣p nhậậ̣t nếu đã có booking.
Phạm vi tích hợp với ePORT như bên dưới. 1) ePORT gửi thơng tin booking
2)CATOS trả về thông báo kết quả giao dịch cho ePORT (thành công/ thất bại) và tạo / cậậ̣p nhậậ̣t booking.
2.2.4 Delete Booking Info - API Xóa booking.
ePORT gửi yêu cầu tới CATOS - Để xóa / hủy booking
Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi xóa / hủy thơng tin booking
2)CATOS trả về thông báo kết quả giao dịch cho ePORT (thành cơng/ thất bại) và xóa / hủy booking.
2.2.5 Create Pickup Order - API Tạo số tham chiếu lấy container.
ePORT gửi yêu cầu thực hiện đơn đặt hàng lấy nguyên container bằng số Billing hoặc nhậậ̣n container rỗỗ̃ng cho booking, CATOS cần xác nhậậ̣n đơn hàng hợp lệ và tạo biên lai cho đơn đặt hàng tiền mặt.
Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi yêu cầu tạo lệnh bốc hàng để tạo Pickup order.
2)CATOS trả về thông báo kết quả đến ePORT (thành công/ thất bại) với số Pickup order.
2.2.6 Update Pickup Order - Cập nhật số lệnh bốc
ePORT sẽ gửi thông báo “UpdatePickupOrder” khi
- Khách hàng thêm container mới vào đơn nhậậ̣n hàng đã tồn tại -Nhậậ̣n eDO với ngày Pickup cậậ̣p nhậậ̣t (giá trị Demurrage)
Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi thông báo cậậ̣p nhậậ̣t đơn đặt hàng đến CATOS.
2) CATOS trả về thông báo kết quả giao dịch tới ePORT (thành công/ thất bại)
2.2.7 Delete Pickup Order - Xóa số lệnh bốc
ePORT sẽ gửi tin nhắn “DeletePickupORder” khi
-Khách hàng loại bỏ container trong đơn nhậậ̣n hàng đã tồn tại Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi thơng báo xóa đơn đặt hàng đến CATOS.
2)CATOS trả về thông báo kết quả giao dịch đến ePORT (thành công/ thất bại) và loại bỏ container ra khỏi đơn nhậậ̣n hàng, cũng tạo biên nhậậ̣n mới trong trường hợp trả tiền mặt.
2.2.8 Create Pre-Advice - Tạo lệnh hạ
ePORT gửi yêu cầu tạo lệnh hạ container có hàng để xuất khẩu, xếp container rỡỗ̃ng tại bãi (bao gồm trả rỗỗ̃ng với DET), CATOS cần xác thực đơn đặt hàng khi tạo dữ liệu và tạo biên nhậậ̣n cho đơn đặt hàng trả tiền mặt
Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi yêu cầu tạo lệnh hạ hàng để tạo pre-advice.
2) CATOS trả về thông báo kết quả tới ePORT (thành công/ thất bại) với job order no.
2.2.9 Update Pre-Advice - Cập nhật lệnh hạ
ePORT gửi yêu cầu “UpdatePreAdvice” để - Cậậ̣p nhậậ̣t giá trị DET khi nhậậ̣n được từ eDO
-Cậậ̣p nhậậ̣t Booking / OPR / SzTp / POD / SSR / remark… của container Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi yêu cầu cậậ̣p nhậậ̣t đơn đặt hàng để tạo pre-advice. 2) CATOS trả về thông báo kết quả cho ePORT (thành cơng/ thất bại)
2.2.10 Delete Pre-Advice - Xóa lệnh hạ
ePORT gửi yêu cầu “DeletePreAdvice” để
-Xóa dữ liệu pre-adive khi khách hàng hủy bỏ container hạ. Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi lệnh xóa để xóa dữ liệu pre-adive.
2) CATOS trả về thông báo kết quả cho ePORT (thành cơng/ thất bại) và xóa bản ghi, tạo ra biên lai mới trong trường hợp tra tiền mặt.
2.2.11 Create Stuffing Stripping Order - Tạo lệnh đóng hàng
ePORT gửi yêu cầu thực hiện đơn đặt hàng đóng/rút container bằng số Bill hoặc bằng booking, CATOS cần xác nhậậ̣n đơn hàng hợp lệ và tạo biên lai cho đơn đặt hàng trả tiền mặt.
Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi yêu cầu đặt hàng đóng/rút để tạo đơn hàng mới
2) CATOS trả về thông báo kết quả tới ePORT (thành công/ thất bại) với số lệnh.
2.2.12 Update Stuffing Stripping Order - Cập nhật lệnh đóng hàng
ePORT sẽ gửi thông báo “UpdateStuffingStrippingOrder” khi - Khách hàng thêm container mới theo lệnh đã có
-Nhậậ̣n eDO với ngày hết hạn được cậậ̣p nhậậ̣t
(Demurrage) Phạm vi tích hợp với ePORT như bên dưới. ePORT gửi thông báo cậậ̣p nhậậ̣t đơn đặt hàng đến CATOS.
CATOS trả về thông báo kết quả giao dịch tới ePORT (thành công/ thất bại)
2.2.13 Delete Stuffing Stripping Order - Xóa lệnh đóng hàng
ePORT sẽ gửi thơng báo “DeleteStuffingStrippingOrder” khi - Khách hàng loại bỏ container đã tồn tại trong lệnh đóng/rút hàng.
Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi thơng báo u cầu xóa tới CATOS.
2)CATOS trả về thông báo kết quả giao dịch đến ePORT (thành công/ thất bại) và loại bỏ container ra khỏi lệnh, tạo ra biên lai mới trong trường hợp trả tiền mặt.
2.2.14 Create SSR Order - Tạo lệnh dịch vụ đặc biệt
ePORT gửi yêu cầu thực hiện dịch vụ SSR bằng container, CATOS cần xác thực đơn đặt hàng hợp lệ và tạo biên lai cho đơn đặt hàng trả tiền mặt.
Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi yêu cầu SSR để tạo đơn hàng
2) CATOS trả về thông báo kết quả tới ePORT (thành công/ thất bại) với số lệnh.
2.2.15 Delete SSR Order - Xóa lệnh dịch vụ đặc biệt
ePORT sẽ gửi thông báo “DeleteSSROrder” khi -Khách hàng xóa container đã tồn tại trong lệnh SSR Phạm vi tích hợp với ePORT như bên dưới. 1) ePORT gửi thơng báo u cầu xóa tới CATOS.
2) CATOS trả về thơng báo kết quả giao dịch tới ePORT (thành công/ thất bại) và loại bỏ container ra khỏi lệnh, cũng tạo ra biên lai mới trong trường hợp trả tiền mặt.
2.2.16 Issue Invoice Order – Lệnh phát hành hóa đơn
ePORT sẽ gửi thơng báo “IssueInvoiceOrder” khi
-Thanh tốn qua NAPAS/ Ví điện tử được thực hiện cho loại thanh toán = “M” (Tiền mặt)
Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi thơng báo đặt hàng hóa đơn tới CATOS.
2) CATOS trả về thông báo kết quả giao dịch cho ePORT (thành cơng/ thất bại) và phát hành hóa đơn.
2.2.17 Cancel Receipt - Hủy biên nhận
ePORT sẽ gửi thông báo “CancelReceipt” khi
-Cần loại bỏ container ra khỏi lệnh trong trường hợp loại thanh tốn = “M” (Tiền mặt) Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi thông báo hủy biên nhậậ̣n đến CATOS.
2) CATOS trả về thông báo kết quả giao dịch cho ePORT (thành công/ thất bại) và hủy biên nhậậ̣n.
2.3 Module giao tiếp giữa ePORT và Catos về nhập danh sách container xuất nhập tàu vào cơ sở dữ liệu của Catos; Tạm giữ/không giữ container; Thay đổi tàu cho container.
2.3.1 Export COPRAR List - Tạo danh sách hàng xuất.
Thông tin cơ bản: một số hãng tàu không áp dụng COPRAR để gửi đến Cảng qua EDI nên chỉ gửi danh sách xuất nhập đảo chuyển bằng file excel.
ePORT nhậậ̣n danh sách hàng xuất trong file excel từ hãng tàu và gửi đến CATOS dưới dạng Danh sách COPRAR hàng xuất để đối chiếu.
Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi thông tin danh sách hàng xuất (loading list)
2) CATOS trả về thông báo kết quả cho ePORT (thành công/ thất bại)
2.3.2 SBP List - API Tạo danh sách hàng nhập (SBP- stowage bay plan)
Thông tin cơ bản: một số hãng tàu khơng có BAPLIE để gửi đến Cảng qua EDI nên chỉ gửi danh sách hàng nhập (discharging list) bằng file excel.
ePORT nhậậ̣n danh sách hàng nhậậ̣p (discharging list) trong file excel từ hãng tàu và gửi đến CATOS dưới dạng Danh sách SBP.
Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi thông tin danh sách hàng nhậậ̣p (discharging list). 2) CATOS trả về thông báo kết quả tới ePORT (thành công/ thất bại)
2.3.3 Hold Release Container - API giữ/ giải phóng container
ePORT sẽ gửi thông báo “HoldReleaseOrder” khi -Container cần được giữ / giao hàng. Phạm
vi tích hợp với ePORT như bên dưới.
1) ePORT gửi thông báo lệnh giữ / giao hàng tới CATOS.
2) CATOS trả về thông báo kết quả giao dịch tới ePORT (thành công/ thất bại) và thiết lậậ̣p giữ / giao hàng cho container.
2.3.4 Change Vessel - API Thay đổi tàu
ePORT sẽ gửi thông báo “ChangeVesselOrder” khi -Container cần được thay đổi theo lịch trình tàu mới Phạm vi tích hợp với ePORT như bên dưới.
1) ePORT gửi lịch trình tàu mới cho container đã đặt trước / container đã hạ bãi đến CATOS.
2) CATOS gửi thông báo kết quả giao dịch đến ePORT (thành công/ thất bại) và cậậ̣p nhậậ̣t thông tin tàu cho container.
2.4 Module giao tiếp giữa ePORT và CATOS (hệ thống truy xuất/ báo cáo dữ liệu phục vụ số hóa dữ liệu)
2.4.1 Tally Export - API danh sách tally hàng xuất.
ePORT yêu cầu tin nhắn này để hỏi danh sách container đang xếp hàng xuất (loading list) của tàu.
Phạm vi tích hợp với ePORT như bên dưới. 1) ePORT gửi lịch trình tàu tới CATOS.
2)CATOS trả về danh sách container hàng xuất (giống như TallyLoadingReport_Report).
2.4.2 Tally Import - API danh sách tally hàng nhập
ePORT gửi yêu cầu thông báo này để hỏi danh sách container đang dỡ hàng nhậậ̣p (discharging list) của tàu.
Phạm vi tích hợp với ePORT như bên dưới. 1) ePORT gửi lịch trình tàu tới CATOS.
2)CATOS trả về danh sách container hàng nhậậ̣p (giống như TallyDischargingReport_Report).
2.4.3 Tally Shifting – API Bảng kê hàng đảo chuyển