1航次管理

对当前用户所属公司下所有船舶（包含退役、未退役）的航次任务统一进行管理。包含以下功能：查看所有船舶的航次基本信息（1.1航次查询），初始化新船航次（1.2初始化航次），查看编辑航次信息（1.3查看航次详情），以及布置修船航次（1.4布置修船航次）。

1.1航次查询

1.1.1功能说明

1、根据查询条件检索出当前用户所在企业的船舶及其航次任务安排情况。

2、提供相关功能按钮来维护/安排各航次任务。

1.1.2用户操作流程

1、用户点击菜单“船舶调度”-“航次管理”，进入航次任务查询页面。

2、系统根据默认的检索条件自动检索出相应的船舶、航次信息。

3、用户也可以手工录入相应条件检索出相应的船舶、航次信息。

4、根据系统提供的功能按钮，针对具体的航次做进一步的操作。

1.1.3页面功能（按钮）

1、查询：根据检索条件查询相关信息。

2、清空：清空所有检索条件。

3、查看航次：选择一条航次进入航次详情页面。

4、初始化航次任务：选择一条没有航次的船舶，进行航次初始化。

5、布置修船航次：将一条不是修船航次的计划航次，修改为修船航次。

1.1.4查询条件

1、船舶名称：文本框、用户手工输入，模糊匹配。

2、船舶代码：文本框、用户手工输入，模糊匹配。

3、船舶呼号：文本框、用户手工输入，模糊匹配。

4、船舶类型：下拉框，数据来源于主数据中的船舶种类，（技术来源于T_PP_VSL

_TYPE.CN_DESC），加载所有船型。

5、船舶种类：下拉框，数据来源于主数据中的船舶种类（技术来源于T_PP_VSL

_KIND.CN_DESC）加载所有船舶种类。

6、船舶状态：下拉框，常量，参考船舶管理页面，加上所有船舶状态。

7、公司航次号：文本框、用户手工输入，模糊匹配。

8、航次状态：下拉框，数据来源主数据中航次状态，（技术来源于FROM T_PP_BCTABLE WHERE FATHER_CD = 'voyStatus'）加载所有航次状态。

航次类型：下拉框，数据来源于主数据中的航次类型（技术来源T_PP_VOY_TYPE

.VOY_TYPE_CN_DESC）加上所有航次类型。 

10、结束时间：目前时间（航次结束时间LOCAL）跨度不能超过3个月，进入页面默认时间为当前时间的前三个月到后三个月，清空时间后查询所有。

1.1.5查询结果显示

1、表格树形展示。

2、一级节点显示船舶相关信息：船舶名称。

3、二级菜单显示航次相关信息：公司航次号、航次状态、开始港口、结束港口、航次开始时间（LOCAL)、航次结束时间(LOCAL)，按照航次号排序。

1.1.6注意事项

1、查询列表会显示出当前登录用户所属公司下所有船舶（退役、未退役）的航次信息。

2、默认查询航次结束时间在当前时间的前3个月至当前时间的后3个月范围内的航次任务。

1.2初始化航次

1.2.1功能说明

1、当有新增船舶录入系统后，在做航次任务安排之前，必须要做一次初始化航次，后续航次系统会在上一个航次结束时自动生成下一个航次。

2、新增船舶包括所有来源的船舶：自有船、新造船、租入船等。

1.2.2用户操作流程

1、在航次任务查询结果页面中，选择一条新船（没有航次任务的船舶），点击【初始化航次任务】按钮，系统进入如下图所示界面。

2、如图，根据提示录入“航次基本信息”、“航次初始存油信息”、“船员信息”，点击【保存】按钮即可。

1.2.3业务逻辑

1、选择船舶，进行航次任务初始化时，需要校验此船舶是否已经初始化

A、选择船舶时，判断此船舶是否已经初始化，如已经初始化，则”新船航次任务初始化“按钮禁用

B、判断规则：根据船舶的UUID，在航次表（T_VOY)中查询是否存在航次记录，如存在，则说明此船舶已经初始化，如不存在任何记录，则说明此船舶没有初始化

2、初始化信息项介绍：

A、船舶名称：由系统自动带出，不可编辑。

B、公司航次号：由用户录入，必填，默认同航次号，需要通过公司代码、船舶UUID、航次号来校验其是否唯一，同航次号的校验。

C、航次类型：下拉框，数据来源于主数据中的航次类型，必填，默认为承租航次

D、航次开始时间(Local)：用户录入，必填，年月日时分秒。

E、开始港口：下拉框，自动匹配用户录入，必填。

F、调度员：下拉框，非必填，数据来源于员工管理中的所有员工。

G、员工：下拉框，非必填，数据来源于员工管理中的所有员工。

H、上船时间：用户录入，年月日时分秒，非必填。

I、存油币种：默认为公司币种。

J、存油情况：根据船舶的燃料种类，将此种类下面所有的燃料类型全部列出，存油量和存油单价数字输入框，非负数，非必填，默认为0

3、保存操作时需要做如下校验：

A、校验数据必填项是否填写，如未填写则无法保存，并提示用户。

B、校验公司航次号是否重复，如重复则提无法保存，并提示用户。

4、保存通过后，系统生成一个当前航次，同时还会生成一个计划航次供用户安排任务。

1.2.4注意事项

1、选择一条没有航次的船舶进行初始化时，可能会出现如下图所示提示：“船舶无需初始化”，原因是所选船舶存在航次任务，只是由于查询条件过滤后导致没有显示出来，清除所有查询条件后再查询即可。 

