Ondc-igm-sdk NPM

IGM Service Package

The Issue & Grievance Management (IGM) Service Package provides a mechanism for resolving issues between users of the ONDC network. The IGM flow is built on the Issue & Grievance Management framework, which facilitates the resolution of issues, grievances, and disputes between a Complainant and Respondent while ensuring transparency, fairness, and data security.

Content

Introduction

The IGM Service Package is designed to handle various interactions related to issue management, resolution, and status tracking within the ONDC network. It allows participants to raise, process, and track issues involving transactions, logistics services, and other identified entities.

Features

Issue creation and management for different network participants (Complainant, Respondent, Buyer, Seller, Logistics Service Provider, etc.).
Issue resolution tracking and reporting.
Event callbacks for handling success, error, and other custom actions.
Modular structure for easy extensibility and customization.

Installation

You can install the IGM Service Package using npm:

npm i ondc-igm-sdk

PropTypes

`init()`

Property	Type	Default	Description
`validateSchema`	Boolean	N/A	To stop schema validation.
`npType`	Array	BUYER, SELLER, LOGISTICS	Type of the Network Participants.
`context`	Array of Objects	N/A	Subscriber Detail.
`Domain`	Array of Strings	RETAIL, MOBILITY, LOGISTICS	Subscriber Domain Type.
`onSuccess`	Callback Function	N/A	Handling the Success Responses.
`onError`	Callback Function	N/A	Handling the Error Responses.

context: An array of objects containing subscriber details.

Each object within the context array should have the following properties:

Property	Type	Description
`subscriberId`	String	A unique identifier for the subscriber.
`subscriberType`	String	The type of the subscriber (e.g., BUYER, SELLER, LOGISTICS).
`subscriberURL`	String	The URL of the subscriber.
`expected_resolution_time`	String	The expected resolution time.
`expected_response_time`	String	The expected response time.
`subscriberCity`	String	The city where the subscriber is located.
`subscriberCountry`	String	The country where the subscriber is located.
`subscriberDomain`	String	The domain of the subscriber.
`ttl`	String	Time to live for the context.
`subscriberState`	String	The state where the subscriber is located.

`buyerIssue()`

Property	Type	Default	Description
`issue`	Object	N/A	The issue object to generate the issue to the seller.
`onNack`	Callback Function	N/A	Handling the Nack Responses
`onSuccess`	Callback Function	N/A	Handling the Success Responses.
`onError`	Callback Function	N/A	Handling the Error Responses.

`buyerIssueStatus()`

Property	Type	Default	Description
`issue_status`	Object	N/A	To get the issue status from seller.
`onNack`	Callback Function	N/A	Handling the Nack Responses.
`onSuccess`	Callback Function	N/A	Handling the Success Responses.
`onError`	Callback Function	N/A	Handling the Error Responses.

`sellerOnIssue()`

Property	Type	Default	Description
`on_issue`	Object	N/A	To get the on issue from the seller.
`onNack`	Callback Function	N/A	Handling the Nack Responses.
`onSuccess`	Callback Function	N/A	Handling the Success Responses.
`onError`	Callback Function	N/A	Handling the Error Responses.

`sellerOnIssueStatus()`

Property	Type	Default	Description
`on_issue_status`	Object	N/A	To get the on issue status from seller.
`onNack`	Callback Function	N/A	Handling the Nack Responses.
`onSuccess`	Callback Function	N/A	Handling the Success Responses.
`onError`	Callback Function	N/A	Handling the Error Responses.

`issueSellerToLogisitics()`

Property	Type	Default	Description
`issue`	Object	N/A	The issue object to generate the issue from seller to logistics.
`onNack`	Callback Function	N/A	Handling the Nack Responses.
`onSuccess`	Callback Function	N/A	Handling the Success Responses.
`onError`	Callback Function	N/A	Handling the Error Responses.

`issueStatusSellerToLogisitics()`

Property	Type	Default	Description
`issue_status`	Object	N/A	To send the issue status from seller to logistics.
`onNack`	Callback Function	N/A	Handling the Nack Responses.
`onSuccess`	Callback Function	N/A	Handling the Success Responses.
`onError`	Callback Function	N/A	Handling the Error Responses.

`onIssueFromLogisitics()`

Property	Type	Default	Description
`on_issue`	Object	N/A	To get the on issue from logistics.
`onNack`	Callback Function	N/A	Handling the Nack Responses.
`onSuccess`	Callback Function	N/A	Handling the Success Responses.
`onError`	Callback Function	N/A	Handling the Error Responses.

