阿里大于 -

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
tally_report_request	TallyReportSyncRequest	可选			仓理货报告回告请求
└ owner_code String 必须 AX766232 货主编码，必须 └ warehouse_code String 必须 STA 仓库编码，必须 └ entry_order_code String 必须 LBX02241014350021633 采购入库仓储作业单号，必须 └ tally_order_id String 必须 LBP50241014350091447 理货单号（服务商系统生成的理货单号）.注意：理货报告被淘天驳回后，重新回告理货报告，需要生成一个新的理货单号，必须 └ operate_time String 必须 2023-12-16 10:05:00 实际操作时间（YYYY-MM-DD HH:MM:SS）,对应所返回状态的实际操作时间 tally_order_lines ItemLineDTO [] 必须 [] 理货品明细（注意理货明细行需要以商品编码为颗粒度进行汇总，同一个商品编码不允许出现在多个明细行上），必须 └ item_code String 必须 758876623 商品编码，必须 └ item_name String 必须眼霜商品名称，必须 └ bar_code String 必须 6988282 条形码，必须 └ plan_quantity String 必须 100 商品数量，必须 └ normal_quantity String 必须 80 正品数量，必须 └ abnormal_quantity String 必须 10 残品数量，必须 batch_info BatchInfoDTO [] 可选 [] 理货明细批次信息 └ batch_id String 可选 BI1234 批次ID └ inventory_type String 可选 CC 库存类型 └ quantity String 可选 123 数量 └ secret_code String 可选 B5800C 暗码，用于解读效期的秘钥，字段格式为：字母+数字+字符（不能有空格） └ product_date String 可选 2024-12-11 生产日期 └ expire_date String 可选 2025-12-11 失效日期 └ abnormal_id String 可选 UN-20231215-28930685-1206517700 服务商侧异常单ID └ extend_props String 可选 xxxxx 扩展属性, Map对应的Json abnormal_lines AbnormalLineDTO [] 可选 [] 异常品明细 └ abnormal_id String 可选 UN-20231215-28930685-1206517700 异常ID（服务商系统生成） └ abnormal_type String 可选 907 异常类型 └ abnormal_remark String 可选残次异常说明 └ item_code String 可选 758876623 商品编码 └ item_name String 可选眼霜商品名称 └ inventory_type String 可选 CC 库存类型 └ qty String 可选 20 异常数量，必须 └ secret_code String 可选 B5800C 暗码，用于解读效期的秘钥，字段格式为：字母+数字+字符（不能有空格） └ img_urls String [] 可选 https://a.demo.com/a.jpg 图片或视频附件URL清单，有效期：1年 └ extend_props String 可选 xxxxx 扩展属性, Map对应的Json └ remark String 可选 xxxxx 备注 └ extend_props String 可选 xxxxx 扩展属性, Map对应的Json

