文档中心 > API类目 > 信息平台-采购

alibaba.jincai.rcv.rt.query (金采供应商接收单查询接口)

金采供应商接收单查询:按单号/PO号/时间范围查询当前appKey供应商的接收单及行明细

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
po_numbers String 可选 ["PO200048858"] 采购订单号集合(按行bizCode匹配)
approval_finish_start_time Date 可选 2021-05-18 10:38:05 接收审批完成时间范围始
approval_finishl_end_time Date 可选 2021-05-18 10:38:05 接收审批完成时间范围终

响应参数

名称 类型 示例值 描述
contents SupplierRcvHeaderDto [] 1 供应商接收单列表
  • └ id
  • Number
  • 1
  • 接收单头ID
  • └ gmt_create
  • Date
  • 2026-09-01 10:00:00
  • 创建时间
  • └ gmt_modified
  • Date
  • 2026-09-01 10:00:00
  • 修改时间
  • └ creator
  • String
  • 10086
  • 创建人工号
  • └ tenant_id
  • String
  • example
  • 租户ID(域外恒空)
  • └ remark
  • String
  • 备注示例
  • 备注
  • └ parent_rsh_id
  • Number
  • 5000000
  • 父接收单ID
  • └ rcv_type
  • String
  • RECEIVE
  • 接收类型(RECEIVE/RETURN,本接口恒RECEIVE)
  • └ delivery_id
  • Number
  • 6000001
  • 关联发货单ID
  • └ supplier_id
  • Number
  • 7000001
  • 供应商ID
  • └ rcv_number
  • String
  • RT2026090900001
  • 接收单号
  • rcv_shipment_items
  • SupplierRcvItemDto []
  • 1
  • 接收行列表
  • └ id
  • Number
  • 1
  • 接收行ID
  • └ gmt_create
  • Date
  • 2026-09-01 10:00:00
  • 创建时间
  • └ gmt_modified
  • Date
  • 2026-09-01 10:00:00
  • 修改时间
  • └ creator
  • String
  • 10086
  • 创建人工号
  • └ tenant_id
  • String
  • example
  • 租户ID(域外恒空)
  • └ receiver
  • String
  • 王五
  • 接收人工号
  • └ rcv_date
  • Date
  • 2026-09-01 10:00:00
  • 接收日期
  • └ status
  • String
  • processing
  • 行状态
  • └ biz_code
  • String
  • PO2026090900001
  • 业务单号(PO号)
  • └ rcv_shipment_id
  • Number
  • 5000001
  • 所属接收单头ID
  • └ delivery_item_id
  • Number
  • 6000001
  • 关联发货行ID
  • └ purchase_org_id
  • Number
  • 9000001
  • 采购组织ID
  • └ quantity_received
  • String
  • 10
  • 已接收数量(字符串化,null→"null")
  • └ quantity_accept
  • String
  • 10
  • 验收数量(字符串化)
  • └ deductions_amount
  • String
  • 0.00
  • 扣款金额(字符串化)
  • └ unit_price
  • String
  • 100.0000
  • 单价(字符串化)
  • └ tax_rate
  • String
  • 13
  • 税率(字符串化)
  • └ currency_code
  • String
  • CNY
  • 币种
  • └ company_code
  • String
  • ALIBABA
  • 公司编码
  • └ category_use
  • String
  • 生产用料
  • 品类用途
  • └ category_code
  • String
  • C001
  • 品类编码
  • └ order_type
  • String
  • STANDARD
  • 订单类型
  • └ uom
  • String
  • 个
  • 计量单位
  • └ is_delivery_by_detail
  • Boolean
  • true
  • 是否按明细收货
  • └ is_detail_by_asset_management
  • Boolean
  • false
  • 是否按资产管理明细
  • └ tax_code
  • String
  • TAX001
  • 税码
  • └ item_id
  • String
  • ITEM0001
  • 物料ID
  • └ evaluate_month_start
  • Date
  • 2026-09-01
  • 考核月份开始
  • └ evaluate_month_end
  • Date
  • 2026-09-30
  • 考核月份结束
  • └ parent_rsh_id
  • Number
  • 5000000
  • 父接收行ID
  • └ remark
  • String
  • 备注示例
  • 备注
  • └ biz_id
  • String
  • BIZ2026090900001
  • 业务单据ID
  • └ biz_type
  • String
  • PO
  • 业务类型
  • └ demander
  • String
  • 10088
  • 需求方工号
  • └ gmt_approval_finish
  • Date
  • 2026-09-02 10:00:00
  • 审批完成时间(域外恒空)
  • └ item_ext
  • String
  • {}
  • 行扩展信息(域外恒空)
  • └ expense_month
  • Date
  • 2026-09-01
  • 费用月份(域外恒空)
  • └ is_structure_item_aap
  • Boolean
  • false
  • 是否结构化明细AAP(域外恒空)
  • └ line_num
  • Number
  • 1
  • 行号
  • attachments
  • SupplierAttachmentDto []
  • 1
  • 附件列表(电子发票/验收材料)
  • └ type
  • String
  • rcvInvoiceFile
  • 文件类型(rcvInvoiceFile/acceptanceMaterials)
  • └ object_key
  • String
  • jincai/rcv/2026/09/invoice.pdf
  • OSS objectKey(下载三元组)
  • └ file_name
  • String
  • 发票.pdf
  • 文件名
  • └ file_size
  • Number
  • 102400
  • 文件大小(字节)
  • └ content_type
  • String
  • application/pdf
  • 内容类型
  • └ uploader_name
  • String
  • 赵六
  • 上传人展示名
  • └ upload_time
  • String
  • 2026-09-01 10:00:00
  • 上传时间(yyyy-MM-dd HH:mm:ss)
  • └ tax_amount
  • String
  • 130.00
  • 含税金额(字符串化)
  • └ rcv_date
  • Date
  • 2026-09-01 10:00:00
  • 接收日期(取gmt_create)
  • └ is_ceres
  • Boolean
  • false
  • 是否CERES(域外恒空)
  • └ source_type
  • String
  • YUNCAI
  • 来源类型
  • └ ext
  • String
  • {}
  • 头扩展信息
  • └ approval_end_time
  • Date
  • 2026-09-02 10:00:00
  • 审批结束时间
  • └ kp_number
  • String
  • KP2026090001
  • KP编号(域外恒空)

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaJincaiRcvRtQueryRequest req = new AlibabaJincaiRcvRtQueryRequest();
req.setPoNumbers("[\"PO200048858\"]");
req.setApprovalFinishStartTime(StringUtils.parseDateTime("2021-05-18 10:38:05"));
req.setApprovalFinishlEndTime(StringUtils.parseDateTime("2021-05-18 10:38:05"));
AlibabaJincaiRcvRtQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_jincai_rcv_rt_query_response>
    <contents>
        <supplier_rcv_header_dto>
            <id>1</id>
            <gmt_create>2026-09-01 10:00:00</gmt_create>
            <gmt_modified>2026-09-01 10:00:00</gmt_modified>
            <creator>10086</creator>
            <tenant_id>example</tenant_id>
            <remark>备注示例</remark>
            <parent_rsh_id>5000000</parent_rsh_id>
            <rcv_type>RECEIVE</rcv_type>
            <delivery_id>6000001</delivery_id>
            <supplier_id>7000001</supplier_id>
            <rcv_number>RT2026090900001</rcv_number>
            <rcv_shipment_items>
                <supplier_rcv_item_dto>
                    <id>1</id>
                    <gmt_create>2026-09-01 10:00:00</gmt_create>
                    <gmt_modified>2026-09-01 10:00:00</gmt_modified>
                    <creator>10086</creator>
                    <tenant_id>example</tenant_id>
                    <receiver>王五</receiver>
                    <rcv_date>2026-09-01 10:00:00</rcv_date>
                    <status>processing</status>
                    <biz_code>PO2026090900001</biz_code>
                    <rcv_shipment_id>5000001</rcv_shipment_id>
                    <delivery_item_id>6000001</delivery_item_id>
                    <purchase_org_id>9000001</purchase_org_id>
                    <quantity_received>10</quantity_received>
                    <quantity_accept>10</quantity_accept>
                    <deductions_amount>0.00</deductions_amount>
                    <unit_price>100.0000</unit_price>
                    <tax_rate>13</tax_rate>
                    <currency_code>CNY</currency_code>
                    <company_code>ALIBABA</company_code>
                    <category_use>生产用料</category_use>
                    <category_code>C001</category_code>
                    <order_type>STANDARD</order_type>
                    <uom>个</uom>
                    <is_delivery_by_detail>true</is_delivery_by_detail>
                    <is_detail_by_asset_management>false</is_detail_by_asset_management>
                    <tax_code>TAX001</tax_code>
                    <item_id>ITEM0001</item_id>
                    <evaluate_month_start>2026-09-01</evaluate_month_start>
                    <evaluate_month_end>2026-09-30</evaluate_month_end>
                    <parent_rsh_id>5000000</parent_rsh_id>
                    <remark>备注示例</remark>
                    <biz_id>BIZ2026090900001</biz_id>
                    <biz_type>PO</biz_type>
                    <demander>10088</demander>
                    <gmt_approval_finish>2026-09-02 10:00:00</gmt_approval_finish>
                    <item_ext>{}</item_ext>
                    <expense_month>2026-09-01</expense_month>
                    <is_structure_item_aap>false</is_structure_item_aap>
                    <line_num>1</line_num>
                    <attachments>
                        <supplier_attachment_dto>
                            <type>rcvInvoiceFile</type>
                            <object_key>jincai/rcv/2026/09/invoice.pdf</object_key>
                            <file_name>发票.pdf</file_name>
                            <file_size>102400</file_size>
                            <content_type>application/pdf</content_type>
                            <uploader_name>赵六</uploader_name>
                            <upload_time>2026-09-01 10:00:00</upload_time>
                        </supplier_attachment_dto>
                    </attachments>
                    <tax_amount>130.00</tax_amount>
                </supplier_rcv_item_dto>
            </rcv_shipment_items>
            <rcv_date>2026-09-01 10:00:00</rcv_date>
            <is_ceres>false</is_ceres>
            <source_type>YUNCAI</source_type>
            <ext>{}</ext>
            <approval_end_time>2026-09-02 10:00:00</approval_end_time>
            <kp_number>KP2026090001</kp_number>
        </supplier_rcv_header_dto>
    </contents>
</alibaba_jincai_rcv_rt_query_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

返回
顶部