`onIssueStatusFromLogistics()`

Property	Type	Default	Description
`on_issue_status`	Object	N/A	To get the on issue status from logistics.
`onNack`	Callback Function	N/A	Handling the Nack Responses.
`onSuccess`	Callback Function	N/A	Handling the Success Responses.
`onError`	Callback Function	N/A	Handling the Error Responses.

Usage

For Buyer

import { issue } from 'ondc-igm-sdk';

issue.init({
  validateSchema: true,
  npType: ['BUYER'],
  context: [
    {
      subscriberId: '<example-subscriber-id>',
      subscriberType: 'BUYER',
      subscriberURL: '<example-subscriber-url>',
      expected_resolution_time: 'P1D',,
      expected_response_time: 'PT2H',,
      subscriberCity: 'BNN',
      subscriberCountry: '0378',
      subscriberDomain: '<example-subscriber-domain>',
      ttl: 'PT1H',
      subcriberState: '3434',
    },
  ],
  domain: ['RETAIL'],
  onSuccess: {
    on_issue: (value) => console.log('logging from on_issue callback', value),
    on_issue_status: (value) => console.log('logging from on_issue_status callback', value),
  },
  onError: (error) => console.log(error),
});

For Seller

issue.init({
  validateSchema: true,
  npType: ['SELLER', 'BUYER'],
  context: [
    {
      subscriberId: '<example-subscriber-id>',
      subscriberType: 'BUYER',
      subscriberURL: '<example-subscriber-url>',
      expected_resolution_time: 'P1D',,
      expected_response_time: 'PT2H',,
      subscriberCity: 'IND',
      subscriberCountry: '0378',
      subscriberDomain: '<example-subscriber-domain>',
      ttl: 'PT1H',
      subcriberState: '3434',
    },
  ],
  domain: ['RETAIL', 'LOGISTICS'],
  onSuccess: {
    issue: (value) => console.log('logging from seller on issue callback', value),
    issue_status: (value) => console.log('logging from seller issue status callback', value),
    on_issue: (value) => console.log('logging from seller on issue callback', value),
    on_issue_status: (value) => console.log('logging from seller on issue status callback', value),
  },
  onError: (error) => console.log(error),
})

For Logistics

issue.init({
  validateSchema: true,
  npType: ['LOGISTICS'],
  context: [
    {
      subscriberId: '<example-subscriber-id>',
      subscriberType: 'BUYER',
      subscriberURL: '<example-subscriber-url>',
      expected_resolution_time: 'P1D',,
      expected_response_time: 'PT2H',,
      subscriberCity: 'IND',
      subscriberCountry: '0378',
      subscriberDomain: '<example-subscriber-domain>',
      ttl: 'PT1H',
      subcriberState: '3434',
    },
  ],
  domain: ['RETAIL'],
  onSuccess: {
    issue: (value) => console.log('logging from logistics issue callback', value),
    issue_status: (value) => console.log('logging from logistics issue_status callback', value),
  },
  onError: (error) => console.log(error),
})

buyerIssue({ issue, onError, onNack, onSuccess }: RouteSpecificManagerProps)

Description: This function delegates the management of a buyer's issue to the BuyerManager.
Parameters:
- issue: The issue to be managed.
- onError: Callback for error handling.
- onNack: Callback for handling when the operation is not acknowledged.
- onSuccess: Callback for handling when the operation is successful.
Issue Schema:

