Setup & config

For this integration you will need:

The Engage integration is set up in Easycom Admin under "Integrations". Here you'll specify the base API URL, your API key and if there are any other Engage contact types besides "Member" and "Contact" that Easycom will need to deal with.

Easycom tracks several KPIs for returns. These can be synced to Engage as contact attributes.

These attributes need to be set up in Engage and will be synced (created or updated) from Easycom whenever a customer makes a return or when one of their specific KPIs are updated.

The KPIs are calculated using whatever group currency is configured in Easycom.

Here are the contact attributes that need to be set up in Engage for this to work:

The results on the customer's contact card in Engage will then look like this:

Easycom supports the sending of returns transaction that were created in the e-com to Engage. So if the e-com is missing returns, these can be synced to Engage directly from Easycom.

If the currency used differs from the group currency, Easycom will include the exchangerateToGroupCurrency attribute when it sends transactions. It will also include returnreason in the transaction call, which can be then used to perform segmentation in Engage.

The returnreason codes must be added in the Engage back-end (your Voyado team will take care of this):

Easycom can trigger transactional emails to be sent from Voyado Engage based on these statuses:

These emails can include the following information:

This is an example payload for this kind of trigger:

{
    "contact": {
        "matchKey": "example@easycom.com",
        "matchKeyType": "Email"
    },
    "orderNumber": "EXAMPLE1234567",
    "orderStatus": "EasycomReturnCreated",
    "paymentStatus": "Paid",
    "createdDate": "2022-11-21T15:55:00.0000000+02:00",
    "shippingDate": "",
    "statusChangedDate": "",
    "storeId": "exampleshop.se",
    "language": "sv",
    "currency": "SEK",
    "exchangeRateToGroupCurrency": 1,
    "extraData": {
        "returnFreight": -69,
        "freight": 49,
        "transportServiceCode": "MYPACK_RETURN_QR",
        "returnLabelURL": "https://examplestore.blob.core.windows.net/documents/5445cd1e-aaa2-1234-8df1-ac900be14e6f.pdf"
    },
    "totalGrossPrice": -1479,
    "totalTax": 0,
    "paymentMethods": [],
    "items": [
        {
            "type": "RETURN",
            "sku": "224-835-1111-666-M",
            "quantity": -1,
            "grossPaidPrice": 1499,
            "taxAmount": 0,
            "taxPercent": 0,
            "description": "Silver-plated cuirass, medium",
            "imageUrl": "https://www.example.se/pub_images/original/224-835-1001-565-26887.jpg?extend=copy&width=1024&method=fit&height=1280&type=webp",
            "targetUrl": "http://www.example.se",
            "extraData": {
                "reasonCode": "Ångrat köp",
                "reasonCodeType": "Return",
                "exchange": 0,
                "exchangeSku": "",
                "exchangeDescription": "",
                "exchangeImageURL": ""
            },
            "discounts": []
        }
    ],
    "freightFee": {
        "value": 20,
        "tax": 0,
        "taxPercent": 0
    },
    "handlingFee": {
        "value": 0,
        "tax": 0,
        "taxPercent": 0
    },
    "totalRoundOff": {
        "value": 0,
        "tax": 0
    }
}

Easycom can export existing return transaction to Engage. This is done in your Easycom configuration area.