Improved documentation and tests of shopping API