码上放心-码上传接口开通指南

平台技术对接支持阿里钉钉群：群号：67685003096

一、什么是码上传服务？

向有开发需求的经营（批发/物流）企业提供码上传接口开发包，企业通过码上接口实现码上放心平台与企业ERP、WMS等信息系统数据对接，实现追溯入出库的自动录入及上传，通过追溯码助力业务管理系统的效率提升；

企业需要有程序开发能力（最好有java语言开发能力），将之前手工做的部分工作由程序完成。主要操作过程是将过去通过客户端上传单据改为由程序读单据文件，并由程序设置往来单位，然后调用我们接口进行上传。

二、开通流程及使用说明

请注意：

（1）请与贵司负责实施的软件商（ERP或WMS、硬件商或信息部门）确认具备对接能力后，再发起开通流程。

（2）本流程仅针对商业公司，若生产企业接口需求，请联系大区负责人联系确认需求场景。

申请APPKEY

接口调用

权限绑定

下载SDK

及权限包

APPKEY

1、申请appKey及对应的权限包

appkey申请过程请按照下面链接操作指南文档进行操作：

https://qg6r2i.yuque.com/qg6r2i/csvggm/ikhmztw15ig5nxsb?singleDoc#

《码上放心-申请appKey及对应的权限包过程（码上传）》

2、企业appKey（8位数字）权限绑定

企业获取appkey后，请将企业名称和appkey8位数字发给对应

大区负责人

开通接口权限。负责人联系方式如下：

IXIAOHUANLXH@ALIBABA-INC.COM

ANYEXUE.FYX@ALIBABA-INC.COM

江西,云南,贵州,重庆

陕西,山西,广西,新疆,西藏,青海,宁夏

WANGYICHENG.WYC@ALIBABA-INC.COM

SL160384@ALIBABA-INC.COM

CHENXUEJIAO.CXJ@ALIBABA-INC.COM

湖北,湖南,天津,北凉

HY260647@ALIBABA-INC.COM

吉林,内蒙古,上海

LIRUICHAO.LRC@ALIBABA-INC.COM

IUCHENGEN.LCE@ALIBABA-INC.COM

YISHI.ZJ@ALIBABA-INC.COM

15757115816

广东,海南香港

电话及钉钉号码

5901030572

13018998376

HUIZI.WJGQALIBABAINC.COM

ANPING.XZPGALIBABAINC.COM

甘肃,河南,辽宁

13761868015

15957151960

15726689729

18810996829

四川,黑龙江

18610773205

江苏,福建,台湾

安徽,浙江

13588831269

18611682540

18258231747

陈雪娇

李小欢

范业雪

王佳奇

负责区域

张静

办公邮箱

柳承恩

孙龙

韩颖

负责人

李睿超

王一澄

河北

徐赞平

山山东

备注：技术开发人员一定要按下面步骤进行开发练习，细读每一行说明，阅读每一行示例代码

相关技术问题可进群咨询：平台技术对接支持阿里钉钉群：

群号：67685003096

注意：

1）若企业信息部门自行对接，请按照上面申请过程文档申请APPKEY；

2）若企业委托第三方软件公司或集团对接，第三方软件公司或集团为首次对接，请按照上面申请过程文档申请APPKEY，若第三方软件公司或集团已有APPKEY，请直接联系表格中的大区负责人绑定；

3、得到appKey和app Secret，下载SDK包。

1）首先进入淘宝开放平台首页：

https://open.taobao.com/

使用申请appkey的淘宝帐号进行登陆，点“控制台”。

商家与生态伙伴大会

2023淘宝天猫

新机

共进

技术变更|商品接口支持非达尔文类目绑定属性数据更新2023.11.17

规则变更|电商业财管理类目开放接入2023.11.09

引领

THEWAY

淘宝开放平台

首页解决方案开放版图文档中心平台服务

OPPORTUNTY

TOGETHER

观看回放

LEADING

THRIVING

台服务商业合作

进入控制台

NEW

9388

更多>

2）进入以下页面，可以看到这个appkey所拥有的应用。下面我们示例中是叫做“测试企业码上放心接口对接”。

审核通过ISV申请API权限包流程-应用APPKEY:测试

商品接口支持非达尔文类目绑定属性...

过ISV申请APL权限包流程-应用APPKEY:测试..

2023年双11大促个性化定制商品订单..

2023年好价节大促API服务调整公告..

公告|2023年好价节大促AP服

电商业财管理类目开放接入

审核通过ISV申请API权限包流程-应用AP

务调整公告[12月5日更新)

测试企业码上放心接口对

申请AP1权限包2022-02-11

申请AP权限包2022-02-11

搜索应用名称&APPK

企业追溯码开发平台

申请AP权限包2022-02-11

98158张张

的应用

选择代开发公司

最新公告

PPKEY:32937056

开放平台

口文档

淘宝

Q工具

量中心

应用名称

开发

全部>

所在类目

O能力

-应用APPKEY:测试..

创建应用

据推送

财务

设置

控告警

操作

单..12/11

状态

连接平台

工单

我的应

奇门

12/川1

云托管

3）点击“管理”，如下图，在左上角部分，有一个appKey及app Secret，点查看，记录下appKey和app Secret。后面在程序中会使用到这两个值。在功能场景中可以看到您申请的权限包。点击场景介绍中的“详情”按钮，可以看到该权限包的相应接口。

App Key和App Secret作为与阿里开放平台对接的“用户密码”，需要严格保密，不能提供给任何人和其它企业，更不能在联调过程中将Secret发送到人员较多的沟通群中，该“用户密码”应该只出现在系统的服务端，不能出现在客户端系统的代码及配置文件中。调用接口的程序应该放到服务器端，不应该是客户端调用，如果客户端调用，appkey自然就需要放到客户端，这是不行的。

权限包已获得权限包(1)|申请中权限包(0)|可申请权限包(0)|未满足条件权限包(0)

证书流量1000,000次/天预警配置重置流量控制0流量自助申请

提供单据列表以及查询单据详情(包含码)详情

ADDSECRET太大大大大大大大大大大大大*大大太大宣看里置

码上放心开发平台,对ISV提供一组开放API详

授权时长4320.0/小时

码上放心-零售数据下行

试企业码上放心接

码上放心-WES详情

PKEY32937056

上架服务市场否

应用授权等级3级

码上放心-一码上传

节大促API服务

公告|2023年好

