API接口目录

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API(新)
财务API
店铺API
物流API
促销API
分销API
发票API
招商API
换货API
互动营销API
退货退款API
客服API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.yskreceive.add 云商卡记账
¥免费

云商卡数据接入记账

公共参数
请求参数
名称 类型 是否必须 示例值 描述
orderbodybeanStringN
billTypeStringY-1订单方向
orderIdStringY28223852028901订单号
sposOrderIdStringNDA5563303SPOS单号
orderChannelStringNPC下单渠道
tmOrderIdStringNTM5563303天猫单号
orderTypeStringYA订单类型
sapOrderIdStringN210100025801582559SAP订单号
orderSourceStringYLCPOS订单来源
salePlatformStringNSAP销售平台
effectiveTimeStringY20190608150000订单生效时间
omsCreatedTimeStringN20190608150000创建时间
appointTransTimeStringN20190608150000指定业务发生时间
detailCountStringY10明细数量
cartNoStringNC3487654D购物车号
btocOrderIdStringN345677755B2C订单号
orderbodyinfobeanStringN
orderItemIdStringY28223852533603行单号
sposOrderItemIdStringNDA5563303spos行号
scsOrderItemIdStringNDA5563303购物车行号(OMS没有提供)
posOrderIdStringN210100025801582559POS订单号
orderTimeStringY20190608150000订单提交时间
sapOrderTypeStringYYCXSSAP订单类型
orderItemTypeStringY10行项目类型
orderItemStepIdStringN210100025801582559阶段号
distChannelStringN50分销渠道
saleOrgStringY5006销售组织
storeCodeStringYDA5563303门店代码
oriSaleOrgStringN5005原销售组织(易购)
shopCodeStringNDA5563303店铺编码
attiShopCodeStringNDA5563303归集门店编码
businessUnitStringNAP经营单元
casherIdStringYY00505000收银员
salesPersonStringY000000000营业员
realSalesPersonStringNY00505000真实营业员编码
attiOrgStringN3457归集公司
shippingConditionStringN000000000装运条件
invoicePrintAddressStringND5678发票打印地点
transpInventoryFlagStringNY在途标识
partNumberStringY01002405商品编码
productNameStringY洗衣机商品名称
sapProductCodeStringY0000000004商品类目(SAP商品组)
productLevelStringY000029999产品层次(品牌)
unitPriceStringY10.80销售价
saleAmountStringY20数量
serviceFeeStringN10.00服务费
itemTaxFareStringN16.20行税费
transportFeeStringN16运费
currencyTypeStringYCNY币种编码
saleUnitStringNS01销售单位(计量单位)
totalAmountStringY17.55行项目销售额
couponTotalMoneyStringN10.00优惠券总额
voucherTotalMoneyStringN15.00优惠单总金额
managerCardMoneyStringN13经理卡金额
managerCardNoStringNweew335667232经理卡号
pointAmountStringN10使用积分数
pointMoneyStringN10.000使用积分金额
provideAddressStringND025供应地点
supProvideAddressStringNZE11供货商供货地点
abBankFlagStringNAAB库标识
serialNumberStringNC序列号
stockTypeStringNX库存类型
stockAreaStringND345库区
supplierCodeStringN10001356供应商编码
mnSupplierCodeStringN210100025801582559供应商编码(返利用)
balancePayTimeStringN20021230115554尾款支付时间
merchantCodeStringNDA55店铺编码
realSupplierCodeStringN33557890454433真实供应商编码
purchaseFlagStringY1先销后采
cscPriceStringN18.65云车销售价
virtualBalanceStartTimeStringN20210309125732虚拟销售日期
deliveryAreaStringN330172配送区域
distributeTypeStringNA运输方式
payOrgStringN2365付款组织
payStoreStringN2323付款门店(OMS没有提供)
casherTerminalIdStringN23578收银台号码
deliveryTypeStringN01配送方式
payAmountStringY15.00行项目应付金额
newPayAmountStringY15.00应付金额(财务)
realPayAmountStringN10.80实际支付金额
debtIdStringY1欠款标识
integratedLogStringN1集成标识
supplierShopTypeStringN16一件代发S端供应店类型
wbStoreCodeStringN323435464575685ddfg外部门店编码
wbLeOrgStringN210100025801582559sjdh外部公司代码
zxxslStringY0.16销项税率
tmOrderitemIdStringN1766557天猫行号
btocOrderItemIdStringNDA5563303B2C行项目号
invoicePrintAddressPsStringNA配送策略
cprototypeIdStringNCS2345C类样机真实商品
cprototypeEanStringNC3487654DC类样机真实商品EAN码
operatorIdStringNY10001001操作人员工号(这个字段要干掉)
subscriptionStringN12订金金额
loweroedersquarebeanStringN
clientIdStringY123clientId
memTypeStringNAP会员类型
parentMemberNoStringNM28655900009母账号会员编码
memOutCardNoStringN2876556788976客户外卡号
memInCardNoStringNDA5563303客户内外号
returnsorderbeanStringN
preOrderItemIdStringN210100025801582559原单号
operatMumStringN32445制单人(逆向)
prePosIdStringNDA5563303原正向POS单号
createdTimeStringN20210619120358原单创建时间
changeOrderNewItemIdStringN3235346475675换货送新订单行号
changeOrderOldItemIdStringN1232154364563467换货拖旧订单行号
specialReturnFlagStringNX特殊退货标识
chgTypeStringN4换货类型
retTypeStringN2退货类型
reasonStringN下错单退换货原因
orderlineusecouponsandpaymentbeanStringN
couponruleIDStringN1111券号
payTypeStringNCArd还欠款方式
serialNoStringY01行项目号
parentPayCodeStringY69支付方式上级编码
payCodeStringY6904支付方式编码
payNameStringY云商卡支付方式名称
oldAccountTypeStringN1老账户类型(OMS没有提供)
bankTypeCodeStringY01银行种类编码
bankTypeNameStringY定金卡银行种类名称
cardNoStringY127182374681265781239581券号(OMS没有提供)
activityIdStringN12134活动编码
energizeTypeStringN1赋能标记
payTimeStringY2020-01-16 15:00:00支付时间
newBankTypeCodeStringN21新银行种类编码
flowIdStringN123456支付流水号(OMS没有提供)
billNoStringN1234567786支付单号(OMS没有提供)
alipaypaynoStringN232435345支付交易流水号(OMS没有提供)
depositFlagStringN01定金尾款标识
repaymentCodeStringN55555555还款客户编码
sellerCodeStringY4356售卡公司
payCompanyStringN3456收款公司
payOfficeStringN5577收款门店
payAmountZfStringY16.00支付方式分摊金额
storeCodeSkStringYDA5563303售卡门店
bolnumStringN124125352342合并流水号
policyflagStringN12退款方向
helpPaySignStringNAP代付标识
响应参数
名称 类型 示例值 描述
flagStringS返回成功标识
messageString接收数据成功信息描述
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <addYskreceive>
      <orderbodyinfobean>
        <currencyType>CNY</currencyType>
        <sposOrderItemId>DA5563303</sposOrderItemId>
        <distChannel>50</distChannel>
        <tmOrderitemId>1766557</tmOrderitemId>
        <abBankFlag>A</abBankFlag>
        <businessUnit>AP</businessUnit>
        <mnSupplierCode>210100025801582559</mnSupplierCode>
        <purchaseFlag>1</purchaseFlag>
        <managerCardNo>weew335667232</managerCardNo>
        <attiShopCode>DA5563303</attiShopCode>
        <saleUnit>S01</saleUnit>
        <productName>洗衣机</productName>
        <saleOrg>5006</saleOrg>
        <distributeType>A</distributeType>
        <managerCardMoney>13</managerCardMoney>
        <orderTime>20190608150000</orderTime>
        <payAmount>15.00</payAmount>
        <supProvideAddress>ZE11</supProvideAddress>
        <invoicePrintAddress>D5678</invoicePrintAddress>
        <integratedLog>1</integratedLog>
        <realPayAmount>10.80</realPayAmount>
        <cscPrice>18.65</cscPrice>
        <payStore>2323</payStore>
        <operatorId>Y10001001</operatorId>
        <supplierShopType>16</supplierShopType>
        <attiOrg>3457</attiOrg>
        <saleAmount>20</saleAmount>
        <serviceFee>10.00</serviceFee>
        <unitPrice>10.80</unitPrice>
        <merchantCode>DA55</merchantCode>
        <pointAmount>10</pointAmount>
        <serialNumber>C</serialNumber>
        <itemTaxFare>16.20</itemTaxFare>
        <realSupplierCode>33557890454433</realSupplierCode>
        <casherId>Y00505000</casherId>
        <invoicePrintAddressPs>A</invoicePrintAddressPs>
        <voucherTotalMoney>15.00</voucherTotalMoney>
        <oriSaleOrg>5005</oriSaleOrg>
        <posOrderId>210100025801582559</posOrderId>
        <payOrg>2365</payOrg>
        <totalAmount>17.55</totalAmount>
        <realSalesPerson>Y00505000</realSalesPerson>
        <productLevel>000029999</productLevel>
        <newPayAmount>15.00</newPayAmount>
        <shippingCondition>000000000</shippingCondition>
        <deliveryArea>330172</deliveryArea>
        <zxxsl>0.16</zxxsl>
        <wbLeOrg>210100025801582559sjdh</wbLeOrg>
        <storeCode>DA5563303</storeCode>
        <provideAddress>D025</provideAddress>
        <sapProductCode>0000000004</sapProductCode>
        <transportFee>16</transportFee>
        <scsOrderItemId>DA5563303</scsOrderItemId>
        <virtualBalanceStartTime>20210309125732</virtualBalanceStartTime>
        <subscription>12</subscription>
        <supplierCode>10001356</supplierCode>
        <stockArea>D345</stockArea>
        <balancePayTime>20021230115554</balancePayTime>
        <casherTerminalId>23578</casherTerminalId>
        <wbStoreCode>323435464575685ddfg</wbStoreCode>
        <cprototypeId>CS2345</cprototypeId>
        <sapOrderType>YCXS</sapOrderType>
        <shopCode>DA5563303</shopCode>
        <orderItemStepId>210100025801582559</orderItemStepId>
        <orderItemType>10</orderItemType>
        <stockType>X</stockType>
        <orderItemId>28223852533603</orderItemId>
        <deliveryType>01</deliveryType>
        <pointMoney>10.000</pointMoney>
        <debtId>1</debtId>
        <cprototypeEan>C3487654D</cprototypeEan>
        <couponTotalMoney>10.00</couponTotalMoney>
        <btocOrderItemId>DA5563303</btocOrderItemId>
        <partNumber>01002405</partNumber>
        <salesPerson>000000000</salesPerson>
        <transpInventoryFlag>Y</transpInventoryFlag>
      </orderbodyinfobean>
      <orderlineusecouponsandpaymentbean>
        <oldAccountType>1</oldAccountType>
        <payTime>2020-01-16 15:00:00</payTime>
        <energizeType>1</energizeType>
        <helpPaySign>AP</helpPaySign>
        <storeCodeSk>DA5563303</storeCodeSk>
        <cardNo>127182374681265781239581</cardNo>
        <parentPayCode>69</parentPayCode>
        <payAmountZf>16.00</payAmountZf>
        <activityId>12134</activityId>
        <sellerCode>4356</sellerCode>
        <payType>CArd</payType>
        <repaymentCode>55555555</repaymentCode>
        <alipaypayno>232435345</alipaypayno>
        <bankTypeName>定金卡</bankTypeName>
        <billNo>1234567786</billNo>
        <flowId>123456</flowId>
        <payName>云商卡</payName>
        <policyflag>12</policyflag>
        <couponruleID>1111</couponruleID>
        <payCompany>3456</payCompany>
        <depositFlag>01</depositFlag>
        <bolnum>124125352342</bolnum>
        <serialNo>01</serialNo>
        <newBankTypeCode>21</newBankTypeCode>
        <payOffice>5577</payOffice>
        <bankTypeCode>01</bankTypeCode>
        <payCode>6904</payCode>
      </orderlineusecouponsandpaymentbean>
      <orderbodybean>
        <orderType>A</orderType>
        <orderSource>LCPOS</orderSource>
        <orderId>28223852028901</orderId>
        <effectiveTime>20190608150000</effectiveTime>
        <billType>-1</billType>
        <orderChannel>PC</orderChannel>
        <salePlatform>SAP</salePlatform>
        <sapOrderId>210100025801582559</sapOrderId>
        <omsCreatedTime>20190608150000</omsCreatedTime>
        <tmOrderId>TM5563303</tmOrderId>
        <appointTransTime>20190608150000</appointTransTime>
        <btocOrderId>345677755</btocOrderId>
        <cartNo>C3487654D</cartNo>
        <sposOrderId>DA5563303</sposOrderId>
        <detailCount>10</detailCount>
      </orderbodybean>
      <loweroedersquarebean>
        <clientId>123</clientId>
        <memOutCardNo>2876556788976</memOutCardNo>
        <memType>AP</memType>
        <memInCardNo>DA5563303</memInCardNo>
        <parentMemberNo>M28655900009</parentMemberNo>
      </loweroedersquarebean>
      <returnsorderbean>
        <reason>下错单</reason>
        <retType>2</retType>
        <preOrderItemId>210100025801582559</preOrderItemId>
        <prePosId>DA5563303</prePosId>
        <changeOrderOldItemId>1232154364563467</changeOrderOldItemId>
        <chgType>4</chgType>
        <specialReturnFlag>X</specialReturnFlag>
        <createdTime>20210619120358</createdTime>
        <changeOrderNewItemId>3235346475675</changeOrderNewItemId>
        <operatMum>32445</operatMum>
      </returnsorderbean>
    </addYskreceive>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "addYskreceive": {
        "orderbodyinfobean": {
          "currencyType": "CNY",
          "sposOrderItemId": "DA5563303",
          "distChannel": "50",
          "tmOrderitemId": "1766557",
          "abBankFlag": "A",
          "businessUnit": "AP",
          "mnSupplierCode": "210100025801582559",
          "purchaseFlag": "1",
          "managerCardNo": "weew335667232",
          "attiShopCode": "DA5563303",
          "saleUnit": "S01",
          "productName": "洗衣机",
          "saleOrg": "5006",
          "distributeType": "A",
          "managerCardMoney": "13",
          "orderTime": "20190608150000",
          "payAmount": "15.00",
          "supProvideAddress": "ZE11",
          "invoicePrintAddress": "D5678",
          "integratedLog": "1",
          "realPayAmount": "10.80",
          "cscPrice": "18.65",
          "payStore": "2323",
          "operatorId": "Y10001001",
          "supplierShopType": "16",
          "attiOrg": "3457",
          "saleAmount": "20",
          "serviceFee": "10.00",
          "unitPrice": "10.80",
          "merchantCode": "DA55",
          "pointAmount": "10",
          "serialNumber": "C",
          "itemTaxFare": "16.20",
          "realSupplierCode": "33557890454433",
          "casherId": "Y00505000",
          "invoicePrintAddressPs": "A",
          "voucherTotalMoney": "15.00",
          "oriSaleOrg": "5005",
          "posOrderId": "210100025801582559",
          "payOrg": "2365",
          "totalAmount": "17.55",
          "realSalesPerson": "Y00505000",
          "productLevel": "000029999",
          "newPayAmount": "15.00",
          "shippingCondition": "000000000",
          "deliveryArea": "330172",
          "zxxsl": "0.16",
          "wbLeOrg": "210100025801582559sjdh",
          "storeCode": "DA5563303",
          "provideAddress": "D025",
          "sapProductCode": "0000000004",
          "transportFee": "16",
          "scsOrderItemId": "DA5563303",
          "virtualBalanceStartTime": "20210309125732",
          "subscription": "12",
          "supplierCode": "10001356",
          "stockArea": "D345",
          "balancePayTime": "20021230115554",
          "casherTerminalId": "23578",
          "wbStoreCode": "323435464575685ddfg",
          "cprototypeId": "CS2345",
          "sapOrderType": "YCXS",
          "shopCode": "DA5563303",
          "orderItemStepId": "210100025801582559",
          "orderItemType": "10",
          "stockType": "X",
          "orderItemId": "28223852533603",
          "deliveryType": "01",
          "pointMoney": "10.000",
          "debtId": "1",
          "cprototypeEan": "C3487654D",
          "couponTotalMoney": "10.00",
          "btocOrderItemId": "DA5563303",
          "partNumber": "01002405",
          "salesPerson": "000000000",
          "transpInventoryFlag": "Y"
        },
        "orderlineusecouponsandpaymentbean": [
          {
            "oldAccountType": "1",
            "payTime": "2020-01-16 15:00:00",
            "energizeType": "1",
            "helpPaySign": "AP",
            "storeCodeSk": "DA5563303",
            "cardNo": "127182374681265781239581",
            "parentPayCode": "69",
            "payAmountZf": "16.00",
            "activityId": "12134",
            "sellerCode": "4356",
            "payType": "CArd",
            "repaymentCode": "55555555",
            "alipaypayno": "232435345",
            "bankTypeName": "定金卡",
            "billNo": "1234567786",
            "flowId": "123456",
            "payName": "云商卡",
            "policyflag": "12",
            "couponruleID": "1111",
            "payCompany": "3456",
            "depositFlag": "01",
            "bolnum": "124125352342",
            "serialNo": "01",
            "newBankTypeCode": "21",
            "payOffice": "5577",
            "bankTypeCode": "01",
            "payCode": "6904"
          }
        ],
        "orderbodybean": {
          "orderType": "A",
          "orderSource": "LCPOS",
          "orderId": "28223852028901",
          "effectiveTime": "20190608150000",
          "billType": "-1",
          "orderChannel": "PC",
          "salePlatform": "SAP",
          "sapOrderId": "210100025801582559",
          "omsCreatedTime": "20190608150000",
          "tmOrderId": "TM5563303",
          "appointTransTime": "20190608150000",
          "btocOrderId": "345677755",
          "cartNo": "C3487654D",
          "sposOrderId": "DA5563303",
          "detailCount": "10"
        },
        "loweroedersquarebean": {
          "clientId": "123",
          "memOutCardNo": "2876556788976",
          "memType": "AP",
          "memInCardNo": "DA5563303",
          "parentMemberNo": "M28655900009"
        },
        "returnsorderbean": {
          "reason": "下错单",
          "retType": "2",
          "preOrderItemId": "210100025801582559",
          "prePosId": "DA5563303",
          "changeOrderOldItemId": "1232154364563467",
          "chgType": "4",
          "specialReturnFlag": "X",
          "createdTime": "20210619120358",
          "changeOrderNewItemId": "3235346475675",
          "operatMum": "32445"
        }
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <addYskreceive>
      <flag>S</flag>
      <message>接收数据成功</message>
    </addYskreceive>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "addYskreceive": {
        "flag": "S",
        "message": "接收数据成功"
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.custom.addyskreceive.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.custom.addyskreceive.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.custom.addyskreceive.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.budsin 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ

Q:参数配置

A:参数配置