PluginsOther

PinMeTo

Guide for setting up PinMeTo integration in Omnium.

What is PinMeTo?

PinMeTo is a tool that helps businesses keep their contact information and opening hours up to date on platforms like Google Maps, Facebook, Apple Maps, and other map and search services.

Instead of manually updating this information on each platform, you can update it in one place — PinMeTo — and have the changes published everywhere simultaneously. This saves time, ensures customers find accurate information, and improves your online visibility.


Setup in Omnium

To integrate with PinMeTo, a connector named PinMeTo must be added. Below you can see a draft of the connector. It is important that it implements the IStoreExporter and have the properties AccountId, AppId and AppSecret configured. These value of these properties are provided by PinMeTo.

{
    "name": "PinMeTo",
    "host": "https://api.pinmeto.com",
    "isAuthenticatedManually": true,
    "timeOut": "00:00:00",
    "implementations": [
        "IStoreExporter"
    ],
    "properties": [
        {
            "key": "AccountId",
            "value": ""
        },
        {
            "key": "AppId",
            "value": ""
        },
        {
            "key": "AppSecret",
            "value": ""
        }
    ]
}

Once this connector is configured, stores will be exported to PinMeTo each time they are saved in Omnium.


Mapping – From Omnium to PinMeTo

The tables below outlines which fields are sent to PinMeTo and where the data is sourced from in Omnium.

Basic Store Information

PinMeToDescriptionOmnium
NameStore namestore.Name
StoreIdInternal store IDstore.Id
LocationDescriptorDisplay namestore.Name
PermanentlyClosedMark as permanently closedstore.IsInactive

Address

PinMeToDescriptionOmnium
StreetStreet + house numberstore.Address.StreetName + StreetNumber
CityCitystore.Address.City
ZipPostal codestore.Address.Zipcode
CountryCountry (translated)store.Address.Country
StateRegion/Countystore.Address.Region

Contact Information

PinMeToDescriptionOmnium
EmailEmail addressstore.Email
PhonePhone numberstore.PhoneNumber
HomepageWebsite/URLstore.Url

Geolocation

PinMeToDescriptionOmnium
LatLatitudestore.Latitude
LonLongitudestore.Longitude

Regular Opening Hours (Monday–Sunday)

PinMeToDescriptionOmnium
OpeningHours.Monday–SundayOpening hours per daystore.{Day}OpeningHours
State"Open" or "Closed"IsOpen for the given day
Times.Opens / ClosesOpening/closing in "hhmm" formatOpenFrom and OpenTo for the given day

Special Opening Hours

PinMeToDescriptionOmnium
LabelName of holiday/special daystoreSpecialOpeningHours.Label
Start / EndDate (same for both fields, one-day)storeSpecialOpeningHours.Date
OpenTimeOpening time (hhmm format)OpeningHours.OpenFrom
CloseTimeClosing time (hhmm format, "0000" → "2400")OpeningHours.OpenTo
IsClosedWhether the store is closed that daystoreSpecialOpeningHours.Closed

Descriptions

PinMeToDescriptionOmnium
Description.LongLong description (max 750 chars, no HTML)store.Description
Description.ShortShort description (max 255 chars, no HTML)store.ShortDescription

Notes

  • Address validation: If City, Zipcode, or StreetName is missing, an exception will be thrown.
  • Country name translation:
    • "Norge""Norway"
    • "Sverige""Sweden"
    • "Danmark""Denmark"
  • HTML is removed from descriptions using regex.
  • If OpeningHours.OpenTo == 00:00, it is sent as "2400" to correctly represent midnight in PinMeTo.

On this page