WooCommerce REST API 文档

title: "报告 #" post_status: publish comment_status: open taxonomy: category: - woocommerce-rest-api post_tag: - Wp Api V3 - Includes - Source

报告

报告 API 允许您查看所有可用的报告类型。

列出所有报告

此 API 允许您检索并查看可用报告的简单列表。

HTTP 请求

GET
/wp-json/wc/v3/reports
curl https://example.com/wp-json/wc/v3/reports \
    -u consumer_key:consumer_secret

WooCommerce.get("reports")
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.log(error.response.data);
  });

<?php print_r($woocommerce->get('reports')); ?>

print(wcapi.get("reports").json())

woocommerce.get("reports").parsed_response

JSON 响应示例：

[
    {
        "slug": "sales",
        "description": "List of sales reports.",
        "_links": {
            "self": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports/sales"
                }
            ],
            "collection": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports"
                }
            ]
        }
    },
    {
        "slug": "top_sellers",
        "description": "List of top sellers products.",
        "_links": {
            "self": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports/top_sellers"
                }
            ],
            "collection": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports"
                }
            ]
        }
    },
    {
        "slug": "orders/totals",
        "description": "Orders totals.",
        "_links": {
            "self": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports/orders/totals"
                }
            ],
            "collection": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports"
                }
            ]
        }
    },
    {
        "slug": "products/totals",
        "description": "Products totals.",
        "_links": {
            "self": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports/products/totals"
                }
            ],
            "collection": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports"
                }
            ]
        }
    },
    {
        "slug": "customers/totals",
        "description": "Customers totals.",
        "_links": {
            "self": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports/customers/totals"
                }
            ],
            "collection": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports"
                }
            ]
        }
    },
    {
        "slug": "coupons/totals",
        "description": "Coupons totals.",
        "_links": {
            "self": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports/coupons/totals"
                }
            ],
            "collection": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports"
                }
            ]
        }
    },
    {
        "slug": "reviews/totals",
        "description": "Reviews totals.",
        "_links": {
            "self": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports/reviews/totals"
                }
            ],
            "collection": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports"
                }
            ]
        }
    },
    {
        "slug": "categories/totals",
        "description": "Categories totals.",
        "_links": {
            "self": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports/categories/totals"
                }
            ],
            "collection": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports"
                }
            ]
        }
    },
    {
        "slug": "tags/totals",
        "description": "Tags totals.",
        "_links": {
            "self": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports/tags/totals"
                }
            ],
            "collection": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports"
                }
            ]
        }
    },
    {
        "slug": "attributes/totals",
        "description": "Attributes totals.",
        "_links": {
            "self": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports/attributes/totals"
                }
            ],
            "collection": [
                {
                    "href": "https://example.com/wp-json/wc/v3/reports"
                }
            ]
        }
    }
]

获取销售报告

此 API 允许您检索和查看销售报告。

HTTP 请求

GET
/wp-json/wc/v3/reports/sales
curl https://example.com/wp-json/wc/v3/reports/sales?date_min=2016-05-03&date_max=2016-05-04 \
    -u consumer_key:consumer_secret

WooCommerce.get("reports/sales", {
  date_min: "2016-05-03",
  date_max: "2016-05-04"
})
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.log(error.response.data);
  });

<?php
$query = [
    'date_min' => '2016-05-03', 
    'date_max' => '2016-05-04'
];

print_r($woocommerce->get('reports/sales', $query));
?>

print(wcapi.get("reports/sales?date_min=2016-05-03&date_max=2016-05-04").json())

query = {
  date_min: "2016-05-03",
  date_max: "2016-05-04"
}

woocommerce.get("reports/sales", query).parsed_response

JSON 响应示例：

[
  {
    "total_sales": "14.00",
    "net_sales": "4.00",
    "average_sales": "2.00",
    "total_orders": 3,
    "total_items": 6,
    "total_tax": "0.00",
    "total_shipping": "10.00",
    "total_refunds": 0,
    "total_discount": "0.00",
    "totals_grouped_by": "day",
    "totals": {
      "2016-05-03": {
        "sales": "14.00",
        "orders": 3,
        "items": 6,
        "tax": "0.00",
        "shipping": "10.00",
        "discount": "0.00",
        "customers": 0
      },
      "2016-05-04": {
        "sales": "0.00",
        "orders": 0,
        "items": 0,
        "tax": "0.00",
        "shipping": "0.00",
        "discount": "0.00",
        "customers": 0
      }
    },
    "total_customers": 0,
    "_links": {
      "about": [
        {
          "href": "https://example.com/wp-json/wc/v3/reports"
        }
      ]
    }
  }
]

