界面名称tt.oapi.customer.list.data.query.get界面说明查询客户资料程序代号soap_oapi00139输入参数说明参数代号型态是否必填参数说明范例值requestkeystring是检核编码(MD5)109c3c41a1441e702b909ed3de58e4b1typestring是Request类型(sync,async)固定传入synchostprodstring是发起方产品名称OAPIverstring是发起方产品版本1.0ipstring是发起方IP位置10.40.71.91idstring否发起方产品识别码，提供同一产品多台主机辨别之用acctstring是登入账号固定传入tiptoptimestampstring是时间戳记格式：yyyyMMddHHmmssSSS20151211123204361timezonestring否发起方时区(-12~+14)+8langstring是语言别(zh_TW,zh_CN,en,vi)Zh_TWserviceprodstring是接收方产品名称ttnamestring是服务名称tt.oapi.customer.list.data.query.getsrvverstring否接收方产品版本1.0ipstring否接收方IP位置10.20.86.223idstring否接收方产品识别码，提供同一产品多台主机辨别之用topprddatakeyEntIdstring否企业编号CompanyIdstring否营运据点DS1enterprise_nostring否企业编号99customer_nostring是客户编号000002sequencenumeric否栏位名称1field_namestring是栏位名称inaa001参数代号型态是否必填参数说明范例值ERP栏位enterprise_nostring是企业编号若无传值则预设值g_enterprisesite_nostring是营运中心is_digiwin_productstring是是否为鼎捷产品(Y,N)Ydata_timedate否异动时间key_conditionstring否前次最后一笔资料的Key条件use_has_nextboolean是是否启用分页机制page_sizenumeric是每页条数/分包的请求笔数page_nonumeric否页码customer_nostring否客户编号00000002occ01customer_full_namestring否客户全名金暾（无锡）精密模具occ18customer_shortnamestring否客户简称金暾（无锡）精密模具有限公司occ02trans_object_typestring否交易对象类型1.供应商,2.客户,3.二者皆是ccc06legal_typestring否法人类型belong_legalstring否所属法人belong_group_nostring否所属集团A002occ34date_snumeric是开始日期date_estring是结束日期conditions—否条件集合(单头节点，支持多数组)sequencenumeric否条件顺序bracketstring否括号类型(、((、)、))field_namestring否栏位名称valuestring否栏位值operatorstring否操作符logicalstring否搜寻组间的关系orders—否排序设置(单头节点，支持多数组)field_namestring是栏位名称order_typestring是搜寻组间的关系Request范例Content-Type:application/json;charset=utf-8digi-protocol:rawdigi-type:syncdigi-key:c53a89adbc6ee58a758868d75dc60094digi-host:{"prod":"OAPI","ip":"10.20.88.30","lang":"zh_TW","timestamp":"20161018132542116","acct":"tiptop"}digi-service:{"prod":"tt","name":"tt.oapi.customer.list.data.query.get","ip":"10.20.88.75","id":"topprod"}digi-datakey:{"EntId":"企业编号","CompanyId":"营运据点","enterprise_no":"企业编号","customer_no":"客户编号"}{"std_data":{"parameter":{"enterprise_no":"企业编号","site_no":"营运据点","is_digiwin_product":"是否为鼎捷产品","data_time":"异动时间","key_condition":"前次最后一笔资料的Key条件","use_has_next":"是否启用分页机制","page_size":"每页条数/分包的请求笔数","page_no":"页码","customer_no":"客户编号","customer_full_name":"客户全名","customer_shortname":"客户简称","trans_object_type":"交易对象类型","legal_type":"法人类型","belong_legal":"所属法人","belong_group":"所属集团","date_s":"开始日期","date_e":"结束日期","conditions":[{"sequence":"栏位名称","bracket":"括号类型","field_name":"栏位名称","value":"栏位值","operator":"操作符","logical":"搜寻组间的关系"}],"orders":[{"field_name":"栏位名称","order_type":"排序类型"}]}}}成功返回参数说明参数代号型态是否必填参数说明范例值ERP栏位srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程，幷产生预期的结果(Basicflow)100:服务未按照正常流程执行，例如发生信息检核不通过等情况，导致无法完成预期的结果000datakeystock_out_nostring否ERP编号B17-202303080050ooeg001参数代号型态是否必填参数说明范例值ERP栏位statuscodestring是错误码00：正确<>0：FAIL（原因代码）sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述data_timedate是异动时间key_conditionstring是前次最后一笔资料的Key条件total_resultsnumeric否总数has_nextboolean否是否有下一页customer_detail—是客户明细(单头节点，支持多数组)customer_noString否客户编号00000002occ01customer_full_nameString否客户全名金暾（无锡）精密模具有限公司occ18customer_shortnameString否客户简称金暾（无锡）精密模具occ02trans_object_typeString否交易对象类型3ccc06legal_typeString否法人类型belong_legalString否所属法人belong_legal_nameString否所属法人名称belong_group_noString否所属集团A002occ34belong_group_nameString否所属集团名称鼎捷集团occ1004uniform_numbernumeric否统一编号0001occ11country_nostring否国家别CNocc21industry_idstring否产业别0101industry_id_namestring否产业别说明农业monthly_settlement_daynumeric否月结日6occ38payment_daynumeric否付款日12occ39receivable_daynumeric否收款日13main_sales_nostring否负责业务人员19097occ04main_sales_namestring否负责业务人员名称张宇gen02responsibility_department_nostring否负责业务部门DC0300responsibility_department_namestring否负责业务部门名称南京开发部currency_nostring否交易币别TWDocc42currency_namestring否交易币别说明台币azi02tax_nostring否交易税别001occ41tax_namestring否交易税别说明增值税含税17%gec02receive_conditionstring否收款条件212occ45payment_condition_namestring否付款条件说明款到发货oag02trade_condition_nostring否交易条件EXWtrade_condition_namestring否交易条件说明卖方工厂交货account_typestring否帐款类别A1类产品销售收入-国内account_type_namestring否帐款类别说明00272modify_nostring否资料修改者2023-05-0408:35:53occmodumodify_datedate否资料修改日011的说明occdatestatusstring否状态码Yoccactitrading_partner_relation_detail—是交易对象关系(单身节点，支持多数组)trade_typestring否交易类型trade_type_namestring否交易类型说明is_mainboolean否主要否trading_partner_nostring否交易对象编号trading_partner_namestring否交易对象名称contact_address_detail—是联络地址明细/联系地址明细(单身节点，支持多数组)simple_nostring否简要编号address_typestring否地址类型is_main_contact_addressstring否主要联络地址country_codestring否国家/地区addressstring否地址南京市江宁区双龙大道1698号景枫大厦写字间17Focc231/occ241expiration_datestring否失效日期communication_detail—是通讯方式(单身节点，支持多数组)communication_typestring否通讯类型1communication_contentstring否通讯内容0987654321occ261/occ262/occ263is_main_communication_wayboolean否主要通讯方式Nexpiration_datedatetime否失效日期20230608bank_detail—是银行信息(单身节点，支持多数组)bank_codestring否银行编号0040200ocj02bank_accountstring否银行账户6222201991334843449292CSocj03is_receive_bank_accountboolean否主要收款账户is_payment_bank_accountboolean否主要付款账户allow_payment_condition—是允许付款条件(单身节点，支持多数组)trade_condition_nostring否交易条件编号trade_condition_namestring否交易条件说明is_mainboolean否主要否Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:2e85034a-9774-4811-9f72-020f066e60a8digi-protocol:rawdigi-srvver:1.0digi-srvcode:000digi-datakey:{"customer_no":"客户编号"}{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"data_time":"异动时间","key_condition":"前次最后一笔资料的Key条件","total_results":"总数","has_next":"是否有下一页","customer_detail":[{"customer_no":"客户编号","customer_full_name":"客户全名","customer_shortname":"客户简称","trans_object_type":"交易对象类型","legal_type":"法人类型","belong_legal":"所属法人","belong_legal_name":"所属法人名称","belong_group":"所属集团","belong_group_name":"所属集团名称","uniform_number":"统一编号","country_no":"国家别","industry_id":"产业别","industry_id_name":"产业别说明","monthly_settlement_day":"月结日","payment_day":"付款日","receivable_day":"收款日","main_sales_no":"负责业务人员","main_sales_name":"负责业务人员名称","responsibility_department_no":"负责业务部门","responsibility_department_name":"负责业务部门名称","currency_no":"交易币别","currency_name":"交易币别说明","tax_no":"交易税别","tax_name":"交易税别说明","receive_condition":"收款条件","payment_condition_name":"付款条件说明","trade_condition_no":"交易条件","trade_condition_name":"交易条件说明","account_type":"帐款类别","account_type_name":"帐款类别说明","modify_no":"资料修改者","modify_date":"资料修改日","status":"状态码","trading_partner_relation_detail":[{"trade_type":"交易类型","trade_type_name":"交易类型说明","is_main":"主要否","trading_partner_no":"交易对象编号","trading_partner_name":"交易对象名称"}],"contact_address_detail":[{"simple_no":"简要编号","address_type":"地址类型","is_main_contact_address":"主要联络地址","country_code":"国家/地区","address":"地址","expiration_date":"失效日期"}],"communication_detail":[{"communication_type":"通讯类型","communication_content":"通讯内容","is_main_communication_way":"主要通讯方式","expiration_date":"失效日期"}],"bank_detail":[{"bank_code":"银行编号","bank_account":"银行账户","is_receive_bank_account":"主要收款账户","is_payment_bank_account":"主要付款账户"}],"allow_payment_condition":[{"trade_condition_no":"交易条件编号","trade_condition_name":"交易条件说明","is_main":"主要否"}]}]}}}失败返回参数说明参数代号型态是否必填参数说明范例值ERP栏位srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程，幷产生预期的结果(Basicflow)100:服务未按照正常流程执行，例如发生信息检核不通过等情况，导致无法完成预期的结果000参数代号型态是否必填参数说明范例值ERP栏位statuscodestring是错误码0：正确<>0：FAIL（原因代码）aws-00102sql_codestring否失败时数据库回传代码descriptionstring是错误问题描述[tt_message]处理笔数1,成功0,失败1Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:2e85034a-9774-4811-9f72-020f066e60a8digi-protocol:rawdigi-srvver:1.0digi-srvcode:100{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"}}}
