淘宝开放平台

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
param_factory_process_goods_batch_report_request	FactoryProcessGoodsBatchReportRequest	可选			生产工序关键物料SN上报参数
goods FactoryProcessGoods [] 可选关键物料信息 └ acceptance_order_number String 可选 SO00001 工厂承接锚链PO单号 └ category_code String 可选 QIJIAN 类目编码 └ ext_info String 可选 {} 拓展信息 └ factory_code String 可选 TD000001 锚链工厂编码 └ factory_material_number String 可选 QE1223 工厂关键物料编码 └ factory_name String 可选 XX一厂锚链工厂名称 └ gsc_material_number String 可选 PE00000D 关键物料对应锚链二级物料编码 └ gsc_po_line_number String 可选 1 锚链PO行号 └ gsc_po_number String 可选 PO202400001 锚链PO machine FactoryProcessGoods 可选关键物料对应的整机信息 └ ext_info String 可选 {} 拓展信息 └ factory_material_number String 可选 QD00001 工厂物料编码 └ gsc_material_number String 可选 ACXX0001 锚链物料编码 └ material_name String 可选方糖3 整机名称 └ sn String 可选 111111111111111111111 整机SN └ material_name String 可选主板关键物料名称 └ pl_code String 可选 CX00001 生产线编码 └ process_code String 可选 ZBZP 工序编码 └ process_name String 可选主板装配工序名称 └ production_plan_number String 可选 PL0000001 工厂生产计划单号 └ pwo_number String 可选 SC00001 工厂生产工单号 └ sn String 可选 QE99977 工序关键物料SN └ supplier_code String 可选 SP00001 锚链供应商编码 └ supplier_name String 可选 XX有限公司锚链供应商名称 └ tenant String 可选 ailab 租户