Sales report properties

Attribute Type Description
total_sales string Gross sales in the period. read-only
net_sales string Net sales in the period. read-only
average_sales string Average net daily sales. read-only
total_orders integer Total of orders placed. read-only
total_items integer Total of items purchased. read-only
total_tax string Total charged for taxes. read-only
total_shipping string Total charged for shipping. read-only
total_refunds integer Total of refunded orders. read-only
total_discount integer Total of coupons used. read-only
totals_grouped_by string Group type. read-only
totals array Totals. read-only

Available parameters

Parameter Type Description
context string Scope under which the request is made; determines fields present in response. Default is view. Options: view.
period string Report period. Default is today's date. Options: week, month, last_month and year
date_min string Return sales for a specific start date, the date need to be in the YYYY-MM-DD format.
date_max string Return sales for a specific end date, the date need to be in the YYYY-MM-DD format.

获取热销商品报告

此 API 允许您检索和查看热销商品报告列表。

HTTP 请求

GET
/wp-json/wc/v3/reports/top_sellers
curl https://example.com/wp-json/wc/v3/reports/top_sellers?period=last_month \
    -u consumer_key:consumer_secret

WooCommerce.get("reports/top_sellers", {
  period: "last_month"
})
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.log(error.response.data);
  });

<?php
$query = [
    'period' => 'last_month'
];

print_r($woocommerce->get('reports/top_sellers', $query));
?>

print(wcapi.get("reports/top_sellers?period=last_month").json())

query = {
  period: "last_month"
}

woocommerce.get("reports/top_sellers", query).parsed_response

JSON 响应示例：

[
  {
    "title": "Happy Ninja",
    "product_id": 37,
    "quantity": 1,
    "_links": {
      "about": [
        {
          "href": "https://example.com/wp-json/wc/v3/reports"
        }
      ],
      "product": [
        {
          "href": "https://example.com/wp-json/wc/v3/products/37"
        }
      ]
    }
  },
  {
    "title": "Woo Album #4",
    "product_id": 96,
    "quantity": 1,
    "_links": {
      "about": [
        {
          "href": "https://example.com/wp-json/wc/v3/reports"
        }
      ],
      "product": [
        {
          "href": "https://example.com/wp-json/wc/v3/products/96"
        }
      ]
    }
  }
]

Top sellers report properties

Attribute Type Description
title string Product title. read-only
product_id integer Product ID. read-only
quantity integer Total number of purchases. read-only

Available parameters

Parameter Type Description
context string Scope under which the request is made; determines fields present in response. Default is view. Options: view.
period string Report period. Default is week. Options: week, month, last_month and year
date_min string Return sales for a specific start date, the date need to be in the YYYY-MM-DD format.
date_max string Return sales for a specific end date, the date need to be in the YYYY-MM-DD format.

Retrieve coupons totals

This API lets you retrieve and view coupons totals report.

HTTP request

GET
/wp-json/wc/v3/reports/coupons/totals
curl https://example.com/wp-json/wc/v3/reports/coupons/totals \
    -u consumer_key:consumer_secret

WooCommerce.get("reports/coupons/totals")
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.log(error.response.data);
  });

<?php
print_r($woocommerce->get('reports/coupons/totals'));
?>

print(wcapi.get("reports/coupons/totals").json())

woocommerce.get("reports/coupons/totals").parsed_response

JSON response example:

[
    {
        "slug": "percent",
        "name": "Percentage discount",
        "total": 2
    },
    {
        "slug": "fixed_cart",
        "name": "Fixed cart discount",
        "total": 1
    },
    {
        "slug": "fixed_product",
        "name": "Fixed product discount",
        "total": 1
    }
]

Coupons totals properties

Attribute Type Description
slug string An alphanumeric identifier for the resource. read-only
name string Coupon type name. read-only
total string Amount of coupons. read-only

获取客户总计数据

此 API 允许您检索和查看客户总计报告。

HTTP 请求

GET
/wp-json/wc/v3/reports/customers/totals
curl https://example.com/wp-json/wc/v3/reports/customers/totals \
    -u consumer_key:consumer_secret