2、如果调度员，船员的下拉框中没有值，请至员工管理中添加员工信息后，重新登录即可。

1.3布置修船航次

1.3.1 功能说明

布置修船航次的快捷方式，可以将一个计划航次布置为修船航次。

1.3.2 用户操作流程

1、选择一条计划航次，点击【布置修船航次】系统弹出如下图所示窗口：

2、确认船舶名称和航次号无误后，点击【保存】按钮即可。

1.3.3 业务逻辑

1、航次必须满足以下条件才能布置为修船航次：

A、航次类型必须为计划航次

B、航次不能配载合同。

2、以上条件在保存操作时校验，不通过则提示弹窗提示用户。

1.4查看航次详情

查看航次详细情况和维护航次任务的入口。

如下图所示,在航次查询页面，选中航次任务点击【查看航次】即可进行详情查看。

1.4.1关联合同

1 功能说明

程租业务中，给具体的船舶航次配载货载合同（VC-OUT）承租合同。

2 用户操作流程

1、进入航次任务页面选择一条航次，点击查看航次按钮，进入编辑状态。

2、在具体的航次任务页面中，点击“关联合同”按钮，系统会弹出关联合同页面。

3、在待关联合同列表中，选择需要关联的合同。

4、（可选）可以关联多个合同，也可以取消已关联的合同。

5、点击“确定”按钮，关联合同成功。

3 页面功能（按钮）

1、保存：取消关联合同和关联合同时都需要保存操作才会生效。

2、取消：关闭关联合同页面。

4 业务逻辑

1、业务描述

A、VC（承租）航次才需要关联合同，修船航次、其它航次不需要（不强制校验）关联合同。

B、VC航次至少需要关联一个合同，大部分航次通常也只关联一个合同，支持关联多个合同。

C、VC航次所关联的合同，指的是VC-OUT合同（合同的合同类型为VC-OUT租出合同，合同还包含COA合同框架合同和VC-IN合同租入合同，具体详见合同模块）。

D、一个租出合同（VC-OUT）至多只能被一个航次关联，但是一个航次可以关联多个合同。

2、待关联合同列表取值逻辑

A、必须是已生效的合同。 

B、合同类型为VC-OUT（承租合同）。

C、此合同未被其它船舶、航次配载，包括当前船舶其它航次。

D、本公司的合同。

E、合同中已指定的船舶为当前船舶，或者合同未指定船舶。

3、关联合同

A、在关联合同时，需要将合同的部分信息初始化到航次合同表。

B、当合同信息有变化时，航次合同表不体现调整后的内容，只有取消关联此合同，并确认后，再次关联此合同时，针对合同做的调整，才能体现到航次合同表中。

C、已完航次不能关联合同，航次状态VOY_STT = C（已完航次）。

4、取消关联合同

A、校验（是否能取消关联）

a)  已完航次不能取消关联合同。

b)  已安排了货载的合同，不能取消，要想取消，必须先将此合同的货载安排删除掉，提示先删除货载信息。

A、取消关联

a)删除此合同与当前航次的关联关系

5 注意事项

1、未生效的合同不会出现在可选合同列表中。

2、未关联本船舶的合同不会出现在可选合同列表中。

    3、只有配载了货物合同，后续才能做货载安排。

1.4.2修改航次基本信息

1 功能说明

通过此功能可以修改航次的基本信息，完善在航次初始化时没有维护的信息。

2 用户操作流程

1、点击航次基本信息中的【修改】按钮，如下图所示，进入航次基本信息维护页面。

2、将需要维护的信息填写完后，点击【保存】按钮。

3 页面功能（按钮）

1、添加特殊点：新增特殊点。

2、编辑特殊点：选择一条特殊点进行编辑。

3、删除特殊点：选择一条特殊点进行删除。

4、保存按钮：保存修改信息，保存时会做如下校验：

5、取消按钮

4 业务逻辑

1、显示航次基本信息中的航次开始时间不可修改（当前航次），为航次初始化时的航次开始时间；航次结束时间和挂港中尾港的离港时间一致；航线是根据货载中第一装港（货载中装港港序最小的港口）和最后卸港生成的（卸港中卸港港序最大的港口）。

2、船舶名称不能编辑，系统自动带入，其他信息也由系统自动带入（信息为初始化时信息）。

3、公司航次号，币种，航次类型为必填项。

4、公司航次号需校验同船，同公司，同航次下是否重复。

5、一个航次可以有多个特殊点，也可以一个都没有。

6、船员信息也可不必填写，但是如果填写了船员信息，上船时间也必须填写。

7、特殊点中特殊点和经过时间必填。

5 注意事项

1、航线是根据货载信息自动生成，生成规则：货载中装港港序最小的港口-货载中卸港港序最大的港口。如果没有满足生成规则则没有航线。

1.4.3航次指令

1 功能说明

航次指令的增删改查、刷新以及发送操作。

2 用户操作流程

1、点击航次详情主页面中的航次指令，如下图所示，进入航次指令主页面。

2、可在航次指令主页面中，点击页面功能按钮，进行相应的增、删、改、刷新以及发送操作。

3、已新增为例，点击【新增】按钮，系统弹出如下图所示窗口（红色边框为必填项），录入主题、正文、和附件后，可以选择保存或者发送。

4、发送完成后，可以在航次主页面，查看所发送的指令。

3 页面功能（按钮）

1、新增：新增航次指令。

2、编辑：选择一条航次指令进行编辑。

3、删除：选择一条或者多条航次指令进行删除。

4、发送：选择一条航次指令进行发送，不支持多条指令同时发送，。

