Release Notes

API, Webhooks, Generic Connector, and SFTP

In this page:

Release Notes

This section contains information about new features and enhancements to the Zyllem API, Webhooks, Generic Connector, and SFTP integration over time (starting from v6.23).

Release

Description

v6.27
10Oct2021

API

  • The Get media download link now supports documents (in the past, it only supports image artifacts).

  • A new field 'deleted' has been added to the response schema of Get operator vehicle type by id. 'True' denotes that the vehicle has been deleted and can be recovered through the Recycle Bin. 'False' means that the vehicle was not deleted and is a readily available resource. (Also applies to legacy API)

  • A new field 'stopguid' has been added to the response schema of Get shift activities. 'Stopguid' is the unique ID of a stop. You can use this ID if, for instance, you want to get all activities of a certain stop, then you can use query Zyllem using this ID.

Generic Connector
When Executing Actions, you will notice that the Destination columns display the same text as the Origin.

v6.24.1.2
21Jun2021

API

  1. createdAt - when the activity was created.
  2. capturedAt - when the geo-coordinates were last refreshed on mobile (that is, when the location last changed). This has the same value as dateTime, which will be deprecated in the future (date to be announced).
  3. recordedAt - when the geo-coordinates were last recorded on mobile based on the tracking interval setting (aka heartbeat).

Webhooks

  • New field executedAt on the Shift webhooks. That is, the date and time on the user's mobile device when the user initiated the event (open/close/postpone a location, etc.). This field applies to the following events: ShiftActivityRouteOpenLocation, ShiftActivityRouteCloseLocation , ShiftActivityRouteInvalidateLocation, ShiftActivityRoutePostpone, ShiftActivityRouteRemovePostpone.

v6.24.1
24May2021

API

  • Support for externalId when booking items. It is an optional item property that you can use to contain the item's unique ID on your (client) side. If defined, must be unique across the enterprise. If defined and is found to be a duplicate, you'll get an error. See API reference.

v6.24
2May2021

API

  • Standardized units of measurements for time (minutes) and distance (meters).

Webhooks

  • All dates and times are now formatted based on the time zone of the user who registered the Webhook APIs.
  • The "eta" field has been replaced with "scheduledEta".

Generic Connector

  • New HTTP Mode in Generic Connector allows operators to synchronize with Zyllem via API based communication!

v6.23
20Jan2021

API

  • You can now book and access items in any Network Group (in the past, you can only do so one network group at a time). To enable this feature, set the network group access to All Network Groups in your API settings and provide the Network Id in your API calls (click on the link to know more).

Known Issues

This section contains information about the known issues of Zyllem API, Webhooks, Generic Connector, and SFTP integration over time (starting from v6.23).

Legend:
"- note" = Unresolved. Ongoing development to fix issue.
"+ note" = Fixed. Release version indicated.

Version

Known Issues

v6.24
2May2021

API

  • Actions performed via the API will be logged under the user defined in the API SETTINGS (Inbound Communication). There is no authentication for different users within the same operator. ZYL-14010

  • When configuring the API SETTINGS, you can save the settings without selecting a user for the Inbound and Outbound Communications. ZYL-14008

v6.23
20Jan2021

API

  • (Fixed) If you GET shifts for a specific operator, you will get an 'Internal server error'. ZYL-13424
  • API v2: If you GET contact operating windows for a contact that does not have any operating window defined, you will get a 'Cannot find contact' message instead of 'Contact has no operating windows define'. ZYL-13427

  • When a new contact is created through a booking and someone deletes the contact on the web portal, the system displays a blank pop-up.

  • When a user imports records of existing contacts, the contactActivityChangeWindow webhook is always triggered even when there is no actual change made to Operating Windows of the same contacts. ZYL-13549 -> ZYL-13558

  • (Fixed in v6.24) In the API settings, if you select All Network Groups then search for a User, if there is only 1 user, clicking cancel will select the said user instead of returning to the page. ZYL-13501

  • (Fixed in v6.24)On the API settings, the Email header is missing from the user selection list. ZYL-13502

  • When you book under the following conditions, you may get a '500 internal server error'. To solve the problem, retry the booking (even immediately). ZYL-12136
    (a) The contact policy setting must be set to 'Auto-Create'.
    (b) Multiple API bookings are made concurrently (simultaneously).
    (c) The said concurrent bookings involve the same contact.
    (d) The said contact doesn’t exist (yet) in the Address Book.