Calendar Sync feature

Allows users to sync their external calendars with the platform

• Why

• Which context

• Interfaces

• Configurations

  • Commands

• Workflows

  • Synchronization from external to the platform’s calendar

  • Synchronization from platforms to external calendar

  • Note

• Special rules

Why

For B2C marketplaces, suppliers often are companies, managing their calendars through multiple systems/apps.

Most suppliers have gone fully digital and use synchronization tools, especially if they already are on platforms other than Second. Using synchronization will not disrupt the professional organization of a supplier.

Understanding and implementing the synchronization helps the offeror manage its timetable from a unique calendar perspective.

Which context

BtoC marketplaces where there are a lot of booking for the offeror.

Some businesses revolve around their calendar and thus managing seamlessly calendars becomes mandatory.

Ex: Medical marketplaces

Interfaces

You can find here all interface documentation related to the Calendar Sync bundle

Dashboard:

• Listings dashboard (Time-based rendering type) - Synchronization

Configurations

The calendar sync feature can be configure in SBO > OTher > Feature > Calendar Synchronization Delay

Commands

Synchronization is done every 5 minutes according to a CRON job,

SBO path: Cron in Other > Command > inventory:availability:synchronize-calendars

And will depend on the parameter cocorico_calendar_sync.delay to verify if the synchronization should be done.

Workflows

Synchronization from external to platform’s calendar

Calendar synchronization is set to be asynchronous.

Synchronization from an external calendar to the platform calendar is automatic.

A manual action is required to update the platform calendar with the offerors’.

External to internal synchronization works as follows:

• The offeror enters the ‘public’ URL of his external calendar.

• The system will automatically launch a synchronization.

• If the platform’s default setting is to have upon creation an unavailable platform agenda, then any event coming from the external calendar will create unavailability in the internal agenda.

• If the platform’s default setting is to have upon creation an available platform agenda, it is the contrary.

Synchronization from platforms to external calendar

The internal-to-external synchronization is as followed:

• Upon booking acceptance, the offeror will receive a confirmation email for the event.

• The offeror will have the possibility to add that booking reservation to his external calendar.

In the session bundle, there is an option to set the status as available/unavailable.

When the external calendar is synced, all the scheduled events with the status “Busy” will overlap any respective session in the session bundle and become unavailable and unable to edit.

In order to set it as available again, the event on the external calendar needs to be deleted.

If there is a booking created before the offer is synced and imports his external calendar, the session will continue regularly as scheduled by the asker and overlap any busy event on the offer calendar.

By configuring "cocorico_listing_availability.status" to 2 (Unavailable) during the import of the calendar, any time slots where no scheduled events exist in the calendar will be marked as busy, effectively rendering them unavailable for bookings.

Special rules

There are no special rules for the calendar sync feature