{
    "context": {
        "bpp_id": "<example-bpp_id>",
        "bpp_uri": "<example-bpp_uri>",
        "ttl": "PT30S"
    },
    "message": {
        "issue": {
            "category": "ITEM",
            "sub_category": "ITM01",
            "complainant_info": {
                "person": {
                    "name": "Sam Manuel"
                },
                "contact": {
                    "phone": "9xxxxxxxxx",
                    "email": "<example.mail.com>"
                }
            },
            "order_details": {
                "id": "4597f703-e84f-431e-a96a-d147cfa142f9",
                "state": "Completed",
                "items": [
                    {
                        "id": "18275-ONDC-1-9",
                        "quantity": 1
                    }
                ],
                "fulfillments": [
                    {
                        "id": "Fulfillment1",
                        "state": "Order-delivered"
                    }
                ],
                "provider_id": "P1"
            },
            "description": {
                "short_desc": "Issue with product quality",
                "long_desc": "product quality is not correct. facing issues while using the product",
                "additional_desc": {
                    "url": "https://buyerapp.com/additonal-details/desc.txt",
                    "content_type": "text/plain"
                },
                "images": [
                    "http://buyerapp.com/addtional-details/img1.png",
                    "http://buyerapp.com/addtional-details/img2.png"
                ]
            },
            "source": {
                "network_participant_id": "buyerapp.com/ondc",
                "type": "CONSUMER"
            },
            "expected_response_time": {
                "duration": "PT2H"
            },
            "expected_resolution_time": {
                "duration": "P1D"
            },
            "status": "OPEN",
            "issue_type": "ISSUE",
            "issue_actions": {
                "complainant_actions": [
                    {
                        "complainant_action": "OPEN",
                        "short_desc": "Complaint created",
                        "updated_at": "2023-01-15T10:00:00.469Z",
                        "updated_by": {
                            "org": {
                                "name": "buyerapp.com::ONDC:RET10"
                            },
                            "contact": {
                                "phone": "9xxxxxxxxx",
                                "email": "<example.mail.com>"
                            },
                            "person": {
                                "name": "John Dode"
                            }
                        }
                    }
                ]
            },
            "created_at": "2023-01-15T10:00:00.469Z"

        }
    }
}

sellerOnIssue({ on_issue, onError, onNack, onSuccess }: RouteSpecificManagerProps)

Description: This function delegates the management of a seller's issue to the SellerManager.
Parameters:
- on_issue: The issue data to be managed by the seller.
- onError: Callback for error handling.
- onNack: Callback for handling when the operation is not acknowledged.
- onSuccess: Callback for handling when the operation is successful.
On_Issue Schema:

   {
    "context": {
        "bap_id":"<example-bap_id>",
        "bap_uri": "<example-bap_uri>",
        "transaction_id": "<example-transaction_id>",
        "message_id": "<example-message_id>",
        "timestamp": "2023-07-28T08:14:14.639Z"
    },
    "message": {
        "issue": {
            "id": "1c1bd458-c524-4f13-949b-71ce1c20e023",
            "issue_actions": {
                "respondent_actions": [
                    {
                        "cascaded_level": 1,
                        "respondent_action": "PROCESSING",
                        "short_desc": "We are investigating your concern.",
                        "updated_at": "2023-07-28T08:14:14.641Z",
                        "updated_by": {
                            "contact": {
                                "email": "<example.mail.com>",
                                "phone": "9xxxxxxxxx"
                            },
                            "org": {
                                "name": "https://fe48-115-240-127-98.ngrok-free.app::nic2004:52110"
                            },
                            "person": {
                                "name": "<example>"
                            }
                        }
                    }
                ]
            },
            "created_at": "2023-07-28T08:14:09.915Z"
        }
    }
}

buyerIssueStatus({ issue_status, onError, onNack, onSuccess }: RouteSpecificManagerProps)

Description: This function delegates the management of a buyer's issue status to the BuyerManager.
Parameters:
- issue_status: The issue status data to be managed.
- onError: Callback for error handling.
- onNack: Callback for handling when the operation is not acknowledged.
- onSuccess: Callback for handling when the operation is successful.
Issue_Status Schema:

{
  "context":
  {
    "bpp_id": "<example-bpp_id>",
    "bpp_uri": "<example-bpp_uri>",
    "transaction_id": "<example-transaction_id>",
    "message_id": "<example-message_id>",
    "timestamp": "2023-01-15T10:30:00.469Z",
    "ttl": "PT30S"
  },
  "message":
  {
    "issue_id": "I1"
  }
}

sellerOnIssueStatus({ on_issue_status, onError, onNack, onSuccess }: RouteSpecificManagerProps)

Description: This function delegates the management of a seller's issue status to the SellerManager.
Parameters:
- on_issue_status: The issue status data to be managed by the seller.
- onError: Callback for error handling.
- onNack: Callback for handling when the operation is not acknowledged.
- onSuccess: Callback for handling when the operation is successful.
On_Issue_Status Seller Schema:

