Skip to main content

What's new

Here you‘ll find all enhancements and updates made to the Yokoy API, in chronological order.

Version 1.21.c​

Changed on 19 July 2024

  • Supplier endpoints
    • d1. Added codingType attribute that lets you determine how invoices are coded for the supplier.
    • d2. Added isInternalSupplier attribute that determines whether the supplier is an intercompany supplier.

Version 1.20​

Changed on 3 July 2024

  • Supplier endpoints
    • Added defaultApproverFirstName, defaultApproverLastName, defaultCategoryName, defaultCostCenterName, and paymentTermIds attributes for legal entity suppliers.
    • Include internalSupplierId and isTemplateOneTimeSupplier attributes for organization suppliers.
  • User endpoints
    • Updated the endpoint description to specify that user email addresses must be unique for the organization.

Version 1.19​

Changed on 1 July 2024

  • Invoice endpoints
    • customInformation object added for invoice line items.

Version 1.18​

Changed on 18 June 2024

  • Transaction endpoints
    • Returns expenseId if the transaction has been matched.

Version 1.17​

Changed on 30 May 2024

  • Invoice endpoints
    • Added support for Swiss QR-Bill codes. If an invoice contains a QR code, the information is returned in the qrInfo attribute.
    • Added one-time supplier information (oneTimeSupplierInfo attribute) to invoices. Used for SAP systems only.

Changed on 27 May 2024

  • Supplier endpoints
    • Added the isTemplateOneTimeSupplier attribute to the organization supplier endpoints. This attribute is used to determine whether a supplier is a one-time supplier in SAP.

Version 1.16​

Changed on 8 May 2024

  • Transaction endpoints
    • New endpoints to retrieve all transactions or a single transaction in Yokoy associated with Yokoy Platinum Visa and Yokoy Business Mastercards or from a third party provider integrated with Yokoy.

Version 1.15​

Changed on 3 May 2024.

  • Invoice endpoint
    • New endpoint to retrieve the invoice PDF in base64 format. Instead of retrieving the PDF file, you can now get the invoice as a base64 encoded string.
  • Reviewed the API spec:
    • Updated all endpoint descriptions.
    • Changed the order in which the endpoints are grouped.
    • Added currency and notifyAssistant attributes in the Users endpoint.
    • Included the date formats for created & lastModified attributes in the Expense and Invoice endpoints.
    • Added explanation of status attribute values in the Invoice endpoint.
    • Added explanation regarding organization and legal entity suppliers.
    • Updated examples for all attributes.

Version 1.14​

Changed on 24 Apr 2024.

  • FX rates endpoints
    • New endpoint to upload a new foreign exchange conversion rate source to Yokoy. By default, Yokoy uses Open Exchange Rates as source for converting expense and invoice amounts from one currency to another, but with this new endpoint, you can add your own foreign exchange rates for a specific date.

Version 1.13​

Changed on 8 April 2024.

  • External invoices endpoint
    • New endpoint to upload external invoices to Yokoy that have been matched with POs and GRs outside Yokoy.
  • Expenses endpoint
    • Added fxRates attribute to return the foreign exchange rates used to convert expense amounts into other currencies.
  • Invoice endpoint
    • Added fxRates attribute to return the foreign exchange rates used to convert the original invoice amount into other currencies.
  • Supplier endpoint
    • Clarified the format of the internalSupplierId.

Version 1.12.1​

Changed on 25 March 2024.

  • Purchase order endpoint
    • Added goodsReceiptId, goodsReceiptItemId, goodsReceiptNumber, purchaseOrderNumber, and matchStatus fields, which are used for invoice matching.
    • Clarified the description of the itemNumber attribute.
  • Enhancements made to improve query performance.
  • Filtering added to several endpoints.

Version 1.12​

Changed on 4 March 2024.

  • User endpoint
    • Added created and lastModified properties.
  • Invoice endpoint
    • Added created, lastModified, and eventLog properties.
    • Added examples for documentData, invoiceNumber, postingDate, date, serviceDate
    • Corrected paymentInformation property (was documented as bankAccount although the payload returned the correct property).

Version 1.11​

Changed on 7 February 2024.

  • Suppliers endpoint
    • Added taxNumbers property (array of strings) to the schema to support multiple tax numbers.
taxNumber attribute

To be deprecated in the future. For the moment, it is present in the schema, but use the taxNumbers attribute to specify an array of strings moving forward.

  • Invoice endpoint
    • Added serviceStartDate and serviceEndDate to the line item to support service dates.

Version 1.10​

Changed on 5 January 2024.

Version 1.9​

Changed on 3 January 2024.

  • Expense endpoints
    • Added two new endpoints to download expense receipt and attachments:
      • /expenses/{expenseId}/attachments/{attachmentName}
      • /expenses/{expenseId}/receipt

Version 1.8​

Changed on 19 December 2023.

  • Expense endpoints
    • Enhanced the Expense endpoint to return additional category items (additionalCategoryItems):
      • categoryId: reference to the expense category.
      • costCenterId: nullable reference to the cost object.
      • taxRateId: nullable reference to the VAT rate object.
      • gross: Gross amount allocated to the additional category. For each additional category, the gross amount is subtracted from the total claim.
  • Tag endpoint
    • Enhanced the Tag endpoint to allow you to read, create, and edit tags with the following additional properties:
      • invoiceApproverIds: List of unique user IDs, which corresponds to the Invoice approver dropdown in the app.
      • expenseApproverIds:List of unique user IDs, which corresponds to the Expense approver dropdown in the app.