务调整公告[12月5日更新

码上放心-WES

码上放心-RDC

码上放心-RDC详

仑云托管

消息服务

Q能力

APP证书

表中心

28314

国财务

凹文档

全中心

@设置

Q工具

Q支持

权限包I

用设置

聚石塔

功能场景

公共场景

全部状态

面开发

30213

淘生

DK下载

8158张张

对接

30157

场景介经

淘宝开放平台

仑首页

已获得

30203

已获得

放平

概览

名称

分类

5返回应用列表

获得

权限包的名称以您所申请的权限包名称为准：

1、码上传权限包名称为“

码上放心-码上传

”

点击左侧“SDK下载”，选择您要开发时使用的开发语言，点击生成，等待10分钟后重新刷新页面，当生成时间为当前最新时间时，点击下载，可下载到最新的SDK。（本文以java开发语言为例，您在开发时以您实际使用的开发语言进行开发）

NETCORESDK

METADATA

NET

PHPSDK

NETCORE

PHP

PHP7

JAVASDK

整公告[12月5日更新]

NET

PYTHON3SDK

NODC

PHP7SDK

NODEJSSDK

NETSDK

PYTHONSDK

AVABSDK

试企业码上放心接口

公告|2023年好

2023-12-15下载

重新生成

GOSDK

8158张张

5返回应用列表

METADATA

了聚石塔

价节大促API服

重新生成

2023-12-15

023-12-15

CSDK

白文档

SDK下载

淘宝

仑首页

开放平台

2023-12-15

重新生成

用设管

Q工具

023-12-15

重新生成

业

重新生成

O能力

仑云托管

全中心

论设置

表中心

SDK下载

下载

息服务

重新生成

对接

一

19:25:41

服务调整公告

下载

财务

开发

支持

新生成

下载

新生成

户

新生成

开放平台

4、接口调用说明

获取自己企业id的方式：进入钉钉群（67685003096），@服务小密 /查询企业ID XXXXXXXX，具体如下所示：

您查询的信息如下:

63B6B977E4B070

查询企业ID测试

ENTLD:63B6B977E4B07O7

NETWORKTYPE:200

@服务小蜜心

14人未读

色机器人

服务小蜜

REFENTLD:

（1）开始第一个接口调用，得到一个企业的唯一标识接口。

1、找到这个接口的文档alibaba.alihealth.drug.msc.getentinfo( 根据企业名称查询企业唯一标识【ref_ent_id】和企业ID【ent_id】)

ENT_ID与REF_ENT_ID的说明及区别，当一个企业初次入网时,都会授予一个REF_ENT_ID，初次入网时ENT_ID与REF_ENT_ID相同，当一个企业进行修改企业名称时，企业的REF_ENT_ID不变，但ENT_ID会变为一个新值。也就是说一个企业的REF_ENT_ID是不会变化的，代表一个企业的唯一标识，但ENT_ID会随着企业改名而发生变化，代表一个企业“临时用的标识“。ENT_ID与REF_ENT_ID会用在后面每个接口中。

为什么收发货企业会用ent_id，而不用ref_ent_id，因为业务上有可能上传上个月的出库单据，如果企业在本月改名了，就有了新ent_id，但因为是上传上个月的单据，所以收货企业还要写改名之前的旧ent_id。ref_ent_id对一个企业来说，改名前后是一直不变的，如果收货企业写ref_ent_id，是无法区分收货人是显示旧名称还是新名称。

已获得权限包(11)|申请中权限包(0)|可申请权限包(0)|未满足

证书流量1,000,000次/天预警配置重查流量控制流量自助申请

据列表以及查询单据详情(包含码)详情

码上放心开发平台,对ISV提伴

码上放心-零售数据下

生成环节集成的接口详情

码上放心-RDC详

码上放心-WES详

调整公告[12月5日更新]

授权时长4320.0/

试企业码上放心接

码上放心-码上

上架服务市场否

码上放心-WES

上放心-RDC

5返回应用列表

APPKEY32937056

应用授权等级3级

好价节大促

仑云托管

淘宝开放平台

能场景

支持

30213

应用设置

30157

码上放心-生产环节集

场景介绍

8158张张

聚石塔

安全中心

全部状态

仑首页

淘宝

APPSECRET

大大大大太大大大大大大大太大方大大水宣看重置

限包I

已获得

28314

APP证书

品

30203

API服务调整公

SDK下载

报表中心

提供单据列表以及查询单

操作

面开发

@设置

国财务

O能力

公共场景

已获得

消息服务

已获得

文档

分类

概览

电工具

ISV提供一组开放

名称

找到你想调用的接口：

LIBABA.ALIHEALTH.DRUGMSC.GETENTINFO

AIBABA.ALIHEALTH.DRUG.MSC.G..

据企业名称查询企业唯一标识[REF_ENTID]和企业ID[ENT_ID])

接口名称,例如:ALIBABA.ALIHEALTH.DRUG.MSC-GETENTINFO

ALIBABA.ALIHEALTH.DRUGMSC.S..

LIBABA.ALIHEALTH.DRUG.MSC.U

ALIBABA.ALIHEALTH.DRUG.MSC.D

通过时间段批量查询入出库单信息

LIBABAALIHEALTHDRUGMSC.G.

ALIBABA.ALIHEALTH.DRUG.MS

生产批发企业上传入出库单据接口

IBABA.ALIHEALTH.DRUG.MSC.

2淘宝开放平台

AP输入参数签名结果,签名算法介绍请点击这里

,格式为YYYY-MM-DDHH:MM:SS,时区为GMT+8,例如:2

LIBABA.ALIHEALTH.DRUG.MSC.LI.

码上放心-码上传

公共参数

公共请求参数:

根据企业

户登录授权成功后,T

注明:"需要授权",则此参数必传;"不需要授权",则此参

平台文档中心.API文档

查询单据详情

求地址:

何获得此AP

查询往来单位列表

否采用精简JSON返回格式,仅当FORMATJSOR

TOP分配给应用的APPKEY,例如:123456

MESTAMP

8158张张V

PP_KEY

误码解转

HTTP地址

TPS地址

SIGN_METHOD

STRING

HTTP://GW.API.TAOBAO.COM/ROUTE

第元

BOOLEAN

ETHOD

STRING

要传;"可选授权",则此参数为可选

工A具

SIGN

APL接口名称,例如:ALI

