The provided yml files for generating the OpenAPI specs are absolutely riddled with errors and inconsistencies. 

From missing fields on the objects, to just incorrectly named resource objects. I'm having to go through and manually changing the spec to actually match was is returned from the API. 

Finding this with both the BooksAPI and InventoryAPI. 

https://www.zoho.com/inventory/api/v1/openapi-all.zip

For example, the last one I ran into. The spec has retrieving a Purchase Order as the key of the json being "purchase_order" in fact it is returned as "purchaseorder". 

Maybe consider writing some tests around these docs so we can make sure the information is accurate. This is so frustrating for us trying to consume the API. I can't trust any of my types.