Receiving the rating of the the delivery of an order with feedback (Node.js)
In this use case, the user rates the delivery of a fulfilled order. The rating is usually between 1 to 5. The delivery service sometimes asks for a reason why the user has provided a particular rating.
Code snippets
BPP receives protocol rating
/*
Example Request JSON:
{
"context": {
"domain": "local_retail",
"country": "IND",
"city": "std:080",
"action": "rating",
"core_version": "0.9.2",
"bap_id": "https://mock_bap.com/",
"bap_uri": "https://mock_bap.com/beckn/",
"transaction_id": "1239890342",
"message_id": "123793824",
"timestamp": "2021-06-23T08:18:49.303Z"
},
"message": {
"id": "fulfillment_1",
"value": 5
}
}
*/
// Auth middleware authenticates the digital signature of the incoming request
router.post('/local_retail/rating', auth, rating);
function rating({ headers, body }, res) {
try {
const message = _.get(body, "message");
const context = _.get(body, "context");
if (!context) {
return res.status(400).send(httpResponse("NACK", "Missing Context"));
}
if (!message) {
return res.status(400).send(httpResponse("NACK", "Missing Message"));
}
// ... Returns the ack immediately and continue the processing after validation
res.status(200).send(httpResponse("ACK"));
processRating(headers, body)
} catch (error) {
res.status(500).send(httpResponse("NACK", error));
}
};
BPP processes the rating
function processRating(requestHeaders, ratingRequestBody) {
// Execute business logic here
let ratingResponse = {}
generateResponse(requestHeaders, ratingResponse)
}
BPP generates response
async function generateResponse(requestHeaders, rawResponse){
/*
Example Request JSON :
{
"context": {
"domain": "local_retail",
"country": "IND",
"city": "std:080",
"action": "on_rating",
"core_version": "0.9.2",
"bap_id": "https://mock_bap.com/",
"bap_uri": "https://mock_bap.com/beckn/",
"transaction_id": "1239890342",
"message_id": "123793824",
"timestamp": "2021-06-29T10:52:01.620Z"
},
"message": {
"feedback": {
"id": "b9e92323-5ff7-4e1f-be43-24e87362b89f",
"descriptor": "https://feedback.bpp.com/provider/pooja-stores/2839",
"parent_id": "fulfillment_1"
}
}
}
*/
let onRatingResponseBody = {
}
//call protocol on_rating
await callOnRating(requestHeaders, onRatingResponseBody);
}
BPP calls protocol on_rating
async function callOnRating(requestHeaders, onRatingResponseBody) {
// Take the subscriber Id from the header and calls the registry to get the url. If already cached it need not to call again
const uri = await lookup(requestHeaders);
// Construct Header
const headers = constructAuthHeader(); // Auth Header with digital Signature
return axios({ url: `${uri}/local_retail/on_rating`, method: "POST", headers, data: onRatingResponseBody });
}