Create an order

Creates an order.

By default, product inventory is not claimed when creating an order.

There are additional optional parameters that can be specified in the body of the request when creating an order:

inventory_behaviour: The behaviour to use when updating inventory. (default: bypass)
- bypass: Do not claim inventory.
- decrement_ignoring_policy: Ignore the product's inventory policy and claim inventory.
- decrement_obeying_policy: Follow the product's inventory policy and claim inventory, if possible.
send_receipt: Whether to send an order confirmation to the customer. (default: `false`)

Note

If you're working on a private app and order confirmations are still being sent to the customer when send_receipt is set to false, then you need to disable the Storefront API from the private app's page in the Shopify admin.

send_fulfillment_receipt: Whether to send a shipping confirmation to the customer. (default: `false`)

Note

If you are including shipping_address or billing_address, make sure to pass both first_name and last_name. Otherwise both these addresses will be ignored.

Usage notes:
If you're using this endpoint with a trial or Partner development store, then you can create no more than 5 new orders per minute.

application/json

Body

示例

Create a comprehensive orderCreate a partially paid order with a new customer and addressesCreate a pending order with an existing customerCreate a simple order and fulfill itCreate a simple order with only a product variant ID and no optional parametersCreate a simple order without sending an order receipt or a fulfillment receiptCreate a simple order, sending an order confirmation and a shipping confirmation to the customerCreate an order and apply a discountCreate an order with tax lines split across taxable line items

