Recently I got the opportunity to do Sitecore's "Implementing Experience Commerce" training course, and get certified in the details of how Commerce works these days. While I was doing the lab exercises for the course I hit an interesting bug, which seemed like just the sort of thing that others might encounter.
So if you're extending the Commerce OData APIs, watch out: