This document describes changes made to the API since its initial release. Here you will find both new and deprecated features. The change date reflects the time the change was made publicly available.
Added a new lookup for price categories in GetLookupValues. LookupType should be set to PriceCategory to get a list of available price categories. LookupArgument should be set to the service code for which you want to get the price categories.
Removed the ResetPassword method from the Account controller. This method was used to reset a users password, but it is no longer needed since we have implemented a new password reset process. To reset a users password you should use the new RequestResetPassword to obtain a reset password token, that can later be used with the ChangePasswordUsingResetToken method. Note that these methods are meant for internal use only.
The functionality that has allowed anonymous users to create new activities has been removed. In its place is a new form allowing companies to apply for contract and login so as to be able to register new cases / activities via eConnect. The form sends an email to sales.support@onitio.com with the information the user entered into the new application form. Sales will then create an offer and send it to the potential customer, which can accept it. Upon which a contract and login will be created by Sales support and communicated to the new customer. The new form: Apply for contract
Added price category to the activity product fields. Is is also available for each activity costline.
We have extended the PartModel with a new property BundleParts. If the part is a bundle this property will contain a list of simple BunldePartModels representing the parts included in the bundle.
We have added a new method ChangeContract to the activity controller methods which changes the contract on the given activity with the provided parameters. We also modified the activity originator field so that it is now writable for infocare users and read only for all other users.
We have extended the SesamDateFields model to include a new field called SesamConvertDate. This field is used to store the date when the activity was converted.
We have added a new lookup for serial numbers in GetLookupValues called SerialNumber2. This lookup will replace the old SerialNumber lookup, the old SerialNumber lookup will be retired 2025-01-15
We have added a new lookup for getting available requisition line functions called GetAvailableFunctions2 , the old method GetAvailableFunctions will be retired 2025-01-15
The AttachmentModel has been extended with an IsVisible property that can set be when adding a new attachement. Restricted to InfoCare and SubContractors. This value determine if the attachment should be available for external users. We have also extened AllowableActivityActions with ChangeAttachmentVisibillity that indicates whether you are allowed to change the IsVisible property of an attachment.
The CommentModel has been extended with an IsVisible field that can be set when adding a new comment. Restricted to InfoCare users. This value determine if the comment should be available for external users. We have also extened AllowableActivityActions with ChangeCommentVisibillity that indicates whether you are allowed to change the IsVisible property of a comment.
In eConnect, the user can now override the value of suggested/estimated work duration at in a new field in the view for creation of an activity.
Added new ChangeCustomer method ChangeCustomer that changes the customer on a given activity to a specified customer. Customer identifier, customer role and activity number are specified in the ActivityChangeCustomerModel
Added new Logon method Logon2 that does not include user name and password in the URL. Username and passoword is instead passed through the UserPasswordArgumentModel. The existing Logon method will be removed after three months, i.e. at the end of August 2024. .
Extended CostLineModel with a property for InvoiceStatus. This shows the current status of the cost line and can also be updated with valid invoice status.
Modified CreateCalendarArgumentModel by removing HolidayCalendar and replacing it with CombinedHolidayCalendarId due to compatability issues with new calenadar implementation.
Extended AttributeUpdateModel with two new fields for Product IMEI number and Product IMEI out (additional IMEI number)
Extended ActivityReturnModel a new field for Received Date.
Extended CostLineModel with two properties for ServiceCode and ServiceCodeDescription. These are read only values for informational perposes. We have also exteded the FieldModels with ContractId, CustomerNumber1 and CustomerNumber2. ContractId will get or set the ContractId on CostLine, this field can be null. CustomerNumber1 and CustomerNumber2 will get or set the customer on CostLine. Setting these could generate a recalculation of prices.
We have extended the ActivitySearchFilter with a new field called ActivityType. This field can be used to search for activities with a specified activity type.
We have added a new method GetSerialNumberHistory that retrieves the serial number history given a requisition number and a requisition line number.
Added Currency as a new field for cost lines. This field tells you the currency used for the cost line. The value cannot be modified.
We have changed the DeleteActivity method to request an activity deletion/deactivation. This method is available for InfoCare, subcontractor and partner users. A partner user must also be member of the Integrator role in order be allowed to request a delete.
We have added a new AllowableActivityActions called DeleteActivity. You should check if this flag is set prior to request deactivating/deleting activity.
We have extended the CommentModel with a new field called IsAlert. This field can be used to mark the comment as alert. If not specified or set to false the comment is just a regular comment. If field is set to true the comment will be marked as an alert.
We have extended CostLineModel and CostLineDefinitionModel with two new properties; MinValue and MaxValue. These properties indicates the maximum and minimum value you can set FieldValue to. If these values are not defined on the model it means that there are no restrictions.
We have extended CostLineModel with CostSetDefiniitonId. This property identifies which cost set the cost line belongs to. This property is for information only and does not have to be set when updating a cost line.
The IsAllowableOnce property has been moved from CostSetDefinitionModel to CostLineDefinitionModel as it not necessarily true at all cost lines within a cost set only can be added once.
We have changed security restriction with respect to partner users for Product.Brand. You no longer have to be a PartnerAdministrator, it is sufficient to be just a Partner user.
We have added a new AllowableActivityActions called AddAttachment. You should check if this flag is set prior to adding new attachments. We have also AttachmentModel with a new field IsDeleteable which indicates if you are allowed to delete the attachment.
We have added a new field to ActivityIdArgumentModel called FormName. A form is used to limit the information returned from GetActivity. If you for example are only interested in a few fields you can define a form with those fields only and specify the id of the form when you call GetActivity. This would make the call to GetActivity faster and you will get less data returned. However, the API does not support the creation of forms, so you if you want to use this feature you will have to contact InfoCare. The form description and title will be returned as additional read-only activity fields.
We have added two new fields to the FieldModel.
We have also extended RequisitionLineEventRule with a new field called RequiredCustomProperties. This field will contain a list of requisition line custom properties names that must be filled out before this function is applied, i.e. requisition line custom properties that are dependent upon this function. This field replaces the more generic CustomPropertiesRule, which will be removed in the next release.
We have extended the CostLineDefinitionModel with a Fields collection. This collection will give you a list of fields that must be included when creating a new cost line. This also means that the CostLineType, DefaultQuantity and IsDescriptionRequired properties is superfluous as these values can be inferred from the appropriate field in the field list. These fields will be deprecated in future versions of the API.
We have added CreatedAt and CreatedBy as FieldModels to the Activity object. Note that if you are a subcontractor or partner user the created by name will only be present if the created by person is registered as a user in your company. If you are an external user or single activity user you will only see the created by person if it was you that created the activity. If you are an InfoCare user you will always be able to see the created by user.
We have added a new method for downloading a file that uses GET. This means that you can use this method directly as an URL, see DownloadFile for more details.
We added a new controller for maintaining resource calendars. The following methods are available
We have added a new security group SFSEC_PartnerIntegrator that gives a partner users more or less the same feature set as sub-contractors.
CostLineModel has been extended with a new field called CostLineCode. This code can be used to infer the type of the cost line without having to get CostSetDefinitionModel.
Add new method; GetSearchFields, to the Lookup controller to get back a list a fields than can be returned from a search. The method currently only supports activity search fields, but will be extended in the near future to also support contract line search and part search. At the same time we have removed ActivitySearchResultsField as a valid argument to GetLookupValues
We have combined 2 methods in PartSearch controller into 1. Methods FindPartsForRequisition and FindParts are now combined into one PartSearch This is now used when searching for parts for a activity and for stock inventory.
Logon method now accepts any of the four phone numbers associated with the activity as verification code.