5、刷新：刷新当前页面数据。

4 业务逻辑

1、新增/编辑

A、收件船舶：为必填，默认为该船舶邮箱，不可编辑。

B、邮件类型：下拉框，必填。

C、抄送人：下拉框，显示值为本公司下所有在役船舶邮箱，支持多个发送人。

D、主题：文字输入框为必填。

E、正文：多行文本框，最多可输入两千字，不必填。

F、附件：支持多附件，可对附件进行删除操作。

2、删除

A、支持多选删除，删除时会同时删除附件。

3、发送

A、发送功能不支持多选发送。

5 注意事项

1、在使用航次指令功能前，请正确配置好系统资源配置（配置邮箱服务器等信息）。

2、确保在船舶信息中，邮箱的正确性。

1.4.4挂港

1 功能说明

1、维护本航次所有的（预估）挂港信息，可以录入实际停靠的港口，也可以预计将来要靠泊的港口。

2、维护各停靠港口的在港动态信息。

3、维护各港口的港口代理信息。

2 用户操作流程

1、在航次任务维护界面下方，选择挂港TAB页（默认TAB页）。

2、通过新增、编辑、插入、删除港口等操作，对航次挂港信息进行维护。

3 页面功能（按钮）

1、新增港口：新增航次挂港

2、编辑港口（双击）：可通过选择一条挂港点击编辑港口，或者直接双击一条挂港进入编辑页面。

3、插入港口：选着一条挂港，点击插入港口在其前插入一条挂港信息，当前航次首港不能插入。

4、删除港口：选择一条或者多条港口进行删除操作。

5、在港动态：选择一条挂港，进行在港动态信息的维护。

6、港口代理：选择一条挂港，进行港口代理信息的维护。

7、保存：维护完挂港后保存信息，保存时校验如下：

A、抵港时间：

a) 抵港时间>=航次开始时间.

b) 离港时间 >= 靠泊时间 >= 抵港时间（无论是否预估，当此些时间有录入的时候必须遵守此规则）。

c) 无论是否预估，抵港时间应晚于当前航次当前挂港之前所有挂港的抵港时间/靠泊时间/离港时间（只比较时间有录入的情况）

B、靠泊时间：

a) 离港时间 >= 靠泊时间 >= 抵港时间（无论是否预估，当此些时间有录入的时候必须遵守此规则）。

C、离港时间：

a) 离港时间 >= 靠泊时间 >= 抵港时间（无论是否预估，当此些时间有录入的时候必须遵守此规则）。

b) 非预估的离港时间，在保存时校验是否晚于当前航次后续挂港的抵港时间/靠泊时间/离港时间（只比较时间有录入的情况），如有提示用户。可以保存成功，只在航次结束时强制校验。

D、编辑时，当港口发生变化，需要校验此港口/挂港是否被引用：此港口是否做了货载（装卸港）、加油水、港口代理、在港动态、事故、停航、修理，如有引用，提示用户需要先将此些信息调整掉，否则不能保持。

4 业务逻辑

1、航次状态为已完航次的航次，其挂港信息不能进行维护，只能查看。

2、挂港信息展示

A、列出本航次所有的挂港信息，按照挂港的顺序依次显示。

B、显示的字段包括：港序，港口，挂港目的，港间里程，抵港时间，抵港存油信息，离港时间，离港存油信息。

    3、新增/编辑港口（挂港）

A、港口

a) 此次挂港所靠泊的港口。

b) 下拉框格式，手工输入时自动匹配，显示中文。

c) 数据来源于主数据中的港口主数据（全部）。

d) 首港：

1、当前航次：首港为系统自动带出，其中第一个航次的首港由用户初始化船舶航次时指定，可以编辑。

2、计划航次：用户录入，可编辑。

3、在航次结束时，系统需要强制校验当前航次首港的数据准确性，详见“航次结束”- 校验。

4、已完航次：不能调整。

5、调整当前航次和已完航次的首港只能通过调整上航次的尾港来实现。

e) 必填。

B、抵港目的

a) 下拉框格式，可多选。

b) 数据来源于平台级别的抵港目的主数据（全部）。

c) 必填。

C、上一港口

a) 系统自动带出本航次中上一挂港的港口（中文），不可编辑；首港此项为空。

b) 数据库中不需要记录此信息。

D、港间里程

a) 从上港口到本港口（所行使）的距离，必填

b) 首港的港间里程默认为0

c) 新增挂港选择港口时或调整港口时（包括新增、编辑功能），系统需要带出港间里程的默认值，规则：

根据当前港口与上港口在港间里程主数据中取值

1、如上港口为空，则港间里程的默认值为0（首港）。

2、如当前用户所在公司维护了公司级别的港间里程主数据，则取公司维护的港间里程；如有，使用此值。

3、如不存在，取平台级别的港间里程；如拿到，则使用此值。

4、如不存在，港间里程的默认值为0。

d) 用户可以调整系统自动带出的港间里程, 不需要回写到公司维护的港间里程主数据中。

e) 当用户调整了港口时，需要重新获取港间距离的默认值。

E、航行时间：用户录入，单位：h（小时），浮点数，>=0。

F、平均航速：非用户录入，系统自动计算，平均航速 = 港间里程/航行时间，默认保留两位小数。 

G、抵港时间（Local）：当前航次首港不能编辑，以及航次结束时需要校验，详见保存/航次结束时的校验规则。

H、抵港时间是否预估：用户录入，E：预计；A：实际，当前航次默认不选择，计划航次默认选择。

