U8CRM类

    crmaccount/batch_get


    目录

    1.接口说明

    1.1接口描述

         批量查询CRM客户档案

    1.2适用版本

         支持U8V12.0 及更高版本

    2.使用场景

    CRM

    3.接口调用说明

    3.1请求说明

    url https://api.yonyouup.com/api/crmaccount/batch_get
    格式 JSON
    https请求方式 GET
    编码类型 UTF-8


    3.2url参数说明

    参数 是否必填 类型 描述
    from_account string 调用方id
    to_account string 提供方id
    app_key string 应用编码
    token string 全局访问唯一识别码
    ds_sequence number 数据源序号(默认取应用的第一个数据源)
    page_index string 页号
    rows_per_page string 每页行数
    person_code string 人员编码,需要先调用 api/user_login 进行用户登录,方可传入此参数。人员编码可以通过 api/person 获取
    user_id string 审批人(用户编码),user_id与pserson_code输入一个参数即可
    AccountNumber string 客户编码关键字
    Name string 客户名称关键字
    CCusAbbName string 客户简称关键字

    3.3请求示例

    GET https://api.yonyouup.com/api/crmaccount/batch_get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&ds_sequence=1


    3.4返回参数说明

    参数说明 类型 参数路径 描述
    errcode string   错误码,0 为正常。
    errmsg string   错误信息。
    page_index string   页号
    rows_per_page string   每页行数
    row_count string   总行数
    page_count string   页数
    AccountNumber string entry 客户编号
    AllotDeptTime date entry 分配到部门时间
    AllotUserTime date entry 分配到业务员时间
    ApprovedExpense number entry 批准费用
    BCredit boolean entry 是否控制信用额度
    BCreditDate boolean entry 是否控制信用期限
    BCusDomestic boolean entry 国内
    BCusOverseas boolean entry 国外
    BCusState boolean entry 是否成交
    BHomeBranch boolean entry 有分支机构
    BLimitSale boolean entry 是否控制允限销
    BOnGPinStore boolean entry 门店收款
    BRequestSign boolean entry 需要回签
    BServiceAttribute boolean entry 服务
    BShop boolean entry 零售
    bTransFlag boolean entry 客户标识
    CBranchAddr string entry 分支机构地址
    CBranchPerson string entry 分支机构联系人
    CBranchPhone string entry 分支机构电话
    CCreatePerson string entry 建档人
    CCusAbbName string entry 客户简称
    CCusAddress string entry 地址
    CCusBP string entry 呼机
    CCusCreGrade string entry 信用等级
    CCusEnAddr1 string entry 英文地址1
    CCusEnAddr2 string entry 英文地址2
    CCusEnAddr3 string entry 英文地址3
    CCusEnAddr4 string entry 英文地址4
    CCusEnName string entry 英文名称
    CCusLPerson string entry 法人
    CCusOAddress string entry 发货地址
    CCusPostCode string entry 邮政编码
    CCusRegCode string entry 税号
    CInvoiceCompany string entry 开票单位
    CMemo string entry 备注
    CModifyPerson string entry 变更人
    Contact string entry 联系人
    CostGrade number entry 价格级别
    CreatedTime date entry 建档日期
    DCusDevDate date entry 发展日期
    DEndDate date entry 停用日期
    DepartmentID string entry 部门ID
    dLtcDate date entry 转换时间
    Email string entry 电子邮件
    Expense number entry 发生费用
    FAdvancePaymentRatio number entry 定金比例
    Fax string entry 传真
    FCommisionRate number entry 佣金比率
    FCusDiscountRate number entry 直营专柜结算扣率
    FInsueRate number entry 保险费率
    IARMoney number entry 应收余额
    ICusCreDate number entry 信用期限
    ICusCreLine number entry 信用额度
    ICusDisRate number entry 扣率
    ID string entry 客户ID
    ILastMoney number entry 最近发票金额
    ILRMoney number entry 最近收款金额
    ITaxRate number entry 税率
    Location string entry 经纬度
    Mobile string entry 手机
    ModifiedTime date entry 变更日期
    Name string entry 名称
    OwnerID string entry 专管业务员ID
    pCustCode string entry 潜在客户编码
    Phone string entry 电话
    RcyDeptTime number entry 回收到部门时间
    RcyPubTime number entry 回收到公共时间
    RecentlyActivityTime date entry 最近行动时间
    RecentlyChanceTime date entry 最近机会时间
    RecentlyContractTime date entry 最近订单时间
    RecentlyCRMContractTime date entry 最近合同时间
    RecentlyDeliverTime date entry 最近出库时间
    RecentlyDispatchListTime date entry 最近发货时间
    RecentlyInvoiceTime date entry 最近发票时间
    RecentlyQuoteTime date entry 最近报价时间
    RecentlyReceiptTime date entry 最近收款时间
    SimpleCode string entry 助记码
    SrcID number entry 来源ID
    SrcType number entry 来源类型
    TouchedTime date entry 最近联络时间
    TransUser string entry 转换人
    TypeID number entry 类型ID

    3.5正确返回示例

    JSON示例:

    application/json;charset=UTF-8
    {
    	"crmaccount":[
    		{
    			"AccountNumber":"zyd",
    			"AllotDeptTime":"",
    			"AllotUserTime":"",
    			"ApprovedExpense":"",
    			"BCredit":"",
    			"BCreditDate":"",
    			"BCusDomestic":"1",
    			"BCusOverseas":"",
    			"BCusState":"1",
    			"BHomeBranch":"",
    			"BLimitSale":"",
    			"BOnGPinStore":"",
    			"BRequestSign":"",
    			"BServiceAttribute":"",
    			"BShop":1,
    			"CBranchAddr":"",
    			"CBranchPerson":"",
    			"CBranchPhone":"",
    			"CCCCode":"10",
    			"CCreatePerson":"demo",
    			"CCusAbbName":"zyd",
    			"CCusAddress":"",
    			"CCusBP":"",
    			"CCusCountryCode":"",
    			"CCusCreGrade":"",
    			"CCusCreditCompany":"zyd",
    			"CCusEnAddr1":"",
    			"CCusEnAddr2":"",
    			"CCusEnAddr3":"",
    			"CCusEnAddr4":"",
    			"CCusEnName":"",
    			"CCusExch_name":"人民币",
    			"CCusLPerson":"",
    			"CCusOAddress":"",
    			"CCusOType":"",
    			"CCusPayCond":"",
    			"CCusPortCode":"",
    			"CCusPostCode":"",
    			"CCusRegCode":"",
    			"CCusWhCode":"60",
    			"CCusssCode":"8",
    			"CInvoiceCompany":"zyd",
    			"CMemo":"",
    			"CModifyPerson":"demo",
    			"CPrimaryVen":"",
    			"CRelVendor":"",
    			"Contact":"",
    			"CostGrade":-1,
    			"Country":{
    				"Name":""
    			},
    			"CreatedTime":"2015-06-1711:09:43",
    			"CreditCompany":{
    				"CCusAbbName":"zyd"
    			},
    			"Currency":{
    				"Name":"人民币"
    			},
    			"CusContactCode":"",
    			"CustomerKCode":"",
    			"CustomerType":{
    				"Name":"门店"
    			},
    			"DCusDevDate":"2015-06-17",
    			"DEndDate":"",
    			"Department":{
    				"Name":"销售部"
    			},
    			"DepartmentID":"0302",
    			"District":{
    				"Name":""
    			},
    			"DistrictID":"",
    			"Email":"",
    			"Expense":"",
    			"FAdvancePaymentRatio":"",
    			"FCommisionRate":"",
    			"FCusDiscountRate":"",
    			"FInsueRate":"",
    			"Fax":"",
    			"IARMoney":"",
    			"ICostGrade":{
    				"Name":""
    			},
    			"ICusCreDate":0,
    			"ICusCreLine":"0",
    			"ICusDisRate":"0",
    			"ID":"zyd",
    			"ILRMoney":"",
    			"ILastMoney":"",
    			"ITaxRate":"",
    			"Location":"",
    			"MasterUser":"",
    			"Mobile":"",
    			"ModifiedTime":"2015-01-1909:51:50",
    			"Name":"zyd",
    			"Owner":{
    				"Name":""
    			},
    			"OwnerID":"",
    			"ParentAccount":{
    				"CCusAbbName":"zyd"
    			},
    			"ParentAccountID":"zyd",
    			"PayCondition":{
    				"Name":""
    			},
    			"Phone":"",
    			"Port":{
    				"Name":""
    			},
    			"Rank":{
    				"Name":""
    			},
    			"RcyDeptTime":"",
    			"RcyPubTime":"",
    			"RecentlyActivityTime":"",
    			"RecentlyCRMContractTime":"",
    			"RecentlyChanceTime":"",
    			"RecentlyContractTime":"2015-01-2500:00:00",
    			"RecentlyDeliverTime":"",
    			"RecentlyDispatchListTime":"",
    			"RecentlyInvoiceTime":"",
    			"RecentlyQuoteTime":"",
    			"RecentlyReceiptTime":"",
    			"RelatedPrivilege":"",
    			"RelatingUser":"",
    			"SettleStyle":{
    				"Name":"银行转账"
    			},
    			"Shipper":{
    				"Name":""
    			},
    			"ShippingChoice":{
    				"Name":""
    			},
    			"SimpleCode":"",
    			"SrcID":"",
    			"SrcObject":{
    				"Name":""
    			},
    			"TouchedTime":"2015-01-2500:00:00",
    			"Trade":{
    				"Name":""
    			},
    			"TradeID":"",
    			"TransUser":"",
    			"Type":{
    				"Name":"普通客户"
    			},
    			"TypeID":26,
    			"Vendor":{
    				"Name":""
    			},
    			"Warehouse":{
    				"Name":"直营门店"
    			},
    			"bTransFlag":2,
    			"dLtcDate":"",
    			"pCustCode":""
    		},
    		{
    			"AccountNumber":"p00000084",
    			"AllotDeptTime":"2015-01-2508:02:31",
    			"AllotUserTime":"2015-01-2508:02:31",
    			"ApprovedExpense":"",
    			"BCredit":"",
    			"BCreditDate":"",
    			"BCusDomestic":"1",
    			"BCusOverseas":"",
    			"BCusState":"",
    			"BHomeBranch":"",
    			"BLimitSale":"",
    			"BOnGPinStore":"",
    			"BRequestSign":"",
    			"BServiceAttribute":"",
    			"BShop":0,
    			"CBranchAddr":"",
    			"CBranchPerson":"",
    			"CBranchPhone":"",
    			"CCCCode":"03",
    			"CCreatePerson":"demo9",
    			"CCusAbbName":"南京美年达",
    			"CCusAddress":"",
    			"CCusBP":"",
    			"CCusCountryCode":"",
    			"CCusCreGrade":"",
    			"CCusCreditCompany":"p00000083",
    			"CCusEnAddr1":"",
    			"CCusEnAddr2":"",
    			"CCusEnAddr3":"",
    			"CCusEnAddr4":"",
    			"CCusEnName":"",
    			"CCusExch_name":"人民币",
    			"CCusLPerson":"",
    			"CCusOAddress":"",
    			"CCusOType":"",
    			"CCusPayCond":"",
    			"CCusPortCode":"",
    			"CCusPostCode":"",
    			"CCusRegCode":"",
    			"CCusWhCode":"",
    			"CCusssCode":"",
    			"CInvoiceCompany":"p00000084",
    			"CMemo":"",
    			"CModifyPerson":"demo9",
    			"CPrimaryVen":"",
    			"CRelVendor":"",
    			"Contact":"",
    			"CostGrade":0,
    			"Country":{
    				"Name":""
    			},
    			"CreatedTime":"2015-01-2508:02:31",
    			"CreditCompany":{
    				"CCusAbbName":"北京山水文化"
    			},
    			"Currency":{
    				"Name":"人民币"
    			},
    			"CusContactCode":"",
    			"CustomerKCode":"",
    			"CustomerType":{
    				"Name":"直销客户"
    			},
    			"DCusDevDate":"2015-01-06",
    			"DEndDate":"",
    			"Department":{
    				"Name":"销售部"
    			},
    			"DepartmentID":"0302",
    			"District":{
    				"Name":""
    			},
    			"DistrictID":"",
    			"Email":"",
    			"Expense":"",
    			"FAdvancePaymentRatio":"",
    			"FCommisionRate":"",
    			"FCusDiscountRate":"",
    			"FInsueRate":"",
    			"Fax":"",
    			"IARMoney":"0",
    			"ICostGrade":{
    				"Name":""
    			},
    			"ICusCreDate":0,
    			"ICusCreLine":"0",
    			"ICusDisRate":"0",
    			"ID":"p00000084",
    			"ILRMoney":"0",
    			"ILastMoney":"0",
    			"ITaxRate":"",
    			"Location":"",
    			"MasterUser":"",
    			"Mobile":"",
    			"ModifiedTime":"2015-01-2508:02:31",
    			"Name":"南京美年达技术有限公司",
    			"Owner":{
    				"Name":"师小容"
    			},
    			"OwnerID":"00023",
    			"ParentAccount":{
    				"CCusAbbName":"北京山水文化"
    			},
    			"ParentAccountID":"p00000083",
    			"PayCondition":{
    				"Name":""
    			},
    			"Phone":"",
    			"Port":{
    				"Name":""
    			},
    			"Rank":{
    				"Name":""
    			},
    			"RcyDeptTime":"",
    			"RcyPubTime":"",
    			"RecentlyActivityTime":"",
    			"RecentlyCRMContractTime":"",
    			"RecentlyChanceTime":"",
    			"RecentlyContractTime":"",
    			"RecentlyDeliverTime":"",
    			"RecentlyDispatchListTime":"",
    			"RecentlyInvoiceTime":"",
    			"RecentlyQuoteTime":"",
    			"RecentlyReceiptTime":"",
    			"RelatedPrivilege":"",
    			"RelatingUser":"",
    			"SettleStyle":{
    				"Name":""
    			},
    			"Shipper":{
    				"Name":""
    			},
    			"ShippingChoice":{
    				"Name":""
    			},
    			"SimpleCode":"",
    			"SrcID":"",
    			"SrcObject":{
    				"Name":""
    			},
    			"TouchedTime":"",
    			"Trade":{
    				"Name":""
    			},
    			"TradeID":"",
    			"TransUser":"",
    			"Type":{
    				"Name":"普通客户"
    			},
    			"TypeID":26,
    			"Vendor":{
    				"Name":""
    			},
    			"Warehouse":{
    				"Name":""
    			},
    			"bTransFlag":1,
    			"dLtcDate":"",
    			"pCustCode":"p00000084"
    		}
    	],
    	"errcode":"0",
    	"errmsg":"",
    	"page_count":7,
    	"page_index":"1",
    	"row_count":123,
    	"rows_per_page":20
    }
    

    3.6错误返回示例

    application/json;charset=UTF-8
    {
    	"errcode" : "30021",
    	"errmsg" : "此应用未上线"
    } 

    4.API测试

    API测试 SDK下载