简要描述:

  • 报价单列表

请求URL:

  • /api/v2/quotations

请求方式:

  • GET

请求头:

请求参数:

字段名 是否必填 描述
page false 页码
per_page false 每页的数量
custom_field_name false 搜索字段名称,支持自定义字段,配合query使用。
query false 搜索关键字
creator_id false 创建人筛选
user_id false 负责人筛选
department_id false 部门筛选
customer_id false 客户id筛选
contact_id false 联系人id筛选
opportunity_id false 商机id筛选
approve_status false 审批状态筛选
sort false 排序类型(created_at )
order false 排序方式(asc desc)

返回示例:

正确时返回:

{
    "code": 0,
    "data": {
        "list": [
            {
                "id": 901935,
                "user_is_self": false,
                "is_creator_self": false,
                "customer_id": 723631426, // 客户id
                "contact_id": null,// 联系人id
                "opportunity_id": 11098391, //商机id
                "custom_field_template_id": 22424,
                "approve_status": "applying",  //审批状态
                "address.contact.id": null,
                "quotation_date": null, //报价日期
                "name": "6666",//报价单名称
                "name_unedit": true,
                "quotation_no": null, //报价单编号
                "quotation_no_unedit": true,
                "customer.name": "就快了看见了",
                "customer.name_unedit": true,
                "total_amount": "33.0", //报价总金额
                "total_amount_unedit": true,
                "status_mapped": null, //报价单状态
                "status_mapped_unedit": true,
                "custom_field_template.name": "业务类型1",
                "custom_field_template.name_unedit": true
            }
        ],
        "user_config_columns": [
            {
                "name": "name",
                "label": "报价单名称",
                "origin_label": "报价单名称",
                "field_type": "text_field",
                "default": true,
                "link": true,
                "link_target": "_blank",
                "is_user_custom_column": "system_column",
                "is_app_user_custom_column": "system_column",
                "visible": true
            },
            {
                "name": "quotation_no",
                "label": "报价单编号",
                "origin_label": "报价单编号",
                "field_type": "text_field",
                "default": true,
                "is_user_custom_column": "system_column",
                "is_app_user_custom_column": "default_column",
                "visible": true
            },
            {
                "name": "customer.name",
                "label": "对应客户",
                "origin_label": "对应客户",
                "field_type": "select2_field",
                "default": true,
                "value_format": "link",
                "is_user_custom_column": "system_column",
                "is_app_user_custom_column": "default_column",
                "visible": true
            },
            {
                "name": "total_amount",
                "label": "报价总金额1-1万",
                "origin_label": "报价总金额",
                "field_type": "currency_field",
                "value_format": "currency",
                "default": true,
                "is_user_custom_column": "system_column",
                "is_app_user_custom_column": "default_column",
                "visible": true
            },
            {
                "name": "status_mapped",
                "label": "报价单状态",
                "origin_label": "报价单状态",
                "field_type": "field_map_field",
                "default": true,
                "is_user_custom_column": "system_column",
                "is_app_user_custom_column": "system_column",
                "visible": true
            },
            {
                "name": "custom_field_template.name",
                "label": "业务类型",
                "origin_label": "业务类型",
                "field_type": "text_field",
                "is_user_custom_column": "system_column",
                "is_app_user_custom_column": "system_column",
                "visible": true
            }
        ],
        "total_count": 1,
        "total_pages": 1,
        "has_next_page": false,
        "page": 1,
        "per_page": 15
    }
}
文档更新时间: 2025-07-24 11:55   作者:曹勇