四阶段框架项目电商类api对接0428讲课内容agent v

PREPAY_ORDER_PRINT_FAILED门票Agent与供应商数据交互设计V2.1.2接互设 连接方 字符编 认证与安 【产品】Qunar获取产品信 【订单】Qunar获取订单信 【订单】Qunar退款通 Qunar提供服务数据格式设 【订单】供应商向Qunar申请退 交互样例（MD5 接口心跳监 接口超时限 产品的处罚下 修订记新2014-01-4.1【产品】Qunar获取产品信息小节中，添在5.2【产品】供应商获取产品信息小节中，参4.1【产品】Qunar获取产品信息。增加8.2014-03-4.3（支付前），4.6（支付后）EticketNo5.7qunar2014-12-【产品】Qunar、【订单】创建订单（支付前下单）、4.6订4.9【订单】Qunar通知中增加本次通知是否4.1【产品】Qunar获取产品信息中增加购接互设AgentHTTPPOST方式进行数接互自测工具地址

所有接口请求（HTTPPOST）JsonrequestParamjson字符串组成，json数据包括以下属性：data（String）：dataQMRequestDataSchema.xsdXML格securityTypeMD5XMLBase64后的结果字符串。signed（String）：MD5(signkey+data)signkeydata进行字符串拼接后的字MD5加密。HTTPPOSTJsonsigned（String）：MD5(signkey+data)signkeydata进行字符串拼接后的字MD5加密。Qunar和供应商一起约定供应商唯一标识（rIdentity）和signkey。可以依据此标识唯一区分，如果供应商本身是平台有多家需要对接，则只需要在这两个字段上进行区分即可。在传输安全方面，Qunar提供两种安全级别的接口MD5，Qunarsigned值来验证数据过篡改。XSD进行设计。总体的格式均分为Header和Body两部分，HeaderXSDHeader头部信息均保持一致，且此complexType不允许继承。RequestHeader与ResponseHeader有所不同。Request是是是是BodyType实际类型填是是本段报文生成的系统名是供应商通信是qunar提供（系统提供商可以根据此信息区分供应Response是是是是依据BodyType是是Body体，XSDBodyComplexType可以继承，不同的数据消息使用不同的消息针对业务发生异常的Body体，使用基类ComplexType即ResponseBody返回，内容为接口对接必做接【】接口状态与稳定性支付后同步订单必做接口（建议做支付前同步订单 供应商退款申请（供应商退款用户确认）（非必做【订单】供应商向Qunar申请退款（applyOrderRefundBy1YY2YY3Y4Y5Y6Y7YY8YY9YYYYYYYYYYYYapplyOrderRefundByNN供应商提供HTTPXml是ALL：获取全部产method=ALL时必method=ALL时必method=SINGLE时供应商的产品号methodALL:供应商分销的产是253个产品，qunar的分3次。每次count都是253但每页中最多只有100条记是ID（唯qunar交对此类resourceId是否是否否是2-30字（如果包含cddata进行封装）是B2C（否（当和供应商是B2B合作模式时，可是CASHPAY：景区支预订限制：提前否预订限制：提前否如20:00，今日的20:00分之前可以预订，同advanceDay共同生使用限制：预定后几小时才能入否810点不支付自动取消否默认：120分钟是否需要取票人否是否需要取票人否（默认是否需要取票人否（默认是否需要取票人地址&否（默认是否需要游客信否每几个游客共享否默认：1，即每个是否需要游客姓否是否需要游客姓否FALSE（默认是否需要游客证否FALSE（默认当RUE时必须多选一，逗号分ID_CARD,护照:HUZHAO,台胞证:TAIBAO通行证:供应商自定义需要游客填写的信1否供应商自定义需要游客填写的信2否取票人 否默认，。如果大 （最大量 大量）为准取票人号最大量的限制否USE_DATE_MAX制号最多N张。：日限制下单日限制号最多N张。PRODUCT_MAX，产品限制号最多N张。取票人最大量的限制否默认，。 um（量），则以um（最大是USE_DATE游客选ER：游客选定的游玩日期起FTER：游客日起天内有游客选定的游玩x天内有AYSAFTER时必须整数，配合validType生效。游客日起DAYSAFTER时必须整数，配合validType生效否格式使用：08:00-或 Qunar销售产品单Qunar和分销商的 单次最小 单次最小单次最大 （号最大量限制），则以 （号最大或 _START_AND_END _START_AND_END否否yyyy-MM-以逗号分隔如：01,2014- _START_AND_ENDqunar _START_AND_ENDQunar和分销商结 _START_AND_END单次最小 _START_AND_END单次最小单次最大 _START_AND_END （号最大量限制），则以（号最大否否如果feeInclude和feeExclude内容，该字段必须包含以下内含】、【费用不含】500否否否否是必须包含以下内容：【入园凭证】【入园凭证发送时间及方否TRUE：支持退款（默认FALSE是否支持部分退否TRUE：支持退款（默认FALSE有效期开始前几否格式如：2_22:00，表示有效期开始前天22点之前可退款。例效期开始日期是201822Day三种模式只能最晚有效期前几否格式如：2_22:00，表示最晚有效期前天22点之前可退20号晚上22点前可Day三种模式只能有效期结束后几否格式如：2_22:00，表示有效期结束后天22点之前可退款。例效期结束日期是202222Day三种模式只能否必须包含以下内容：【游客申请退款的时间及方式】【是否支供应商在去哪儿开通的400对应的否400对应的否yyyy-MM-ddhhsaleEndTime否00:00saleStartTime，否自定义内容，默认为：您将会在3-5分钟内收到电子票，在景区售票处取是Q_CODEQunarS_CODE：供应票。（需要供应商S_STRING：供应商S_PIC供的入园凭证urlNO_CODE【订单】创建订单（支付前同步订单qunar主动调用此接口将订单信息传到供应商。如果是预付订单，供应商需要回传订Xml供应qunar订单是qunar供应商产品是是否E_AND_N_DAYSAFTER或产品售卖单是Qunar产品售卖单价返现金额（每张票否否B2B:分销contact取票人否contact取票人否contact是contact否contact否contact取票人否游玩人否游玩人游玩人否游玩人拼否游玩人证件否ID_CARD,护照:HUZHAO,台胞证:TAIBAO通行证credentials供应商自定1否供应商自定2否是是订单返现总否是否否Qunar电子否Q_CODE时传递。是否必是是SS（现付否【订单】支付订单（支付前同步订单qunar支付成功后调用此接口通知供应户已支付，供应商回传是否成功接收到信息，针对多次重试未正常返回正确结果的，Qunar将自动给用户退款。如果供应商成功接收到信息，针对不使用QunarXml供应供应商订单是是是银行流否Qunar电子否针对产品设置了使用Qunar电子票的，在支付时，Qunar会生成是否必供应商生成的ID是是否【订单】同步订单（支付前同步订单qunar在修改订单时主动调用此接口将订单信息传到供应商，包括取票人信息，取消Xml供应供应商订单是否取消订单原否否取票人否是否否否否游玩人否游玩人拼否游玩人证件否ID_CARD,护照:HUZHAO,台胞证:TAIBAO通行证credentials供应商自定1否供应商自定2否否是否必供应商生成的ID是否【订单】创建订单校验（支付后同步订单此接口是支付后下单时使用的，与createOrderForAfterPaySync配套，用来在供应商qunar传递的数据，校验门票是否可订，qunar根据校验返回结果判断该供应是qunar供应商产品是是否E_AND_N_DAYSAFTER或产品售卖单是Qunar产品售卖单价返现金额（每张票否contact取票人否contact取票人否contact是contact否contact否contact取票人否游玩人否游玩人游玩人否游玩人拼否游玩人证件否ID_CARD,护照:HUZHAO,台胞证:TAIBAO通行证credentials供应商自定1否供应商自定2否是是订单返现总否否否否是否必否【订单】创建订单（支付后同步订单考虑到用户从下单校验至支付的时间差，qunar再次发送了订单的产品信息，供应商如果供应商成功接收到信息，针对不使用Qunar电子票的供应商，供应商应自动给用code=1000orderStatus=PREPAY_ORDER_PRINT_SUCCESS（预付）接口描述Xml供应是qunar供应商产品是是否ND_N_DAYSAFTERUSE_DATE产品售卖单是Qunar产品售卖单价返现金额（每张票否否否取票人否contact是contact否contact否contact取票人否游玩人否游玩人游玩人否游玩人拼否游玩人证件否ID_CARD,护照:HUZHAO,台胞证:TAIBAO通行证credentials供应商自定1否供应商自定2否是是订单返现总否否 否否银行流否Qunar电子否针对产品设置了使用Qunar电子票的，在支付时，Qunar会生成是否必供应商生成的ID是是否qunar查询订单在供应商的状态信息，用于查看订单同步结果、订单支供应是是否必是是 S是否qunarqunar提电子票发送状是如果没有电子票，则记录实际通知用户后，才能将此设置为true返回。是是【订单】（重）qunar请求重发入园凭证时主Xml供应是重发是是Xml供应是是qunar定义，供应商可以是否是否否否否是否Qunar申请退款时，qunar主动调用此接口向供应商发送退款申请noticeOrderRefundApproveResult配套使用发该接口，必须在qunar的（http://t Xml供应是是qunar定义是是是否否否否Qunar获得订单返现时，qunar主动调用此接口向供应商发送已返现通知，供Xml供应是订单已返现金是否Qunar 【订单】供应商向Qunar申请退款（applyOrderRefundBy如果去哪儿未抓到产品，则会在去哪儿下架对应的产品，也就是说，如果供应商该接口是为了保证产品的及时更新，避免价格、库存等不相同而造成下单失败。根据Xml是否必是否B2C/B2B（为空默认为父元素否【产品】供应商获取产品信息（暂时不支持供应商可以调用此接口来查询产品在qunar如果供应商开发了该接口，可以在自己的系统里查看产品信息，不必在qunar的系统和自己的系统来回切换，能够节省时间；如果供应商不开发该接口，可以在qunar的 Xml供应商产品当NGLE时必IDResponse是否必4.1【产品】Qunar获是是【产品】产品申请上架（暂时不支持统和自己的系统来回切换，能够节省时间；如果供应商不开发该接口，可以在qunar 是否必是父元素否【订单】供应商获取订单信息（暂不支持是是否必是是 Scontact取票人否contact取票人拼否contact是contact否contact否contact取票人否游玩人否游玩人游玩人拼否游玩人拼否游玩人证件类否ID_CARD,护照:HUZHAO,台胞证:TAIBAO通行证credentials供应商自定义1否供应商自定义2否否【订单】供应商发码通知（推荐避免因为供应商通道堵塞造成用户收不到入园凭证。使用该接口可显著减少用户Xml/singleApiDebugData是否qunarqunar提电子票发送状是知用户后，才能将此设置为true否【订单】用户消费通知（推荐用户消费后供应商主动调用此接口通知使用该接口可以将用户的消费状态及时同步给qunarXml/singleApiDebugData是否否否否Qunar供应商主动调用此接口向qunar4.9【订单】Qunar退款通知。Xml是是是是否否是是是否否否供应商审核完用户的退款后，主动调用此接口向qunar通知审核结果ApplyOrderRefundByUser配套使用发该接口，必须在qunar的（http://t 若返回的结果为同意退款，Qunar将不再进行人为审核，系统将按照退款单进行实际Xml/singleApiDebugData是是qunar定义否当VE否是否#12004= 20002=创建订单异常，选购产品数量 号码异 异20008=创建订单异常，价格排期 失20009=创建订单异常，根据价格ID20012=创建订单异常，根据产品ID 20018=创建订单异常，价格排期ID 的票数范 限 劵异20031=创建订单异常，超出产品同 限14002=14003=14007=514008=14011=11 号下发凭# 15005=抱歉，该订单无法进行退款，若有任