{
    "context": {
        "bap_id": "<example-bap_id>",
        "bap_uri": "<example-bap_uri>",
        "transaction_id": "<example-transaction_id>",
        "message_id": "<example-message_id>",
        "timestamp": "2023-01-15T10:31:00.523Z"
    },
    "message": {
        "issue": {
            "id": "I1",
            "issue_actions": {
                "respondent_actions": [
                    {
                        "respondent_action": "PROCESSING",
                        "short_desc": "Complaint is being processed",
                        "updated_at": "2023-01-15T10:10:00.142Z",
                        "updated_by": {
                            "org": {
                                "name": "sellerapp.com::ONDC:RET10"
                            },
                            "contact": {
                                "phone": "9xxxxxxxxx",
                                "email": "<example.mail.com>"
                            },
                            "person": {
                                "name": "Jane Doe"
                            }
                        },
                        "cascaded_level": 1
                    },
                    {
                        "respondent_action": "RESOLVED",
                        "short_desc": "Complaint resolved",
                        "updated_at": "2023-01-15T10:31:00.523Z",
                        "updated_by": {
                            "org": {
                                "name": "sellerapp.com::ONDC:RET10"
                            },
                            "contact": {
                                "phone": "9xxxxxxxxx",
                                "email": "<example.mail.com>"
                            },
                            "person": {
                                "name": "Jane Doe"
                            }
                        },
                        "cascaded_level": 1
                    }
                ]
            },
            "created_at": "2023-01-15T10:00:00.469Z",
            "updated_at": "2023-01-15T10:31:00.523Z",
            "resolution_provider": {
                "respondent_info": {
                    "type": "TRANSACTION-COUNTERPARTY-NP",
                    "organization": {
                        "org": {
                            "name": "sellerapp.com::ONDC:RET10"
                        },
                        "contact": {
                            "phone": "9xxxxxxxxx",
                            "email": "<example.mail.com>"
                        },
                        "person": {
                            "name": "resolution provider org contact person name"
                        }
                    },
                    "resolution_support": {
                        "chat_link": "http://chat-link/respondent",
                        "contact": {
                            "phone": "9xxxxxxxxx",
                            "email": "<example.mail.com>"
                        },
                        "gros": [
                            {
                                "person": {
                                    "name": "Sam D"
                                },
                                "contact": {
                                    "phone": "9xxxxxxxxx",
                                    "email": "<example.mail.com>"
                                },
                                "gro_type": "TRANSACTION-COUNTERPARTY-NP-GRO"
                            }
                        ]
                    }
                }
            },
            "resolution": {
                "short_desc": "Refund to be initiated",
                "long_desc": "For this complaint, refund is to be initiated",
                "action_triggered": "REFUND",
                "refund_amount": "100"
            }
        }
    }
}

issueSellerToLogisitics({ issue, onError, onNack, onSuccess }: RouteSpecificManagerProps)

Description: This function delegates the management of a seller's issue to the logistics manager.
Parameters:
- issue: The issue data to be managed by the logistics manager.
- onError: Callback for error handling.
- onNack: Callback for handling when the operation is not acknowledged.
- onSuccess: Callback for handling when the operation is successful.
Issue Seller to Logistics Schema:

