open-api
首页
open-api
  • 快速开始
  • 授权登录
  • 客户
  • 销售订单
  • 采购订单
  • 产品
  • 回款登记
  • 回款单
  • 付款单
  • 费用单
  • 报价单
  • 供应商
  • 商机
  • 用户
  • 销售出库单
  • 库存
  • 线索
  • 资金
  • 采购入库单
  • 采购退货单
    • 采购退货单
    • 采购退货单-列表GET
    • 采购退货单-详情GET
    • 采购退货单字段GET
    • 采购退货单-新建/编辑POST
    • 采购退货单-删除POST
  • 统计分析
  • 示例接口(勿用)
  • 阿里账号信息GET
  • 阿里资金账户信息GET
亮色模式
  1. 采购退货单

采购退货单字段

GET/v1/invoices/purchaseReturn/fields

字段类型有哪些

field_type
1 单行文本
2 多行文本
3 单选,在该字段选项枚举值在返回值中的ext_info里面,可用于单据新建、编辑该字段传值
4 日期,YYYY-MM-DD
5 数字
6 图片
7 多选,在该字段选项枚举值在返回值中的ext_info里面,可用于单据新建、编辑该字段传值
8 附件
9 关联字段
10 日期时间,YYYY-MM-DD HH:mm:ss
11 公式
12 汇总
13 布尔
17 状态
18 阶段
21 时间范围
22 富文本
23 引用

若发现没有的字段类型可以咨询对接群,或者提客户工单。

请求参数

无

示例代码

返回响应

成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
code
integer 
必需
message
string 
必需
now
string 
必需
data
array [object {9}] 
必需
id
string  | integer 
字段ID
必需
name
string 
字段名称
必需
base
integer 
必需

是否系统字段,1=系统字段,0=自定义字段

field_type
integer 
字段类型
必需
ext_info
array[string] | null 
必需

选字段额外信息,比如选项等枚举值

require
integer 
必需

是否必填,1=必填,0=非必填

