Notifications send different types of messages to the systems you use in your business. Notifications inform your systems about events in the returns process in 12Return.
Notification templates
Notifications exist in 2 types:
Type | Description |
Primary process | These notifications are triggered when the status of a return has changed. |
Secondary process | These notifications are triggered when a subprocess has been executed. |
Notifications templates exist in 3 types:
Type | Description |
The notification is sent to an email address as defined in a Notification Profile. | |
Alert (JSON) | The notification is sent to an endpoint as defined in a Notification Profile. |
Alert (XML) | The notification is sent to an endpoint as defined in a Notification Profile. |
Primary process
All notification templates can be set up and activated for the following events in the returns process:
Event | Description | Process |
Return requested | The return has been requested by the customer and is awaiting authorization from an agent. | Authorization |
Return rejected | The return has been rejected by an agent. | Authorization |
Return authorized | The return has been authorized by an agent and can be shipped by the customer. | Authorization |
Return shipped | The return has been shipped by the customer. | Logistics |
Return tracked (new trigger coming soon) | The return has been tracked by the carrier. | Logistics |
Return received | The return has been received in the warehouse. | Processing |
Return processed | The return has been received and graded in the warehouse. | Processing |
Return settled (new trigger coming soon) | The return has been settled with the customer. | Settlement |
Return completed | The return has been completed by an agent. | Settlement |
Return canceled | The return has been canceled by an agent. | Authorization, Logistics, Processing, or Settlement |
Secondary process
All notification templates can be set up and activated for the following events subprocesses:
Event | Description | Process |
Settlement memo | The settlement memo has been completed by an agent. | Settlement |
Use case email | The use case email will be sent to your inbox when the customer has created an email in the return portal. | Initiate return |
Notification emails
Notification emails can be sent to an external email address, such as a team inbox, Teams or Slack channel, or a support system (Zendesk, Intercom). You can define the email title and body text and enrich it with dynamic content from 12Return.
Use-case for a notification email:
You can activate the Return Requested Email and send it to a Zendesk or Intercom email address to create a ticket. The ticket can include a link that navigates straight to the return authorization screen in 12Return. No need anymore for agents to be in 12Return to watch out for new return requests.
Notification alerts
Notification alerts are webhooks in JSON or XML that can be sent to an endpoint in your system to update your system and to trigger an action. The notification alert contains all relevant data from the return and is automatically enriched when the return reaches a new status in the process.
Use-case for a notification alert:
You can activate the Return Processed Alert to trigger a refund or store credit in your system when the return has been received and graded in the warehouse. You can fully automate the settlement process with your customer and achieve a better customer satisfaction score.
Notification profiles
In order to send notifications, you need to create a notification profile that exists in 2 types:
Email for sending a Notification Email to an email address
Custom for sending Notification Alerts to an endpoint
You can use the notification profiles for a notification type for all notification templates of that type.
Test your integration
For the Essentials plan, integrating the notification alert is a do-it-yourself effort. You can test the integration for a notification alert in your own account:
Set up a notification profile for test purposes that is connected to the test environment of your system
Create a notification alert with this notification profile
Create a return and test the integration
In the Professional and Enterprise plans, we can give you access to our integration-staging environment where you can test the integration. In the Enterprise plan, we also offer a dedicated sandbox environment.
Our support team can always provide additional support.