I、靠泊时间（Local）

a) 所有航次的首港靠泊时间默认等于抵港时间（Local），此时间可手工调整

b) 所有航次的非首港靠泊时间由用户录入，可编辑。

c) 保存以及航次结束时需要校验，详见保存/航次结束时的校验规则。

J、靠泊时间是否预估：用户录入，E：预计；A：实际，当前航次默认不选择，计划航次默认选择。

K、吃水和水密：用户录入，默认为0，> = 0，保留2位小数点。

L、开始存油和润滑油：当前航次首港不能编辑，

M、离港信息和抵港一样，其中离港时间和离港存油和村润滑油可以编辑，并且尾港离港时间和和离港存油和村润滑油为必填，详见保存/航次结束时的校验规则。

存油情况：

1、新增时，根据船舶的燃料种类，将此种类下面所有的燃料类型全部列出，让用户做存油情况录入动作。

2、编辑时，直接列出航次存油信息表中的存油情况，提供用户编辑。

4、字段取值逻辑（系统自动处理）

A、航次UUID：当前航次ID。

B、公司代码：当前公司CODE。

C、船舶代码：挡墙船舶CODE。

D、挂港序号（港序）：首港为1，按挂港顺序依次递增，递增率为1。

E、港口时区：所靠泊港口所在的时区。

F、港口类型：首港：F，中间港口：O，尾港：L，新增插入时默认为中间港。

G、抵港时间（GMT）: 根据港口时区，将抵港时间（Local)转换成GMT时间，详见代码帮助类。

H、靠泊时间（GMT）：根据港口时区，将靠泊时间（Local)转换成GMT时间，详见代码帮助类。

I、离港时间（GMT）：根据港口时区，将离港时间（Local)转换成GMT时间，详见代码帮助类。

存油情况：

K、存油数据类型：0（挂港）。

L、存油数据UUID：挂港的UUID。

M、燃料种类：新增时，获取船舶的燃料种类，编辑时，燃料种类不变。

N、币种：公司的默认币种。

O、开始单价和结束单价：在航次结束时同意维护。

P、记录版本号、创建人、创建时间、修改人、修改时间。

5、插入港口:

A、页面/操作同新增功能。

B、系统需要自动更新后续挂港的港序。

C、计划航次的所有港口都支持插入港口动作，当前航次的首港不能再插入港口。

6、删除港口：

A、当前航次的首港不能删除。

B、系统需要自动更新后续挂港的港序。

C、删除时需要校验当前港口是否有加油水，如有，则需要提示用户。要先删掉加油信息或者将加油港调整成其它港口，否则不能删除成功。

D、需要删除当前挂港的挂港信息、存油水信息、在港动态、港口代理信息。

E、删除时需要校验当前港口是否有货载，如有，则需要提示用户。要先删除货载信息，或者将货载中的装卸港调整成其它港口，否则不能删除成功。

F、删除时需要校验当前港口是否有事故，修理，停航，如有，则需要提示用户。要先删除事故，修理停航信息，或者将其中的开始港，结束港调整成其它港口，否则不能删除成功。

5 注意事项

1、当前航次首港不能插入（计划航次可以），并且首港的挂港目的为空（航次初始化时没有维护），否则无法航次结束时会校验。

2、挂港尾港的离港时间和离港存油信息为必填，否则不能航次结束。

3、挂港显示信息中的存油信息，根据船舶燃油类型自动生成（所以不同船舶显示不一样）。

4、当前航次首港中抵港时间和开始存油信息不能编辑。

1.4.5 港口代理

1 功能说明

1、通过此功能，可维护船舶在港口的代理信息。

2、维护港口代理中的费信息。

2 用户操作流程

1、选择挂港TAB页（默认TAB页）。

2、如上图所示，选着一条挂港信息，点击【港口代理】按钮，系统弹出如下图所示窗口，

3、通过上图页面功能按钮可以进行新增、修改、删除港口代理信息。

3 页面功能（按钮）

1、新增代理：点击新增代理弹出新增页面。

2、修改代理：选择一条港口代理信息，点击【修改代理】进入下图所示修改页面。

3、保存：保存港口代理信息。

4、删除代理：选择一条或者多条港口代理信息，点击删除代理（物理删除）。

4 业务逻辑

1、选择一条挂港点击港口代理，进行港口代理信息维护（每个挂港可以有多个港口代理）。

2、新增/编辑：

A、代理：用户录入（所有供应商），下拉框，必填。

B、代理类型：用户录入，下拉框。

C、代理指定方：用户录入，1：船东；2：租家。

D、代理费支付方：用户录入，1：船东；2：租家。

E、报价：数字输入框，用户录入，非负数，不填时默认为0。

F、币种：用户录入（所有币种），下拉框，报价大于0时币种必填。

G、备注：用户录入。

H、港口：港口为代理所在挂港中的港口。

I、船舶代码：航次所在船舶代码。

J、公司代码、航次UUID、挂港UUID、记录版本号、创建人、创建时间、修改人、修改时间，通用规则。

3、删除：物理删除。

5 注意事项

1、代理商的选项来自供应商，显示为供应商名称。

1.4.6 在港动态

1 功能说明

通过此功能可维护挂港中的在港动态(船舶在该港口的所有动态)

2 用户操作流程

1、选择挂港TAB页（默认TAB页）。

2、如上图所示，选着一条挂港信息，点击【在港动态】，系统弹出如下图所示窗口。

3、通过上图页面功能按钮可以进行新增、修改、删除在港口动态信息。

3 页面功能（按钮）

