Smeetz
Easily sync your shows, guest badges, and volunteer badges with the Smeetz integration. In this article, we will take you step by step through setting up this integration.
Before continuing, make sure you have access to the Smeetz dashboard https://app.smeetz.com/ and the integration settings in your Fiona.
Setting up the integration
To successfully set up an integration with Smeetz, you will need to:
- Add an Smeetz Base URI and API key to the integration settings
- Map fields between Fiona and Smeetz
Integration Settings
To set up your integration, you need to add two values from Smeetz to Fiona. Log in to https://app.smeetz.com/ to retrieve the following two values.
- Base URI - This is https://api.smeetz.com/org/prod/nl/v1/unless communicated otherwise.
- API key - You can retrieve the API key from the Smeetz Back Office. Once logged i , you can find your API key by clicking on the button with the nine squares at the top right of the screen. Next, head to "integrations" and copy the API key. Note that each Smeetz Group ID has its own API key.
Next, paste the API key in the integration settings of Fiona to complete the first step of the integration setup.

Mappings
Custom mappings
Mapping is the process of connecting an item's ID from Smeetz to a value in Fiona. This way, Fiona knows what show type or badge type belongs to which price grid or membership in Smeetz. To finish the integration setup, you need to map the following fields:
- Price grid map - use this mapping to map your Show Audience Types in Fiona to your Pricing grids in Smeetz. You can edit your Audience Types through the LookupList ShowPublicTypes in Fiona.
In Smeetz, you can configure your pricing grids in your account details. You will find this by clicking on your username on the top right of the screen > Account details > Pricing grids. While setting up the pricing grids in Smeetz, make sure not to use any variations within one pricing grid. This way, all your audience types can be mapped to a pricing grid in Smeetz.
The ID of the items in Smeetz can always be found in the URL of the specific pricing grid. Copy this ID and paste it into the mapping table in Fiona.


- Membership map - use this mapping to define which Guest Badges belong to which Smeetz membership. You can set up your badges in your Guestbooks.
You can configure your memberships in the Smeetz back office by going to Orders > Memberships. You can copy the ID of each membership from the URL of the page.
- Volunteer badges map - use this mapping to map Volunteer Badges from Fiona to Memberships in Smeetz. You can edit the list of badges through the Fiona Lookup list VolunteerBadgeTypes.
Fiona's Volunteer badges are also mapped to Memberships in Smeetz. You can find the ID by following the same steps as described above.

Tip! Always fill in the default value in your mapping. This value will be used when no other mapping is provided, helping avoid errors during syncing.
Auto-created mapping
Next to the custom mappings, Fiona also keeps track of one automatic mapping. This lets you keep track of the mapped values and make adjustments if needed.
- Activity map - This mapping is automatically created when you publish shows. An activity is a combination of a location and an edition in Fiona. Syncing a show in Fiona will automatically create a location in Smeetz.
Publishing data
Once the integration is set up, you are ready to sync data. You can publish information from the following cards.
- Show - Syncing a show from Fiona creates or updates an event in Smeetz. Smeetz returns an 'External event ID' on the show card in Fiona.
- Guest badge - Syncing a guest badge from Fiona creates a pass, a Membership Card in Smeetz. Smeetz returns a 'Code on badge' and, if applicable, a 'voucher code' to Fiona. These codes can then be used to print on badges or to communicate via email using the template editor.
Note: Only Guest badges with a status of "approved" or higher can be synced.
- Volunteer - Syncing a volunteer also creates a pass, a Membership Card in Smeetz. Smeetz returns a 'Code on badge' and, if applicable, a 'voucher code' to Fiona.

QR code on Badge
You can use the 'Code on badge' and 'voucher code' in templates for volunteer and guest badges. These codes can then be used to generate passes with personal booking information or scannable QR codes.
Try, for example, the following code on a GuestBadge template to generate a QR code on a badge.
{{ #if Code }}
<img class="qr" src="https://api.qrserver.com/v1/create-qr-code/?data={{code}}&size=100x100" />
{{ /if }}Check out our full template documentation Templateshere for more information. Or write [email protected] if you need help setting this up.