{
    "order": {
        "id": 1073459962,
        "admin_graphql_api_id": "gid://shopify/Order/1073459962",
        "app_id": 755357713,
        "browser_ip": null,
        "buyer_accepts_marketing": false,
        "cancel_reason": null,
        "cancelled_at": null,
        "cart_token": null,
        "checkout_id": null,
        "checkout_token": null,
        "client_details": null,
        "closed_at": null,
        "confirmed": true,
        "contact_email": null,
        "created_at": "2023-01-03T12:26:04-05:00",
        "currency": "EUR",
        "current_subtotal_price": "224.97",
        "current_subtotal_price_set": {
            "shop_money": {
                "amount": "224.97",
                "currency_code": "EUR"
            },
            "presentment_money": {
                "amount": "224.97",
                "currency_code": "EUR"
            }
        },
        "current_total_discounts": "0.00",
        "current_total_discounts_set": {
            "shop_money": {
                "amount": "0.00",
                "currency_code": "EUR"
            },
            "presentment_money": {
                "amount": "0.00",
                "currency_code": "EUR"
            }
        },
        "current_total_duties_set": null,
        "current_total_price": "238.47",
        "current_total_price_set": {
            "shop_money": {
                "amount": "238.47",
                "currency_code": "EUR"
            },
            "presentment_money": {
                "amount": "238.47",
                "currency_code": "EUR"
            }
        },
        "current_total_tax": "13.50",
        "current_total_tax_set": {
            "shop_money": {
                "amount": "13.50",
                "currency_code": "EUR"
            },
            "presentment_money": {
                "amount": "13.50",
                "currency_code": "EUR"
            }
        },
        "customer_locale": null,
        "device_id": null,
        "discount_codes": [],
        "email": "",
        "estimated_taxes": false,
        "financial_status": "paid",
        "fulfillment_status": null,
        "gateway": "",
        "landing_site": null,
        "landing_site_ref": null,
        "location_id": null,
        "merchant_of_record_app_id": null,
        "name": "#1002",
        "note": null,
        "note_attributes": [],
        "number": 2,
        "order_number": 1002,
        "order_status_url": "https://jsmith.myshopify.com/548380009/orders/319b6019f95405472f9713cef70a99a8/authenticate?key=e81d0103ae0eb50bf94365dca29df99f",
        "original_total_duties_set": null,
        "payment_gateway_names": [
            ""
        ],
        "phone": null,
        "presentment_currency": "EUR",
        "processed_at": "2023-01-03T12:26:04-05:00",
        "processing_method": "",
        "reference": null,
        "referring_site": null,
        "source_identifier": null,
        "source_name": "755357713",
        "source_url": null,
        "subtotal_price": "224.97",
        "subtotal_price_set": {
            "shop_money": {
                "amount": "224.97",
                "currency_code": "EUR"
            },
            "presentment_money": {
                "amount": "224.97",
                "currency_code": "EUR"
            }
        },
        "tags": "",
        "tax_lines": [
            {
                "price": "13.50",
                "rate": 0.06,
                "title": "State tax",
                "price_set": {
                    "shop_money": {
                        "amount": "13.50",
                        "currency_code": "EUR"
                    },
                    "presentment_money": {
                        "amount": "13.50",
                        "currency_code": "EUR"
                    }
                },
                "channel_liable": null
            }
        ],
        "taxes_included": false,
        "test": false,
        "token": "319b6019f95405472f9713cef70a99a8",
        "total_discounts": "0.00",
        "total_discounts_set": {
            "shop_money": {
                "amount": "0.00",
                "currency_code": "EUR"
            },
            "presentment_money": {
                "amount": "0.00",
                "currency_code": "EUR"
            }
        },
        "total_line_items_price": "224.97",
        "total_line_items_price_set": {
            "shop_money": {
                "amount": "224.97",
                "currency_code": "EUR"
            },
            "presentment_money": {
                "amount": "224.97",
                "currency_code": "EUR"
            }
        },
        "total_outstanding": "0.00",
        "total_price": "238.47",
        "total_price_set": {
            "shop_money": {
                "amount": "238.47",
                "currency_code": "EUR"
            },
            "presentment_money": {
                "amount": "238.47",
                "currency_code": "EUR"
            }
        },
        "total_shipping_price_set": {
            "shop_money": {
                "amount": "0.00",
                "currency_code": "EUR"
            },
            "presentment_money": {
                "amount": "0.00",
                "currency_code": "EUR"
            }
        },
        "total_tax": "13.50",
        "total_tax_set": {
            "shop_money": {
                "amount": "13.50",
                "currency_code": "EUR"
            },
            "presentment_money": {
                "amount": "13.50",
                "currency_code": "EUR"
            }
        },
        "total_tip_received": "0.00",
        "total_weight": 0,
        "updated_at": "2023-01-03T12:26:04-05:00",
        "user_id": null,
        "billing_address": null,
        "customer": null,
        "discount_applications": [],
        "fulfillments": [],
        "line_items": [
            {
                "id": 1071823172,
                "admin_graphql_api_id": "gid://shopify/LineItem/1071823172",
                "fulfillable_quantity": 3,
                "fulfillment_service": "manual",
                "fulfillment_status": null,
                "gift_card": false,
                "grams": 1300,
                "name": "Big Brown Bear Boots",
                "price": "74.99",
                "price_set": {
                    "shop_money": {
                        "amount": "74.99",
                        "currency_code": "EUR"
                    },
                    "presentment_money": {
                        "amount": "74.99",
                        "currency_code": "EUR"
                    }
                },
                "product_exists": false,
                "product_id": null,
                "properties": [],
                "quantity": 3,
                "requires_shipping": true,
                "sku": null,
                "taxable": true,
                "title": "Big Brown Bear Boots",
                "total_discount": "0.00",
                "total_discount_set": {
                    "shop_money": {
                        "amount": "0.00",
                        "currency_code": "EUR"
                    },
                    "presentment_money": {
                        "amount": "0.00",
                        "currency_code": "EUR"
                    }
                },
                "variant_id": null,
                "variant_inventory_management": null,
                "variant_title": null,
                "vendor": null,
                "tax_lines": [
                    {
                        "channel_liable": null,
                        "price": "13.50",
                        "price_set": {
                            "shop_money": {
                                "amount": "13.50",
                                "currency_code": "EUR"
                            },
                            "presentment_money": {
                                "amount": "13.50",
                                "currency_code": "EUR"
                            }
                        },
                        "rate": 0.06,
                        "title": "State tax"
                    }
                ],
                "duties": [],
                "discount_allocations": []
            }
        ],
        "payment_details": null,
        "payment_terms": null,
        "refunds": [],
        "shipping_address": null,
        "shipping_lines": []
    }
}

Note

Note

请求参数

示例代码

返回响应