1、新增动态：点击新增动态弹出新增页面。

2、修改动态：选择一条在港动态信息，点击【修改动态】进入下图所示修改页面

3、保存：保存所维护的在港动态信息。 

4、删除动态：选择一条或者多天在港动态，点击删除动态（物理删除）。

4 业务逻辑

1、选择一条挂港点击港口代理，进行港口代理信息维护（每个挂港可以有多个港口代理）。

2、新增/编辑：

a)动态: 用户录入，下拉框，必填。

b)开始时间：用户录入，必填。

c)开始时间是否预估（开始时间类型）：用户录入，E：预计；A：实际。

d)结束时间：用户录入，必填。

e)结束时间是否预估（结束时间类型）：用户录入，E：预计；A：实际。

f)天数：系统自动计算，天数 = 结束时间 - 开始时间（需要折算到天）。

g)备注：用户录入。

h)开始时区、结束时区：开始时区 = 结束时区 = 当前挂港的时区。

i)开始时间（GMT）：按照开始时区、开始时间（Local）计算。

j)结束时间（GMT）：按照结束时区、结束时间（Local）计算。

k)公司代码、航次UUID、挂港UUID、记录版本号、创建人、创建时间、修改人、修改时间（通用规则）。

3、删除：直接物理删除。

5 注意事项

1、在港动态的开始时间和结束时间如果是预估类型，该航次无法航次结束。

1.4.7货载

1 功能说明

维护航次所有的货载相关信息，包括新增/编辑/删除。

2 用户操作流程

1、选择货载TAB页。

2、点击【新建货载】，系统弹出如下图所示窗口。

3、输入货载信息后，点击保存即可。

4、通过页面功能按钮，还可以对货载信息进行维护。

5、货载信息维护完成后，如上图所示，可以点击【修改运价率】系统弹出如下图所示窗口

6、修改完成运价率后，点击保存即可。

3 页面功能（按钮）

1、新建货载：点击新建货载弹出新建货载页面。

2、编辑：选择一条货载信息，点击编辑进行编辑货载操作。

3、删除：选择一条货载信息，点击删除进行删除货载操作。

4、修改运价率：新增一条货载后可以修改该货载的运价率（每个合同对应一个）。

4 业务逻辑

1、可以添加多个货载信息，且多个货载可以使用同一个合同。

2、新增/编辑：

A、 字段取值逻辑（用户录入）：

a)装港：下拉框格式，手工输入时自动匹配，显示中文，必填。

b)卸港：下拉框格式，手工输入时自动匹配，显示中文，必填。

c)合同号：拉框格式，手工输入时自动匹配，显示合同号，本航次已关联的合同，单选。

d)货物名称：文本框，不可编辑，根据用户选择的合同号，系统自动带出其货物名称。

e)合同货量：文本框，根据用户选择的合同号，系统自动带出其货物数量，取基本货量区间的小值，用户不可编辑。

f)提单货量：文本框，用户录入，必填，默认值0。

g)提单号：文本框，用户录入。

h)装货货量：文本框，用户录入，必填，默认值0。

i)卸前货量：文本框，用户录入，必填，默认值0。

j)卸货货量：文本框，用户录入，必填，默认值0。

k)保函号：文本框，用户录入。

l)备注：文本域，用户录入。

B、字段取值逻辑（系统自动处理）：

a)航次UUID：当前航次的UUID。

b)公司代码：当前用户的公司代码。

c)装载所在挂港的UUID（LOAD_PROT_SCH_UUID）：装港所在挂港的挂港UUID。

d)卸载所在挂港的UUID（DISCH_PORT_SCH_UUID）：卸港所在挂港的挂港UUID。

3、保存货载信息时校验如下：

a）卸前货量 > 卸货货量。

b）装卸港和合同为必填项，如果没有填写则提示。

c）卸港港序要大于装港港序。

4、运价率：

A、货载中每个合同可配置不同的运价率。

B、字段取值逻辑：

a)计价方式：用户录入，下拉框，必填。

单价率：单价必填。

包干：包干价格必填。

WS（游轮运价指数）：指数必填，浮动率必填。

b)货量计算方式

按浮动率和按区间。

5、保存运价率时校验如下：

A、计价方式：

a)单价率：单价率必填。

b)包干：包干价格必填。

c)WS：基本价和浮动价必填。

B、浮动率计算：

a)货物数量必填。

b)浮动率最大值不能超过99.99.

c)超出货量开始量自动输入为货物数量值，结束量最小值为开始量，第二个超出货量中的开始量为第一个超出货量的结束量（以此类推最多有三个）。

d)计费标准：如果选择%，则计费标准最大值为99.99，如果选择包干，则没有最大值限制（计费标准可以有多个最多有三个标准）

C、区间计算：

a)货物数量开始结束必填。

b)超出货量开始量自动输入为货物数量结束值，结束量最小值为开始量，第二个超出货量中的开始量为第一个超出货量的结束量（以此类推最多有三个），结束量为必填。

c)计费标准：如果选择%，则计费标准最大值为99.99，如果选择包干，则没有最大值限制（计费标准可以有多个最多有三个标准）

D、计费标准必填。

6、删除：直接物理删除。

5 注意事项

1、新建货载前需先关联合同，货载中合同号必填。

2、承租航次必须有货载，可以有多个货载。

3、一个合同可以有多个货载信息。

1.4.8加油水

1 功能说明

维护航次中的加油水记录信息。

2 用户操作流程

1、选择加油水TAB页。

2、点击【加油水】，系统弹出如下图所示窗口。