(根据企业名称查询企业唯一标

2、点击您使用的开发语言示例，并将示例代码复制。

ALIBABAALIHEALTHDRUGSCGETENTINFOREQUESTREQ=NEWALIBABAALIHEALTHDRUGMSCGET

ALIBABAALIHEALTHDRUGMSCGETENTINFORESPONSERSP=CLIENT.EXECUTE(

CRET-ENT_ID>320000000000127971</REF_ENT_ID

AOBAOCLIENTCLIENT=NEWDEFAULTTAOBAOCLIENT(URL,APPKEY,SECRET);

根据企业主EAH.DRUG.MSC.G..

EAANEATNDRUGMSOR

</ALIBABA_ALIHEALTH_DRUG_MSC_GETENTINFO_RESP

物流企业音海袋空ATNDRUG.MSC.S..

根据企MAHEALTH.DRUG.MSC

AIBABA.ALIHEALTH.DRUG.MSC.D..

LIBABAALIHEALTH.DRUG.MSC.U

单据外USNEALTH.DRUG.MSC.BI.

<ENT_ID>320000000008127971</ENT_ID>

JAVAPHP.NETCURLPYTHONNODEJS

<NETWORK_TYPE>G9</NETWORK_TYPE>

正业各称营询企业唯一标识89

<MSG_INFO>SUCCESS</MSG_INFO>

REQSETREFENTID("320000000000127G71");

SYSTEMOUT.PRINTLN(RSP.GETBODY());

LIBABA_ALIHEALTH_DRUG_MSC

LIBABA.ALIHEALTH.DRUG.MSC.S..

通过时间段批量查询入出库单信息

REQ,SETENTNAME("测试企业U):

ABABA.ALIHEALTH.DRUGNS

DABA.ALIHEALTH.DRUOM

常示例

询往来单位列表U9.SC.I..

<MSG_CODE>调用成功</MSG_CODE>

<RESPONSE_SUCCESS>TRUE</RESPO

码上放心-码上传

LIBABA.ALIHEALTH.DRUGMSC.S..

,年标识喜看企业详细信意9.

SCGETENTINFORESPONSES

响应参数

应示例

查询单据详情

求示例

</RESULT>

何获得此AF

误码解释

AP工具

SULTMODE

/MODEL>

异常示例

求示例

应示9

共参

UERESPONSESUCCESSS

XMLJS

回结果

决会型

贷美企业信息安S..

类型

3、将

示例代码复制到开发工具中，并将第三步中得到的

appKey

和

app Secret

，下载

SDK

包引入到开发工程中，如下：

url

：

https://eco.taobao.com/router/rest

（

所有测试过程，都使用正式环境，不要使用沙箱环境

）

如果不想使用自已正式企业做测试，可以先和业务同学联系，让业务同学给出测试用的企业名称并授权。

ALIBABALIHEALTHDRUGNSCGETENTINFOREQUVESTREQ=NEWALIBABALIHEATHDRUGMSCETENTINFOREQUEST()

米**太太太水水米欢米大*太水水水水光大大这部分是直接将开放平台的示例代码复制到这里***水***水***水

ALIBABAALIHEALTHDRUGMSCGETENTINFORESPONSERSPCLIENT.EXECUTE

TAOBAOCIENTCLIENTNEWDEFAUTTAOBAOCLIENT(URL,APPKEY,SECRET);

OUT.PRINTLN("接口异常:"+E.GETERRCODE()+"-"+E.GETERRMSG

REQ.SETREFENTID("320000000000127970");

STRINGURL=HTTPS://ECO.TAOBAOCOM/ROUTER/REST"

UBLICSTATICVOIDMAIN(STRINGL]ARGS){

SYSTEM.OUT.PRINTLN(RSP.GETBODY())

>图COMMONS-LOGGING-1.2JARLIBRARYROOT

CMAVER:COMMONS-LOGGING:COMMONS-LOGGINC

[G18>LIBRARY/JAVA/JAVAVIRTUALMACHINES/J

CATCHAPIEXCEPTIONE)

REG.SETENTNAME("测试企业")

PUBLICCLASSTEST

SCRATCHESANDCONSOLES

AOBAO-SDK-JAVA-AUTO_1701765666106-2

STRINGSECRET="FCC59

</3-SELLOUT-0716_01.XML

STRINGAPPKEY="3;

MSCDEMO~/MSCDER

EXTERNALLIBRARIES

VBGETENTINFO

呈RESOURCES

NOUSAGES

TARGET

EXTENSIONS

MPOM.XML

BBILUPLOAD

TEST>MAIN()

>图TAOBAO

OXMLUTIL

59--.-.-2145";

口SRC

.IDEA

NOUSAGES

GMAIN

口JAVA

EMS

口IB

TEST

TOP

OTEST

QAEVG

PUBICSTATICV

大

OTEST

CMSCDEM

AAEAV0EWECE93

4、执行代码，得到请求结果。见下面红圈部分：

,/N,AAUENNNHTUN:TPANSPARTETSOCKET,ADURESS=127.0.0.1:49426,SUSPENDEYSERVER0JAVAGNT:/USERS/2IANGLE/LN

ALIBABALIHEALTHDRUGNSCGETENTINFOREQUESTREQ=NEWALIBABAAIHEALTHDRUGMSCGETENTINFOREQUEST

/欢大大太太水水大大大大水大大大太大大大这部分是直接将开放平台的示例代码复制到这里大太太水水水水水水次次

AYA/JAYAVIRTUALMACHINES/JDK-18.0.1.1.JDK/CONTENTS/HOME/B1N/JAVA-AGENT

ALIBABAALIHEALTHDRUGMSCGETENTINFORESPONSERSPCLIENT.EXECUTEREQ)

ALIHEALTHDPUA_MSC_QETENTINFO,RESPONSE":{"RESULT":{"MODE1":"ENT_ID":"1LC758D69CF074A6291628E4DFD85ET

SYSTEM,OUT,PRINTLN("接口异常:"+E.GETERRCODEQ)+-"+E.GETERRMSGL)

TAOBAOCLIENTCLIENTENEWDEFAUTAOBAOCLIENT(URL,APPKEY,SECRET)

EDFROMTHETARGETVN,ADDRESS:127.0.0.1:49426,TRANSPORT:'SOCKET

TOTHETARGETVM,ADDRESS:127.0.0.1:49426',TRANSPORT:'SOCKET

STRINGURLHTTPS://ECOTAOBAOCOM/ROUTER/REST"

REQ.SETREFENTD("320000000000127970)

PUBLICSTATICVOIDMAIN(STRING[]ARGS)

STRINGSECRETE"FCC861FLED445

SYSTEMOUT.PRINTLNRSP.GETBODY))

DEBUGTHREADS&VARIABLESCONSOLECD

>3COMMONS-LOGGING-1.2JARLIBRARYROOT

REG.SETENTNAME"测试企业"

L场MAVEN:COMMONS-LOGGING:COMMONS-LOGGIN

CATCHAPIEXCEPTIONE

>图TAOBAO-SDK-JAVA-AUTO_1701765666106-2

NISHEDWITHEXITCODE

318>/LIBRARY/JAVA/JAVAVIRTUALMACHINES

PUBLICCLASSTEST

STRINGAPNKEYE"3295"

SCRATCHESANDCONSOLES

</3-SELOUT-0716_01.XML

9426TASP:AM.1758D69CF074

C3MSCDEMO~/MSCDE

BLLUPLOAD

ST>MAIN

HEXTERNALLIBRARIES

回GETENTINFO

MPOM.XML

EXTENSIONS

VRESOURCES

MAIN

V口JAVA

NOUSAGES

OTEST

OXMLUIL

OTEST

口JAVA

V白TOP

TARGET

,2.A.0.1:626,TRANPART:SACETCCPTNKTYPE.280EFENT.JU:C75300T5AS0A

TEST

GMSC

ACOM

NOUSAGES

口SRC

大

IDEA

口IB

5、接口有统一的返回格式，具体说明如下

返回对像为alibaba_alihealth_XXX_XXX_XXX，例如下面格式

{

"alibaba_alihealth_drug_msc_xxxx_response": {

"model":""

"msg_code": "",

"msg_info": "",

"response_success": true,

"request_id": "5z317d85s34z"

}

解析返回值的说明：

response_success为true时，说明接口调用成功，如果msg_code为SUCCESS说明完全正确直接解析model即可。如果msg_code为WARN开头（比如WARN_SYS、WARN_BIZ），说明有需要注意的信息，此时除了解析model还需要解析msg_info查看具体的告警信息。response_success为false时，说明接口调用失败，此时msg_code以FAIL开头，细分为FAIL_SYS（系统错误）和 FAIL_BIZ（业务错误）等。

6、上述执行代码示例，示例使用IDEA开发（下面示例双击可以打开）。

码上传示例代码工程-idea.zip(1.1 MB)

7、每个接口，都可以通过一个网页版的测试工具进行调试，

强烈建议每个接口都先在这个地方调用测试完成通过后，再进行程序调用

。

开发者大复

支付宝小程

2023高校季:年轻科技力

淘宝开放平台

开放版图

平台服务

AP文档

平台简介

文档中心

商业合

商家应用

饭

聚石塔

选择文档中心》》平台简介

空开故平台1IBDA:CPAMRATAM)是基于调宝签类电子骨务业务的月放平台,提供外都含作伙伴参与接务赛宝用产的各块原材料,如业务AR,贴号件系,数偿维选,街门们网关等,它是大海宝电子核务基磁据务的

要开的造径,将准过各行各业定制,创新,进化,并最终促成新简业文调注方围的提立,我们的使宗是把宽室网的离品,用户,交易,物流等一系列电于带务基时接务,像水,电,体一样输进给有需要的顶家,开2

和各项垂直业务的主要流程,日均AP调用量超白亿.无比定从业分开吸的发及,"

淘宝开放平台为外部合作伙伴提供了极大的尚业惩家工问日"...,.,

.2646E以生7吸断均因候式如亦用硝售分成,演空路成交法情,湾宝者上其分队,*"向力以市,7日42"

,L..EAMIUF4,向对罗使开分空台码式自由一不限选高,不限开台(反用然见底,果图,1网如A

国内开放业务规模最大的开放平台.回的,周主

一,什么是淘宝开放平台

平台简介

宝开放平台为各类应用提供了清晰的盈利式,如业

淘宝开放平台所依托的大淘宝,拥有注册用户数以亿

开放规模大,程度深,限制少

文档中心.开放平台

,到TOP能做什么?

一,什么是淘宝开放平台

二,平台特点

开放业务

,社区媒体和各行各业.如何接入,点我了解详情

更新时间:2023-05-16

利模式清晰

开放平台

业务强大,商机无限

.商家自研-商家后台系统

内容创作工具

.商家运营服务

2.商家经营工具

开放业务

常用工具

1.购物小程序

平台简介

.商家自研-小程序

基础技术

石塔云产品

商家应用

,平台特点

开放业务

接入指南

创意小游戏

和淘宝业务需求的多样性为各类合作伙伴提供了

台规则

合作形式丰备

分成,P4P广告分成等,并且还会根据合作伙伴反馈,不断提供更多更灵活的盈利模式,全力支持各合作伙伴不断地成长

和壮大.

.店铺动态卡片(LIVECAR

常见问题

奇门

淘宝,拥有注册用户数以亿级的买家和百方级买家,淘主式见而少的中"一

API文档

淘宝开放平台(TAOBAOOPENPLATFORM)是基于淘宝

添写相应的入参点“提交测试”：

注:系统分配APPKEY只能调用基础API

JSONOXMLOSIMPITYJSO

PI测试工具(新

PP访问日志工!

品属性工具

P收费查询

2淘宝开放平

用工具说明

户授权工具

误码排查工具

制台工具

PI测试工具

I需要填入自己申请的APPKEY

聚石塔云产品

常用工具

开放业务

APPKEY:

返回格式:

基础技术

用工具

常见间题

.开放平台

提交测试

AP文档

API名称:

ONINE

台规则

不填则厚

奇门

环境:

Q接

文档中心.

8、日常问题可以通过“码上放心小蜜”进行查询：

地址：

https://links.alipay.com/app/room/61541e0582326505a2f41a84/

输入问题关键字，点回车：

码上放心

新淘

问题咨询

可以快速解答你的任何问题

top

企业系统接口对接一TOP文档-快易通接口...

企业系统接口对接-TOP文档*快易通对接...

企业系统接口对接一-TOP文档接口对接错...

企业系统接口对接一TOP文档-申请appkey...

top

语雀文档

百科

会话

全部

互企业系统接口对接一TOP文档-快易通对接文档

https:qg6r2iyuque.comdocsshar7-

86cd7510?#

来源:码上放心

百科企业系统接口对接一TOP文档-快易通接口说明文档

https:open.taobao.comapihtmdocld410318doclype-2&scopel

d-15614

宗源:码上放心

五企业系统接口对接一TOP文档接口对接错误说明指南

httpsqg6r2iyuque.comdocshde-9140079c4dda

c3d1764a?#

来源:码上放心

百科企业系统接口对接一TOP文档-申请appkey及对应的权限包过程

httpsqg6rziyuque.comdocsshareea9d87e-9e482-91d9

50110fae?#

宗源:码上放心

会适我自己申请的top接口,测试通过后,在客户处上线是需要客户再...

问题类型:TOP接口企业名称:ds问题描述:我自己申请的top接口,测

试通过后,在客户处上线是需要客户再去申请一个app吗?接口名:接口

参数:接口返回:紧急程度:一股联系人姓名:手机号:.

来源:码上放心

会话企业系统接口对接一top文档快易通对接文档

企业名称:国药控股山西有限公司接口参数:紧急程度:较重问题类型:

TOP接口接口返回:接口名:手机号:问题述:最近的快易通接口怎么

更新联系人姓名:...

亲源:码上放心

会drugtrace.toplsyduploadinoutbill上传的这个接口一次上传...

问题类型:入出库单据企业名称:成都任我行千方百剂软件有限公司问

题荷述:alibaba.alihealth.drugtrace.toplsyduploadinoutbill上传的

接入在线支持

（2）开始第二个接口的调用，完成一个单据上传接口的调用。

A.什么是单据：记录一次企业与企业（个人）之间进行药品收发货信息的记录。每次收货及发货都应该形成一条单据记录。本接口是一个企业出库的单据示例。

B.什么是

单据号：是每个单据必须有的一个属性值，在同一个企业每条单据号是唯一的，不能出现两条单据使用同一个单据号，已上传过的单据号再次上传将提示错误信息。

C.单据文件：一般由扫码枪生成，是一个xml类型的文件，详细可以见“单据模板示例”附件。单据文件格式的详细描述可以访问：

https://files.alicdn.com/tpsservice/aa3e9a993338a0028549a6d2f67e4ac7.pdf?spm=a21f6.8078399.0.0.7bfa6857QbPT0o&file=aa3e9a993338a0028549a6d2f67e4ac7.pdf

上述文档中，大多数属性是用于客户端上传的。

在接口对接开发时，单据文件只关注Name属性和Code属性（

WareHouseOut、CorpOrderID、ActDate属性需要存在，但属性值以接口入参为准

），其它属性可以不关注。

version-"1.0"encoding"utt-8">

?xml

日日日日

ainAction-"WareHouseOut">

EventName-"WholesalewareHouseut"

code-"83689060000001555528"

CoRPOdeID"3-供应出库07160ACtDate202007

<Data

code-83689060000001542589"

OPORdID"-伙应出07160ACtDate*2020-076

Data

</Datarield>

</Event>

/EveNtS>

K/Document>

单据收发货企业、单据号等是在接口调用时以入参形式上传的。

单据类型字典：

101, "生产入库"102, "采购入库"103, "退货入库"104, "调拨入库"106, "零头入库"107, "供应入库"108, "召回入库"110,"赠品入库"111,"盘盈入库"112,"报废入库"113,"其他入库"

201, "销售出库"202, "退货出库"203, "调拨出库"204, "返工出库"205, "销毁出库"206, "抽检出库"207, "直调出库"208, "生产出库"209, "供应出库"211, "召回出库"212,"赠品出库"214,"盘亏出库"215,"损坏出库"216,"报废出库"217,"其他出库"237, "直调退货"

1、通过第三步的1）2）找到要调用的接口，如下图：

ALIBABA.ALHEALTH.DRUG.MSC.UPLOADCIRCUBLL

调拨出库";204,返工出库";205,"制段出库";206,"抽检出库";207,"重调出库";20,"生产出库";209,"供应出库";21召固出库":212,赠品出库"1

AHAHAALHEAHCL

户登录授权成功后,,TOP预发给应用的授权后司,,详超增出

112:00:00.淘宝AP服务端允许客户端请求最大时间误差为10分钟

AAAC

AIPAPAALINEATH.DRUG.MSCR

AP接口名称,例如:ALIBABA.ALIHEALTH.DRUG.MSC.UPLOADCIRCUBILL

淘宝开放平台文档中心API文

ALIBABA.ALIHEALTH.DRUGMSC.BI...

ALIBABA.ALIHEALTH.DRUG.MSC.G...

响应格式.默认为XML格式,可选值:XML,JSON.

ALIBABAALIHEALTHDRUG.MSC.S...

ALIBABA.ALIHEALTH.DRUGMSC.S.

(生产批发企业上传入出库单据接口)

TOP分配给应用的APPKEY,例如:12345678

ALIBABA.ALIHEALTH.DRUG.MSC.S..

ALIBABA.ALIHEALTH.DRUG.MSC.LI...

通过时间段批量查询入出库单信息

ALIBABA.ALIHEALTH.DRUG.MSC.D...

AP输入参数签名结果,签名算法介绍请点击这里

需要传;"可选授权",则此参数为可选

HTTP://GW.API.TAOBAO.COM/ROUTE

HTTPS://ECO.TAOBAO.COM/ROUTER/RES

物流企业意询货主企业信息

库";113,"其他入库"201,"销售出库";202,"退货出库";203,"调拨出库";204

公共请求参数:

签名的摘要算法,可选值为:HMAC,MD5,HMAC-S

公共参数

单据处理状态宣询

98158张张

码上放心-码上传

￥免费不需用户授权

SIAN_METHOD

生产批发单据上传(非零售企业使用),包括101,"生产入库:

何获得此AP

请求地址:

询药品目录信息

TIMESTAM

宣询单据详情

误码解释

间戳,格式为YYYY-MM-DDHH:MM:SS,时区为

STRING

正式环境

STRING

HTTPS地址

METHOD

SIGN

STRING

名称

类型

P工具

STRING

常示例

7.其他出库";237,"直调退货".

STRING

此AP的标签上注明:需要授权",则此参数必传;"不

应示例

应参数

Q搜

STING

必须

复制代码示例：

ALIBABAALIHEALTHDRUGMSCUPLOADCIRCUBILLREQUESTREQ=NEWALIBABAALIHEALTHD

REQ,SETBILLTIME(STRINGUTILS.PARSEDATETIME("2023-10-1016:57:15"));

REG,SETFILECONTENT("添写单据文件XML的加密事,加密过程看文档.XMLU

TAOBAOCLIENTCLIENTNEWDEFAULTTAOBAOCLIENT(URL,APPKEY,SECRET);

REG,SETDISREFENTID("5069452C34B94A778ABAA26C2B40B305"

REQ.SETDRUGLISTJSON("[("CODECOUNT":100,"COMMDRUGID":"TESTCOMM

REG,SETTOUSERID("D5F5F05C6AF04E52BA7894D9BBF8E757)

REG.SETDESTUSERID("D5F5F05C6AF04E52BA7894D9BBF8E757

REQ,.SETDISENTID("5069452C34B94A778ABAA26C2B40B305");

REQSETASSENTID("5069452C34B94A778ABAA26C2B40B305");

ALIBABAALIHEALTHDRUGMSCUPLOADCIRCUB1LLRESPONSER

REG,SETUPLOADFILENAME("单据文件00001.XML");

REQ,SETXTCHECKCODEDESC("未通过原因描述");

REQ.SETREFUSERID("320000000000127971");

SYSTEMOUTPRINTLN(RSPGETBODY());

ALIDABAALIHEALTH.DRUG.MSC.S...

REQ,SETASSREFENTID("5069452C34B94A778ABAA26C2B40B305");

REG.SETFROMUSERID("00000000000020671792)

MEAEALLDRUG-MSCU

BAALIHEALTHDRUGMSCUPLOADCIRCUBILLRE

喷正业名称查询企业唯1SC.9..

REQ,SETFROMADDRESS("发货地址XXX");

ALIBABA.ALIHEALTH.DRUG.MSC.D...

REQ.SET0RDERCODE("123456");

REQ.SET0PERICCODE("21208834S");

REG.SETFROMPERSON("张菜");

REQ,SETBILLCODE("MSC_BC0GS");

ALIBABA.ALIHEALTHDRUG.MSC.G...

REQSETTOPERSON("享某");

TANEALTH.DRUG.MSC.S..

REQ.SETXTCHECKCODE(OL);

G询往E.AIHEALTH.DRUG.MSC.LI.

REG,SETXTISCHECK("未验证通过原因");

根据企业主键查看企业详细信息

REQ,SETQURECEIVABLE(1OL);

APABA.ALIHEALTH.DRUO

ALIBABAALIHEALTH.DRUGMSC.G...

ADA.ALIHEALTH.DRUGMS

REG.SETCLIENTTYPE("2");

REQ.SETIGNORECHECK("II

GRAOAALIHEALTH.DRUG.MSE

零关出入库单据上传771SCR...

根据企业唯一标识宣看企业详细信息

码上放心-码上传

单据处理状态宣询91SC.DI..

REQ,SETTOADDRESS("收货地址BXXX");

请求示例

询药品目录信息

ALBABA.ALIHEALTH.DRUGME

如何获得此AP

其询单据详情9.711SC.S...

UBILLRESPONSERSP=CLIENT,EXECUTE(REQ)

REQ.SETOPERICNAME("张三");

API工具

异常示例

错误码解释

REQ.SETFROMBILLCODE("1234S6");

响应示例

响应参数

公共参数

请求示例

ETCURLPYTHON

请求参数

REQ.SETBILLTYPE(2OL);

UBILLREQUEST();

PYTHON3

NODEJS

JAVA8

CJC++

2、复制示例代码到您的开发工具中，如下图：

{'ALIBABAALIHEALTH,DRUGNSC.UPLOADCIRCUBI11,RESPONSE"MODEL1""51161F84245BD845BEF76FECFC6D3'N59.CBDE-SU

LIBABALIHEALTNORUQNSCUPLOADCIRCUBILLREQUESTEQ=NEWAIBABALIHEALTHORUGNSCUPLOADCIRCUTILREQUEST()

++MUYBO65OZM8QZGSGPAE4AGAC0WMJAYAGPOPGBPBGRPAEGRGQYTKGWWB6VDS0NDNAGJPAUFLAZUR/XPICYHQXSBIITAKXN

++WFUVUJK3ZA1FXZN6ERZKHNOGSQMPECNS5KZL66RVJPS2ZQUHZK9NYLFNPI..Z2X0Q(ODSCN6-LA2SS6J0ANF4Y1FQR/5PCNP

REQ.SETB1LLTIME(STRINGUTIL.S.P0RSE0ATETIME(STR"2023-10-1016:57:15"));//单据时间

+/QULSGG+IZ15JSKLYENRZTBMJ.ZYKUMLM5GRANMARN0+STAIHYIZSWVSDCWNDQXHDQZMS.STXV0BFLJA50KCDZLXKINTESEYQ*6

DISCONNECTEDFROMTHETARGETVM,ADRESS:127.0.0.1:6403',TRANSPORT:SOCKET

CONNECTEDTOTHETARGETVM,ADRESS:127.0.0.1:64033',TRANSPORT:SOCKET

REQ.SETT0USERID("D5F5F05C6AF04E52BA7894D9BBF8E757);

TAOBAOCUIENTCLIENTNEWDEFAUTTAOBAOCUIENT(URL,APPKEY,SEORET)

+"+SJGEAA-=");//添加单据XML文件的加密串,调用XMLUTI类的CREATEFILEZIPCONTENT方法生成

REQ.SETDISREFENTID("5069452C34B94A778ABAA26C2B40B305"

REQ,SETBI11C0DE("MSC_BC005");/单据号,不要使用默认的

REQ.SETDESTUSERID("D5F5F05C6AF04E52BA7894D9BBF8E757");

REQSETD1SENTID(5069452C34B94A778ABAA26C2B40B305")

REQ.SETFR0MUSERD("3E8CB88E9E04465781F7DB1A7441C275");

CAUAUUUUOOAOOGIAOOAOGINVUOOOUI

REQ.SETBIL1TYPE(201L);//单据类型-销售出库

REG.SETUPLOADFILENAME("单据文件00001.XM");

REQ.SETFLECONTENTH4SIAAAAAAAA/3U/E7"

REQ.SETREFUSERID("320000000000127970")

LMAVEN:COMMONS-LOGGING:COMMONS-LOGGIN43

REQ.SETXTISCHECK("未验证通过原因");

PROCESSFINISHEDWITHEXITCODEB

REQ.SETFROMADDRESS("发货地址XXX");

REGSETCLIENTTYPE"2"//默I

DEBUGTHREADS&VARIABLESCONSOLECDL

REQ,SET0PERICNAME("张三");//单据上传人

REG.SETFROMBI1LCODE("123456");

REQ.SETTOPERSON("李某");

REQ.SET0RDERCODE("123456");

AAAAA有AAAAAAAAAAAAA不不本刀定国货付以们小阳题创到达至不东不A不不不不不不不不不不不A不A

REQ.SETTOADDRESS("收货地池址XXX");

REQ.SETQURECEIVABLE1L)

>图COMMONS-LOGGING-1.2JARLIBRARYROOT

REQ.SET0PERICCODE"212000345")

</3-SELLOUT-0716_01.XML

REQ.SETFROMPERSON("张某");

LMSCDEMO~/MSCDER

EXTERNALLIBRARIES

SCRATCHESANDCONSOLES

3TAOBAO-SDKJAVA-

CRESOURCES

LEGETENTINFO

G<18>LIBRARYJAVA/J

AVA-AUTO17017A

SCRATCHES

当EXTENSIONS

企O元

65666106

MPOM.XML

口TARGET

白MAIN

生

OTEST

OXMLUTIL

ABILLUPLOAD

TEST

.IDEA

话

PROJECTV

话

CODE":"SUCCESS","MSG_INFO":"调用成功",

口SRC

VQCOM

丫口JAVE

三

口JAVA

OTEST

合PROCES

所有接口需要关注ref_user_id/ref_ent_id字段，如果你是服务商，您为哪家企业服务，这个字段就写哪家企业。如果您做为企业的IT部门为本企业开发接口服务，这个字段则填写本企业的ref_ent_id。

3、当出现以下提示时，说明接口调试已通，只是您的appkey没有操作企业的权限。

{"alibaba_alihealth_drug_msc_uploadcircubill_response":{"msg_code":"FAIL_BIZ_AUTH_ERROR","msg_info":"(25465001)没有操作权限：(320000000000127971)(MSCBillUploadCircuServiceImpl.uploadCircuBillInfo)","response_success":false,"request_id":"10ixyzdqzv4rb"}}

该返回值说明这个appkey没有与相应企业绑定，请联系阿里业务人员，请将您的返回串给到阿里人员，进行权限赋予。

4、

当出现以下提示时，说明您的调用已经成功，单据已经传上到码上放心平台。

{"alibaba_alihealth_drug_msc_uploadcircubill_response":{"model":"76368a4de28446c481d91e85c53871b5","msg_code":"SUCCESS","msg_info":"调用成功","response_success":true,"request_id":"saem4c6fhq17"}}

5、接口有统一的返回格式，具体说明如下

返回对像为alibaba_alihealth_XXX_XXX_XXX，例如下面格式

{

"alibaba_alihealth_drug_msc_xxxx_response": {

"model":""

"msg_code": "",

"msg_info": "",

"response_success": true,

"request_id": "5z317d85s34z"

}

解析返回值的说明：

6、上述执行代码示例，示例使用IEDA开发（下面示例双击可以打开）。

码上传示例代码工程-idea.zip(1.1 MB)

单据模板示例20201211.rar(7 KB)

Net加密.txt(1 KB)

使用C#开发时，单据文件的加密过程示例代码。

XmlUtil.java(3 KB)

使用java(jdk8版本以下)开发时，单据文件的加密过程示例代码。

XmlUtil.java(3 KB)

使用java(含jdk8及更高版本以上)开发时，单据文件的加密过程示例代码。

注：由于单据上传是异步处理的，接口返回成功不等于处理成功，需要获取处理状态判断是否成功，平台提供两种方法判断处理是否成功：

第一种，通过接口查询单据是否处理成功，调用

alibaba.alihealth.drug.msc.searchstatus

接口实时查询单据处理状态，详见3.4中「通过接口获取单据处理状态」

第二种，通过消息接口方式，方法是在调用单据上传接口时，

入参client_type 填写为8

，系统处理完成后会将处理结果通过消息的方式发送给调用方，详见第3.4中「通过消息方式接收单据处理状态」

（3）开始第三个接口的调用，查询一个出入库单据上传后是否处理成功。

所有单据上传是一个异步过程，单据上传成功后，并不代表单据已入到系统中，而是有一个5秒左右的延时处理，只有单据处理成功后，才代表单据正式上传到了系统中。如果单据处理失败，在入出库单查询中，是查不到单据信息的。可以通过三种方式获取处理状态信息。

一、通过接口获取单据处理状态

1、

接口名称：alibaba.alihealth.drug.msc.searchstatus ( 上传单据后处理状态查询 )

ALIBABAALIHEALTH.DRUGMSC.BILL.SEARCHSTATUS单理S)

SAAMEAN.DRUGMSC.L..

MCANTEATDRU9MSCG

间戳,格式为YYYY-MM-DDHH:MM:SS,时区为GMT+8,例如:2015-

ALIBABA.ALIHEALTH.DRUGMSC.G...

AAAACRL

AP的标签上注明:"需要授权",则此参数必传;"不需要授权",则此参数

TTP:LGWAPITAOBAO.COMLROUTERIREST

TOP分配给应用的APPKEY,例如:12345678

ALBABA.ALIHEALTH.DRUG.MSC.BI..

ALIBABA.ALIHEALTH.DRUG.MSC.D..

ALIBABA.ALIHEALTH.DRUGMSC.S..

ALIBABA.ALIHEALTH.DRUG.MSC.R...

很据企业名称查询企业唯一标识

物流企业宣询货主企业信91SC.S...

TTPS:LLECO.TAOBAO.COMLROUTERFREST

￥免费不需用户授权

ALIBABA.ALIHEALTH.DRUG.MSC.G...

之淘宝开放平台

文档中心.API文档V

响应格式.默认为XML格式,可选值:XML,JSON.

AP接口名称,例如:ALIBABAALIHEALTH.DRUG.MSC.BILLSEAN

码上放心-码上传

P输入参数签名结果,签名算法介绍请点击这里

公共参数

共请求参数:

API协议版本,可选值:2.0

请求地址:

需要传;"可选授权",则此参数为可选

SIGN_METHOD

98158张张

HTTPS地址

查询药品目录信息

单据处理状态查询

正式环境

HTTP地址

TIMESTAMP

APP_KEY

何获得此AF

环境

响应示例

STRING

STING

STRING

STING

错误码解释

STRING

异常示例

求示例

户登录授权成功后,TOP颁发给

ETHOD

12:0000.淘宝AP1服务端允许客户烤

2、复制示例代码到您的开发工具中，按请求描述修改参数，如下：

物AOA-AEATHDRUG.MSC.S..

ALIBABAALIHEALTHDRUGMSCBILLSEARCHSTATUSREQUESTREQ=NEWALIB

根据企业多称GATHDRUG.MSCG..

生产发EA.IRUGMSC.U..

零头出入库鱼提AILN.DRUG.MSC.R...

通过时间段ESDRU9MSC.S..

ALIBABAALIHEALTHDRUGMSCBILLSEARCHSTATUSRESPONSERSP=CLIENT.EXECUTE(REQ)

查询往SAIMNEALTH.DRUG.MSC.I..

单据处理状柔EALTH.DRUGMSC,BI..

G.SETBILLCODE("BC001_1123566

EQ.SETAGENTREFUSERID("320000000000127971

SYSTEMOUT,PRINTLN(RSP,GETBODY());

CLIENT=NEWDEFAULTTAOBAOCLIENT(URL,APPKEY,SECRE

ALIBABAAIHEALTH.DRUG.MSC.G...

A.AINEALTH.DRUG.MSC.S

LIBABA.ALIHEALTH.DRUG.MSC.G...

LIBABA.ALIHEALTH.DRUG.MSC.D...

EG.SETREFENTID("320000000000127971");

G.SETDRUGTYPE("2")

EG.SETPAGESIZE(2OL);

LSEARCHSTATUSREQUEST();

Q,SETDEALSTATUS("3");

EG.SETBILLTYPE("A");

码上放心-码上传

EG,SETFROMUSERID("3200OOO00000127

EQ.SETPAGE(IL);

REG=NEWALIBABAALIHEALTHDRUGMSCBILL

求示例

宣询单据详情

EQ.SETTOUSERID("320000000000127G71");

宣询药品目录信息

如何获得此AP

TAOBAOCLIENTCLIENT

响应参数

错误码解释

EQ,SETENDDATE("2023-12-15");

API工具

处理成功

请求示例

异常示例

公共参线

响应结果

响应示例

YTHON3

请求参数

PPKEY,SECRET);

PYTHON

G,SETBEGINDATE("2023-10-01");

CURL

RUGMSCBILLSEARCHSTE

NET6

NODEJS

JAVA8

3、执行示例代码，返回如下结果，则表示上传成功，如遇“没有操作权限”同上解决

result:

model:

resultlist:

billdealstatussearchdo:

*billcode:"B2C2018110617375430002

billtime:2017-05-1016:57:15

*billtype:*326,

crtdate:2020-11-0219:30:10

"fromrefuserid:*320000000000127971"

"fromuserid:45637fe075194c988b7a53a3cb344cd2

"fromusername:"'香港测试108改名2

"iccode:~23313615

physictype:*3,

4、接口有统一的返回格式，具体说明如下

返回对像为alibaba_alihealth_XXX_XXX_XXX，例如下面格式

{

"alibaba_alihealth_drug_msc_xxxx_response": {

"model":""

"msg_code": "",

"msg_info": "",

"response_success": true,

"request_id": "5z317d85s34z"

}

解析返回值的说明：

二、通过消息方式接收单据处理状态

1、如果要通过消息方式接收单据处理状态，首先在上传单据的时候接口入参clientType需填写为: 8

请求示例

C/c++

Python

JAVA

NodeJS

CURL

NET

PHP

TaoDaocHentcLentDeutaoaocen

Btbbatthe

reg.setailicode(bcoo

Eeg.setB11TSu

reg.setBilltype(L

reg.setPhysictypeL)

reg.setReruserrd(320000000000127971

reg.setgenteuserid20000000000127971)

reg.setFromuserid00000000000020671792

Eeg.settouserdd505c6ao4a79b877

eg.setDestuserd505cbo4oa

reg.setoperIccode("212000345")

reg.setoperIcname("张兰")

teg.etiacon

reg.setuploadFilename单文件00001.m1

reg.setciienttype""

reg.setouReceivable

reg.setxtischeck(o"

reg.setxtcheckcode"未验证通过原因"

reg.setxtcheckcodeDesc("未通过原因描述")

2、订阅消息，登录控制台在应用管理页面【消息服务】->【订阅消息】勾选需要订阅的消息，勾选

alibaba_alihealth_BillProcessStatusNotify

后即可接收消息。

op.fam"..doctor

如向使用潮县型务?

From淘宝

根剪

清点名或中文名

搜率

SDK下

中文名称

分

消只多称

应用设置

单撼处理状态薄知

已订扣/取消

阿里修本追润势

albaba.aheaheillProcesssta

玛生,根务机关霜泉

口

xibabecheoth_Dodtorllossoge

安全中心

平台潘三方机构"订单状态变买"

订间

alibabaalheshhOroasanooa

报表中心

已订阅/消

取消授权浦总通知

平台消启

闵里饿续-会员...

阿里位陕测试消息

已订约取消

消点服务

订间

YUNOSYOC

YunosYocdatapool沙箱环境

订问消息

口

YunDsYoc

订购

yoc有尽服务

Messp-ScrmVice

我的消息

口

农入球认失送

服务市场

订餐

fuwu_canfrmFall

消息报表

订店

农入码认院功

轻努市场

消足物边查询

订购

订单关闭消息

adao.fuNJCrdardcsed

服务市场

消总队别及况

页群转

共12条亚页页上页下页尾页荒

TMC连接宜询

消总订阅查询

消启流控配置

API服务提供

满站园

咨涛小开

3、编写业务代码

TmcClient client =

new

TmcClient(

"app_key"

"app_secret"

"default"

);

client.setMessageHandler(

new

MessageHandler() {

public void

onMessage

(Message message, MessageStatus status)

{

try

{

System.out.println(message.getContent());

System.out.println(message.getTopic());

}

catch

(Exception e) {

e.printStackTrace();

status.fail();

// 消息处理失败回滚，服务端需要重发// 重试注意：不是所有的异常都需要系统重试。 // 对于字段不全、主键冲突问题，导致写DB异常，不可重试，否则消息会一直重发// 对于，由于网络问题，权限问题导致的失败，可重试。// 重试时间 5分钟不等，不要滥用，否则会引起雪崩

}

});

client.connect(

"ws://mc.api.taobao.com"

);

注：采用Java main方法在IDE里面运行上面的代码测试时，请在client.connect()后面加上Thread.sleep让main线程等待一段时间结束，以便观察消息的实时接收情况，否则main线程结束后，TMC长连接也会跟着断开。如果是在web服务器上运行上面的代码，则不用在 client.connect()后面加任何Thread.sleep代码，也不需要在外面包一层while(true)循环，因为web服务器上的主线程只要服务器不关闭都是不会结束的，TMC的长连接会一直保持。

消息返回结果示例：

{

"result_type"

"4"

, //

处理状态 0，处理中 1, 上传成功 3, 处理成功 4, 处理失败

"ref_user_id"

"320000000000127971"

//单据所属企业ID

"process_info"

"该单有1个追溯码未激活,如81012350000000157474。"

// 处理信息

"ic_code"

"123456"

//单据上传人

"bill_code"

"BC1_112001aaa"

//单据编号

"process_date"

"2021-06-11 17:38:39"

//单据处理时间

"bill_type":"102"

, //单据类型

"store_inout_seq_no"

"a92dfa23c53e4ffe99ee2c2bf6fcbf7c"

// 出入库唯一编号

"bill_time"

"2021-01-02 02:21:21"

// 单据时间

}

三、通过客户端的方式查看单据处理状态

1、登录码上放心客户端

2、选择【入出库单】菜单下拉列表下的【单据处理状态查询】

上放心客户端

国际医药物流

关联关系

追溯码管理

临床试验用药

客户服务

受权管理

系统设吉

入出库单

帮助中心

品度管理

账户管理

信息管理

单据处理状态查询

首页

全部

2022-02-17

单层类型

结束时间:

开始时间:

2022-02-01

发货单位:

全部

处理状态:

全部药品

药品类型

请点击选择

配送单位:

委托单位:

收货单位:

请选择

消点击选择

货主与委托单位的区别?

请点击选择

重五

查询

删除

红色背景色的是处理失败的单据,请双击查者失败原因

单据号码

收驾单位

入出库日期

药品类型

配送单位

单指类型

文件名

发货单位

委托单位

中信测试21世纪制药厂北

生产入库

SYS_IN_2022021717230254626XML

SY5JNL2022021717230254626

2022-02-17

普通药品

京分公司7

京分公司

中信测试21世纪制药厂北

生产入库

普通药品

SY5_IN_2022021716193349629XML

SY5_IN_2022021716193349629

2022-02-17

京分公司7

中信测试21世纪制药厂北

普通药品

生产入串

SY5 IN 202202171520448700

SY5.IN_202202171520448700XML

2022-02-17

京分公司7

中信测试21世纪制药厂北

2022-02-08

普通药品

XIAOSHOU 20220208 003

销售出店

LUOJI测试企业11

XIAOSHOU_20220208 003XML

京分公司7

中信测试21世纪制药厂北

特殊药品制剂

采购入库

中信测试21世纪医院

DET_102 OUT_2022021142807695

2022-02-09

20220211142842390

京分公司7

中信测试21世纪制药厂北

普通药品

供应入库

DEF_107_OUT_2022021142618948

20220211142655069

LUOJ通试企业11

2022-02-10

京分公司7

中信测试21世纪制药厂北

2022-02-10

召回入库

DEF_108_OUT_20220210204114596

20220210203721872

999香港第一制药厂

京分公司7

（4）其它更多接口使用方法，请到

https://open.taobao.com/api.htm?docId=68503&docType=2&scopeId=30203

进行查看。

在进行接口调用时，出现的接口调用错误，请参考下面说明

https://qg6r2i.yuque.com/qg6r2i/csvggm/zv23fl?singleDoc#

《码上放心-接口错误说明指南》

（5）关于接口访问安全的设置（必须设置，不然后期接口将不允许访问）

为了防止接口被恶意调用，使用的开放平台调用的ISV及企业都应该进行接口安全调用的白名单设置（若为浮动IP请请勿设置，固定IP请必必须设置），设置页面如图：

个IP白名单是您用来调用API的服务器IP,设置后可以防止您的APPKEY被其他服务器盗用,

聚石塔云应用更多信息以及操作,请前往聚石塔中进行.立即前往

设置IP白名单会影响您的应用安全指数,查看更多

节大促API服务调整公告[12月5日

持.UT纯文本文件,请将每个IP换行分割

试企业码上放心接口

公告|2023年好价

203.119.241.126

IP白名单设置

47.100.21.242山

124220.81.219

5返回应用列表

+批量导入IP数据

8158张张

74.125.71.1

203.119.196.9血

聚石培

提交信息

6设管

手动添加

门文档

淘宝

缺陷列表

自动添加

+新增

仑首页

消息服务

仑云托管

手动添加

国财务

操作日志

开放平台

能力

2工具

59.82.**

用设置

2支持

表中心

对接

DK下载

开发

重置

203.119.*.*[

点击新增，输入您要添加的

地址（哪台机器需要访问接口，就设置哪台机器的

），点提交信息，完成设置。

被设置的

为访问接口的机器出口

（并不是机器的内网

），出口

可以通过百度查询如图：

查询ip

百度一下

Baidu百度

更多>

资讯

文库贴吧

采购

地图

知道

图片

视频

网页

百度为您找到相关结果约73,700,000个

了搜索工具

IP查询数据接口免费API接口调用-聚合数据

聚合教据专业的AP数据平台为您提供P查询数据接口以及调用信息无期限免费试用再付

升级.

https://www.juhe.cndocai.-度快照

P地址查询

北京市北京市阿里云

本机LIP:106.11.34.4

查询

请输入ip地址

本机IP查看方法IP地址设置方法

如果您的服务器不是

windows

可以通过：

curl

http://members.3322.org/dyndns/getip

进行查询，如下图：

5:242020from10.47.144.132

Lastlogin:wedMay1311:56:2420

welcometoaliyunElasticcomputeservice!

[tomcatemaster~scurlhttp://members.3322.og/yds/ge

112.124.1.165

tomcatamaster~1s

得到

后，请在

白名单设置中进行添加，若为浮动IP的企业可不设置或者设置为浮动的IP区间（如上图）106.11.*.*；

如果报下面图的错误，则将报错信息中的IP配到白名单中。如果IP后两位经常发生变化，后两位可以配置成*.*的方式，例如：203.119.*.*

响应:

Cory

ferrorresponse/code:11,msg:"nsufficientis

permissions'subcode:"isypermissi

I-whitelist-limit"'sub_msg:"The

appkey32122119isonl

owedtocallfromitsipwhitelist,butthesoucep

203.119.193.10

isnotincluded"rquestid":zap9ad67gf7"7

（6）平台提供如下测试企业

企业类型	名称	ref_ent_id	ent_id
生产企业	测试1生产企业	646d79e8e4b09d4f0095a831	646d79e8e4b09d4f0095a831
批发企业	香港测试107new	320000000000127970	c12db0d3fbc3401987d605b80f3b5e90
批发企业	中信测试批发企业001	320000000000141936	00000000000022959216
批发企业	测试入驻批发企业	64547b8de4b0cae8cc3f2f3f	64547b8de4b0cae8cc3f2f3f
零售药店	开心大药房(测试)	5f742dc2e4b009caa5b865f8	5f742dc2e4b009caa5b865f8

（7）平台提供如下测试用的追溯码

测试企业使用儿童.xml(7 KB)

测试企业使用五朵金花.xml(7 KB)

若有收获，就点个赞吧

健康一贴灵

医药行业、IT、ERP

码上放心-码上传接口开通指南（相关技术问题可进群咨询，钉钉群号：67685003096）

公告

搜索

常用链接

随笔分类

随笔档案

文章分类

阅读排行榜

评论排行榜

推荐排行榜

最新评论