文档中心 > API类目 > AIS基石API

alibaba.ais.component.customer.po.post (部件PO)

整机厂家基于阿里巴巴“部件下单指令”,下发PO给对应供应商(B&S就是阿里,AVAP是对应部件厂商),及时获得部件供应; B&S订单,必须回填阿里已提供的PO,阿里PO line;并与阿里巴巴要求采购的信息完全一致,否则阿里会报错,要求贵公司重新下发采购单; AVAP 订单,必须回填阿里提供的指令、指令行号及其他必填信息;

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param0 CustomerPoDto 可选 部件PO
  • └ purchase_way
  • String
  • 可选
  • 1
  • 采购方式 1:B&S;2:AVAP
  • └ directive_number
  • String
  • 可选
  • DT0000000001
  • 指令号(全局唯一),DT开头,后面10位数字
  • └ brand
  • String
  • 可选
  • intel
  • 采购品牌 Intel、Samsung
  • customer_p_o_line_list
  • CustomerPoLinesDto []
  • 可选
  • 客户PO行JSON数组
  • └ expected_time_departure
  • Date
  • 可选
  • 2017-05-20 00:00:00
  • 期望发货日(ETD),格式"yyyyMMdd"
  • └ spec
  • String
  • 可选
  • 5554
  • 规格
  • └ unit
  • String
  • 可选
  • PCS
  • 度量单位
  • └ directive_line_number
  • String
  • 可选
  • 1
  • 指令行号,从1开始递增
  • └ customer_po_line_number
  • String
  • 可选
  • 1
  • 客户PO行,从1开始递增
  • └ customer_po_number
  • String
  • 可选
  • 供应商自己定义
  • 客户PO
  • └ actual_time_order
  • Date
  • 可选
  • 2017-05-20 00:00:00
  • 实际下单日,格式"yyyyMMdd" (AVAP时必填)
  • └ ali_po
  • String
  • 可选
  • PO12345678
  • 阿里PO,PO开头,8位数字(B&S时必填)
  • └ quantity
  • Number
  • 可选
  • 200
  • 数量
  • └ mpn
  • String
  • 可选
  • IXX1234567
  • MPN
  • └ component_category
  • String
  • 可选
  • SSD
  • 部件类别
  • └ ali_po_line
  • String
  • 可选
  • 1
  • 阿里PO行号,从1开始递增(B&S时必填)
  • └ expected_time_arrival
  • Date
  • 可选
  • 2017-06-20 00:00:00
  • 期望到货日(ETA),格式"yyyyMMdd"
  • └ business_ext
  • String
  • 可选
  • {"price":"1.01"}
  • 业务扩展属性,用于额外属性传递。无数据不用传递,有参数时需要按照JSON的格式传递,格式参考实例

响应参数

名称 类型 示例值 描述
result BaseResDto result
  • └ err_msg
  • String
  • 某某错误描述
  • errMsg
  • └ err_code
  • String
  • 00000000
  • errCode
  • └ is_success
  • Boolean
  • true
  • success

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAisComponentCustomerPoPostRequest req = new AlibabaAisComponentCustomerPoPostRequest();
AlibabaAisComponentCustomerPoPostRequest.CustomerPoDto obj1 = new AlibabaAisComponentCustomerPoPostRequest.CustomerPoDto();
obj1.setPurchaseWay("1");
obj1.setDirectiveNumber("DT0000000001");
obj1.setBrand("intel");
List<AlibabaAisComponentCustomerPoPostRequest.CustomerPoLinesDto> list3 = new ArrayList<AlibabaAisComponentCustomerPoPostRequest.CustomerPoLinesDto>();
AlibabaAisComponentCustomerPoPostRequest.CustomerPoLinesDto obj4 = new AlibabaAisComponentCustomerPoPostRequest.CustomerPoLinesDto();
list3.add(obj4);
obj4.setExpectedTimeDeparture(StringUtils.parseDateTime("2017-05-20 00:00:00"));
obj4.setSpec("5554");
obj4.setUnit("PCS");
obj4.setDirectiveLineNumber("1");
obj4.setCustomerPoLineNumber("1");
obj4.setCustomerPoNumber("供应商自己定义");
obj4.setActualTimeOrder(StringUtils.parseDateTime("2017-05-20 00:00:00"));
obj4.setAliPo("PO12345678");
obj4.setQuantity(200L);
obj4.setMpn("IXX1234567");
obj4.setComponentCategory("SSD");
obj4.setAliPoLine("1");
obj4.setExpectedTimeArrival(StringUtils.parseDateTime("2017-06-20 00:00:00"));
obj4.setBusinessExt("{\"price\":\"1.01\"}");
obj1.setCustomerPOLineList(list3);
req.setParam0(obj1);
AlibabaAisComponentCustomerPoPostResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_ais_component_customer_po_post_response>
    <result>
        <err_msg>某某错误描述</err_msg>
        <err_code>00000000</err_code>
        <is_success>true</is_success>
    </result>
</alibaba_ais_component_customer_po_post_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部