Other

Google Feeds Integration

Omnium supports exporting products as a Google XML product feed. This feed is set up using a combination of scheduled tasks and connector settings in Omnium, resulting in an XML document containing a set of products. The resulting XML document is located in blob storage, and the consumer needs to fetch the feed from its location for consumption.

Multiple feeds can be generated by setting up multiple connectors with different settings. The scheduled task GoogleXmlFeedScheduledTask will read all connectors named GoogleXmlFeed and generate one feed for each.

Options

Product Filtering

By default, only active products are included in the product feeds. However, it is possible to exclude selected products by setting the property "ExcludeFromFeed" to true under SeoInformation on products in Omnium.

The property "ProductMarket" should contain the marketId of the market for the products in the feed. If product languages are enabled, the feed will be populated with information from the market's product content language. This property is required.

Product Availability

The product availability is calculated from the product inventory. Since this status is calculated from the inventory items on the product entity (and not from the inventory index), the scheduled task ProductInventoryStatusScheduledTask should also be activated to populate the products with the required inventory levels used in the feed.

It is possible to specify the store for which availability is calculated by adding the property "Store" and specifying the Omnium storeId.

Virtual products in Omnium will always be shown as "in stock" in the product feed.

Custom Properties

It is possible to add custom properties from products in Omnium to the product feed by adding properties with keyGroup set to "CustomProperties" and key set to the key of the custom property.

Setup

1. Go to Configuration -> Integrations -> GoogleXmlFeed.
2. Click Add.
3. Fill in the required fields. At a minimum, feed title and feed directory must be specified.
4. Click Save at the bottom of the page. Then click Publish in the top right. The URL pointing to the location where the feed will be located should appear.

Testing the Feed

1. Go to Configuration -> Advanced -> Scheduled Tasks.
2. Locate the scheduled task "GoogleXmlFeedScheduledTask".
3. Click the options button on the right side and click "Run Now".
   • Note: Depending on the number of products, this process might take some time to complete.
4. Go to Configuration -> Integrations -> GoogleXmlFeed.
5. Click the link pointing to the feed's location. The feed should be displayed in your browser.

Sample Google Feed

---

SendGrid integration

Settings in Omnium

1. Go to Configuration -> Advanced -> Email Client.
2. Set type to Sendgrid.
3. Add the API key to the "Key Name" field.

Inbound Parsing

To handle incoming e-mails for adding replies to carts, orders, projects, etc., follow SendGrid's documentation: SendGrid Inbound Parse Documentation

Set up MX Records

1. Navigate to the MX Records page on your hosting provider’s website. If you're unsure who your hosting or DNS provider is, contact your website administrator.
2. Create a new MX record for the subdomain (e.g., parse.yourdomain.com) you want to process incoming email. This hostname should be used exclusively for parsing incoming emails.
3. Assign the MX record a priority of 10 and point it to mx.sendgrid.net.

Inbound Settings in SendGrid

1. Go to Settings -> Inbound Parse.
2. Click "Add host & URL".
3. Add your subdomain (same as MX record, e.g., "incoming").
4. Add your Domain (verified domain).
5. Set Destination URL to https://api.omnium.no/api/InboundParse.
6. Optional: Check "Check incoming emails for spam".
7. Do NOT check "POST the raw, full MIME message".

Inbound Settings in Omnium

1. Go to Configuration -> Advanced -> Email Client.
2. Add the new inbound e-mail address to "Inbound E-mail Address".

Using Raw-format with SendGrid

Due to varying formats across different email providers, formatting issues may sometimes occur when using the standard model received from SendGrid. A way to overcome this issue is leveraging the SendGrid option "POST the raw, full MIME message" when setting up the inbound parse hook. This better preserves the formatting information related to the email.

Steps to Use the Raw Option:

1. Go to Settings -> Inbound Parse
2. Click "Add host & URL"
3. Add subdomain (same as MX record, e.g., "incoming")
4. Domain: Add your verified domain
5. Destination URL: https://api.omnium.no/api/InboundParse/Raw
6. Optional: Check incoming emails for spam
7. Check the option "POST the raw, full MIME message"

Inbound Settings in Omnium:

1. Go to Configuration -> Advanced -> Email Client
2. Add the new inbound email address to "Inbound email address"

---

Link Mobility plugin

Introduction to Link Mobility functionality

With the Link Mobility integration, you can configure SMS notifications in Omnium based on various events and order statuses. Follow this guide to set up and get started with SMS notifications in Omnium.

Getting Started with the Link Mobility Integration

To get started, you must first set up an agreement with Link Mobility.

1. Contact Link Mobility to obtain a license and establish the agreement.
2. Once the agreement is in place, Link Mobility will reach out to Omnium to configure the integration in your system.

Set up

The configuration for the SMS client is located under:

Configuration → Advanced → Notifications → SMS Client

Once the integration is ready, you can proceed to configure your notifications.