{
    "context": {
        "domain":"0030433",
        "country":"IND",
        "city":"0458",
        "bpp_id": "<example-bpp_id>",
        "bpp_uri": "<example-bpp_uri>",
        "ttl": "PT30S"
    },
    "message": {
        "issue": {
            "id":"4597f703-e84f-431e-a96a-d147cfa142f9",
            "category": "ITEM",
            "sub_category": "ITM01",
            "complainant_info": {
                "person": {
                    "name": "Sam Manuel"
                },
                "contact": {
                    "phone": "9xxxxxxxxx",
                    "email": "<example.mail.com>"
                }
            },
            "order_details": {
                "id": "4597f703-e84f-431e-a96a-d147cfa142f9",
                "state": "Completed",

                "items": [
                    {
                        "id": "18275-ONDC-1-9",
                        "quantity": 1
                    }
                ],
                "fulfillments": [
                    {
                        "id": "Fulfillment1",
                        "state": "Order-delivered"
                    }
                ],
                "provider_id": "P1"
            },
            "description": {
                "short_desc": "Issue with product quality",
                "long_desc": "product quality is not correct. facing issues while using the product",
                "additional_desc": {
                    "url": "https://buyerapp.com/additonal-details/desc.txt",
                    "content_type": "text/plain"
                },
                "images": [
                    "http://buyerapp.com/addtional-details/img1.png",
                    "http://buyerapp.com/addtional-details/img2.png"
                ]
            },
            "source": {
                "network_participant_id": "buyerapp.com/ondc",
                "type": "CONSUMER"
            },
            "expected_response_time": {
                "duration": "PT2H"
            },
            "expected_resolution_time": {
                "duration": "P1D"
            },
            "status": "OPEN",
            "issue_type": "ISSUE",
            "issue_actions": {
                "complainant_actions": [
                    {
                        "complainant_action": "OPEN",
                        "short_desc": "Complaint created",
                        "updated_at": "2023-01-15T10:00:00.469Z",
                        "updated_by": {
                            "org": {
                                "name": "buyerapp.com::ONDC:RET10"
                            },
                            "contact": {
                                "phone": "9xxxxxxxxx",
                                "email": "<example.mail.com>"
                            },
                            "person": {
                                "name": "John Dode"
                            }
                        }
                    }
                ],
                "respondent_actions": [
                    {
                        "respondent_action": "PROCESSING",
                        "short_desc": "Complaint is being processed",
                        "updated_at": "2023-01-15T10:10:00.142Z",
                        "updated_by": {
                            "org": {
                                "name": "sellerapp.com::ONDC:RET10"
                            },
                            "contact": {
                                "phone": "9xxxxxxxxx",
                                "email": "<example.mail.com>"
                            },
                            "person": {
                                "name": "Jane Doe"
                            }
                        },
                        "cascaded_level": 1
                    },
                    {
                        "respondent_action": "RESOLVED",
                        "short_desc": "Complaint resolved",
                        "updated_at": "2023-01-15T10:31:00.523Z",
                        "updated_by": {
                            "org": {
                                "name": "sellerapp.com::ONDC:RET10"
                            },
                            "contact": {
                                "phone": "9xxxxxxxxx",
                                "email": "<example.mail.com>"
                            },
                            "person": {
                                "name": "Jane Doe"
                            }
                        },
                        "cascaded_level": 1
                    }
                ]
            },
            "created_at": "2023-01-15T10:00:00.469Z"
        }
    }
}

issueStatusSellerToLogisitics({ issue_status, onError, onNack, onSuccess }: RouteSpecificManagerProps)

Description: This function delegates the management of a seller's issue status to the logistics manager.
Parameters:
- issue_status: The issue status data to be managed by the logistics manager.
- onError: Callback for error handling.
- onNack: Callback for handling when the operation is not acknowledged.
- onSuccess: Callback for handling when the operation is successful.
Issue_Status Seller To Logistics Schema:

{
    "context": {
        "domain": "0030433",
        "country": "IND",
        "city": "0458",
        "bpp_id": "<example-bpp_id>",
        "bpp_uri": "<example-bpp_uri>",
        "transaction_id": "<example-transaction_id>",
        "message_id": "<example-message_id>",
        "timestamp": "2023-01-15T10:30:00.469Z",
        "ttl": "PT30S"
    },
    "message": {
        "issue_id": "I1"
    }
}

onIssueFromLogisitics({ on_issue, onError, onNack, onSuccess }: RouteSpecificManagerProps)

Description: This function delegates the management of an on_issue to the logistics manager from a buyer perspective.
Parameters:
- on_issue: The on_issue data to be managed.
- onError: Callback for error handling.
- onNack: Callback for handling when the operation is not acknowledged.
- onSuccess: Callback for handling when the operation is successful.
On_Issue Logistics Schema:

{
    "context": {
        "domain": "0030433",
        "country": "IND",
        "city": "0458",
        "bap_id": "<example-bap_id>",
        "bap_uri": "<example-bap_uri>",
        "transaction_id": "<example-transaction_id>",
        "message_id": "<example-message_id>",
        "timestamp": "2023-07-28T08:14:14.639Z",
        "ttl": "PT30S"
    },
    "message": {
        "issue": {
            "id": "1c1bd458-c524-4f13-949b-71ce1c20e023",
            "issue_actions": {
                "respondent_actions": [
                    {
                        "cascaded_level": 1,
                        "respondent_action": "PROCESSING",
                        "short_desc": "We are investigating your concern.",
                        "updated_at": "2023-07-28T08:14:14.641Z",
                        "updated_by": {
                            "contact": {
                                "email": "<example.mail.com>",
                                "phone": "9xxxxxxxxx"
                            },
                            "org": {
                                "name": "https://fe48-115-240-127-98.ngrok-free.app::nic2004:52110"
                            },
                            "person": {
                                "name": "<example>"
                            }
                        }
                    }
                ]
            },
            "created_at": "2023-07-28T08:14:09.915Z"
        }
    }
}