mirror of
https://gh.wpcy.net/https://github.com/woocommerce/woocommerce-rest-api-docs.git
synced 2026-04-25 04:52:16 +08:00
2217 lines
61 KiB
Markdown
2217 lines
61 KiB
Markdown
# Orders #
|
|
|
|
This section lists all API that can be used to create, edit or otherwise manipulate orders.
|
|
|
|
## Orders Properties ##
|
|
|
|
| Attribute | Type | Description |
|
|
|-----------------------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
| `id` | integer | Order ID (post ID) <i class="label label-info">read-only</i> |
|
|
| `order_number` | integer | Order number <i class="label label-info">read-only</i> |
|
|
| `created_at` | string | UTC DateTime when the order was created <i class="label label-info">read-only</i> |
|
|
| `updated_at` | string | UTC DateTime when the order was last updated <i class="label label-info">read-only</i> |
|
|
| `completed_at` | string | UTC DateTime when the order was last completed <i class="label label-info">read-only</i> |
|
|
| `status` | string | Order status. By default are available the status: `pending`, `processing`, `on-hold`, `completed`, `cancelled`, `refunded` and `failed`. See [View List of Order Statuses](#view-list-of-order-statuses) |
|
|
| `currency` | string | Currency in ISO format, e.g `USD` |
|
|
| `total` | string | Order total <i class="label label-info">read-only</i> |
|
|
| `subtotal` | string | Order subtotal <i class="label label-info">read-only</i> |
|
|
| `total_line_items_quantity` | integer | Total of order items <i class="label label-info">read-only</i> |
|
|
| `total_tax` | string | Order tax total <i class="label label-info">read-only</i> |
|
|
| `total_shipping` | string | Order shipping total <i class="label label-info">read-only</i> |
|
|
| `cart_tax` | string | Order cart tax <i class="label label-info">read-only</i> |
|
|
| `shipping_tax` | string | Order shipping tax <i class="label label-info">read-only</i> |
|
|
| `total_discount` | string | Order total discount <i class="label label-info">read-only</i> |
|
|
| `shipping_methods` | string | Text list of the shipping methods used in the order <i class="label label-info">read-only</i> |
|
|
| `payment_details` | array | List of payment details. See [Payment Details Properties](#payment-details-properties) |
|
|
| `billing_address` | array | List of customer billing address. See [Customer Billing Address Properties](#billing-address-properties) |
|
|
| `shipping_address` | array | List of customer shipping address. See [Customer Shipping Address Properties](#shipping-address-properties) |
|
|
| `note` | string | Customer order notes |
|
|
| `customer_ip` | string | Customer IP address <i class="label label-info">read-only</i> |
|
|
| `customer_user_agent` | string | Customer User-Agent <i class="label label-info">read-only</i> |
|
|
| `customer_id` | integer | Customer ID (user ID) <i class="label label-info">required</i> |
|
|
| `view_order_url` | string | URL to view the order in frontend <i class="label label-info">read-only</i> |
|
|
| `line_items` | array | List of order line items. See [Line Items Properties](#line-items-properties) |
|
|
| `shipping_lines` | array | List of shipping line items. See [Shipping Lines Properties](#shipping-lines-properties) |
|
|
| `tax_lines` | array | List of tax line items. See [Tax Lines Properties](#tax-lines-properties) <i class="label label-info">read-only</i> |
|
|
| `fee_lines` | array | List of fee line items. See [Fee Lines Properites](#fee-lines-properites) |
|
|
| `coupon_lines` | array | List of cupon line items. See [Coupon Lines Properties](#coupon-lines-properties) |
|
|
| `customer` | array | Customer data. See [Customer Properties](#customers-properties) |
|
|
|
|
### Payment Details Properties ###
|
|
|
|
| Attribute | Type | Description |
|
|
| ---------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| `method_id` | string | Payment method ID <i class="label label-info">required</i> |
|
|
| `method_title` | string | Payment method title <i class="label label-info">required</i> |
|
|
| `paid` | boolean | Shows/define if the order is paid using this payment method. Use `true` to complate the payment. |
|
|
| `transaction_id` | string | Transaction ID, an optional field to set the transacion ID when complate one payment (to set this you need set the `paid` as `true` too) |
|
|
|
|
### Line Items Properties ###
|
|
|
|
| Attribute | Type | Description |
|
|
|----------------|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
| `id` | integer | Line item ID <i class="label label-info">read-only</i> |
|
|
| `subtotal` | string | Line item subtotal |
|
|
| `subtotal_tax` | string | Line item tax subtotal |
|
|
| `total` | string | Line item total |
|
|
| `total_tax` | string | Line item tax total |
|
|
| `price` | string | Product price <i class="label label-info">read-only</i> |
|
|
| `quantity` | integer | Quantity |
|
|
| `tax_class` | string | Product tax class <i class="label label-info">read-only</i> |
|
|
| `name` | string | Product name <i class="label label-info">read-only</i> |
|
|
| `product_id` | integer | Product ID <i class="label label-info">required</i> |
|
|
| `sku` | string | Product SKU <i class="label label-info">read-only</i> |
|
|
| `meta` | array | List of product meta items. See [Products Meta Items Properties](#products-meta-items-properties) |
|
|
| `variations` | array | List of product variation attributes. e.g: `"variation": {"pa_color": "Black", "pa_size": "XGG"}` (Use `pa_` prefix when is a product attribute) <i class="label label-info">write-only</i> |
|
|
|
|
#### Products Meta Items Properties ####
|
|
|
|
| Attribute | Type | Description |
|
|
| --------- | ------ | --------------- |
|
|
| `key` | string | Meta item key |
|
|
| `label` | string | Meta item label |
|
|
| `value` | string | Meta item value |
|
|
|
|
### Shipping Lines Properties ###
|
|
|
|
| Attribute | Type | Description |
|
|
|----------------|---------|----------------------------------------------------------------|
|
|
| `id` | integer | Shipping line ID <i class="label label-info">read-only</i> |
|
|
| `method_id` | string | Shipping method ID <i class="label label-info">required</i> |
|
|
| `method_title` | string | Shipping method title <i class="label label-info">required</i> |
|
|
| `total` | string | Total amount |
|
|
|
|
### Tax Lines Properties ###
|
|
|
|
| Attribute | Type | Description |
|
|
|------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------|
|
|
| `id` | integer | Tax rate line ID <i class="label label-info">read-only</i> |
|
|
| `rate_id` | integer | Tax rate ID <i class="label label-info">read-only</i> |
|
|
| `code` | string | Tax rate code <i class="label label-info">read-only</i> |
|
|
| `title` | string | Tax rate title/name <i class="label label-info">read-only</i> |
|
|
| `total` | string | Tax rate total <i class="label label-info">read-only</i> |
|
|
| `compound` | boolean | Shows if is or not a compound rate. Compound tax rates are applied on top of other tax rates. <i class="label label-info">read-only</i> |
|
|
|
|
### Fee Lines Properites ###
|
|
|
|
| Attribute | Type | Description |
|
|
|-------------|---------|-------------------------------------------------------------------------------|
|
|
| `id` | integer | Fee line ID <i class="label label-info">read-only</i> |
|
|
| `title` | string | Shipping method title <i class="label label-info">required</i> |
|
|
| `taxable` | boolean | Shows/define if the fee is taxable <i class="label label-info">write-only</i> |
|
|
| `tax_class` | string | Tax class, requered in write-mode if the fee is taxable |
|
|
| `total` | string | Total amount |
|
|
| `total_tax` | string | Tax total |
|
|
|
|
### Coupon Lines Properties ###
|
|
|
|
| Attribute | Type | Description |
|
|
|-----------|---------|----------------------------------------------------------|
|
|
| `id` | integer | Coupon line ID <i class="label label-info">read-only</i> |
|
|
| `code` | string | Coupon code <i class="label label-info">required</i> |
|
|
| `amount` | string | Total amount <i class="label label-info">required</i> |
|
|
|
|
## Create An Order ##
|
|
|
|
This API helps you to create a new order.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-post">POST</i>
|
|
<h6>/wc-api/v2/orders</h6>
|
|
</div>
|
|
</div>
|
|
|
|
> Example of create a paid order:
|
|
|
|
```shell
|
|
curl -X POST https://example.com/wc-api/v2/orders \
|
|
-u consumer_key:consumer_secret \
|
|
-H "Content-Type: application/json" \
|
|
-d '{
|
|
"order": {
|
|
"payment_details": {
|
|
"method_id": "bacs",
|
|
"method_title": "Direct Bank Transfer",
|
|
"paid": true
|
|
},
|
|
"billing_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US",
|
|
"email": "john.doe@example.com",
|
|
"phone": "(555) 555-5555"
|
|
},
|
|
"shipping_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US"
|
|
},
|
|
"customer_id": 2,
|
|
"line_items": [
|
|
{
|
|
"product_id": 546,
|
|
"quantity": 2
|
|
},
|
|
{
|
|
"product_id": 613,
|
|
"quantity": 1,
|
|
"variations": {
|
|
"pa_color": "Black"
|
|
}
|
|
}
|
|
],
|
|
"shipping_lines": [
|
|
{
|
|
"method_id": "flat_rate",
|
|
"method_title": "Flat Rate",
|
|
"total": "10.00"
|
|
}
|
|
]
|
|
}
|
|
}'
|
|
```
|
|
|
|
```javascript
|
|
var data = {
|
|
order: {
|
|
payment_details: {
|
|
method_id: 'bacs',
|
|
method_title: 'Direct Bank Transfer',
|
|
paid: true
|
|
},
|
|
billing_address: {
|
|
first_name: 'John',
|
|
last_name: 'Doe',
|
|
address_1: '969 Market',
|
|
address_2: '',
|
|
city: 'San Francisco',
|
|
state: 'CA',
|
|
postcode: '94103',
|
|
country: 'US',
|
|
email: 'john.doe@example.com',
|
|
phone: '(555) 555-5555'
|
|
},
|
|
shipping_address: {
|
|
first_name: 'John',
|
|
last_name: 'Doe',
|
|
address_1: '969 Market',
|
|
address_2: '',
|
|
city: 'San Francisco',
|
|
state: 'CA',
|
|
postcode: '94103',
|
|
country: 'US'
|
|
},
|
|
customer_id: 2,
|
|
line_items: [
|
|
{
|
|
product_id: 546,
|
|
quantity: 2
|
|
},
|
|
{
|
|
product_id: 613,
|
|
quantity: 1,
|
|
variations: {
|
|
pa_color: 'Black'
|
|
}
|
|
}
|
|
],
|
|
shipping_lines: [
|
|
{
|
|
method_id: 'flat_rate',
|
|
method_title: 'Flat Rate',
|
|
total: '10.00'
|
|
}
|
|
]
|
|
}
|
|
};
|
|
|
|
WooCommerce.post('orders', data, function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
data = {
|
|
"order": {
|
|
"payment_details": {
|
|
"method_id": "bacs",
|
|
"method_title": "Direct Bank Transfer",
|
|
"paid": True
|
|
},
|
|
"billing_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US",
|
|
"email": "john.doe@example.com",
|
|
"phone": "(555) 555-5555"
|
|
},
|
|
"shipping_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US"
|
|
},
|
|
"customer_id": 2,
|
|
"line_items": [
|
|
{
|
|
"product_id": 546,
|
|
"quantity": 2
|
|
},
|
|
{
|
|
"product_id": 613,
|
|
"quantity": 1,
|
|
"variations": {
|
|
"pa_color": "Black"
|
|
}
|
|
}
|
|
],
|
|
"shipping_lines": [
|
|
{
|
|
"method_id": "flat_rate",
|
|
"method_title": "Flat Rate",
|
|
"total": "10.00"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
|
|
print(wcapi.post("orders", data).json())
|
|
```
|
|
|
|
```php
|
|
<?php
|
|
$data = array(
|
|
'order' => array(
|
|
'payment_details' => array(
|
|
'method_id' => 'bacs',
|
|
'method_title' => 'Direct Bank Transfer',
|
|
'paid' => true
|
|
),
|
|
'billing_address' => array(
|
|
'first_name' => 'John',
|
|
'last_name' => 'Doe',
|
|
'address_1' => '969 Market',
|
|
'address_2' => '',
|
|
'city' => 'San Francisco',
|
|
'state' => 'CA',
|
|
'postcode' => '94103',
|
|
'country' => 'US',
|
|
'email' => 'john.doe@example.com',
|
|
'phone' => '(555) 555-5555'
|
|
),
|
|
'shipping_address' => array(
|
|
'first_name' => 'John',
|
|
'last_name' => 'Doe',
|
|
'address_1' => '969 Market',
|
|
'address_2' => '',
|
|
'city' => 'San Francisco',
|
|
'state' => 'CA',
|
|
'postcode' => '94103',
|
|
'country' => 'US'
|
|
),
|
|
'customer_id' => 2,
|
|
'line_items' => array(
|
|
array(
|
|
'product_id' => 546,
|
|
'quantity' => 2
|
|
),
|
|
array(
|
|
'product_id' => 613,
|
|
'quantity' => 1,
|
|
'variations' => array(
|
|
'pa_color' => 'Black'
|
|
)
|
|
)
|
|
),
|
|
'shipping_lines' => array(
|
|
array(
|
|
'method_id' => 'flat_rate',
|
|
'method_title' => 'Flat Rate',
|
|
'total' => '10.00'
|
|
)
|
|
)
|
|
)
|
|
);
|
|
|
|
print_r($woocommerce->orders->create($data));
|
|
?>
|
|
```
|
|
|
|
```ruby
|
|
data = {
|
|
order: {
|
|
payment_details: {
|
|
method_id: "bacs",
|
|
method_title: "Direct Bank Transfer",
|
|
paid: true
|
|
},
|
|
billing_address: {
|
|
first_name: "John",
|
|
last_name: "Doe",
|
|
address_1: "969 Market",
|
|
address_2: "",
|
|
city: "San Francisco",
|
|
state: "CA",
|
|
postcode: "94103",
|
|
country: "US",
|
|
email: "john.doe@example.com",
|
|
phone: "(555) 555-5555"
|
|
},
|
|
shipping_address: {
|
|
first_name: "John",
|
|
last_name: "Doe",
|
|
address_1: "969 Market",
|
|
address_2: "",
|
|
city: "San Francisco",
|
|
state: "CA",
|
|
postcode: "94103",
|
|
country: "US"
|
|
},
|
|
customer_id: 2,
|
|
line_items: [
|
|
{
|
|
product_id: 546,
|
|
quantity: 2
|
|
},
|
|
{
|
|
product_id: 613,
|
|
quantity: 1,
|
|
variations: {
|
|
pa_color: "Black"
|
|
}
|
|
}
|
|
],
|
|
shipping_lines: [
|
|
{
|
|
method_id: "flat_rate",
|
|
method_title: "Flat Rate",
|
|
total: "10.00"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
|
|
woocommerce.post("orders", data).parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"order": {
|
|
"id": 645,
|
|
"order_number": 645,
|
|
"created_at": "2015-01-26T20:00:21Z",
|
|
"updated_at": "2015-01-26T20:00:21Z",
|
|
"completed_at": "2015-01-26T20:00:21Z",
|
|
"status": "processing",
|
|
"currency": "USD",
|
|
"total": "79.87",
|
|
"subtotal": "63.97",
|
|
"total_line_items_quantity": 3,
|
|
"total_tax": "5.90",
|
|
"total_shipping": "10.00",
|
|
"cart_tax": "5.40",
|
|
"shipping_tax": "0.50",
|
|
"total_discount": "0.00",
|
|
"shipping_methods": "Flat Rate",
|
|
"payment_details": {
|
|
"method_id": "bacs",
|
|
"method_title": "Direct Bank Transfer",
|
|
"paid": true
|
|
},
|
|
"billing_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US",
|
|
"email": "john.doe@example.com",
|
|
"phone": "(555) 555-5555"
|
|
},
|
|
"shipping_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US"
|
|
},
|
|
"note": "",
|
|
"customer_ip": "127.0.0.1",
|
|
"customer_user_agent": "WordPress/4.1; http://example.com",
|
|
"customer_id": 2,
|
|
"view_order_url": "https://example.com/my-account/view-order/645",
|
|
"line_items": [
|
|
{
|
|
"id": 504,
|
|
"subtotal": "43.98",
|
|
"subtotal_tax": "4.40",
|
|
"total": "43.98",
|
|
"total_tax": "4.40",
|
|
"price": "21.99",
|
|
"quantity": 2,
|
|
"tax_class": "reduced-rate",
|
|
"name": "Premium Quality",
|
|
"product_id": 546,
|
|
"sku": "",
|
|
"meta": []
|
|
},
|
|
{
|
|
"id": 505,
|
|
"subtotal": "19.99",
|
|
"subtotal_tax": "1.00",
|
|
"total": "19.99",
|
|
"total_tax": "1.00",
|
|
"price": "19.99",
|
|
"quantity": 1,
|
|
"tax_class": null,
|
|
"name": "Ship Your Idea",
|
|
"product_id": 613,
|
|
"sku": "",
|
|
"meta": [
|
|
{
|
|
"key": "pa_color",
|
|
"label": "Color",
|
|
"value": "Black"
|
|
}
|
|
]
|
|
}
|
|
],
|
|
"shipping_lines": [
|
|
{
|
|
"id": 506,
|
|
"method_id": "flat_rate",
|
|
"method_title": "Flat Rate",
|
|
"total": "10.00"
|
|
}
|
|
],
|
|
"tax_lines": [
|
|
{
|
|
"id": 507,
|
|
"rate_id": "5",
|
|
"code": "US-CA-TAX-1",
|
|
"title": "Tax",
|
|
"total": "4.40",
|
|
"compound": false
|
|
},
|
|
{
|
|
"id": 508,
|
|
"rate_id": "4",
|
|
"code": "US-STANDARD-1",
|
|
"title": "Standard",
|
|
"total": "1.50",
|
|
"compound": false
|
|
}
|
|
],
|
|
"fee_lines": [],
|
|
"coupon_lines": [],
|
|
"customer": {
|
|
"id": 2,
|
|
"created_at": "2014-11-19T18:34:19Z",
|
|
"email": "john.doe@example.com",
|
|
"first_name": "",
|
|
"last_name": "",
|
|
"username": "john.doe",
|
|
"last_order_id": "645",
|
|
"last_order_date": "2015-01-26T20:00:21Z",
|
|
"orders_count": 2,
|
|
"total_spent": "19.00",
|
|
"avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
|
|
"billing_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US",
|
|
"email": "john.doe@example.com",
|
|
"phone": "(555) 555-5555"
|
|
},
|
|
"shipping_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## View An Order ##
|
|
|
|
This API lets you retrieve and view a specific order.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-get">GET</i>
|
|
<h6>/wc-api/v2/orders/<id></h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl https://example.com/wc-api/v2/orders/645 \
|
|
-u consumer_key:consumer_secret
|
|
```
|
|
|
|
```javascript
|
|
WooCommerce.get('orders/645', function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
print(wcapi.get("orders/645").json())
|
|
```
|
|
|
|
```php
|
|
<?php print_r($woocommerce->orders->get(645)); ?>
|
|
```
|
|
|
|
```ruby
|
|
woocommerce.get("orders/645").parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"order": {
|
|
"id": 645,
|
|
"order_number": 645,
|
|
"created_at": "2015-01-26T20:00:21Z",
|
|
"updated_at": "2015-01-26T20:00:21Z",
|
|
"completed_at": "2015-01-26T20:00:21Z",
|
|
"status": "processing",
|
|
"currency": "USD",
|
|
"total": "79.87",
|
|
"subtotal": "63.97",
|
|
"total_line_items_quantity": 3,
|
|
"total_tax": "5.90",
|
|
"total_shipping": "10.00",
|
|
"cart_tax": "5.40",
|
|
"shipping_tax": "0.50",
|
|
"total_discount": "0.00",
|
|
"shipping_methods": "Flat Rate",
|
|
"payment_details": {
|
|
"method_id": "bacs",
|
|
"method_title": "Direct Bank Transfer",
|
|
"paid": true
|
|
},
|
|
"billing_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US",
|
|
"email": "john.doe@example.com",
|
|
"phone": "(555) 555-5555"
|
|
},
|
|
"shipping_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US"
|
|
},
|
|
"note": "",
|
|
"customer_ip": "127.0.0.1",
|
|
"customer_user_agent": "WordPress/4.1; http://example.com",
|
|
"customer_id": 2,
|
|
"view_order_url": "https://example.com/my-account/view-order/645",
|
|
"line_items": [
|
|
{
|
|
"id": 504,
|
|
"subtotal": "43.98",
|
|
"subtotal_tax": "4.40",
|
|
"total": "43.98",
|
|
"total_tax": "4.40",
|
|
"price": "21.99",
|
|
"quantity": 2,
|
|
"tax_class": "reduced-rate",
|
|
"name": "Premium Quality",
|
|
"product_id": 546,
|
|
"sku": "",
|
|
"meta": []
|
|
},
|
|
{
|
|
"id": 505,
|
|
"subtotal": "19.99",
|
|
"subtotal_tax": "1.00",
|
|
"total": "19.99",
|
|
"total_tax": "1.00",
|
|
"price": "19.99",
|
|
"quantity": 1,
|
|
"tax_class": null,
|
|
"name": "Ship Your Idea",
|
|
"product_id": 613,
|
|
"sku": "",
|
|
"meta": [
|
|
{
|
|
"key": "pa_color",
|
|
"label": "Color",
|
|
"value": "Black"
|
|
}
|
|
]
|
|
}
|
|
],
|
|
"shipping_lines": [
|
|
{
|
|
"id": 506,
|
|
"method_id": "flat_rate",
|
|
"method_title": "Flat Rate",
|
|
"total": "10.00"
|
|
}
|
|
],
|
|
"tax_lines": [
|
|
{
|
|
"id": 507,
|
|
"rate_id": "5",
|
|
"code": "US-CA-TAX-1",
|
|
"title": "Tax",
|
|
"total": "4.40",
|
|
"compound": false
|
|
},
|
|
{
|
|
"id": 508,
|
|
"rate_id": "4",
|
|
"code": "US-STANDARD-1",
|
|
"title": "Standard",
|
|
"total": "1.50",
|
|
"compound": false
|
|
}
|
|
],
|
|
"fee_lines": [],
|
|
"coupon_lines": [],
|
|
"customer": {
|
|
"id": 2,
|
|
"created_at": "2014-11-19T18:34:19Z",
|
|
"email": "john.doe@example.com",
|
|
"first_name": "",
|
|
"last_name": "",
|
|
"username": "john.doe",
|
|
"last_order_id": "645",
|
|
"last_order_date": "2015-01-26T20:00:21Z",
|
|
"orders_count": 2,
|
|
"total_spent": "19.00",
|
|
"avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
|
|
"billing_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US",
|
|
"email": "john.doe@example.com",
|
|
"phone": "(555) 555-5555"
|
|
},
|
|
"shipping_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## View List Of Orders ##
|
|
|
|
This API helps you to view all the orders.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-get">GET</i>
|
|
<h6>/wc-api/v2/orders</h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl https://example.com/wc-api/v2/orders \
|
|
-u consumer_key:consumer_secret
|
|
```
|
|
|
|
```javascript
|
|
WooCommerce.get('orders', function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
print(wcapi.get("orders").json())
|
|
```
|
|
|
|
```php
|
|
<?php print_r($woocommerce->orders->get()); ?>
|
|
```
|
|
|
|
```ruby
|
|
woocommerce.get("orders").parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"orders": [
|
|
{
|
|
"id": 645,
|
|
"order_number": 645,
|
|
"created_at": "2015-01-26T20:00:21Z",
|
|
"updated_at": "2015-01-26T20:00:21Z",
|
|
"completed_at": "2015-01-26T20:00:21Z",
|
|
"status": "processing",
|
|
"currency": "USD",
|
|
"total": "79.87",
|
|
"subtotal": "63.97",
|
|
"total_line_items_quantity": 3,
|
|
"total_tax": "5.90",
|
|
"total_shipping": "10.00",
|
|
"cart_tax": "5.40",
|
|
"shipping_tax": "0.50",
|
|
"total_discount": "0.00",
|
|
"shipping_methods": "Flat Rate",
|
|
"payment_details": {
|
|
"method_id": "bacs",
|
|
"method_title": "Direct Bank Transfer",
|
|
"paid": true
|
|
},
|
|
"billing_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US",
|
|
"email": "john.doe@example.com",
|
|
"phone": "(555) 555-5555"
|
|
},
|
|
"shipping_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US"
|
|
},
|
|
"note": "",
|
|
"customer_ip": "127.0.0.1",
|
|
"customer_user_agent": "WordPress/4.1; http://example.com",
|
|
"customer_id": 2,
|
|
"view_order_url": "https://example.com/my-account/view-order/645",
|
|
"line_items": [
|
|
{
|
|
"id": 504,
|
|
"subtotal": "43.98",
|
|
"subtotal_tax": "4.40",
|
|
"total": "43.98",
|
|
"total_tax": "4.40",
|
|
"price": "21.99",
|
|
"quantity": 2,
|
|
"tax_class": "reduced-rate",
|
|
"name": "Premium Quality",
|
|
"product_id": 546,
|
|
"sku": "",
|
|
"meta": []
|
|
},
|
|
{
|
|
"id": 505,
|
|
"subtotal": "19.99",
|
|
"subtotal_tax": "1.00",
|
|
"total": "19.99",
|
|
"total_tax": "1.00",
|
|
"price": "19.99",
|
|
"quantity": 1,
|
|
"tax_class": null,
|
|
"name": "Ship Your Idea",
|
|
"product_id": 613,
|
|
"sku": "",
|
|
"meta": [
|
|
{
|
|
"key": "pa_color",
|
|
"label": "Color",
|
|
"value": "Black"
|
|
}
|
|
]
|
|
}
|
|
],
|
|
"shipping_lines": [
|
|
{
|
|
"id": 506,
|
|
"method_id": "flat_rate",
|
|
"method_title": "Flat Rate",
|
|
"total": "10.00"
|
|
}
|
|
],
|
|
"tax_lines": [
|
|
{
|
|
"id": 507,
|
|
"rate_id": "5",
|
|
"code": "US-CA-TAX-1",
|
|
"title": "Tax",
|
|
"total": "4.40",
|
|
"compound": false
|
|
},
|
|
{
|
|
"id": 508,
|
|
"rate_id": "4",
|
|
"code": "US-STANDARD-1",
|
|
"title": "Standard",
|
|
"total": "1.50",
|
|
"compound": false
|
|
}
|
|
],
|
|
"fee_lines": [],
|
|
"coupon_lines": [],
|
|
"customer": {
|
|
"id": 2,
|
|
"created_at": "2014-11-19T18:34:19Z",
|
|
"email": "john.doe@example.com",
|
|
"first_name": "",
|
|
"last_name": "",
|
|
"username": "john.doe",
|
|
"last_order_id": "645",
|
|
"last_order_date": "2015-01-26T20:00:21Z",
|
|
"orders_count": 2,
|
|
"total_spent": "19.00",
|
|
"avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
|
|
"billing_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US",
|
|
"email": "john.doe@example.com",
|
|
"phone": "(555) 555-5555"
|
|
},
|
|
"shipping_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US"
|
|
}
|
|
}
|
|
},
|
|
{
|
|
"id": 644,
|
|
"order_number": 644,
|
|
"created_at": "2015-01-26T19:33:42Z",
|
|
"updated_at": "2015-01-26T19:33:42Z",
|
|
"completed_at": "2015-01-26T19:33:42Z",
|
|
"status": "on-hold",
|
|
"currency": "USD",
|
|
"total": "44.14",
|
|
"subtotal": "30.99",
|
|
"total_line_items_quantity": 2,
|
|
"total_tax": "3.15",
|
|
"total_shipping": "10.00",
|
|
"cart_tax": "2.65",
|
|
"shipping_tax": "0.50",
|
|
"total_discount": "0.00",
|
|
"shipping_methods": "Flat Rate",
|
|
"payment_details": {
|
|
"method_id": "bacs",
|
|
"method_title": "Direct Bank Transfer",
|
|
"paid": false
|
|
},
|
|
"billing_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US",
|
|
"email": "john.doe@example.com",
|
|
"phone": "(555) 555-5555"
|
|
},
|
|
"shipping_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US"
|
|
},
|
|
"note": "",
|
|
"customer_ip": "127.0.0.1",
|
|
"customer_user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.91 Safari/537.36",
|
|
"customer_id": 2,
|
|
"view_order_url": "https://example.com/my-account/view-order/644",
|
|
"line_items": [
|
|
{
|
|
"id": 499,
|
|
"subtotal": "21.99",
|
|
"subtotal_tax": "2.20",
|
|
"total": "21.99",
|
|
"total_tax": "2.20",
|
|
"price": "21.99",
|
|
"quantity": 1,
|
|
"tax_class": "reduced-rate",
|
|
"name": "Premium Quality",
|
|
"product_id": 546,
|
|
"sku": "",
|
|
"meta": []
|
|
},
|
|
{
|
|
"id": 500,
|
|
"subtotal": "9.00",
|
|
"subtotal_tax": "0.45",
|
|
"total": "9.00",
|
|
"total_tax": "0.45",
|
|
"price": "9.00",
|
|
"quantity": 1,
|
|
"tax_class": null,
|
|
"name": "Woo Album #4",
|
|
"product_id": 96,
|
|
"sku": "",
|
|
"meta": []
|
|
}
|
|
],
|
|
"shipping_lines": [
|
|
{
|
|
"id": 501,
|
|
"method_id": "flat_rate",
|
|
"method_title": "Flat Rate",
|
|
"total": "10.00"
|
|
}
|
|
],
|
|
"tax_lines": [
|
|
{
|
|
"id": 502,
|
|
"rate_id": "5",
|
|
"code": "US-CA-TAX-1",
|
|
"title": "Tax",
|
|
"total": "4.40",
|
|
"compound": false
|
|
},
|
|
{
|
|
"id": 503,
|
|
"rate_id": "4",
|
|
"code": "US-STANDARD-1",
|
|
"title": "Standard",
|
|
"total": "1.50",
|
|
"compound": false
|
|
}
|
|
],
|
|
"fee_lines": [],
|
|
"coupon_lines": [],
|
|
"customer": {
|
|
"id": 2,
|
|
"created_at": "2014-11-19T18:34:19Z",
|
|
"email": "john.doe@example.com",
|
|
"first_name": "",
|
|
"last_name": "",
|
|
"username": "john.doe",
|
|
"last_order_id": "645",
|
|
"last_order_date": "2015-01-26T20:00:21Z",
|
|
"orders_count": 2,
|
|
"total_spent": "19.00",
|
|
"avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
|
|
"billing_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US",
|
|
"email": "john.doe@example.com",
|
|
"phone": "(555) 555-5555"
|
|
},
|
|
"shipping_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US"
|
|
}
|
|
}
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
#### Available Filters ####
|
|
|
|
| Filter | Type | Description |
|
|
| -------- | ------ | ------------------------------------------------- |
|
|
| `status` | string | Orders by status. eg: `processing` or `cancelled` |
|
|
|
|
## Update An Order ##
|
|
|
|
This API lets you make changes to an order.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-put">PUT</i>
|
|
<h6>/wc-api/v2/orders/<id></h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl -X PUT https://example.com/wc-api/v2/orders/645 \
|
|
-u consumer_key:consumer_secret \
|
|
-H "Content-Type: application/json" \
|
|
-d '{
|
|
"order": {
|
|
"status": "completed"
|
|
}
|
|
}'
|
|
```
|
|
|
|
```javascript
|
|
var data = {
|
|
order: {
|
|
status: 'completed'
|
|
}
|
|
};
|
|
|
|
WooCommerce.put('orders/645', data, function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
data = {
|
|
"order": {
|
|
"status": "completed"
|
|
}
|
|
}
|
|
|
|
print(wcapi.put("orders/645", data).json())
|
|
```
|
|
|
|
```php
|
|
<?php
|
|
$data = array(
|
|
'order' => array(
|
|
'status' => 'completed'
|
|
)
|
|
);
|
|
|
|
print_r($woocommerce->orders->update(645, $data));
|
|
?>
|
|
```
|
|
|
|
```ruby
|
|
data = {
|
|
order: {
|
|
status: "completed"
|
|
}
|
|
}
|
|
|
|
woocommerce.put("orders/645", data).parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"order": {
|
|
"id": 645,
|
|
"order_number": 645,
|
|
"created_at": "2015-01-26T20:00:21Z",
|
|
"updated_at": "2015-01-26T20:00:21Z",
|
|
"completed_at": "2015-01-26T20:00:21Z",
|
|
"status": "completed",
|
|
"currency": "USD",
|
|
"total": "79.87",
|
|
"subtotal": "63.97",
|
|
"total_line_items_quantity": 3,
|
|
"total_tax": "5.90",
|
|
"total_shipping": "10.00",
|
|
"cart_tax": "5.40",
|
|
"shipping_tax": "0.50",
|
|
"total_discount": "0.00",
|
|
"shipping_methods": "Flat Rate",
|
|
"payment_details": {
|
|
"method_id": "bacs",
|
|
"method_title": "Direct Bank Transfer",
|
|
"paid": true
|
|
},
|
|
"billing_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US",
|
|
"email": "john.doe@example.com",
|
|
"phone": "(555) 555-5555"
|
|
},
|
|
"shipping_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US"
|
|
},
|
|
"note": "",
|
|
"customer_ip": "127.0.0.1",
|
|
"customer_user_agent": "WordPress/4.1; http://example.com",
|
|
"customer_id": 2,
|
|
"view_order_url": "https://example.com/my-account/view-order/645",
|
|
"line_items": [
|
|
{
|
|
"id": 504,
|
|
"subtotal": "43.98",
|
|
"subtotal_tax": "4.40",
|
|
"total": "43.98",
|
|
"total_tax": "4.40",
|
|
"price": "21.99",
|
|
"quantity": 2,
|
|
"tax_class": "reduced-rate",
|
|
"name": "Premium Quality",
|
|
"product_id": 546,
|
|
"sku": "",
|
|
"meta": []
|
|
},
|
|
{
|
|
"id": 505,
|
|
"subtotal": "19.99",
|
|
"subtotal_tax": "1.00",
|
|
"total": "19.99",
|
|
"total_tax": "1.00",
|
|
"price": "19.99",
|
|
"quantity": 1,
|
|
"tax_class": null,
|
|
"name": "Ship Your Idea",
|
|
"product_id": 613,
|
|
"sku": "",
|
|
"meta": [
|
|
{
|
|
"key": "pa_color",
|
|
"label": "Color",
|
|
"value": "Black"
|
|
}
|
|
]
|
|
}
|
|
],
|
|
"shipping_lines": [
|
|
{
|
|
"id": 506,
|
|
"method_id": "flat_rate",
|
|
"method_title": "Flat Rate",
|
|
"total": "10.00"
|
|
}
|
|
],
|
|
"tax_lines": [
|
|
{
|
|
"id": 507,
|
|
"rate_id": "5",
|
|
"code": "US-CA-TAX-1",
|
|
"title": "Tax",
|
|
"total": "4.40",
|
|
"compound": false
|
|
},
|
|
{
|
|
"id": 508,
|
|
"rate_id": "4",
|
|
"code": "US-STANDARD-1",
|
|
"title": "Standard",
|
|
"total": "1.50",
|
|
"compound": false
|
|
}
|
|
],
|
|
"fee_lines": [],
|
|
"coupon_lines": [],
|
|
"customer": {
|
|
"id": 2,
|
|
"created_at": "2014-11-19T18:34:19Z",
|
|
"email": "john.doe@example.com",
|
|
"first_name": "",
|
|
"last_name": "",
|
|
"username": "john.doe",
|
|
"last_order_id": "645",
|
|
"last_order_date": "2015-01-26T20:00:21Z",
|
|
"orders_count": 2,
|
|
"total_spent": "19.00",
|
|
"avatar_url": "https://secure.gravatar.com/avatar/ad516503a11cd5ca435acc9bb6523536?s=96",
|
|
"billing_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US",
|
|
"email": "john.doe@example.com",
|
|
"phone": "(555) 555-5555"
|
|
},
|
|
"shipping_address": {
|
|
"first_name": "John",
|
|
"last_name": "Doe",
|
|
"company": "",
|
|
"address_1": "969 Market",
|
|
"address_2": "",
|
|
"city": "San Francisco",
|
|
"state": "CA",
|
|
"postcode": "94103",
|
|
"country": "US"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Delete An Order ##
|
|
|
|
This API helps you delete an order.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-delete">DELETE</i>
|
|
<h6>/wc-api/v2/orders/<id></h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl -X DELETE https://example.com/wc-api/v2/orders/645/?force=true \
|
|
-u consumer_key:consumer_secret
|
|
```
|
|
|
|
```javascript
|
|
WooCommerce.delete('orders/645/?force=true', function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
print(wcapi.delete("orders/645/", params={"force": True}).json())
|
|
```
|
|
|
|
```php
|
|
<?php print_r($woocommerce->orders->delete(645, true)); ?>
|
|
```
|
|
|
|
```ruby
|
|
woocommerce.delete("orders/645/, force: true).parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"message": "Permanently deleted order"
|
|
}
|
|
```
|
|
|
|
### Parameters ###
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
| `force` | string | Use `true` whether to permanently delete the order, defaults to `false`. Note that permanently deleting the order will return HTTP 200 rather than HTTP 202. |
|
|
|
|
## View Orders Count ##
|
|
|
|
This API lets you retrieve a count of all orders.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-get">GET</i>
|
|
<h6>/wc-api/v2/orders/count</h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl https://example.com/wc-api/v2/orders/count \
|
|
-u consumer_key:consumer_secret
|
|
```
|
|
|
|
```javascript
|
|
WooCommerce.get('orders/count', function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
print(wcapi.get("orders/count").json())
|
|
```
|
|
|
|
```php
|
|
<?php print_r($woocommerce->orders->get_count()); ?>
|
|
```
|
|
|
|
```ruby
|
|
woocommerce.get("orders/count").parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"count": 2
|
|
}
|
|
```
|
|
|
|
#### Available Filters ####
|
|
|
|
| Filter | Type | Description |
|
|
| -------- | ------ | ------------------------------------------------- |
|
|
| `status` | string | Orders by status. eg: `processing` or `cancelled` |
|
|
|
|
## View List Of Order Statuses ##
|
|
|
|
This API lets you retrieve a list of orders statuses available.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-get">GET</i>
|
|
<h6>/wc-api/v2/orders/statuses</h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl https://example.com/wc-api/v2/orders/statuses \
|
|
-u consumer_key:consumer_secret
|
|
```
|
|
|
|
```javascript
|
|
WooCommerce.get('orders/statuses', function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
print(wcapi.get("orders/statuses").json())
|
|
```
|
|
|
|
```php
|
|
<?php print_r($woocommerce->orders->get_statuses()); ?>
|
|
```
|
|
|
|
```ruby
|
|
woocommerce.get("orders/statuses").parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"order_statuses": {
|
|
"pending": "Pending Payment",
|
|
"processing": "Processing",
|
|
"on-hold": "On Hold",
|
|
"completed": "Completed",
|
|
"cancelled": "Cancelled",
|
|
"refunded": "Refunded",
|
|
"failed": "Failed"
|
|
}
|
|
}
|
|
```
|
|
|
|
## Create A Note For An Order ##
|
|
|
|
This API helps you to create a new note for an order.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-post">POST</i>
|
|
<h6>/wc-api/v2/orders/<id>/notes</h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl -X POST https://example.com/wc-api/v2/orders/645/notes \
|
|
-u consumer_key:consumer_secret \
|
|
-H "Content-Type: application/json" \
|
|
-d '{
|
|
"order_note": {
|
|
"note": "Order ok!!!"
|
|
}
|
|
}'
|
|
```
|
|
|
|
```javascript
|
|
var data = {
|
|
order_note: {
|
|
note: 'Order ok!!!'
|
|
}
|
|
};
|
|
|
|
WooCommerce.post('orders/645/notes', data, function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
data = {
|
|
"order_note": {
|
|
"note": "Order ok!!!"
|
|
}
|
|
}
|
|
|
|
print(wcapi.post("orders/645/notes", data).json())
|
|
```
|
|
|
|
```php
|
|
<?php
|
|
$data = array(
|
|
'order_note' => array(
|
|
'note' => 'Order ok!!!'
|
|
)
|
|
);
|
|
|
|
print_r($woocommerce->order_notes->create(645, $data));
|
|
?>
|
|
```
|
|
|
|
```ruby
|
|
data = {
|
|
order_note: {
|
|
note: "Order ok!!!"
|
|
}
|
|
}
|
|
|
|
woocommerce.post("orders/645/notes", data).parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"order_note": {
|
|
"id": "416",
|
|
"created_at": "2015-01-26T20:56:44Z",
|
|
"note": "Order ok!!!",
|
|
"customer_note": false
|
|
}
|
|
}
|
|
```
|
|
|
|
### Order Notes Properties ###
|
|
|
|
| Attribute | Type | Description |
|
|
| --------------- | ------- | ------------------------------------------------------------------------------------------------------------------ |
|
|
| `id` | integer | Order note ID <i class="label label-info">read-only</i> |
|
|
| `created_at` | string | UTC DateTime when the order note was created <i class="label label-info">read-only</i> |
|
|
| `note` | string | Order note <i class="label label-info">required</i> |
|
|
| `customer_note` | boolean | Shows/define if the note is only for reference or for the customer (the user will be notified). Default is `false` |
|
|
|
|
## View An Order Note ##
|
|
|
|
This API lets you retrieve and view a specific note from an order.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-get">GET</i>
|
|
<h6>/wc-api/v2/orders/<id>/notes/<note_id></h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl https://example.com/wc-api/v2/orders/645/notes/416 \
|
|
-u consumer_key:consumer_secret
|
|
```
|
|
|
|
```javascript
|
|
WooCommerce.get('orders/645/notes/416', function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
print(wcapi.get("orders/645/notes/416").json())
|
|
```
|
|
|
|
```php
|
|
<?php print_r($woocommerce->order_notes->get(645, 416)); ?>
|
|
```
|
|
|
|
```ruby
|
|
woocommerce.get("orders/645/notes/416").parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"order_note": {
|
|
"id": "416",
|
|
"created_at": "2015-01-26T20:56:44Z",
|
|
"note": "Order ok!!!",
|
|
"customer_note": false
|
|
}
|
|
}
|
|
```
|
|
|
|
<aside class="notice">
|
|
View the <a href="#order-notes-properties">Order Notes Properties</a> for more details on this response.
|
|
</aside>
|
|
|
|
## View List Of Notes From An Order ##
|
|
|
|
This API helps you to view all the notes from an order.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-get">GET</i>
|
|
<h6>/wc-api/v2/orders/<id>/notes</h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl https://example.com/wc-api/v2/orders/645/notes \
|
|
-u consumer_key:consumer_secret
|
|
```
|
|
|
|
```javascript
|
|
WooCommerce.get('orders/645/notes', function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
print(wcapi.get("orders/645/notes").json())
|
|
```
|
|
|
|
```php
|
|
<?php print_r($woocommerce->order_notes->get(645)); ?>
|
|
```
|
|
|
|
```ruby
|
|
woocommerce.get("orders/645/notes").parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"order_notes": [
|
|
{
|
|
"id": "416",
|
|
"created_at": "2015-01-26T20:56:44Z",
|
|
"note": "Order ok!!!",
|
|
"customer_note": false
|
|
},
|
|
{
|
|
"id": "415",
|
|
"created_at": "2015-01-26T20:16:14Z",
|
|
"note": "Order status changed from Processing to Completed.",
|
|
"customer_note": false
|
|
},
|
|
{
|
|
"id": "412",
|
|
"created_at": "2015-01-26T20:00:21Z",
|
|
"note": "Order item stock reduced successfully.",
|
|
"customer_note": false
|
|
},
|
|
{
|
|
"id": "411",
|
|
"created_at": "2015-01-26T20:00:09Z",
|
|
"note": "Order status changed from Pending Payment to Processing.",
|
|
"customer_note": false
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
<aside class="notice">
|
|
View the <a href="#order-notes-properties">Order Notes Properties</a> for more details on this response.
|
|
</aside>
|
|
|
|
## Update An Order Note ##
|
|
|
|
This API lets you make changes to an order note.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-put">PUT</i>
|
|
<h6>/wc-api/v2/orders/<id>/notes/<note_id></h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl -X PUT https://example.com/wc-api/v2/orders/645/notes/416 \
|
|
-u consumer_key:consumer_secret \
|
|
-H "Content-Type: application/json" \
|
|
-d '{
|
|
"order_note": {
|
|
"note": "Ok!"
|
|
}
|
|
}'
|
|
```
|
|
|
|
```javascript
|
|
var data = {
|
|
order_note: {
|
|
note: 'Ok!'
|
|
}
|
|
};
|
|
|
|
WooCommerce.put('orders/645/notes/416', data, function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
data = {
|
|
"order_note": {
|
|
"note": "Ok!"
|
|
}
|
|
}
|
|
|
|
print(wcapi.put("orders/645/notes/416", data).json())
|
|
```
|
|
|
|
```php
|
|
<?php
|
|
$data = array(
|
|
'order_note' => array(
|
|
'note' => 'Ok!'
|
|
)
|
|
);
|
|
|
|
print_r($woocommerce->order_notes->update(645, 416, $data));
|
|
?>
|
|
```
|
|
|
|
```ruby
|
|
data = {
|
|
order_note: {
|
|
note: "Ok!"
|
|
}
|
|
}
|
|
|
|
woocommerce.put("orders/645/notes/416", data).parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"order_note": {
|
|
"id": "416",
|
|
"created_at": "2015-01-26T20:56:44Z",
|
|
"note": "Ok!",
|
|
"customer_note": false
|
|
}
|
|
}
|
|
```
|
|
|
|
<aside class="notice">
|
|
View the <a href="#order-notes-properties">Order Notes Properties</a> for more details on this response.
|
|
</aside>
|
|
|
|
## Delete An Order Note ##
|
|
|
|
This API helps you delete an order note.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-delete">DELETE</i>
|
|
<h6>/wc-api/v2/orders/<id>/notes/<note_id></h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl -X DELETE https://example.com/wc-api/v2/orders/645/notes/416 \
|
|
-u consumer_key:consumer_secret
|
|
```
|
|
|
|
```javascript
|
|
WooCommerce.delete('orders/645/notes/416', function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
print(wcapi.delete("orders/645/notes/416").json())
|
|
```
|
|
|
|
```php
|
|
<?php print_r($woocommerce->order_notes->delete(645, 416)); ?>
|
|
```
|
|
|
|
```ruby
|
|
woocommerce.delete("orders/645/notes/416").parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"message": "Permanently deleted order note"
|
|
}
|
|
```
|
|
|
|
## Create A Refund For An Order ##
|
|
|
|
This API helps you to create a new refund for an order.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-post">POST</i>
|
|
<h6>/wc-api/v2/orders/<id>/refunds</h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl -X POST https://example.com/wc-api/v2/orders/645/refunds \
|
|
-u consumer_key:consumer_secret \
|
|
-H "Content-Type: application/json" \
|
|
-d '{
|
|
"order_refund": {
|
|
"amount": 10
|
|
}
|
|
}'
|
|
```
|
|
|
|
```javascript
|
|
var data = {
|
|
order_refund: {
|
|
amount: 10
|
|
}
|
|
};
|
|
|
|
WooCommerce.post('orders/645/refunds', data, function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
data = {
|
|
"order_refund": {
|
|
"amount": 10
|
|
}
|
|
}
|
|
|
|
print(wcapi.post("orders/645/refunds", data).json())
|
|
```
|
|
|
|
```php
|
|
<?php
|
|
$data = array(
|
|
'order_refund' => array(
|
|
'amount' => 10
|
|
)
|
|
);
|
|
|
|
print_r($woocommerce->order_refunds->create(645, $data));
|
|
?>
|
|
```
|
|
|
|
```ruby
|
|
data = {
|
|
order_refund: {
|
|
amount: 10
|
|
}
|
|
}
|
|
|
|
woocommerce.post("orders/645/refunds", data).parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"order_refund": {
|
|
"id": 649,
|
|
"created_at": "2015-01-26T19:29:32Z",
|
|
"amount": "10.00",
|
|
"reason": "",
|
|
"line_items": []
|
|
}
|
|
}
|
|
```
|
|
|
|
### Order Refunds Properties ###
|
|
|
|
| Attribute | Type | Description |
|
|
|--------------|---------|------------------------------------------------------------------------------------------|
|
|
| `id` | integer | Order note ID <i class="label label-info">read-only</i> |
|
|
| `created_at` | string | UTC DateTime when the order refund was created <i class="label label-info">read-only</i> |
|
|
| `amount` | string | Refund amount <i class="label label-info">required</i> |
|
|
| `reason` | string | Reason for refund |
|
|
| `line_items` | array | List of order items to refund. See [Line Items Properties](line-items-properties) |
|
|
|
|
## View An Order Refund ##
|
|
|
|
This API lets you retrieve and view a specific refund from an order.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-get">GET</i>
|
|
<h6>/wc-api/v2/orders/<id>/refunds/<refund_id></h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl https://example.com/wc-api/v2/orders/645/refunds/649 \
|
|
-u consumer_key:consumer_secret
|
|
```
|
|
|
|
```javascript
|
|
WooCommerce.get('orders/645/refunds/649', function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
print(wcapi.get("orders/645/refunds/649").json())
|
|
```
|
|
|
|
```php
|
|
<?php print_r($woocommerce->order_refunds->get(645, 649)); ?>
|
|
```
|
|
|
|
```ruby
|
|
woocommerce.get("orders/645/refunds/649").parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"order_refund": {
|
|
"id": 649,
|
|
"created_at": "2015-01-26T19:29:32Z",
|
|
"amount": "10.00",
|
|
"reason": "",
|
|
"line_items": []
|
|
}
|
|
}
|
|
```
|
|
|
|
<aside class="notice">
|
|
View the <a href="#order-refunds-properties">Order Refunds Properties</a> for more details on this response.
|
|
</aside>
|
|
|
|
## View List Of Refunds From An Order ##
|
|
|
|
This API helps you to view all the refunds from an order.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-get">GET</i>
|
|
<h6>/wc-api/v2/orders/<id>/refunds</h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl https://example.com/wc-api/v2/orders/645/refunds \
|
|
-u consumer_key:consumer_secret
|
|
```
|
|
|
|
```javascript
|
|
WooCommerce.get('orders/645/refunds', function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
print(wcapi.get("orders/645/refunds").json())
|
|
```
|
|
|
|
```php
|
|
<?php print_r($woocommerce->order_refunds->get(645)); ?>
|
|
```
|
|
|
|
```ruby
|
|
woocommerce.get("orders/645/refunds").parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"order_refunds": [
|
|
{
|
|
"id": 649,
|
|
"created_at": "2015-01-26T19:29:32Z",
|
|
"amount": "10.00",
|
|
"reason": "",
|
|
"line_items": []
|
|
},
|
|
{
|
|
"id": 647,
|
|
"created_at": "2015-01-26T19:19:06Z",
|
|
"amount": "21.99",
|
|
"reason": "",
|
|
"line_items": [
|
|
{
|
|
"id": 514,
|
|
"subtotal": "-21.99",
|
|
"subtotal_tax": "0.00",
|
|
"total": "-21.99",
|
|
"total_tax": "0.00",
|
|
"price": "-21.99",
|
|
"quantity": 1,
|
|
"tax_class": "reduced-rate",
|
|
"name": "Premium Quality",
|
|
"product_id": 546,
|
|
"sku": "",
|
|
"meta": []
|
|
},
|
|
{
|
|
"id": 515,
|
|
"subtotal": "0.00",
|
|
"subtotal_tax": "0.00",
|
|
"total": "0.00",
|
|
"total_tax": "0.00",
|
|
"price": "0.00",
|
|
"quantity": 0,
|
|
"tax_class": null,
|
|
"name": "Ship Your Idea",
|
|
"product_id": 613,
|
|
"sku": "",
|
|
"meta": []
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
<aside class="notice">
|
|
View the <a href="#order-refunds-properties">Order Refunds Properties</a> for more details on this response.
|
|
</aside>
|
|
|
|
## Update An Order Refund ##
|
|
|
|
This API lets you make changes to an order refund.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-put">PUT</i>
|
|
<h6>/wc-api/v2/orders/<id>/refunds/<refund_id></h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl -X PUT https://example.com/wc-api/v2/orders/645/refunds/649 \
|
|
-u consumer_key:consumer_secret \
|
|
-H "Content-Type: application/json" \
|
|
-d '{
|
|
"order_refund": {
|
|
"reason": "Because was it necessary!"
|
|
}
|
|
}'
|
|
```
|
|
|
|
```javascript
|
|
var data = {
|
|
order_refund: {
|
|
reason: 'Because was it necessary!'
|
|
}
|
|
};
|
|
|
|
WooCommerce.put('orders/645/refunds/649', data, function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
data = {
|
|
"order_refund": {
|
|
"reason": "Because was it necessary!"
|
|
}
|
|
}
|
|
|
|
print(wcapi.put("orders/645/refunds/649", data).json())
|
|
```
|
|
|
|
```php
|
|
<?php
|
|
$data = array(
|
|
'order_refund' => array(
|
|
'reason' => 'Because was it necessary!'
|
|
)
|
|
);
|
|
|
|
print_r($woocommerce->order_refunds->update(645, 649, $data));
|
|
?>
|
|
```
|
|
|
|
```ruby
|
|
data = {
|
|
order_refund: {
|
|
reason: "Because was it necessary!"
|
|
}
|
|
}
|
|
|
|
woocommerce.put("orders/645/refunds/649", data).parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"order_refund": {
|
|
"id": 649,
|
|
"created_at": "2015-01-26T19:29:32Z",
|
|
"amount": "10.00",
|
|
"reason": "Because was it necessary!",
|
|
"line_items": []
|
|
}
|
|
}
|
|
```
|
|
|
|
<aside class="notice">
|
|
View the <a href="#order-refunds-properties">Order Refunds Properties</a> for more details on this response.
|
|
</aside>
|
|
|
|
## Delete An Order Refund ##
|
|
|
|
This API helps you delete an order refund.
|
|
|
|
### HTTP Request ###
|
|
|
|
<div class="api-endpoint">
|
|
<div class="endpoint-data">
|
|
<i class="label label-delete">DELETE</i>
|
|
<h6>/wc-api/v2/orders/<id>/refunds/<refund_id></h6>
|
|
</div>
|
|
</div>
|
|
|
|
```shell
|
|
curl -X DELETE https://example.com/wc-api/v2/orders/645/refunds/649 \
|
|
-u consumer_key:consumer_secret
|
|
```
|
|
|
|
```javascript
|
|
WooCommerce.delete('orders/645/refunds/649', function(err, data, res) {
|
|
console.log(res);
|
|
});
|
|
```
|
|
|
|
```python
|
|
print(wcapi.delete("orders/645/refunds/649").json())
|
|
```
|
|
|
|
```php
|
|
<?php print_r($woocommerce->order_refunds->delete(645, 649)); ?>
|
|
```
|
|
|
|
```ruby
|
|
woocommerce.delete("orders/645/refunds/649").parsed_response
|
|
```
|
|
|
|
> JSON response example:
|
|
|
|
```json
|
|
{
|
|
"message": "Permanently deleted refund"
|
|
}
|
|
```
|