package common
type StamperBean struct {
// core:true 【签署位置类型】签署位置类型 【传参】 取值范围:SEAL_PERSONAL(个人签名)、TIMESTAMP(时间戳)、PERSONAL_ACROSS_PAGE(骑缝签名)、PERSONAL_ACROSS_PAGE_ODD(奇数页骑缝签名)、PERSONAL_ACROSS_PAGE_EVEN(偶数页骑缝签名)、PERSONAL_ACROSS_PAGE_SCOPE(指定页面范围骑缝签名)、PURPOSE(用途章)、ANNOTATION(签署批注)。 【特殊说明】 1、骑缝章类型只需要指定电子签约文档id和Y轴坐标 2、用印流程配置不允许添加日期,则传入的时间戳无效 3、支持的批注类型默认取用印流程配置,若流程未开启则默认为“文字批注”类型 4、使用用途章可以给文件做标记,避免重要的文件被乱用。如“此件仅供XXX使用,其他用途无效”。用印流程配置不允许添加用途章时传入的用途章无效
Type_ string `json:"type"`
// core:true 【X轴坐标/偏移量】X轴坐标/偏移量 【作用】 1、通过坐标指定签署位置时,根据坐标的原点,根据坐标单位(offsetUnit)确认签署位置横向位置(例如,以页面左下角为原点时,根据坐标单位确认签署位置左下角所在横向位置) 2、通过关键字指定签署位置时,以位置块的初始定位为原点,根据偏移量单位(offsetUnit)确认签署位置需横向偏移量 【传参】 不传值默认为:0。
OffsetX *float64 `json:"offsetX,omitempty"`
// core:true 【Y轴坐标/偏移量】Y轴坐标/偏移量 【作用】 1、通过坐标指定签署位置时,根据坐标的原点,根据坐标单位(offsetUnit)确认签署位置纵向位置(例如,以页面左下角为原点时,根据坐标单位确认签署位置左下角所在纵向位置) 2、通过关键字指定签署位置时,以位置块的初始定位为原点,根据偏移量单位(offsetUnit)确认签署位置需纵向偏移量 【传参】 不传值默认为:0。
OffsetY *float64 `json:"offsetY,omitempty"`
// 【坐标原点位置】坐标原点位置 【作用】 通过坐标指定签署位置时,可指定坐标原点。指定签署位置时,按指定的坐标原点为起始点设置位置的横纵坐标 【传参】 取值范围:LEFT_TOP (页面左上角),RIGHT_TOP (页面右上角),LEFT_BOTTOM (页面左下角),RIGHT_BOTTOM (页面右下角);不传值默认为:LEFT_BOTTOM (页面左下角)
OriginPosition string `json:"originPosition,omitempty"`
// core:true 【签署页码】签署页码 【作用】 指定签署位置所在的文件页码 【传参】 1、使用坐标指定位置时必须传入。 2、0:全部页,-1:最后一页,其他:第page页(例如:第7页,则传入7)。
Page string `json:"page,omitempty"`
// core:true 【关键字】关键字 【作用】 通过查询签署文件中的关键字来指定签署位置,如指定在甲方这样的关键字后方生成签署位置则传入甲方
Keyword string `json:"keyword,omitempty"`
// core:true 【关键字索引】关键字索引 【作用】 使用关键字指定签署位置时,指定哪几个关键字需要指定签署位置,比如可以指定第1个关键字、倒数第1个关键字等 【传参】 1、默认为1,即第1个关键字。 2、0:全部,-1:最后一个,其他:第keywordIndex个(例如:第7个,则传入7)。
KeywordIndex string `json:"keywordIndex,omitempty"`
// 【坐标/偏移量单位】坐标/偏移量单位 【作用】 1、通过坐标指定签署位置时,用于设置坐标值的单位 2、通过关键字指定签署位置时,用于设置偏移量的单位 3、单位包括3种,具体如下: (1)比例:页面宽度、高度为1,通过比例定位坐标或偏移量,通过坐标定位时传值范围为0-1,通过关键字指定签署位置时偏移量范围为-1~1 (2)毫米:通过相对距离定位坐标或偏移量,单位为毫米,传值范围不限制 (3)磅:通过相对距离定位坐标或偏移量,单位为磅,传值范围不限制 【传参】 取值范围:RATIO(比例),MM(毫米),POINT(磅);不传值默认为:RATIO(比例)。
OffsetUnit string `json:"offsetUnit,omitempty"`
// core:true 【签署位置相对于关键字的方向】签署位置相对于关键字的方向 【作用】 使用关键字定位时传入,用于确定签署位置在关键字的哪个方向 【传参】 取值范围:RIGHT(关键字右侧),LEFT(关键字左侧),CENTER(签章中心与关键字中心重合),UPPER_LEFT(关键字上方左对齐),UPPER_RIGHT(关键字上方右对齐),UPPER_CENTER(关键字上方居中),LOWER_LEFT(关键字下方左对齐),LOWER_RIGHT(关键字下方右对齐),LOWER_CENTER(关键字下方居中),LEFT_COVER(覆盖关键字左对齐),RIGHT_HALF_COVER(覆盖关键字右半边);不传值默认为:RIGHT(关键字右侧)。
RelativePosition string `json:"relativePosition,omitempty"`
// core:true 【签署位置相对于坐标的方向】签署位置相对于坐标的方向 【作用】 使用坐标定位时传入,确定签署位置相对于坐标的方向和对齐方式 【传参】 取值范围:RIGHT(位置在坐标右侧中心对齐),LEFT(位置在坐标左侧中心对齐),CENTER(位置中心与重叠),UPPER_LEFT(位置在坐标上方左侧对齐),UPPER_RIGHT(位置在坐标上方右侧对齐),UPPER_CENTER(位置在坐标上方中心对齐),LOWER_LEFT(位置在坐标下方左侧对齐),LOWER_RIGHT(位置在坐标下方右侧对齐),LOWER_CENTER(位置在坐标下方中心对齐);不传值默认为:UPPER_LEFT(位置在坐标上方左侧对齐)。 【特殊说明】 仅对批注类型的位置生效
CoordinateRelativePosition string `json:"coordinateRelativePosition,omitempty"`
// core:true 【签署位置宽度】签署位置宽度 【作用】 设置签署位置的宽度,防止用户在文件上添加的签名过大或过小 【传参】 1、支持个人签名、时间戳位置,不支持签章位置;支持文字批注,超出设置的宽度会自动换行。 2、仅传宽度时,高度按比例适配,两者均传参以宽度为准。 3、最小值:10(包含),最大值:120(包含);不传值默认为:系统默认大小。 【特殊说明】 1、内部法人单位发起的文件默认大小取【电子签章系统前台-用印流程-高级配置-文件签署-签署位置初始大小设置】中设置的大小 2、外部法人单位发起的文件默认大小取【电子签章系统后台-电子用印设置-高级配置-文件签署-签署位置初始大小设置】中设置的大小
Width *float64 `json:"width,omitempty"`
// core:true 【签署位置高度】签署位置高度 【作用】 设置签署位置的高度,防止用户在文件添加的签名过大或过小 【传参】 1、支持个人签名、时间戳位置,不支持签章位置。 2、仅传宽度时,高度按比例适配,两者均传参以宽度为准。 3、最小值:4(包含),最大值:48(包含);不传值默认为:系统默认大小。 【特殊说明】 1、内部法人单位发起的文件默认大小取【电子签章系统前台-用印流程-高级配置-文件签署-签署位置初始大小设置】中设置的大小 2、外部法人单位发起的文件默认大小取【电子签章系统后台-电子用印设置-高级配置-文件签署-签署位置初始大小设置】中设置的大小
Height *float64 `json:"height,omitempty"`
// core:true 【签署位置旋转角度】签署位置旋转角度 【作用】 指定签署位置的旋转角度,当文件为横向或扫描件存在角度偏移时,可以指定签署位置的旋转角度 【传参】 1、支持个人签名、时间戳、签章位置。 2、旋转中心为签署左下角,方向为顺时针。 3、最小值:0(包含),最大值:360(包含);不传值默认为:不旋转。
RotateDegree *float64 `json:"rotateDegree,omitempty"`
// core:true;format:string 【签署文档id】签署文档id 【作用】 1、用于指定签署位置所在的签署文档 2、不传入documentId和documentIds时,签署位置默认对全部签署文档生效。
DocumentId *int64 `json:"documentId,omitempty"`
// core:true 【签署文档id集合】签署文档id集合 【作用】 1、用于指定签署位置所在的签署文档,可指定多个。 2、不传入documentId和documentIds时,签署位置默认对全部签署文档生效。
DocumentIds []string `json:"documentIds,omitempty"`
PurposeConfig *PurposeConfig `json:"purposeConfig,omitempty"`
SealAnnotation *SealAnnotation `json:"sealAnnotation,omitempty"`
// core:true 【骑缝签名自定义页面加盖】骑缝签名自定义页面加盖 【传参】 1、可传入页码或页码范围,多组页码或页码范围之间用英文逗号(,)分隔,例如:2,4~7,8~11。 2、当type(签署位置类型)为PERSONAL_ACROSS_PAGE_SCOPE(指定页面范围骑缝签名)时,此参数必填。 【说明】 1、受参数acrossType(骑缝签名位置指定方式)影响: (1)当acrossType为SINGLE_DOCUMENT(每份文档单独指定骑缝签名位置)时,骑缝章自定义页面配置对每份文档单独生效。 (2)当acrossType为ALL_DOCUMENT(多份文档合并指定骑缝签名位置)时,骑缝章自定义页面配置对所有文档合并生效,即相当于多份文档合并成一份文档后统一生效。
SealPageConfig string `json:"sealPageConfig,omitempty"`
// core:true 【骑缝签名位置指定方式】骑缝签名位置指定方式 【作用】 指定骑缝签名位置时,可以通过此参数控制位置的指定方式 【传参】 取值范围:SINGLE_DOCUMENT(每份文档单独指定骑缝签名位置),ALL_DOCUMENT(多份文档合并指定骑缝签名位置);不传值默认为:SINGLE_DOCUMENT(每份文档单独指定骑缝签名位置)。
AcrossType string `json:"acrossType,omitempty"`
}