WooCommerce.get("reports/customers/totals")
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.log(error.response.data);
  });

<?php
print_r($woocommerce->get('reports/customers/totals'));
?>

print(wcapi.get("reports/customers/totals").json())

woocommerce.get("reports/customers/totals").parsed_response

JSON 响应示例：

[
    {
        "slug": "paying",
        "name": "Paying customer",
        "total": 2
    },
    {
        "slug": "non_paying",
        "name": "Non-paying customer",
        "total": 1
    }
]

Customers totals properties

Attribute Type Description
slug string An alphanumeric identifier for the resource. read-only
name string Customer type name. read-only
total string Amount of customers. read-only

Retrieve orders totals

This API lets you retrieve and view orders totals report.

HTTP request

GET
/wp-json/wc/v3/reports/orders/totals
curl https://example.com/wp-json/wc/v3/reports/orders/totals \
    -u consumer_key:consumer_secret

WooCommerce.get("reports/orders/totals")
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.log(error.response.data);
  });

<?php
print_r($woocommerce->get('reports/orders/totals'));
?>

print(wcapi.get("reports/orders/totals").json())

woocommerce.get("reports/orders/totals").parsed_response

JSON response example:

[
    {
        "slug": "pending",
        "name": "Pending payment",
        "total": 7
    },
    {
        "slug": "processing",
        "name": "Processing",
        "total": 2
    },
    {
        "slug": "on-hold",
        "name": "On hold",
        "total": 1
    },
    {
        "slug": "completed",
        "name": "Completed",
        "total": 3
    },
    {
        "slug": "cancelled",
        "name": "Cancelled",
        "total": 0
    },
    {
        "slug": "refunded",
        "name": "Refunded",
        "total": 0
    },
    {
        "slug": "failed",
        "name": "Failed",
        "total": 0
    }
]

Orders totals properties

Attribute Type Description
slug string An alphanumeric identifier for the resource. read-only
name string Orders status name. read-only
total string Amount of orders. read-only

获取产品统计总数

此 API 允许您检索和查看产品统计总数报告。

HTTP 请求

GET
/wp-json/wc/v3/reports/products/totals
curl https://example.com/wp-json/wc/v3/reports/products/totals \
    -u consumer_key:consumer_secret

WooCommerce.get("reports/products/totals")
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.log(error.response.data);
  });

<?php
print_r($woocommerce->get('reports/products/totals'));
?>

print(wcapi.get("reports/products/totals").json())

woocommerce.get("reports/products/totals").parsed_response

JSON 响应示例：

[
    {
        "slug": "external",
        "name": "External/Affiliate product",
        "total": 1
    },
    {
        "slug": "grouped",
        "name": "Grouped product",
        "total": 1
    },
    {
        "slug": "simple",
        "name": "Simple product",
        "total": 21
    },
    {
        "slug": "variable",
        "name": "Variable product",
        "total": 3
    }
]

Products totals properties

Attribute Type Description
slug string An alphanumeric identifier for the resource. read-only
name string Product type name. read-only
total string Amount of products. read-only

获取评价总计

此 API 允许您检索和查看评价总计报告。

HTTP 请求

GET
/wp-json/wc/v3/reports/reviews/totals
curl https://example.com/wp-json/wc/v3/reports/reviews/totals \
    -u consumer_key:consumer_secret

WooCommerce.get("reports/reviews/totals")
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.log(error.response.data);
  });

<?php
print_r($woocommerce->get('reports/reviews/totals'));
?>

print(wcapi.get("reports/reviews/totals").json())

woocommerce.get("reports/reviews/totals").parsed_response

JSON 响应示例：

[
    {
        "slug": "rated_1_out_of_5",
        "name": "Rated 1 out of 5",
        "total": 1
    },
    {
        "slug": "rated_2_out_of_5",
        "name": "Rated 2 out of 5",
        "total": 0
    },
    {
        "slug": "rated_3_out_of_5",
        "name": "Rated 3 out of 5",
        "total": 3
    },
    {
        "slug": "rated_4_out_of_5",
        "name": "Rated 4 out of 5",
        "total": 0
    },
    {
        "slug": "rated_5_out_of_5",
        "name": "Rated 5 out of 5",
        "total": 4
    }
]

Reviews totals properties

Attribute Type Description
slug string An alphanumeric identifier for the resource. read-only
name string Review type name. read-only
total string Amount of reviews. read-only