3、录入加油水信息，点击【保存】即可。

4、通过页面功能按钮，可以进行加油水维护操作。

3 页面功能（按钮）

1、加油水：点击加油水，弹出加油水页面。

2、删除：选择一条或者 多条加油水信息，点击删除直接物理删除加油水所有信息。

3、编辑：选择一条加油水信息，点击编辑，可以修改加油水记录。

4 业务逻辑

1、一个航次中可以有多个加油水，多条加油水记录可以对应一个加油港。

2、新增/编辑（加油水）：

字段取值逻辑（页面/用户录入）：

A、加油港：

a)当前航次中所靠泊的港口（所有挂港中的港口）。

b)下拉框格式，手工输入时自动匹配，显示中文，必填。

B、计划加油水开始时间-计划加油水结束时间（local），未加入GMT时间

c)用户输入。

d)计划加油水时间要么开始时间和结束时间都不填，要么都填

C、实际加油水时间(local)，未加入GMT时间

a)用户输入。

b)和计划时间选填。

D、供应商：用户选择，从供应商主数据中获取。

E、支付方：用户录入，选择项：租家，船东（0,1）。

F、币种：用户选择，从币种表中获取，默认该航次所在公司币种（页面加载时获取），原币种。

G、原币种对航次币种（对本位币）汇率：用户不可编辑，根据加油水币种和航次币种以及加油港的抵港时间查询出汇率。

H、驳船费/佣金/查验费/其他费：用户输入，非负数默认为零。

I、存油情况：数字输入框，用户录入，非负数，不填时默认为0，详见保存时校验。

字段取值逻辑（系统自动处理）：

A、挂港UUID：当前挂港的UUID。

B、公司代码：用户所在公司代码。

C、航次币种：公司币种。

存油情况：

A、存油数据UUID：挂港的UUID。

B、燃料种类：新增时，获取船舶的燃料种类。

C、计划加油量/实际加油量：用户输入。

D、加油水UUID：系统带出。

E、加油单价：用户输入。

F、记录版本号、创建人、创建时间、修改人、修改时间（通用逻辑）。

3、维护完加油水信息后，点击保存按钮做以下校验：

B、加油水状态：

a)加油水中有实际加油水时间则航次状态为实际。

b)加油水中没有实际加油水时间则航次状态为计划。

C、校验实际时间和计划时间必须填写一个，如果填写了实际时间，则实际加油量和实际加水量为必填。

D、校验如果填写了实际加油量或者实际加水量，则单价和实际加油时为必填。

E、校验如果填写了计划加油量或者计划加水量，计划加油时为必填。

4、删除：直接物理删除所有加油水信息。

5 注意事项

1、加油港来源于挂港，必须先有挂港才有加油水。

2、 改变港口或者改变加油水币种时都会查询加油水币种对航次币种（对本位币）的汇率，没有时会提示维护。

1.4.9事故

1 功能说明

维护航次中的事故信息 

2 用户操作流程

1、选择事故TAB页。

2、点击【新建】，系统弹出如下图所示窗口。

3、录入事故信息，点击保存即可。

4、通过页面功能按钮，可以进行事故维护操作

3 页面功能（按钮）

1、新建：点击新建按钮，弹出新建航次事故页面。

2、删除：选择一条或者多条航次事故信息，点击删除按钮，直接删除所选中的航次事故信息（物理删除）。

3、编辑：选择一条航次事故信息，点击编辑，弹出编辑页面。

4 业务逻辑

1、显示的事故原因为中文描述，显示信息按照创建时间排序（降序）。可以有多个航次事故。

2、字段取值逻辑（页面/用户录入）

A、报告时间：用户选择，时间控件，必填。

B、事故原因：用户选择，下拉框，必填，来源于主数据红的事故原因。

C、开始时间：用户选择，时间控件，必填。

C、开始存水：数字输入框，用户录入，非负数，不填时默认为0。

D、事故开始所在港口：

a)当前航次中所挂港的所有港口（显示值为港口中文描述，后台传值为挂港id）。

b)下拉框格式，手工输入时自动匹配，显示中文。

E、开始描述/所在水域/事故结果：用户输入。

F、经度/纬度：用户输入，数字输入框，不填时为空，经度最大值为180，纬度最大值为90。.

G、存油情况：

a)新增时，根据船舶的燃料种类，将此种类下面所有的燃料类型全部列出，让用户做存油情况录入动作。

b)编辑时，直接列出航次存油信息表中的存油情况，提供用户编辑。

H：结束同开始

I、备注：用户输入。

字段取值逻辑（系统自动处理）

A、开始港口代码：所选开始港口中港口代码。

B、结束港口代码：所选结束港口中港口代码（根据挂港id查找港口）。

C、开始挂港id：所选开始港口中挂港id。

D、结束挂港id：所选结束港口中挂港id。

E、公司代码：户所在公司代码。

F、航次代码：当前航次。

G、船舶代码：当前船舶代码。

H、开始时区：开始港口所在时区。

I、开始GMT时间：根据港口时区，将开始时间（Local)转换成GMT时间。

J、结束时区：结束港口所在时区。

K、结束GMT时间：根据港口时区，将结束时间（Local)转换成GMT时间。

L、记录版本号、创建人、创建时间、修改人、修改时间，通用逻辑。

3、维护完航次事故信息后，点击保存按钮，保存信息保存时校验如下：

A、校验结束时间>开始时间>报告时间（必填）。

B、事故原因必填。

4、删除：直接物理删除所有航次事故信息。

5 注意事项

