Notes
Happy new year! We had a long sprint over the holidays, so we’ve got a lot of stuff in this release.
We’ve set a removal date for some elements that were deprecated in the past. On February 4, we’ll remove the follow:
- Entire ISDs endpoint
- dttmLoaded meta attribute from all records
- A few unused subrecipient attributes: duns_four, risk_level, risk_period_end_date, supplier_group, and tax_locations
We’ve published a migration guide for these changes here.
We got the basic function of the Locations API working behind the scenes, a big step toward general availability. We implemented paginated responses and added configuration options for the data source.
We found some places to cut our AWS hosting costs by cleaning up development resources, and we upgraded our MySQL databases (the storage layer behind the Finance API).
We made some performance upgrades to our slowest endpoints. These all run significantly faster:
- billingSchedules
- externalCustomers
- isdLines
- purchaseOrders
- supplierInvoices
In addition to the improved response speed, you can now filter all of these endpoints by any of their attributes, not just the particular ones we previously allowed. Some of those queries might run a bit slow, but they’ll still be faster than querying all of the records and throwing out the ones you don’t want. If these new filters see heavy use, we’ll consider additional performance improvements in the future.
The supplierInvoices endpoint includes some attributes whose names don’t closely match their contents. We’re moving to new attribute names for these. The old attributes are still available, but are now deprecated. The newly named attributes are available now. If your integration uses any of the deprecated attributes, you’ll need to switch to the new ones. A full migration guide for supplier invoice attribute names is here.
API changes
- billingSchedules, externalCustomers, isdLines, purchaseOrders, and supplierInvoices: all attributes can now be used as filters
- supplierInvoices: newly deprecated attributes:
- amount (use totalAmount instead)
- invoiceNumber (use record ID instead)
- name
- supplierInvoicesId (use supplierInvoiceNumber instead)
- supplierName (use company instead)
- Migration guide