Some users may experience random login-problems to our Community. We are investigating the root cause of this. If you get an error message from CloudFlare, please send the RayID in the message to support@superoffice.com. You may also clear your browser cookies and cashe to solve it. Thanks for your understanding. 

Spring API and SDK updates

By Tony Yates, Updated on 14 May 2025
push_pin
star
Hello friends!
 
We have a few announcements and know that all of you will get at least one interesting takeaway from this update!

Integration services

The first announcement is a little old, but with the latest marketing push to promote more ERP integrations with SuperOffice, its timely to announce our recent refresh of the integration services SDK. This is a GitHub repo that provides sample code for .NET8 web service for hosting a QuoteConnector and ERPConnector endpoints for SuperOffice.
 
 
The key components are:
 
* ConnectorService (.net8) : A wrapper exposing services for the QuoteConnector, using CoreWCF for .NET Core support.
* Uses EPPLUS: Utilized for reading/writing Excel files, with a non-commercial license for this sample.
* QuoteConnectorWS & ERPConnectorWS: WCF services handling requests and responses for SuperOffice.
* ERPConnector (netstandard2.0)
* QuoteConnector (netstandard2.0)
 
What's new about this project? First off it is .NET Minimalistic API: Handles reading/writing Excel files and allows uploading/downloading templates. Read more about it on GitHub. 

Video meeting reservations (version 11) 

We are very happy to announce a new capability that allows integrations to create video meetings! This enhancement introduces video meeting reservations as distinct business objects, separate from appointment entities. However, the management of these reservations is conveniently located under the Appointment Agent endpoint.

Key Endpoints:

It's crucial to understand the separation of concerns between appointments and video meetings. Appointments and video meeting reservations are created and persisted independently. This distinction is evident in the SuperOffice client:
  • Creating Appointments: When you create an appointment, it does not need to be saved before you click the video meeting icon to create a video meeting reservation and link it to the appointment.
  • Managing Reservations: You can open an existing appointment and create or remove a video meeting reservation associated with it. The response from the Video Meeting Reservation contains the join URL, which must be added to or removed from the Appointment Entity JoinVideoMeetingUrl property.
This new feature streamlines the process of managing video meetings, making it easier and more efficient for partners to integrate video conferencing into their workflows.

Enhanced efficiency with webhook FieldValues (version 11)

We are excited to announce webhook FieldValues, designed to optimize the efficiency of your integrations. This update introduces a new property called FieldValues in most webhook payloads.

Key Features:

  • FieldValues Property: This key-value pair object contains non-sensitive data about the data record, allowing your integrations to determine if additional requests to SuperOffice are necessary.
  • Reduced Requests: By leveraging FieldValues, you can minimize unnecessary data retrieval, saving resources and improving performance.
Practical Example:
 
Consider a subscription to contact.created. You may only need more information about the contact if business_idx equals 2. With FieldValues, you can avoid making redundant requests to fetch a ContactEntity unless this condition is met.
 
This enhancement streamlines your workflow, ensuring that your applications run more efficiently by reducing the number of unnecessary requests.
 

That's all for now

We think these are some useful updates that you can start testing now in your development environments, and we looking forward to bring you more value to the API's in the near future! Till then, happy coding!