名称	类型	示例值	描述
result	DataResult		请求响应
└ code String 00000 响应编码 └ msg String 请求成功请求处理信息 └ success String true 请求是否处理成功 └ total Number 0 分页总条数 └ trace_id Number 11111 请求traceId

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAilabFactoryProcessGoodsReportRequest req = new AlibabaAilabFactoryProcessGoodsReportRequest();
AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoodsBatchReportRequest obj1 = new AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoodsBatchReportRequest();
List<AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoods> list3 = new ArrayList<AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoods>();
AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoods obj4 = new AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoods();
list3.add(obj4);
obj4.setAcceptanceOrderNumber("SO00001");
obj4.setCategoryCode("QIJIAN");
obj4.setExtInfo("{}");
obj4.setFactoryCode("TD000001");
obj4.setFactoryMaterialNumber("QE1223");
obj4.setFactoryName("XX一厂");
obj4.setGscMaterialNumber("PE00000D");
obj4.setGscPoLineNumber("1");
obj4.setGscPoNumber("PO202400001");
AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoods obj6 = new AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoods();
obj6.setExtInfo("{}");
obj6.setFactoryMaterialNumber("QD00001");
obj6.setGscMaterialNumber("ACXX0001");
obj6.setMaterialName("方糖3");
obj6.setSn("111111111111111111111");
list5.setMachine(obj6);
obj4.setMaterialName("主板");
obj4.setPlCode("CX00001");
obj4.setProcessCode("ZBZP");
obj4.setProcessName("主板装配");
obj4.setProductionPlanNumber("PL0000001");
obj4.setPwoNumber("SC00001");
obj4.setSn("QE99977");
obj4.setSupplierCode("SP00001");
obj4.setSupplierName("XX有限公司");
obj4.setTenant("ailab");
obj1.setGoods(list3);
req.setParamFactoryProcessGoodsBatchReportRequest(obj1);
AlibabaAilabFactoryProcessGoodsReportResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAilabFactoryProcessGoodsReportRequest req = new AlibabaAilabFactoryProcessGoodsReportRequest();
AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoodsBatchReportRequestDomain obj1 = new AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoodsBatchReportRequestDomain();
List<AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoodsDomain> list3 = new List<AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoodsDomain>();
AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoodsDomain obj4 = new AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoodsDomain();
list3.Add(obj4);
obj4.AcceptanceOrderNumber = "SO00001";
obj4.CategoryCode = "QIJIAN";
obj4.ExtInfo = "{}";
obj4.FactoryCode = "TD000001";
obj4.FactoryMaterialNumber = "QE1223";
obj4.FactoryName = "XX一厂";
obj4.GscMaterialNumber = "PE00000D";
obj4.GscPoLineNumber = "1";
obj4.GscPoNumber = "PO202400001";
AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoodsDomain obj5 = new AlibabaAilabFactoryProcessGoodsReportRequest.FactoryProcessGoodsDomain();
obj5.ExtInfo = "{}";
obj5.FactoryMaterialNumber = "QD00001";
obj5.GscMaterialNumber = "ACXX0001";
obj5.MaterialName = "方糖3";
obj5.Sn = "111111111111111111111";
obj4.Machine= obj5;
obj4.MaterialName = "主板";
obj4.PlCode = "CX00001";
obj4.ProcessCode = "ZBZP";
obj4.ProcessName = "主板装配";
obj4.ProductionPlanNumber = "PL0000001";
obj4.PwoNumber = "SC00001";
obj4.Sn = "QE99977";
obj4.SupplierCode = "SP00001";
obj4.SupplierName = "XX有限公司";
obj4.Tenant = "ailab";
obj1.Goods= list3;
req.ParamFactoryProcessGoodsBatchReportRequest_ = obj1;
AlibabaAilabFactoryProcessGoodsReportResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAilabFactoryProcessGoodsReportRequest;
$param_factory_process_goods_batch_report_request = new FactoryProcessGoodsBatchReportRequest;
$goods = new FactoryProcessGoods;
$goods->acceptance_order_number="SO00001";
$goods->category_code="QIJIAN";
$goods->ext_info="{}";
$goods->factory_code="TD000001";
$goods->factory_material_number="QE1223";
$goods->factory_name="XX一厂";
$goods->gsc_material_number="PE00000D";
$goods->gsc_po_line_number="1";
$goods->gsc_po_number="PO202400001";
$machine = new FactoryProcessGoods;
$machine->ext_info="{}";
$machine->factory_material_number="QD00001";
$machine->gsc_material_number="ACXX0001";
$machine->material_name="方糖3";
$machine->sn="111111111111111111111";
$goods->machine = $machine;
$goods->material_name="主板";
$goods->pl_code="CX00001";
$goods->process_code="ZBZP";
$goods->process_name="主板装配";
$goods->production_plan_number="PL0000001";
$goods->pwo_number="SC00001";
$goods->sn="QE99977";
$goods->supplier_code="SP00001";
$goods->supplier_name="XX有限公司";
$goods->tenant="ailab";
$param_factory_process_goods_batch_report_request->goods = $goods;
$req->setParamFactoryProcessGoodsBatchReportRequest(json_encode($param_factory_process_goods_batch_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.ailab.factory.process.goods.report' \
-d 'partner_id=apidoc' \
-d 'sign=6C7FF0D0FB2D1790D36FF8EB380B9C26' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-07-06+11%3A14%3A53' \
-d 'v=2.0' \
-d 'param_factory_process_goods_batch_report_request=null'

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

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

req.param_factory_process_goods_batch_report_request="数据结构示例JSON格式"
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.ailab.factory.process.goods.report");
add_param(pRequest,"param_factory_process_goods_batch_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',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.ailab.factory.process.goods.report', {
	'param_factory_process_goods_batch_report_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_ailab_factory_process_goods_report_response>
    <result>
        <code>00000</code>
        <msg>请求成功</msg>
        <success>true</success>
        <total>0</total>
        <trace_id>11111</trace_id>
    </result>
</alibaba_ailab_factory_process_goods_report_response>

{
    "alibaba_ailab_factory_process_goods_report_response":{
        "result":{
            "code":"00000",
            "msg":"请求成功",
            "success":"true",
            "total":0,
            "trace_id":11111
        }
    }
}

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下载

天猫精灵供应链数字工厂

alibaba.ailab.factory.process.goods.report (工厂生产工序节点SN信息上报)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