支付宝Acord接口说明V2[1].6.6.doc

支付宝acord接口说明副标题：保险产品acord接口说明当前版本 2.6.6修订历史版本号修订人内容提要发布日期2.6武信（蒋易民）加入交易回查报文定义及说明，调整部分报文细节2011-5-192.6.1武信（蒋易民）加入法定受益人不在报文中体现的说明，增加缴费年期类型；2011-5-202.6.2武信（蒋易民）删除核保不通过的code，启用系统异常code，增加用户的支付宝唯一标识号2011-5-272.6.3武信（蒋易民）补充relation节点relatedobjectid属性说明；修正id类型错误，改为string类型；替换 finactivitynetamt为finactivitygrossamt2011-5-312.6.4武信（蒋易民）调整响应报文中olife节点为非必需；调整身高，体重数据类型为float；将自动续保节点从调整到；2011-6-22.6.5武信（蒋易民）修改增加保障期类型值，加入boolean类使用示例2011-6-72.6.5武信（蒋易民）修改为；修改应答报文中关于交易时间的描述2011-6-23目录1文档说明51.1描述51.2技术服务51.3术语定义52数据字典62.1描述62.2明细62.2.1证件类型62.2.2 boolean类型62.2.3电话类型72.2.4性别72.2.5省市72.2.6投保地区82.2.7缴费方式82.2.8缴费形式82.2.9缴费类型92.2.10缴费年期类型92.2.11地址类型92.2.12保障期类型102.2.13保障内容分类112.2.14分配选项112.2.15关联对象类型112.2.16关联角色类型122.2.17保单状态132.2.18交易类型132.2.19交易响应结果类型142.2.20交易响应结果信息类型153通用对象报文定义153.1请求153.2请求授权163.3响应173.4响应结果173.5保单183.6寿险193.7实体203.8人213.9电话223.10地址223.11电子邮件223.12关联233.13扩展对象244报文说明244.1保单查询交易244.1.1请求254.1.2应答254.2核保交易264.2.1请求264.2.2应答274.3财务活动交易284.3.1请求284.3.2应答294.4交易查询304.4.1请求304.4.2应答314.5异步响应314.5.1请求324.5.2应答321 文档说明1.1 描述本文档根据acord标准（版本号2.24.00）定制支付宝与保险公司的业务交互规则，主要限定基于acord标准的报文协议；交易接口采用遵循acord的报文，文档中描述具体的报文格式，含义及一些数据字典定义。1.2 技术服务在开发或使用本接口时，报文有疑问的地方可以到acord官方网站查找资料及下载最新的标准文档。/pages/default.aspx1.3 术语定义术语解释对象文中出现的如果不加特别说明指的都是acord标准中的object属性文中出现的如果不加特别说明指的都是acord标准中的attribute字典类型文中出现的如果不加特别说明指的都是acord标准中的lookups章节中的内容节点报表中的每个element都可以看成是节点lookup作为报文中的一种数据类型，代表的是取值（tc）由数据字典限定percent比例作为报文中的一种数据类型用于表示百分比。需要注意的是在存储时，所存数值应该是乘于100后的值，例如：8.5%存的是8.5，而不是0.085。currency金额作为报文中的一种数据类型用来表示涉及到钱的数字，单位为分，无小数，比如一元钱就是100分。2 数据字典2.1 描述本节用来定义一些常用业务代码，如证件类型，性别等。使用过程中代码值是必须在报文中体现的，代码名称可以不用再报文中体现。2.2 明细2.2.1 证件类型对应acord中的government id type code,对象取值范围由该字典限定，对应acord字典为oli_lu_govtidtc。需要提醒的是，由于acord标准未定义国内几种通用的类型，在这里进行了自定义，前缀通用为ali（oli前缀的来源acord）,取值与当前acord标准中已经定义的值不冲突。代码值代码名称说明800ali_social_security_card身份证；生日日期必须与身份证号码中的出生年月日信息保持一致801ali_student_card学生证802ali_drivers_licence驾驶证803ali_house_card户口本804ali_birth_card出生证17oli_govtid_passportid护照21oli_govtid_chinamil军官证2.2.2 boolean类型对于是否的取值需要该类型限定，对应acord数据字典为oli_lu_boolean。代码值代码名称说明0oli_bool_false代表false1oli_bool_true代表true,注意：使用格式为，而不是12.2.3 电话类型对应acord中的phone type,对象取值范围由该字典限定，对应acord字典为oli_lu_phonetype。代码值代码名称说明1oli_phonetype_home家庭电话2oli_phonetype_bus办公电话12oli_phonetype_mobile移动电话19oli_phonetype_fax传真2.2.4 性别对应acord中的gender type, 对象取值范围由该字典限定，对应acord字典为oli_lu_gender。如果证件类型选择身份证，那么该值必须与身份证号码中的性别标识信息相匹配。代码值代码名称说明1oli_gender_male男2oli_gender_female女0oli_unknown未知2.2.5 省市采用国家标准定义值，详细见如下文件：2.2.6 投保地区采用国家标准定义值，针对具体保险公司的过滤需求由具体需求确定，但采用的值都在本定义范围内，详细见如下文件：2.2.7 缴费方式用来指定保费缴纳（支付）的具体方式，如：提前支付、保费垫交、信用卡结算、电子资金转账等，在本规范中只取7即电子资金转账代表支付宝支付。限定acord对象，对应acord数据字典为oli_lu_paymethod。代码值代码名称说明7oli_paymeth_etranselectronic funds transfer电子资金转账(网上银行支付)，在这里就代表支付宝2.2.8 缴费形式用来指定保费缴纳（支付）的具体形式，支付形式，如：现金、支票、信用卡，电子资金转账等，在本规范中只取7即电子资金转账代表支付宝支付。限定acord对象，对应acord数据字典为oli_lu_paymentform。代码值代码名称说明7oli_paymeth_etranselectronic funds transfer电子资金转账(网上银行支付)，在这里就代表支付宝2.2.9 缴费类型保费缴纳类型，典型的如：年付、月付、周付等等。限定acord对象，对应acord数据字典为oli_lu_paymode。代码值代码名称说明1oli_paymode_annual年缴4oli_paymode_mnthly月缴6oli_paymode_wkly周缴8oli_paymode_daily日缴9oli_paymode_singlepay趸交，一次交清（single payment）2.2.10 缴费年期类型缴费年期类型，典型的如：年付、月付、周付等等。限定扩展节点代码值代码名称说明1oli_durationmode_annual年缴4oli_durationmode_mnthly月缴6oli_durationmode_wkly周缴8oli_durationmode_daily日缴9oli_durationmode_singlepay趸交，一次交清（single payment）2.2.11 地址类型限定acord对象，对应acord数据字典为oli_lu_adtype。该类型用来区分是居住地址还是保单配送地址。代码值代码名称说明1oli_adtype_homeresidence居住地址17oli_adtype_mailingmailing邮寄地址，一般是邮政地址。该地址可以收到的所有信件除非另有指定的地址，可以住宅或商业地址，它可以表示业务送货地址。20oli_adtype_polmail保单邮寄地址88ali_adtype_insure扩展类型，代表投保地区2.2.12 保障期类型受益期类型,限定acord对象 (保险金给付的约束)下的取值，对应acord数据字典为oli_lu_beneperiod。代码值代码名称说明6oli_dibenprd_1yr1 year (12 months, 52 weeks, 365 days)保障期为一年42oli_dibenprd_years按年计算，由指定具体年限。benefit period in yearsnotes:see benefit max durations or max amountperiods for length53oli_dibenprd_agespec至某年龄coverage to specified agenotes:see benefit max durations periods for age18oli_dibenprd_life终身lifetime41oli_dibenprd_months按月计算description:period is expressed in monthsnotes:see benefit max durations or max amountperiods for length40oli_dibenprd_days按天计算amount specified in daysnotes:see benefit max durations or max amountperiods for length2.2.13 保障内容分类限定acord属性下的取值，对应acord数据字典为oli_lu_covindcode。代码值代码名称说明1oli_covind_basebase 主险2oli_covind_riderrider 附加险2.2.14 分配选项限定acord对象取值，对应acord数据字典为oli_lu_distoption。代码值代码名称说明1oli_distoption_equalequal；用于在受益参与人之间平均分配，比如可以指定3个受益人每人占到三分之一受益2oli_distoption_percentpercent按百分比分配2.2.15 关联对象类型限定acord对象及取值，对应acord数据字典为oli_lu_objecttype。代码值代码名称说明6oli_party关联对象为4oli_holding关联对象为2.2.16 关联角色类型限定acord对象取值，对应acord数据字典为oli_lu_rel。代码值代码名称说明1oli_rel_spouse配偶8oli_rel_owner保单投保人owner，关系双方为：holding - - party: party - -party:32oli_rel_insured保单保障人，被保人，关系双方为：holding - - party: party - -party:description:insureddefinition:reciprocal is oli_rel_insured whenrelation is holding-to-party. reciprocal isoli_rel_hlthinsurer whenrelationship is party-to-party.notes:reciprocal is oli_rel_insured whenrelation is holding-to-party. reciprocal isoli_rel_hlthinsurer whenrelationship is party-to-party.34oli_rel_beneficiary保单受益人，关系双方为：holding - - party:primary beneficiarywhen paying proceeds to beneficiaries, thebeneficiaries in this role will receiveproceeds first.notes:reciprocal is oli_rel_beneficiary2oli_rel_child儿女，关系双方为：party - - party:3oli_rel_parent父母，关系双方为：party - - party:92oli_rel_grandparent祖父/母，关系双方为：party - - party:4oli_rel_sibling兄弟姐妹，关系双方为：party - - party:27oli_rel_legalguard法定监护人，关系双方为：party - - party:168oli_rel_self自己，关系双方为：party - - party:1oli_rel_spouse配偶，关系双方为：party - - party:171oli_rel_childinlaw女婿或媳妇，关系双方为：party - - party:description:child-in-lawdefinition:non-gender specific title for a son-in-lawand daughter-in law.reciprocal is oli_rel_parentinlaw2147483647oli_rel_other其他2.2.17 保单状态限定acord对象取值，对应acord数据字典为oli_lu_polstat。代码值代码名称说明55oli_polstat_suspend暂存39oli_polstat_cancelled撤销1oli_polstat_active生效4oli_polstat_lapsed失效2.2.18 交易类型限定acord对象取值，对应acord数据字典为oli_lu_trans_type_codes。代码值代码名称说明111oli_trans_illcalrequest illustration calculations保费试算185oli_trans_chgfinupdate financial activity财务活动交易203oli_trans_inqhldholding inquiry，保单查询303oli_trans_check交易查询2.2.19 交易响应结果类型限定acord对象下的取值，对应acord数据字典为result_codes。代码值代码名称说明1result_success仅表示交易已经出来成功，且没有更多额外信息。如果选择该值，对象中不必指定对象。成功执行了业务过程，例如资金转移，发起方需要的信息得到返回相应；means you successfully completed the business process (e.g. fund transfer).2result_successinfo带有信息的成功返回标准，交易已经成功，但某些条件下要求返回特定信息。有时候是一些正常信息，有时候会是一些警告信息。如果选择该值，那么对象必须包含对象3result_recdpend异步交易中表明消息已经被接收到，但需要后续等待处理才能返回发起方需要的回执信息；表示已经接收了消息，将在以后处理请求。如果选择该值，对象中不必指定对象。means you accept the msg (got the message) and have it pending for later processing4result_recdpendinfo异步交易中表明消息已经被接收到，但需要后续等待处理才能返回发起方需要的回执信息；如果选择该值，对象中必指定至少一个对象。5result_failure交易处理失败，失败原因必须返回，返回相应错误提示信息；选择该值，必须指定至少一个对象，业务处理失败或者被处理被拒绝2.2.20 交易响应结果信息类型限定acord对象下的取值，在交易响应中的中用来返回除了交易响应类型之外的具体的响应结果类型，是比响应类型粒度更小的响应结果信息，参考acord数据字典为result_info_codes。代码值代码名称说明999resultinfo_unknown未知原因，系统异常。只提供一个值来标识响应方的系统异常，非业务异常，业务异常用其他code值来表示，请求方在获得响应后可以通过识别999这个值来判断是否需要发起请求重试，如果是999就重试8883 通用对象报文定义3.1 请求对应acord中的对象，用来描述请求信息，该对象是txlife请求报文的主要对象，请求的主要信息需要该节点携带。properties/attributes数据类型必选多选说明stringy报文发送系统内部标识的唯一交易流水号，响应系统响应时必须返回当前响应对应的请求交易号，即同一笔交易，请求和响应的值是相同的。该值由一次交易的请求方生成，响应方回传lookupy交易类型lookup交易子类型boolean表明是可以待发送的响应，默认值是trueboolean标志该请求是否需要响应，默认为false,必须响应。true表示响应不需要发出信息date交易日期，格式为：yyyy-mm-ddtime交易时间object该节点是olife中整个对象模型的基础。其他对象、相关的属性和方法通过该对象同客户端的应用发生联系3.2 请求授权对应acord中的对象，代表请求者的授权信息，可以提供一个低层级的安全检查properties/attributes数据类型必选多选说明string用户名object密码:properties/attributes数据类型必选多选说明string加密后的字符串与二选一string密码string加密类型，有才指定类型:扩展信息properties/attributes数据类型必选多选说明string值固定为alipay代表发起方是支付宝3.3 响应对应acord中的对象，表示响应信息，该对象是txlife响应报文的主要对象，响应的主要信息需要该节点携带。properties/attributes数据类型必选多选说明stringy报文发送系统内部标识的唯一交易流水号，响应系统响应时必须返回当前响应对应的请求交易号，即同一笔交易，请求和响应的值是相同的。lookupy交易类型lookup交易子类型date交易日期，格式为：yyyy-mm-ddtime交易时间格式为：hh:mm:ssobject返回txlife消息请求的响应消息object该节点是olife中整个对象模型的基础。其他对象、相关的属性和方法通过该对象同客户端的应用发生联系3.4 响应结果对应acord标准中的对象，描述请求对应的响应中携带的具体信息。properties/attributes数据类型必选多选说明lookupy接收系统返回的结果代码objecty结果信息对象，transresult中resultinfo出现与否由resultcode属性中的类型代码值决定，具体请参考交易响应结果类型相关描述。integer在搜索（search）交易中，用该值来返回符合条件的记录总数3.5 保单保单对象，描述保单信息，对应acord标准中的对象properties/attributes数据类型必选多选说明idstring标识符，用于唯一识别xml文档的idstring保单号，承保成功后生成string产品代码date保险起期，保单生效日，格式为：yyyy-mm-dddate保险止期，保单终止日，格式为：yyyy-mm-ddlookup缴费类型，如：趸交、月缴、周缴等lookup缴费方式date保费的支付日期，格式为：yyyy-mm-dddate最后一次支付保费的日期currency缴费的金额，也可以表示首期保费，当前正常情况下应支付的保费，表示承保人希望被支付的保费金额date承保日期，格式为：yyyy-mm-dddate续保日期，格式为：yyyy-mm-ddobjecty财务活动，如果保费不仅通过支付宝支付还有其他支付组合支付，可以考虑该字段描述currency应收金额。date财务活动处理日期，缴费日期，用来代表交易日期，付款日期，格式为：yyyy-mm-dd。objecty支付对象，描述具体的支付信息，比如金额，形式，方式lookup支付形式，取值选自字典oli_lu_paymentformcurrency该支付对象支付金额objecty申请信息string申请保单代码,投保单号，核保成功后返回object寿险保单对象,描述寿险特定信息objectlife扩展信息boolean是否自动续保，有的产品需要在提交保单的时候选择是否同意自动申请续保，从oli_lu_boolean.选择3.6 寿险寿险保单对象，对应acord标准中的下的对象properties/attributes数据类型必选多选说明currency保额，就寿险对象而言，该属性表示的是基本保额。integer投保份数currency保费总额objecty保障内容对象，描述保障利益；该对象包含了保单的具体保障或附加险相关的属性；保单的基本保障信息也用该对象表示；保障内容对象集合表示了特定寿险或健康险保单的所有保障或附加险string计划的全称。计划可以包含多种保障条款类型，例如满期生存保险金, 身故保险金,基本保障、附加险等lookup主附加险信息,保障内容的分类，如：基本、附加等。该属性识别保障内容是否为基本保障内容。currency保额，保障金额，如果保单中有多个保障利益，比如身故保险金40万，节假日意外身故保险金20万，这种情况可以用两个描述一个为40，一个为20object保险金给付的约束,受益限定信息lookup从oli_lu_beneperiod字典中选择值，最大给付期间的类型，保障年期类型integer给付期间最大次数，保障年期object扩展信息，描述缴费年期类型和具体年限lookup缴费年期类型integer缴费年期3.7 实体实体对象，描述的是个人或者组织的信息，对应acord标准中的对象properties/attributes数据类型必选多选说明idstringpartyid属性string实体对象的全称，当实体类型为个人时，全称的格式是%l, %f %，其中：%l表示姓，%f表示名；当实体类型为组织时，全称是组织完整的、依法登记的名称。string实体类型是1(oli_pt_person)代表是证件类型，取值由oli_lu_govtidtc限定string上述类型的代码objecty当事人的一种类型objecty联系电话objecty地址addressobjecty邮件地址object描述风险信息，比如被保险人相关的健康告知objecty键值对象，可以用来描述多个健康告知项，一个问题对应一个string键名string键值object扩展信息date证件有效截止日期，格式为：yyyy-mm-dd3.8 人人对象，代表的是个人的基本信息，对应acord标准中的对象properties/attributes数据类型必选多选说明idstringphoneid属性string支付宝用户唯一标识号string姓氏string名字date生日，格式为：yyyy-mm-ddstring职业，与保险公司的一致，本标准不限制，如果职业描述需要3个字段可以采用逗号拼接存入该节点，表现形式类似：lookup性别float身高，单位cm(厘米)float体重，单位kg（千克，公斤）3.9 电话代表的是个人的电话基本信息，对应acord标准中的对象properties/attributes数据类型必选多选说明idstringphoneid属性lookup联系电话类型，值由字典oli_lu_phonetype决定string联系电话号码3.10 地址代表的是个人的住址或者办公地址信息，对应acord标准中的对象properties/attributes数据类型必选多选说明idstringaddressid属性lookup地址类型string省，直辖市string城市string第一地址行，代表区string第二地址行，备用字段string邮编string用于包含提示或额外的地址，比如常见的备注字段用来描述具体的地址信息。3.11 电子邮件代表的是个人的邮件地址信息，对应acord标准中的对象properties/attributes数据类型必选多选说明idstring用于标识给定xml文档的唯一idstring完整的、可用的电子邮件地址，被正确定义为smtp地址。3.12 关联对应acord中的对象，代表了当事人、活动、群体或者权益对象与另一个对象之间的关联关系。值得注意的是如果收益是指定为法定的，报文中不会体现，即如果不描述受益人信息，就认为是法定的。properties/attributes数据类型必选多选说明idstringy关联发起一方的对象的id.originatingobjectidstringy关联发起对象idrelatedobjectidstring相关对象idlookup关联发起对象的顶级对象类型lookup关联相对应对象的类型lookup关联角色代码，当处理相同类型的对象时，通过填充下述句子的空白来解释关联角色代码：关联对象是发起对象的关联角色代码。例如：如果发起对象=“灰太狼”，关联对象=“红太狼”，关联角色代码=“丈夫”，你可以对关系解释如下：灰太狼是红太狼的丈夫。percent受益比例integer用来说明受益顺序，显示关系的顺序。当拥有大量相同类型相等百分比的关系时，这个对象被用于显示哪一个是主要的，其次的，第三的，等等。这个域只用于有相同百分比的特定类型的关系。lookup指定受益人的保险金分配方式3.13 扩展对象用于扩展acord数据模型的对象，可以使用任意结构以允许任何有效的xml包含在扩展信息中。对应acord中的对象，需根据具体业务需求扩展。所有acord数据模型的对象都可以通过该对象来扩展。properties/attributes数据类型必选多选说明vendorcodestringy唯一实体识别键。不同的扩展信息通过该标志来区分和代表具体的扩展含义自定义名称合法的类型按业务需要扩展的代码4 报文说明4.1 保单查询交易保单查询相关，针对是指定保单号的单个保单查询，不是search(搜索)交易。用途对保单的各项基本信息的查询所属类别查询类交易交易码203消息组成请求方发送的保单信息查询请求和应答方返回的保单信息查询应答信息组成了整个交易4.1.1 请求节点数据类型必选多选说明objectyxml根节点objectn用户信息objecty描述txlife请求消息的细节stringy交易流水号lookupy交易类型datey提交请求日期，格式为：yyyy-mm-ddtimey提交请求时间，格式为：hh:mm:ssobjecty交易数据objectyy权益对象object保单对象object实体object关系报文样例：4.1.2 应答节点数据类型必选多选说明objectyxml根节点objecty总体提供txlife响应消息的细节stringy交易流水号lookupy交易类型datey提交应答日期，格式为：yyyy-mm-ddtimey提交应答时间，格式为：hh:mm:ssobjecty交易结果细节object交易数据objecty权益对象object保单对象object实体object关系报文样例：4.2 核保交易核保处理用途向保险公司发送个人投保信息所属类别记录类交易交易码1035消息组成请求方发发起新保单的基本信息的提交请求和应答方返回的保单是否正常记录的应答信息组成了整个交易4.2.1