1、所在港口来源于挂港，必须先维护挂港。

1.4.10修理

1 功能说明

维护航次中的修理信息。

2 用户操作流程

1、选择修理TAB页。

2、点击【新建】按钮，录入事故信息，点击保存即可。

3、通过其他页面功能按钮，可以维护事故信息。

3 页面功能（按钮）

1、新建：点击新建按钮，弹出新建修理页面。

2、删除：选择一条或者多天航次修理信息，点击删除按钮，删除所选航次修理信息（物理删除）。

3、编辑：选择一条航次修理信息，点击编辑按钮弹出编辑航次修理页面。

4 业务逻辑

1、显示的修理类型为中文描述，显示信息按照创建时间排序（降序）。可以有多个航次修理。

2、字段取值逻辑（页面/用户录入）

A、报告时间：下拉框格式，必填。

B、修理类型：下拉框格式，必填。

C、待修开始时间：下拉框格式，必填。

D、修理开始时间、修理结束时间：下拉框格式，必填。

E、开始存水、结束存水：用户录入，大于0，18位有效位数，包括5位小数。

F、开始港口、结束港口：下拉框格式，

H、开始描述、结束描述：用户输入。

G、备注：用户输入。

H、存油情况：

a)字段取值逻辑（系统自动处理）新增时，根据船舶的燃料种类，将此种类下面所有的燃料类型全部列出，让用户做存油情况录入动作。

b)编辑时，直接列出航次存油信息表中的存油情况，提供用户编辑。

字段取值逻辑（系统自动处理）

A、航次UUID：当前航次的UUID。

B、存油UUID：新增时，动态生成UUID，编辑时，存油UUID不变。

C、燃料种类：新增时，航次中的船舶的燃料种类，编辑时，燃料种类不变。

D、币种：新增时，公司币种，编辑时，币种不变。

E、燃料类型：新增时，前台页面自动加载，系统带出，编辑时，燃料类型不变。

F、公司代码：新增时，航次中的公司信息，编辑时，公司代码不变。

G、航次：新增时，前台传过来的航次UUID查询出的航次信息，编辑时，不做操作。

H、存油数据类型：为修理代码”1“。

I、存油数据UUID：新增时，修理UUID，编辑时，不做操作。

J、开始存量：用户输入。

K、开始单价：修理界面不需要录入。

L、结束存量：用户输入。

M、结束单价：修理界面不需要录入。

N、记录版本号、创建人、创建时间、修改人、修改时间，通用逻辑。

3、维护完航次修理信息后，点击保存，保存时做如下操作：

A、开始时间小于结束时间。

B、待修理开始时间要小于结束时间。

C、报告时间小于开始时间。

D、报告时间小于待修理开始时间。

E、报告时间要小于结束时间。

F、航次修理类型为必填。

4、删除修理信息：直接物理删除所选的航次修理信息。

5 注意事项

1.4.11停航

1 功能说明

记录航次中的停航信息，维护航次过程中的停航信息。

2 用户操作流程

1、选择停航TAB页。

2、点击【新建】按钮，系统弹出如下图所示窗口，录入停航信息，点击保存即可。

3、通过其他页面功能按钮可以维护停航信息。

3 页面功能（按钮）

1、新建：点击新建按钮，弹出新建停航页面。

2、删除：选择一条或者多天航次停航信息，点击删除按钮，删除所选航次停航信息（物理删除）。

3、编辑：选择一条航次停航信息，点击编辑按钮弹出编辑航次停航页面。

4 业务逻辑

1、显示的停航原因为中文描述，显示信息按照创建时间排序（降序）。可以有多个航次停航。

2、新增/编辑（停航）

   字段取值逻辑（页面/用户录入）

A、报告时间：用户选择，时间控件，必填。

B、停航原因：用户选择，下拉框，必填，来源于主数据中的停航原因。

C、开始时间：用户选择, 时间控件，必填。

D、所在水域：用户输入。

E、停航开始所在港口：

a)当前航次中所挂港的所有港口（显示值为港口中文描述，后台传值为挂港id）。

b)下拉框格式，手工输入时自动匹配，显示中文。

F、开始描述：用户输入。

G、经度/纬度：用户输入，数字输入框，不填时为空，经度最大值为180，纬度最大值为90。

H、存油情况：

a)新增时，根据船舶的燃料种类，将此种类下面所有的燃料类型全部列出，让用户做存油情况录入动作。

b)编辑时，直接列出航次存油信息表中的存油情况，提供用户编辑。

I、结束同上。

J、停航天/油耗损失/扣减费用：数字输入框，用户录入，非负数，不填时默认为0。

K、计入非营运天：用户选择, 单选按钮，默认不选，选择后将不计入营运天.

L、备注：用户输入。

字段取值逻辑（系统自动处理）

A、开始港口代码：所选开始港口中港口代码。

B、结束港口代码：所选结束港口中港口代码（根据挂港id查找港口）。

C、开始挂港id：所选开始港口中挂港id。

D、结束挂港id：所选结束港口中挂港id。

E、公司代码：用户所在公司代码。

F、航次代码：当前航次。

G、船舶代码：当前船舶代码。

H、开始时区：开始港口所在时区。

I、开始GMT时间：根据港口时区，将开始时间（Local)转换成GMT时间。

J、结束时区：结束港口所在时区。

K、结束GMT时间：根据港口时区，将结束时间（Local)转换成GMT时间。

M、记录版本号、创建人、创建时间、修改人、修改时间，通用逻辑。

3、维护完航次停航信息后，点击保存，保存时做如下操作：

