This API provides real-time state of an order. Additionally, it allows for the updating of an order state when circumstances change. There is currently only one update allowed, which sets an order into preparation stage once an upload is complete. Here is the typical usage:
- Order is created using the order endpoint.
- Images are uploaded into the order using the image endpoint within the order.
- Order is moved from WAITING_FOR_UPLOAD state to PREPARING state using a PUT to this Order State endpoint.
- Order processes normally.
Note that order state updates will only succeed if the order is in WAITING_FOR_UPLOAD state and if all images are in READY state. For Shutterfly to process the order, it is mandatory that the application make this update after uploading relevant images.