Get Principal

The Get Principals API allows RVAT agents to retrieve a list of their principals. This is a necessary step for processing RVAT transactions correctly.

⚠️ Note: This endpoint is intended solely for use by RVAT Agents.

GetPrincipalsAsync() Method

This method calls the underlying POST endpoint to retrieve the list of principals associated with the authenticated RVAT agent.

---

Request

The request requires the following data to be sent in the request body: NB: These details are stored in the configuration files

Parameter	Type	Required	Description	Example
Tpin	string	Optional	Taxpayer Identification Number of the RVAT agent.	"123456789"
BhfId	string	Optional	Branch identifier of the RVAT agent.	"BRANCH-001"
LastRequestDate	string	Optional	The date and time of the last successful request (in ISO 8601 format). Used to fetch only new or updated records.	"2023-10-25T14:30:00Z"

---

Usage Example

Example Successful Response

{
    {
                "manufacturerTpin": "1000018994",
                "manufacturerName": "NGAMBI ELIAS",
                "itemCd": "12345",
                "itemClsCd": "5020220100",
                "itemNm": "Dunhill switch",
                "orgnNatCd": "ZM",
                "pkgUnitCd": "PACK",
                "qtyUnitCd": "NO",
                "rrp": 4000
            },
            {
                "manufacturerTpin": "1000018994",
                "manufacturerName": "NGAMBI ELIAS",
                "itemCd": "33351",
                "itemClsCd": "5020220100",
                "itemNm": "Beer",
                "orgnNatCd": "ZM",
                "pkgUnitCd": "BN",
                "qtyUnitCd": "L",
                "rrp": 300
            },
            {
                "manufacturerTpin": "1001688716",
                "manufacturerName": "ORICA ZAMBIA LIMITED",
                "itemCd": "RRP1",
                "itemClsCd": "31201532",
                "itemNm": "PVC PIPE",
                "orgnNatCd": "SA",
                "pkgUnitCd": "NT",
                "qtyUnitCd": "NO",
                "rrp": 1000
            },
            {
                "manufacturerTpin": "1001688716",
                "manufacturerName": "ORICA ZAMBIA LIMITED",
                "itemCd": "2007",
                "itemClsCd": "31201532",
                "itemNm": "ImportItem5",
                "orgnNatCd": "SA",
                "pkgUnitCd": "PK",
                "qtyUnitCd": "GRO",
                "rrp": 1000
            },
            {
                "manufacturerTpin": "1001846988",
                "manufacturerName": "SAVANNA SOLUTIONS LIMITED",
                "itemCd": "SPDRNK001",
                "itemClsCd": "50193001",
                "itemNm": "Special Drink",
                "orgnNatCd": "ZM",
                "pkgUnitCd": "EA",
                "qtyUnitCd": "EA",
                "rrp": 160
            },
            {
                "manufacturerTpin": "1001846988",
                "manufacturerName": "SAVANNA SOLUTIONS LIMITED",
                "itemCd": "LNV001",
                "itemClsCd": "43211700",
                "itemNm": "Lenovo Laptop",
                "orgnNatCd": "CN",
                "pkgUnitCd": "EA",
                "qtyUnitCd": "EA",
                "rrp": 7500
            },
            {
                "manufacturerTpin": "1001846988",
                "manufacturerName": "SAVANNA SOLUTIONS LIMITED",
                "itemCd": "SPRT001",
                "itemClsCd": "50193001",
                "itemNm": "Sprite",
                "orgnNatCd": "ZM",
                "pkgUnitCd": "EA",
                "qtyUnitCd": "EA",
                "rrp": 160
            },
            {
                "manufacturerTpin": "1002590502",
                "manufacturerName": "ULTRAVETIS ZAMBIA LIMITED",
                "itemCd": "FG470304",
                "itemClsCd": "10121800",
                "itemNm": "PetPlus 5Kg (Unit per Kg)",
                "orgnNatCd": "TZ",
                "pkgUnitCd": "BG",
                "qtyUnitCd": "KG",
                "rrp": 52
            },
            {
                "manufacturerTpin": "1002590502",
                "manufacturerName": "ULTRAVETIS ZAMBIA LIMITED",
                "itemCd": "FG470302",
                "itemClsCd": "10121800",
                "itemNm": "PetPlus 5Kg (Unit per Kg)",
                "orgnNatCd": "TZ",
                "pkgUnitCd": "BG",
                "qtyUnitCd": "KG",
                "rrp": 50
            },
            {
                "manufacturerTpin": "1002590502",
                "manufacturerName": "ULTRAVETIS ZAMBIA LIMITED",
                "itemCd": "Sera Smart Invoice",
                "itemClsCd": "13111203",
                "itemNm": "Sera Smart Invoice",
                "orgnNatCd": "ZM",
                "pkgUnitCd": "BG",
                "qtyUnitCd": "BX",
                "rrp": 123.68
            },
            {
                "manufacturerTpin": "1002590502",
                "manufacturerName": "ULTRAVETIS ZAMBIA LIMITED",
                "itemCd": "itemCode2",
                "itemClsCd": "50102515",
                "itemNm": "Item Name Example 4",
                "orgnNatCd": "ZM",
                "pkgUnitCd": "BG",
                "qtyUnitCd": "BX",
                "rrp": 123.68
            },
            {
                "manufacturerTpin": "1002590502",
                "manufacturerName": "ULTRAVETIS ZAMBIA LIMITED",
                "itemCd": "itemCode1",
                "itemClsCd": "50102515",
                "itemNm": "Item Name Example",
                "orgnNatCd": "ZM",
                "pkgUnitCd": "BG",
                "qtyUnitCd": "BX",
                "rrp": 123.68
            },
            {
                "manufacturerTpin": "1002590502",
                "manufacturerName": "ULTRAVETIS ZAMBIA LIMITED",
                "itemCd": "Sample 1",
                "itemClsCd": "50102515",
                "itemNm": "Sample 1",
                "orgnNatCd": "ZM",
                "pkgUnitCd": "BG",
                "qtyUnitCd": "BX",
                "rrp": 123.68
            },
            {
                "manufacturerTpin": "1002590502",
                "manufacturerName": "ULTRAVETIS ZAMBIA LIMITED",
                "itemCd": "FG430515",
                "itemClsCd": "10121800",
                "itemNm": "Cosumix Plus 20KG (unit per kg)",
                "orgnNatCd": "TZ",
                "pkgUnitCd": "BG",
                "qtyUnitCd": "PIECE",
                "rrp": 900
            },
            {
                "manufacturerTpin": "1002590502",
                "manufacturerName": "ULTRAVETIS ZAMBIA LIMITED",
                "itemCd": "FG420241",
                "itemClsCd": "10121800",
                "itemNm": "Ultravin Dudu Dust 100GM",
                "orgnNatCd": "TZ",
                "pkgUnitCd": "BG",
                "qtyUnitCd": "PIECE",
                "rrp": 35
            },
}