apidoc: document all user-facing invoice methods