default
string 
默认值
必需
disable_flag
integer 
必需
is_list
integer 
是否明细字段
必需
示例
{
  "code": 200,
  "message": "success",
  "now": "2025-03-14 15:43:12",
  "data": [
    {
      "id": "product_model",
      "name": "产品型号",
      "base": 1,
      "field_type": 1,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "handler",
      "name": "处理人",
      "base": 1,
      "field_type": 1,
      "ext_info": null,
      "require": 1,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "product_amount",
      "name": "产品金额",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 1,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "product_total_amount",
      "name": "产品总金额",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 1,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "return_count",
      "name": "退货数量",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 1,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "discount",
      "name": "整单折扣额",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "return_price",
      "name": "退货单价",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 1,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "discount_rate",
      "name": "整单折扣率",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 1,
      "is_list": 0
    },
    {
      "id": "moment_enable_count",
      "name": "可用库存",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "inbound_count",
      "name": "入库数量",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "invoice_warehouse_id",
      "name": "仓库",
      "base": 1,
      "field_type": 3,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "inbound_serial_id",
      "name": "关联采购入库单号",
      "base": 1,
      "field_type": 1,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "remark",
      "name": "退货备注",
      "base": 1,
      "field_type": 2,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "product_unit",
      "name": "单位",
      "base": 1,
      "field_type": 3,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "warehouse_invoice_time",
      "name": "退货日期",
      "base": 1,
      "field_type": 4,
      "ext_info": null,
      "require": 1,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "status",
      "name": "退货状态",
      "base": 1,
      "field_type": 3,
      "ext_info": null,
      "require": 1,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "sku_attributes",
      "name": "规格",
      "base": 1,
      "field_type": 1,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "supplier_id",
      "name": "供应商",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 1,
      "is_list": 0
    },
    {
      "id": "supplier_no",
      "name": "供应商编号",
      "base": 1,
      "field_type": 1,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "sku_code",
      "name": "产品编号",
      "base": 1,
      "field_type": 1,
      "ext_info": null,
      "require": 1,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "serial_id",
      "name": "采购退货单号",
      "base": 1,
      "field_type": 1,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "product_cn_name",
      "name": "中文产品名称",
      "base": 1,
      "field_type": 1,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "product_name",
      "name": "产品名称",
      "base": 1,
      "field_type": 1,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "product_image",
      "name": "产品图片",
      "base": 1,
      "field_type": 6,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "product_disable_flag",
      "name": "产品是否停售",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 1,
      "is_list": 1
    },
    {
      "id": "warehouse_id",
      "name": "出入库明细-仓库",
      "base": 1,
      "field_type": 3,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 1,
      "is_list": 1
    },
    {
      "id": "sku_id",
      "name": "sku",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 1,
      "is_list": 1
    },
    {
      "id": "product_id",
      "name": "产品id",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 1,
      "is_list": 1
    },
    {
      "id": "inbound_invoice_id",
      "name": "关联采购入库单ID",
      "base": 1,
      "field_type": 1,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 1,
      "is_list": 1
    },
    {
      "id": "update_user",
      "name": "修改人",
      "base": 1,
      "field_type": 1,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "update_time",
      "name": "修改时间",
      "base": 1,
      "field_type": 10,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "create_user",
      "name": "创建人",
      "base": 1,
      "field_type": 1,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "create_time",
      "name": "创建时间",
      "base": 1,
      "field_type": 10,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "attachment",
      "name": "附件",
      "base": 1,
      "field_type": 8,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "product_total_amount_usd",
      "name": "产品总金额(USD)",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "product_total_amount_rmb",
      "name": "产品总金额(CNY)",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "exchange_rate_usd",
      "name": "汇率(兑USD)",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 1,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "exchange_rate",
      "name": "汇率(兑CNY)",
      "base": 1,
      "field_type": 5,
      "ext_info": null,
      "require": 1,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "currency",
      "name": "币种",
      "base": 1,
      "field_type": 3,
      "ext_info": null,
      "require": 1,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": 3580648905,
      "name": "455",
      "base": 0,
      "field_type": 1,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "3159980713",
      "name": "多行文本",
      "base": 0,
      "field_type": 2,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "3159957925",
      "name": "图片-自定义",
      "base": 0,
      "field_type": 6,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "3159957937",
      "name": "明细-图片",
      "base": 0,
      "field_type": 6,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "3159957920",
      "name": "附件-自定义",
      "base": 0,
      "field_type": 8,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "3159957935",
      "name": "明细-数值",
      "base": 0,
      "field_type": 5,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "3159957918",
      "name": "数值",
      "base": 0,
      "field_type": 5,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "3159957933",
      "name": "明细-日期",
      "base": 0,
      "field_type": 4,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "3159957916",
      "name": "日期",
      "base": 0,
      "field_type": 4,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "3159957929",
      "name": "明细-下拉多选",
      "base": 0,
      "field_type": 7,
      "ext_info": [
        "M123",
        "S2938",
        "K283"
      ],
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "3159957913",
      "name": "下拉多选",
      "base": 0,
      "field_type": 7,
      "ext_info": [
        "皮卡",
        "轮船",
        "火车"
      ],
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": 3468697736,
      "name": "0104的退货明细",
      "base": 0,
      "field_type": 5,
      "ext_info": null,
      "require": 1,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "3159957911",
      "name": "下拉单选",
      "base": 0,
      "field_type": 3,
      "ext_info": [
        "蓝色",
        "红色",
        "绿色",
        "黑色"
      ],
      "require": 0,
      "default": "蓝色",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "3118099731",
      "name": "采购退货下拉单选",
      "base": 0,
      "field_type": 3,
      "ext_info": [
        "7天无理由退货",
        "不喜欢",
        "地址不对"
      ],
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "3113203061",
      "name": "退货原因",
      "base": 0,
      "field_type": 3,
      "ext_info": [
        "不喜欢",
        "7天无理由",
        "尺码不合适"
      ],
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": "3118099725",
      "name": "采购退货",
      "base": 0,
      "field_type": 1,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 1
    },
    {
      "id": "3113188749",
      "name": "文本框",
      "base": 0,
      "field_type": 1,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    },
    {
      "id": 3468718108,
      "name": "0104新增多行文本",
      "base": 0,
      "field_type": 2,
      "ext_info": null,
      "require": 0,
      "default": "",
      "disable_flag": 0,
      "is_list": 0
    }
  ]
}
最后修改时间: 2 个月前