Remorse time
This feature allows a merchant to specify a certain period of time when an order is in a ON HOLD status. Remorse time pauses all orders in your Order Management System (OMS) for n seconds before continuing with the normal flow. n seconds begins from the order.origin_date attribute that you can find in the magento.sales.order_management.create message.
For example, a merchant wants to have some time for a customer to cancel the order due to a mistake in their order.
This functionality uses UTC timezone. If an order with an incorrect order.origin_date is placed, this order is in a ON HOLD status until the order.origin_date and its related remorse time are finished.
Configuration
To enable this functionality:
-
Activate the Remorse time option in your System Integrator (SI) Portal in Config > Global settings > Order.
This functionality can only be setup with the time in
nseconds where the order needs to remain in anON HOLDstatus. -
Setup Custom details restrictions for this functionality. Specifying this value means that remorse time will only be applied to orders that contain this restriction. This allows you the capability of applying use cases to define a unique remorse time, like for orders with more than
nlines. -
An Expiration Mode type can be setup to define the applicable days:
all: Takes in consideration all days.excludeWeekends: Only takes in consideration days between Monday-Friday.
It is possible to setup a Remorse time (Test) which is only applicable to Test Orders. Testorders are orders which contain Test in any of the Name or Surname fields.
These definitions are enabled and configured in your System Integrator (SI) Portal, which is not yet accessible externally. Contact Magento Support for assistance.
Restrictions
There are no restrictions applicable to this functionality. Remorse time can be used with all OMS order types.
Integration
Example of an order with Remorse time (JSON file)
{
"order": {
"addresses": [
{
"address1": "98 Wyoming Place",
"address2": " 13",
"address_type": "customer",
"city": "Osage",
"country_code": "US",
"custom_attributes": [
{
"name": "subscribed_to_newsletter",
"value": "true"
}
],
"email": "johndoe@example.com",
"first_name": "John",
"last_name": "Doe",
"latitude": "43.999",
"longitude": "-104.4226",
"phone": "2345-535-2234",
"reference": "johndoepers",
"state": "Wyoming",
"zip": "82723"
},
],
"custom_attributes": [],
"customer": {
"id": "3",
"segment": "B2C",
"type": "REGISTERED"
},
"customer_service_agent": "JohnDoe",
"id": "ISPU-001",
"ip": "154.226.28.27",
"language": "en_US",
"lines": [
{
"amount": {
"currency": "USD",
"gross_amount": 100,
"net_amount": 100,
"tax_amount": 0,
"tax_rate": 0,
"taxes": [
{
"amount": 0,
"rate": 0,
"type": "VAT"
}
]
},
"custom_attributes": [
{
"name": "imageUrl",
"value": ""
}
],
"id": "1",
"line_number": 1,
"payment_reference": "1",
"payments": [],
"pickup_location": "EU-STORE2",
"product_name": "1111111111",
"product_type": "PHYSICAL",
"shipping_address_reference": "johndoepers",
"sku": "1111111111"
},
{
"amount": {
"currency": "USD",
"gross_amount": 100,
"net_amount": 100,
"tax_amount": 0,
"tax_rate": 0,
"taxes": [
{
"amount": 0,
"rate": 0,
"type": "VAT"
}
]
},
"custom_attributes": [
{
"name": "imageUrl",
"value": ""
}
],
"id": "SHIPPING",
"line_number": 3,
"payment_reference": "1",
"payments": [],
"product_name": "ISPU",
"product_type": "SHIPPING",
"shipping_address_reference": "johndoepers",
"sku": "ISPU"
}
],
"origin": "WEB",
"origin_date": "2019-03-15T12:02:54+01:00",
"payments": [
{
"currency": "USD",
"reference": "1",
"transactions": [
{
"amount": 250,
"billing_address_reference": "johndoepers",
"gateway_information": {
"authorization_status": "AUTHORIZED",
"custom_attributes": [],
"gateway_id": "OFFLINE"
},
"payment_method": "ZEROPAY",
"payment_submethod": "ZEROPAY"
}
]
}
],
"store": "STORE-EU",
"vat_country": "US"
}
}
Customer service view
When a store representative accesses the OMS, a status of ON HOLD with the status reason of PENDING_REMORSE_TIME (while the remorse time is active) appears in the Customer service view.
After the remorse time is finished, the status is still ON HOLD while the status reason changes to REMORSE_TIME_COMPLETED.
For more information on status changes and the flow of an order, see the Order flow page.