trieb-work / zoho-ts Goto Github PK

View Code? Open in Web Editor NEW

13.0 6.0 5.0 849 KB

Zoho Inventory, Invoice and Books Typescript library with several predefined functions

License: Apache License 2.0

TypeScript 99.63% JavaScript 0.37%

typescript zoho zoho-books zoho-inventory zoho-invoice zoho-one

zoho-ts's People

Contributors

Stargazers

Watchers

Forkers

granduke klevytskyi hugopereez ukanwat amexn-me

zoho-ts's Issues

Add timeout config

Some bulk requests take forever

Add an "enableTracking" function

POST https://inventory.zoho.eu/api/v1/shipmentorders/XXXX/enable/tracking
JSONString: {"carrier":"DPD","tracking_number":"XXXX","notification_email_ids":[""],"notification_phone_numbers":[],"aftership_carrier_code":"dpd"}
organization_id: XXXX

make it selectable to use inventory or books

We want to make it selectable, to use the zoho books or inventory api.

Would be also really cool: Automatically switch to Zoho Books API, if API request limit is running low. Can be checked with response headers from Zoho.

createContact: street2 should be optional

https://www.zoho.com/inventory/api/v1/#Contacts_Create_a_Contact

zoho does not require a street2 key to be set

Use get Bulk API endpoint for articles

https://inventory.zoho.com/api/v1/itemdetails?item_ids=<item-id-list>&organization_id=<organizationID>

Request Method : GET

You can pass upto 100 item-ids in the list

TokenHost parameter

Hello - great work on this. Need ability to set tokenHost on client.ts to change domain from .eu to .com just like can pass baseUrl.

Cant change API flavors

Cant change API flavors. Trying to use Books, connects to inventory

Add missing functions for packages

Make use of partial, pick or extend in Typescript

The types of the API is "selfmade" - and we are repeating ourselves a lot in order to GET, or UPDATE data. - types are optional or mandatory. We can enhance that!

v5: add salesorder list by customviewID

the old function searchSalesOrdersWithScrolling does no longer exist at the Zoho v0.5 version. We have to add this functionality to the salesorder list

Check API result of salesOrder.confirm

zoho-ts/src/service/salesOrder.ts

Line 160 in f86ffbd

await this.client.post<{ salesorder: SalesOrder }>({

The zoho client does not check the json return and status code. I would suggest to throw an error if the status code is not 200 or if the returned json has some errors like in this example response:

{"code":0,"message":"Sales order status has been changed to Confirmed.","data":{"ava_invoice_ids":[],"email_errors_info":[{"code":36007,"ids":["116240000001641005","116240000001641027","116240000001641045"],"message":"Invalid sales order status."}],"email_success_info":{"message":"The status of the Sales order has been changed to Open."}}}

Is 25 a hard limit or can we confirm even more with one API request to safe some zoho api requests?

zoho-ts/src/service/salesOrder.ts

Line 149 in f86ffbd

    
                * Confirm one ore many salesorders at once. Can be used for unlimited amount of SalesOrders. Creates chunks of 25.

If it is a hard limit please close the issue otherwise I would suggest to increase it to at least 100 and make the option configurable via an optional argument like this:

public async confirm(ids: string[], chunkSize: number = 100): Promise<void> {