名称	类型	示例值	描述
result	TallyReportSyncResponse		理货报告回告响应
└ success Boolean true 是否成功，true-成功; false-失败 └ error_code String ERROR_OWNER_NOT_EXIST 错误编码 └ error_message String 货主不存在错误描述 └ tally_order_code String TALLY20240601001 理货单号

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlihealthWmsTallyReportSyncRequest req = new AlibabaAlihealthWmsTallyReportSyncRequest();
AlibabaAlihealthWmsTallyReportSyncRequest.TallyReportSyncRequest obj1 = new AlibabaAlihealthWmsTallyReportSyncRequest.TallyReportSyncRequest();
obj1.setOwnerCode("AX766232");
obj1.setWarehouseCode("STA");
obj1.setEntryOrderCode("LBX02241014350021633");
obj1.setTallyOrderId("LBP50241014350091447");
obj1.setOperateTime("2023-12-16 10:05:00");
List<AlibabaAlihealthWmsTallyReportSyncRequest.ItemLineDTO> list3 = new ArrayList<AlibabaAlihealthWmsTallyReportSyncRequest.ItemLineDTO>();
AlibabaAlihealthWmsTallyReportSyncRequest.ItemLineDTO obj4 = new AlibabaAlihealthWmsTallyReportSyncRequest.ItemLineDTO();
list3.add(obj4);
obj4.setItemCode("758876623");
obj4.setItemName("眼霜");
obj4.setBarCode("6988282");
obj4.setPlanQuantity("100");
obj4.setNormalQuantity("80");
obj4.setAbnormalQuantity("10");
List<AlibabaAlihealthWmsTallyReportSyncRequest.BatchInfoDTO> list7 = new ArrayList<AlibabaAlihealthWmsTallyReportSyncRequest.BatchInfoDTO>();
AlibabaAlihealthWmsTallyReportSyncRequest.BatchInfoDTO obj8 = new AlibabaAlihealthWmsTallyReportSyncRequest.BatchInfoDTO();
list7.add(obj8);
obj8.setBatchId("BI1234");
obj8.setInventoryType("CC");
obj8.setQuantity("123");
obj8.setSecretCode("B5800C");
obj8.setProductDate("2024-12-11");
obj8.setExpireDate("2025-12-11");
obj8.setAbnormalId("UN-20231215-28930685-1206517700");
list5.setBatchInfo(list7);
obj4.setExtendProps("xxxxx");
obj1.setTallyOrderLines(list3);
List<AlibabaAlihealthWmsTallyReportSyncRequest.AbnormalLineDTO> list10 = new ArrayList<AlibabaAlihealthWmsTallyReportSyncRequest.AbnormalLineDTO>();
AlibabaAlihealthWmsTallyReportSyncRequest.AbnormalLineDTO obj11 = new AlibabaAlihealthWmsTallyReportSyncRequest.AbnormalLineDTO();
list10.add(obj11);
obj11.setAbnormalId("UN-20231215-28930685-1206517700");
obj11.setAbnormalType("907");
obj11.setAbnormalRemark("残次");
obj11.setItemCode("758876623");
obj11.setItemName("眼霜");
obj11.setInventoryType("CC");
obj11.setQty("20");
obj11.setSecretCode("B5800C");
obj11.setImgUrls("https://a.demo.com/a.jpg");
obj11.setExtendProps("xxxxx");
obj1.setAbnormalLines(list10);
obj1.setRemark("xxxxx");
obj1.setExtendProps("xxxxx");
req.setTallyReportRequest(obj1);
AlibabaAlihealthWmsTallyReportSyncResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAlihealthWmsTallyReportSyncRequest req = new AlibabaAlihealthWmsTallyReportSyncRequest();
AlibabaAlihealthWmsTallyReportSyncRequest.TallyReportSyncRequestDomain obj1 = new AlibabaAlihealthWmsTallyReportSyncRequest.TallyReportSyncRequestDomain();
obj1.OwnerCode = "AX766232";
obj1.WarehouseCode = "STA";
obj1.EntryOrderCode = "LBX02241014350021633";
obj1.TallyOrderId = "LBP50241014350091447";
obj1.OperateTime = "2023-12-16 10:05:00";
List<AlibabaAlihealthWmsTallyReportSyncRequest.ItemLineDTODomain> list3 = new List<AlibabaAlihealthWmsTallyReportSyncRequest.ItemLineDTODomain>();
AlibabaAlihealthWmsTallyReportSyncRequest.ItemLineDTODomain obj4 = new AlibabaAlihealthWmsTallyReportSyncRequest.ItemLineDTODomain();
list3.Add(obj4);
obj4.ItemCode = "758876623";
obj4.ItemName = "眼霜";
obj4.BarCode = "6988282";
obj4.PlanQuantity = "100";
obj4.NormalQuantity = "80";
obj4.AbnormalQuantity = "10";
List<AlibabaAlihealthWmsTallyReportSyncRequest.BatchInfoDTODomain> list6 = new List<AlibabaAlihealthWmsTallyReportSyncRequest.BatchInfoDTODomain>();
AlibabaAlihealthWmsTallyReportSyncRequest.BatchInfoDTODomain obj7 = new AlibabaAlihealthWmsTallyReportSyncRequest.BatchInfoDTODomain();
list6.Add(obj7);
obj7.BatchId = "BI1234";
obj7.InventoryType = "CC";
obj7.Quantity = "123";
obj7.SecretCode = "B5800C";
obj7.ProductDate = "2024-12-11";
obj7.ExpireDate = "2025-12-11";
obj7.AbnormalId = "UN-20231215-28930685-1206517700";
obj4.BatchInfo= list6;
obj4.ExtendProps = "xxxxx";
obj1.TallyOrderLines= list3;
List<AlibabaAlihealthWmsTallyReportSyncRequest.AbnormalLineDTODomain> list9 = new List<AlibabaAlihealthWmsTallyReportSyncRequest.AbnormalLineDTODomain>();
AlibabaAlihealthWmsTallyReportSyncRequest.AbnormalLineDTODomain obj10 = new AlibabaAlihealthWmsTallyReportSyncRequest.AbnormalLineDTODomain();
list9.Add(obj10);
obj10.AbnormalId = "UN-20231215-28930685-1206517700";
obj10.AbnormalType = "907";
obj10.AbnormalRemark = "残次";
obj10.ItemCode = "758876623";
obj10.ItemName = "眼霜";
obj10.InventoryType = "CC";
obj10.Qty = "20";
obj10.SecretCode = "B5800C";
obj10.ImgUrls = "https://a.demo.com/a.jpg";
obj10.ExtendProps = "xxxxx";
obj1.AbnormalLines= list9;
obj1.Remark = "xxxxx";
obj1.ExtendProps = "xxxxx";
req.TallyReportRequest_ = obj1;
AlibabaAlihealthWmsTallyReportSyncResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAlihealthWmsTallyReportSyncRequest;
$tally_report_request = new TallyReportSyncRequest;
$tally_report_request->owner_code="AX766232";
$tally_report_request->warehouse_code="STA";
$tally_report_request->entry_order_code="LBX02241014350021633";
$tally_report_request->tally_order_id="LBP50241014350091447";
$tally_report_request->operate_time="2023-12-16 10:05:00";
$tally_order_lines = new ItemLineDTO;
$tally_order_lines->item_code="758876623";
$tally_order_lines->item_name="眼霜";
$tally_order_lines->bar_code="6988282";
$tally_order_lines->plan_quantity="100";
$tally_order_lines->normal_quantity="80";
$tally_order_lines->abnormal_quantity="10";
$batch_info = new BatchInfoDTO;
$batch_info->batch_id="BI1234";
$batch_info->inventory_type="CC";
$batch_info->quantity="123";
$batch_info->secret_code="B5800C";
$batch_info->product_date="2024-12-11";
$batch_info->expire_date="2025-12-11";
$batch_info->abnormal_id="UN-20231215-28930685-1206517700";
$tally_order_lines->batch_info = $batch_info;
$tally_order_lines->extend_props="xxxxx";
$tally_report_request->tally_order_lines = $tally_order_lines;
$abnormal_lines = new AbnormalLineDTO;
$abnormal_lines->abnormal_id="UN-20231215-28930685-1206517700";
$abnormal_lines->abnormal_type="907";
$abnormal_lines->abnormal_remark="残次";
$abnormal_lines->item_code="758876623";
$abnormal_lines->item_name="眼霜";
$abnormal_lines->inventory_type="CC";
$abnormal_lines->qty="20";
$abnormal_lines->secret_code="B5800C";
$abnormal_lines->img_urls="https://a.demo.com/a.jpg";
$abnormal_lines->extend_props="xxxxx";
$tally_report_request->abnormal_lines = $abnormal_lines;
$tally_report_request->remark="xxxxx";
$tally_report_request->extend_props="xxxxx";
$req->setTallyReportRequest(json_encode($tally_report_request));
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.alihealth.wms.tally.report.sync' \
-d 'partner_id=apidoc' \
-d 'sign=263B211B0E97A835E831D3C9F46FCF2F' \
-d 'sign_method=hmac' \
-d 'timestamp=2026-09-10+03%3A21%3A19' \
-d 'v=2.0' \
-d 'tally_report_request=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlibabaAlihealthWmsTallyReportSyncRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.tally_report_request=""
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.alihealth.wms.tally.report.sync");
add_param(pRequest,"tally_report_request","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'url': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.alihealth.wms.tally.report.sync', {
	'tally_report_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_alihealth_wms_tally_report_sync_response>
    <result>
        <success>true</success>
        <error_code>ERROR_OWNER_NOT_EXIST</error_code>
        <error_message>货主不存在</error_message>
        <tally_order_code>TALLY20240601001</tally_order_code>
    </result>
</alibaba_alihealth_wms_tally_report_sync_response>

{
    "alibaba_alihealth_wms_tally_report_sync_response":{
        "result":{
            "success":true,
            "error_code":"ERROR_OWNER_NOT_EXIST",
            "error_message":"货主不存在",
            "tally_order_code":"TALLY20240601001"
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

阿里健康API

alibaba.alihealth.wms.tally.report.sync (理货报告回告)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