[#webmachine] add Flow.md to document how api is used
[#grape] changes to Order model to handle error