create_order

POST https://api.bootic.net/v1/shops/{shop_id}/orders

Use this relation to create a new order for a given shop. New orders default to the checkout state.

This relation is available only for shops owned by your current scope and credentials (required scope: admin).

This endpoint is in early development and might change in the future.
Consider this a BETA feature. 
$ curl -XPOST -H'Accept:application/json' -H'Content-Type:application/json' -H "Authorization: Bearer xxxx" -i https://api.bootic.net/v1/shops/:shop_id/orders -d[REQUEST_BODY]

Request body

{
  "line_items": [
    {
      "variant_id": 1234,
      "units": 3
    },
    {
      "variant_id": 3222,
      "units": 1
    }
  ],
  "contact": {
    "email": "joe@bloggs.com",
    "name": "Joe Bloggs",
    "phone_number": "12322222222"
  },
  "address": {
    "id": 35666
  }
}
line_items
Array of objects with variant_id and units. Variant must exist in shop. Required.
contact
Full contact data, or just email if contact already exists in shop. Optional.
address
Object with address id. It will copy address attributes by passed id. Optional.

Successful response

For the moment this endpoint can only copy attributes for existing addresses. You must make sure you pass and existing address.id. You can get this value from querying previous orders created via Bootic's online shops. 
Status: 201 Created
Content-Type: application/json; charset=utf-8
Connection: keep-alive
ETag: "0728e2965bd03e20a7f1c33add2f8775"
Last-Modified: Fri, 20 Jun 2014 22:34:14 GMT
Cache-Control: must-revalidate, private, max-age=0
Date: Wed, 31 Jul 2013 21:11:52 GMT
X-OAuth-Scopes: admin
{
  "_links": {
    "self": {
      "href": "https://api.bootic.net/v1/shops/10/orders/R1C3964"
    },
    "btc:update_order": {
      "href": "https://api.bootic.net/v1/shops/10/orders/R1C3964",
      "method": "put"
    },
    "btc:web_cart": {
      "href": "http://www.acme.com/cart/R1C3964",
      "type": "text/html"
    },
    "btc:web_checkout": {
      "href": "https://checkout.bootic.net/orders/R1C3964",
      "type": "text/html"
    }
  },
  "id": 583085,
  "shop_id": 29,
  "code": "R1C3964",
  "status": "checkout",
  "net_total": 29990,
  "total": 33704,
  "created_on": "2013-10-19T11:06:18.000Z",
  "updated_on": "2013-10-19T11:20:14.000Z",
  "pending_on": null,
  "closed_on": null,
  "shipped_on": null,
  "shipping_total": 3714,
  "shipping_description": "",
  "discount_total": 100,
  "tracking_code": null,
  "courier_name": null,
  "shipped_email_sent": false,
  "closed_email_sent": false,
  "fulfillment": {
    "fulfillment_method": "shipping"
  },
  "payment_info": {
    "name": "Webpay",
    "type": "webpay",
    "data": {
      "tbk_numero_cuotas": 1,
      "tbk_codigo_autorizacion": "abc",
      "tbk_id_transaccion": 3222,
      "tbk_tipo_pago": "VD"
    }
  },
  "_embedded": {
    "address": {
      "street": "Av. Brasil 20",
      "street_2": "4to piso",
      "locality_name": "Valparaiso",
      "region_name": "Valparaiso",
      "country_name": "Chile",
      "postal_code": null,
      "country_code": "CL"
    },
    "contact": {
      "name": "Joe Bloggs",
      "email": "joe@bloggs.com",
      "phone_number": "12322222222"
    },
    "promotion": {
      "name": "Summer discount",
      "discount": 100,
      "discount_type": "$",
      "free_shipping": false
    },
    "discounts": [

    ],
    "line_items": [
      {
        "_links": {
          "product": {
            "href": "https://api.bootic.net/v1/shops/29/products/130924-tinto"
          }
        },
        "product_id": 31166,
        "product_title": "130924 Tinto",
        "unit_price": 29990,
        "units": 3,
        "discount_total": 100,
        "net_total": 89970,
        "total": 89870,
        "product_weight_in_grams": 1400,
        "variant_id": 1234,
        "variant_title": "39",
        "variant_sku": "SXDD3",
        "requested_units": 3,
        "_embedded": {
          "discounts": [
            {
              "class": [
                "discount"
              ],
              "amount": 100,
              "description": "Super offer!"
            }
          ],
          "image": {
            "class": [
              "image",
              "asset"
            ],
            "links": {
              "thumbnail": {
                "href": "http://cdn.bootic.net/29/thumbnail/73763-_MG_4360.JPG"
              },
              "small": {
                "href": "http://cdn.bootic.net/29/small/73763-_MG_4360.JPG"
              },
              "medium": {
                "href": "http://cdn.bootic.net/29/medium/73763-_MG_4360.JPG"
              },
              "large": {
                "href": "http://cdn.bootic.net/29/large/73763-_MG_4360.JPG"
              },
              "original": {
                "href": "http://cdn.bootic.net/29/original/73763-_MG_4360.JPG"
              }
            },
            "file_name": "_MG_4360.JPG",
            "title": ""
          }
        }
      }
    ]
  }
}

The returned order entity includes a btc:web_checkout link relation that points to Bootic’s checkout web checkout pages, where a human user can complete and pay for the order.

There’s also a btc:web_cart link that will direct the user to the web shopping cart where the user can continue to modify the cart by adding or removing products, as well as proceed to the checkout phase and finalize the order.

Invalid response

Status: 422 Unprocessable Entity
Content-Type: application/json; charset=utf-8
Connection: keep-alive
ETag: "0728e2965bd03e20a7f1c33add2f8775"
Last-Modified: Fri, 20 Jun 2014 22:34:14 GMT
Cache-Control: must-revalidate, private, max-age=0
Date: Wed, 31 Jul 2013 21:11:52 GMT
X-OAuth-Scopes: admin
{
  "_class": [
    "errors"
  ],
  "_embedded": {
    "errors": [
      {
        "_class": [
          "error"
        ],
        "field": "variant.id",
        "messages": [
          "Variant 32222 does not exist in this shop"
        ]
      }
    ]
  }
}

Examples

Contact information will be looked up by email, so you can pass that field alone and your new order will re-use the existing contact.

{
  "contact": {
    "email": "joe@bloggs.com"
  },
  "line_items": [
    {
      "variant_id": 1233,
      "units": 1
    }
  ]
}

Passing more contact attributes for an existing email will update contact information for that contact, including other orders that share it.

{
  "contact": {
    "email": "joe@bloggs.com",
    "name": "New Name"
  },
  "line_items": [
    {
      "variant_id": 1233,
      "units": 1
    }
  ]
}

If the email is not found, a new contact will be created. New contacts require email, phone_number and name attributes.

{
  "contact": {
    "email": "joe@bloggs.com",
    "name": "New Name",
    "phone_number": "1244333333"
  },
  "line_items": [
    {
      "variant_id": 1233,
      "units": 1
    }
  ]
}

You can create a new order in the “checkout” state with no contact or address information. ie. a “cart” order that needs to be completed by a human user.

{
  "line_items": [
    {
      "variant_id": 1233,
      "units": 1
    }
  ]
}

See update_order

Guides