Returns - Receiving Return Requests and Accepting the Physical Return

Overview

Customers can request a return within Google Shopping Actions and the return request will get sent to Logicbroker. All return requests will be processed on a 4 hour schedule by default, once a return is received a response can get created within Logicbroker to issue the refund. Refunds can be issued with or without the return request, and the total amount of the refund can be edited for each item in Logicbroker. 

The return request functionality will operate like an RMA process, where the return is initiated by the end customer from Google Shopping, providing carrier and tracking details on the expected return. This information will send to Logicbroker, and remain in the Under Review status.

Once the physical return is received, it is expected to provide a response accepting the return with a refund amount. This should fit in to your normal return integration process with Logicbroker. Once the return response is sent the original Return request will go to a status of Response Received.

See additional sections below for:

Process Flow

Below represents the process of a return initiating from Google to Logicbroker, then accepting the return and providing a refund response back to Google.

mceclip0.png

Creating Test Returns

Currently, the only way to create return requests is to create them through the Google API; contact Logicbroker if you wish to create those return requests.

For testing purposes, you can still send return responses to process refunds. To do this begin by creating your order (follow steps here) and shipment (follow steps here). 

Once you create your order is marked as Complete in Logicbroker, navigate to it and you can click More Actions > Return Items

mceclip0.png

On the return draft page, you will need to enter the Quantity Returned, Return Reason, and Refund_Amount. The Refund_Amount will be the total refunded to the customer. 

mceclip1.png

For the Return Reason, you can use the Logicbroker standard reasons that can be found in the portal drop down. They map to the following Google Shopping reasons below.

Logicbroker Standard Reason

Google Shopping Reason

Wrong item shipped

wrongProductShipped

Damaged shipment

productArrivedDamaged

Arrived late

deliveredTooLate

Product quality issue

qualityNotAsExpected

Product not as described

productNotAsDescribed

Do not want

customerDiscretionaryReturn

Other

other

Customer ordering error

undeliverableShippingAddress

Once the return is submitted through Logicbroker, the return and refund will automatically process to Google Shopping, providing the refund to the end customer. You will see all the return and refund data on the order in the Google Merchant Center.

mceclip2.png

Field Descriptions

Return Request (From Google Shopping)

Listed below are all the fields sent from Google to Logicbroker. This will help understand your integration and what information will be expected from Google Shopping. 

Google Field

Logicbroker Field

orderReturnId

ReturnNumber

orderId

OrderNumber

merchantOrderId

ExtendedAttributes[Name="GoogleMerchantOrderNumber"].value

returnShipments.shipmentTrackingInfos.carrier

ExtendedAttributes[Name="Carrier{{@index}}"].value

returnShipments.shipmentTrackingInfos.trackingNumber

ExtendedAttributes[Name="TrackingNumber{{@index}}"].value

returnItems.quantity

ReturnLine.Quantity

returnItems.product.price.value

ReturnLine.Price

returnItems.product.title

ReturnLine.Description

returnItems.product.offerId

ReturnLine.ItemIdentifier.SupplierSKU

returnItems.customerReturnReason.reasonCode

ReturnLine.ReturnReason

returnItems.product.gtin

ReturnLine.ExtendedAttributes[Name="gtin"].value

returnItems.product.mpn

ReturnLine.ExtendedAttributes[Name="mpn"].value

returnItems.itemId

ReturnLine.ExtendedAttributes[Name="GoogleLineItemId"].value

Return Response (From Logicbroker)

Below are all the fields that will process from Logicbroker to Google Shopping, that will update and refund the end customer. 

Google Field

Logicbroker Field

Description

Notes

Requirement

operationId

"ret" + returnObj.Identifier.LogicbrokerKey + "-" + i

Will automatically generate from document

 

Required

lineItemId

ShipmentLines.ExtendedAttribute[Name="GoogleLineItemId"].value

Will automatically pull from the linked order.

 

Required

quantity

ReturnLines.Quantity

Quantity being refunded

 

Required

reason

ReturnLines.ReturnReason

Return reason provided

 

Required

reasonText

ReturnLines.ReturnReason

Return reason provided

 

Required

priceAmount

ReturnLines.Price

Amount to refund

 

Required

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.

Didn't find what you were looking for?

Submit a request