A、结束时间>开始时间>报告时间（必填）。

B、停航原因必填。

4、删除停航信息：直接物理删除所选的航次停航信息。

5 注意事项

1.4.12相邻航次查询

1 功能说明

1、进入航次详情查看界面后，如下图所示，点击【上航次】、【下航次】可以快捷查看相邻航次。

1.4.13航次结束

1 功能说明

结束当前航次（当本航次在实际业务中已经结束，且需要录入的相关信息已经录入时）。

2 用户操作流程

1、进入航次详情页面后，如下图所示，点击【航次结束】按钮。

2、系统对用户录入（维护）的航次所有信息进行业务以及逻辑上的校验，当有异常情况时，提示用户做修正，否则不能结束。

3 页面功能（按钮）

航次结束：进入一个需要结束的航次，点击航次结束按钮，结束该航次。

4 业务逻辑

1、系统校验

a）航次状态控制：当前航次才能做航次结束

b）本航次的上一航次为已完航次（如存在），本航次才能结束。

2、关联合同校验：航次类型为VC（承租）的航次，必须关联合同，否则不能结束航次

3、挂港：

a)在航次结束时，挂港中不能有预估信息。

b)尾港的离港时间必填。

c)尾港中离港的各类型的燃料数量之和必须 > 0，即航次结束存油必须 > 0（各类型分开计算，类型有：燃料油，润滑油，水）

d)所有挂港中的抵港时间、靠泊时间、离港时间必须按照挂港的顺序保证前后时间的一致性，譬如当前港口的抵港时间肯定晚于/等于上个挂港的离港时间（当各时间有录入时）

4、货载：VC（承租）航次，必须要做货载（主要用来标记装卸港）。

5、在港动态：在航次结束时，在港动态中不能有预估信息。

6、航次基本信息：公司航次号必填，且不能与本船舶的其它航次重复。

7、业务处理：

a)挂港信息维护：

b)港口类型：设置港序为1的港口为首港类型为首港（F），中间港为（O），

最后一个港口为尾港（L），如果只有一个港口将其设置为首港（新增港口时默认为中间港）。

c)挂港-存油水信息维护：

d)需要更新首港的结束单价以及中间港、尾港的开始单价/结束单价（此单价全部相同）；其中首港的开始单价由上航次的尾港的单价来决定，此处不需要更新

e)需要更新所有燃料类型的单价。

f)币种 = 公司币种。

g)开始单价（BGN_PRC）、结束单价（END_PRC），开始单价 = 结束单价 = （首港的开始存量 × 开始单价 + 加油量 × 加油单价 × 加油币种To航次币种的汇率（所有加油水）） /（首港开始存量 + 加油量（所有加油水））。

h)事故、停航、修理-存油水信息维护：

1、开始单价/结束单价。

2、开始单价 = 结束单价 = 尾港的结束单价。

i)航次基本信息维护（T_VOY）：

1、首港（ST_PORT_CD）：挂港中的首港的港口CODE.

2、尾港（ST_PORT_CD）：挂港中的尾港的港口CODE.

3、第一装港（FIR_LOAD_PORT_CD）：货载中装港港序最小的港口CODE。

4、最后卸港（FIR_LOAD_PORT_CD）：货载中卸港港序最大的港口CODE。

j)航线：货载中装港港序最小的港口和货载中卸港港序最大的港口组成。

k)航次状态：当前航次（A）-》已完航次（C）

8、下航次的初始化

a)初始化下航次的首港信息：

1、查找下航次的第一个挂港信息（首港），如不存在，给下航次新增首港，如存在，比较此港口是否与当前航次尾港的港口相同，如不相同，则给下航次新增首港，如相同，则只需要更新下航次首港的相关信息。

2、新增首港逻辑，逻辑同船舶航次初始化，不同点如下：

港口：不是来源于用户录入，= 当前航次的尾港的港口。

抵港时间/靠泊时间：抵港时间 = 靠泊时间 = 上航次尾港的离港时间。

3、更新首港的相关信息（首港存油水信息），逻辑同船舶航次初始化，不同点如下：

燃料类型：不是来源于用户录入，= 当前航次尾港的燃料类型。

币种：= 下航次的航次币种（T_VOY.CRY_CD)。

开始存量：开始存量 = 当前航次尾港的离港存量。

开始单价：开始单价 = 当前航次尾港的离港单价 * (离港存油水币种To下航次航次币种的汇率)。

b)更新下航次的航次信息：

1、航次开始时间：航次开始时间 = 当前航次尾港的离港时间。

2、航次状态：判断下航次是否为计划航次，如是，则将航次状态改为当前航次，如不是，保持不变。

9、新增一个计划航次：

a)逻辑同船舶航次初始化，不同点如下：

1、航次号：航次号 = MAX(当前航次号） + 1 FROM T_VOY WHERE VSL_GEN_UUID = '船舶UUID'

5 注意事项

1、航次结束时会给出相应的提示，根据提示修改航次信息，直到不报错为止。

1.4.14航次解锁

1 功能说明

系统默认已完航次是无法进行修改的，当一个完航航次需要调整时，可以通过“航次解锁功能”解锁后，才能进行调整。

2用户操作

1、进入航次详情页面后，如下图所示，点击【航次解锁】按钮即可。

3 注意事项

1、选择一条已完航次，点击航次解锁，解锁完后航次状态变为当前航次。

2、出现多个当前航次，需要按顺序从第一个开始逐个结束航次。

3、只有已完航次可点击航次解锁，其他航次默认不可点击。