Perione e-Invoice API

How to Start

Go to Credentials > Use Sandbox Keys Click here
Go to Credentials > Use Production Keys ( Top-up or Renew e-Invoice APIs)
Start using Perione e-Invoice Client ID & Client Secret ID Credentials for your Sandbox Testing
e-Invoice API Integration Demo, Click here

API Documentation

e-Invoice Help Document Click Here
Error Codes Click Here
SSL Certificate Click Here
Master List Click Here
Click Here E-Invoice API Documentation

Choose the environment you want to test:

Sandbox

Production

Use Base URL as: https://staging.perione.in

Field Name	Description	Type
email * ^required	Email address	(query)
client_id * ^required	Client ID	(header)
client_secret * ^required	Client Secret	(header)
gstin * ^required	GSTIN number	(header)
ip_address * ^required	IP Address	(header)
username * ^required	User Name	(header)
password * ^required	Password	(header)

Curl

Request URL

Status Code

Response

Field Name	Description	Type	Action
param1 * ^required	GSTN Number	(query)	string
email * ^required	User Email	(query)
ip_address * ^required	IP Address	(header)
client_id * ^required	Client ID	(header)
client_secret * ^required	Client Secret	(header)
username * ^required	User Name	(header)
auth-token * ^required	Token	(header)
gstin * ^required	GSTIN number	(header)

Curl

Request URL

Status Code

Response

Name	Description	Parameter Type	Data Type
param1 * ^required	GSTN Number	(query)	string
email * ^required	User Email	(query)
ip_address * ^required	IP Address	(header)
client_id * ^required	Client ID	(header)
client_secret * ^required	Client Secret	(header)
username * ^required	User Name	(header)
auth-token * ^required	Token	(header)
gstin * ^required	GSTIN number	(header)

Curl

Request URL

Status Code

Response

Name	Description	Parameter Type	Data Type
email * ^required	User Email	(query)	string
ip_address * ^required	IP Address	(header)	string
client_id * ^required	Client ID	(header)	string
client_secret * ^required	Client Secret	(header)	string
username * ^required	User Name	(header)	string
auth-token * ^required	Token	(header)	string
gstin * ^required	GSTIN number	(header)	string

{
  "Version": "1.1",
  "TranDtls": {
    "TaxSch": "GST",
    "SupTyp": "B2B",
    "RegRev": "N",
    "EcmGstin": null,
    "IgstOnIntra": "N"
  },
  "DocDtls": {
    "Typ": "INV",
    "No": "INV-1652",
    "Dt": "05/05/2026"
  },
  "SellerDtls": {
    "Gstin": "29AARFB4347G000",
    "LglNm": "NIC company pvt ltd",
    "TrdNm": "NIC company pvt ltd",
    "Addr1": "5th block",
    "Addr2": "Bengaluru City",
    "Loc": "BENGALURU",
    "Pin": 560001,
    "Stcd": "29",
    "Ph": "9000000000",
    "Em": "abc@gmail.com"
  },
  "BuyerDtls": {
    "Gstin": "29AWGPV7107B1Z1",
    "LglNm": "XYZ company pvt ltd",
    "TrdNm": "XYZ company pvt ltd",
    "Pos": "37",
    "Addr1": "7th block",
    "Addr2": "Kuvempu layout",
    "Loc": "BENGALURU",
    "Pin": 562160,
    "Stcd": "29",
    "Ph": "9000000000",
    "Em": "xyz@gmail.com"
  },
  "DispDtls": {
    "Nm": "NIC company pvt ltd",
    "Addr1": "5th block",
    "Addr2": "Bengaluru City",
    "Loc": "BENGALURU",
    "Pin": 560001,
    "Stcd": "29"
  },
  "ShipDtls": {
    "Gstin": "29AWGPV7107B1Z1",
    "LglNm": "XYZ company pvt ltd",
    "TrdNm": "XYZ company pvt ltd",
    "Addr1": "7th block",
    "Addr2": "Kuvempu layout",
    "Loc": "KURNOOL",
    "Pin": 518360,
    "Stcd": "37"
  },
  "ItemList": [
    {
      "SlNo": "1",
      "IsServc": "N",
      "PrdDesc": "Rice",
      "HsnCd": "1001",
      "Barcde": "123456",
      "BchDtls": {
        "Nm": "BATCH001",
        "Expdt": "01/08/2026",
        "wrDt": "01/09/2026"
      },
      "Qty": 600,
      "FreeQty": 0,
      "Unit": "BAG",
      "UnitPrice": 100,
      "TotAmt": 60000,
      "Discount": 0,
      "PreTaxVal": 0,
      "AssAmt": 60000,
      "GstRt": 5,
      "CgstAmt": 0,
      "SgstAmt": 0,
      "IgstAmt": 3000,
      "CesRt": 0,
      "CesAmt": 0,
      "CesNonAdvlAmt": 0,
      "StateCesRt": 0,
      "StateCesAmt": 0,
      "StateCesNonAdvlAmt": 0,
      "OthChrg": 0,
      "TotItemVal": 63000,
      "OrdLineRef": "1",
      "OrgCntry": "IN",
      "PrdSlNo": "RICE001",
      "AttribDtls": [
        {
          "Nm": "Rice",
          "Val": "600 Bags"
        }
      ]
    }
  ],
  "ValDtls": {
    "AssVal": 60000,
    "CgstVal": 0,
    "SgstVal": 0,
    "IgstVal": 3000,
    "CesVal": 0,
    "StCesVal": 0,
    "Discount": 0,
    "OthChrg": 0,
    "RndOffAmt": 0,
    "TotInvVal": 63000,
    "TotInvValFc": 63000
  },
  "PayDtls": {
    "Nm": "XYZ company pvt ltd",
    "Accdet": "5697389713210",
    "Mode": "Cash",
    "Fininsbr": "SBIN11000",
    "Payterm": "Immediate",
    "Payinstr": "Cash Payment",
    "Crtrn": "NA",
    "Dirdr": "NA",
    "Crday": 0,
    "Paidamt": 63000,
    "Paymtdue": 0
  },
  "RefDtls": {
    "InvRm": "IRN with E-Way Bill generation",
    "DocPerdDtls": {
      "InvStDt": "05/05/2026",
      "InvEndDt": "05/05/2026"
    },
    "PrecDocDtls": [
      {
        "InvNo": "DOC/001",
        "InvDt": "05/05/2026",
        "OthRefNo": "REF001"
      }
    ],
    "ContrDtls": [
      {
        "RecAdvRefr": "DOC/001",
        "RecAdvDt": "05/05/2026",
        "Tendrefr": "TEN001",
        "Contrrefr": "CON001",
        "Extrefr": "EXT001",
        "Projrefr": "PROJ001",
        "Porefr": "PO001",
        "PoRefDt": "05/05/2026"
      }
    ]
  },
  "AddlDocDtls": [
    {
      "Url": "https://staging.perione.in",
      "Docs": "Invoice Document",
      "Info": "IRN with E-Way Bill test"
    }
  ],
  "ExpDtls": {
    "ShipBNo": "NA",
    "ShipBDt": "05/05/2026",
    "Port": "INBLR1",
    "RefClm": "N",
    "ForCur": "INR",
    "CntCode": "IN"
  },
  "EwbDtls": {
    "Transid": "12AWGPV7107B1Z1",
    "Transname": "XYZ EXPORTS",
    "Distance": 0,
    "Transdocno": "DOC01",
    "TransdocDt": "05/05/2026",
    "Vehno": "KA12AB1234",
    "Vehtype": "R",
    "TransMode": "1"
  }
}

Curl

Request URL

Status Code

Response

Name	Description	Parameter Type	Data Type
param1 * ^required	IRN	(query)	string
email * ^required	User Email	(query)	string
supplier_gstn	Supplier GSTIN, only in case E Comm. operator is getting IRN details	(query)	string
irp	e-Invoice Server Type(NIC1/NIC2), given at the time of e-Invoice generation	(query)	string
ip_address * ^required	IP Address	(header)	string
client_id * ^required	Client ID	(header)	string
client_secret * ^required	Client Secret	(header)	string
username * ^required	User Name	(header)	string
auth-token * ^required	Token	(header)	string
gstin * ^required	GSTIN number	(header)	string

Curl

Request URL

Status Code

Response

Name	Description	Parameter Type	Data Type
param1 * ^required	Document type	(query)	string
supplier_gst	Supplier GSTIN, only in case E Comm. operator is getting IRN details	(query)	string
irp	e-Invoice Server Type(NIC1/NIC2),given at the time of e-Invoice generation	(query)	string
docnum * ^required	Document number	(header)	string
docdate * ^required	Document date (dd/MM/YYYY)	(header)	string
email * ^required	User Email	(query)	string
ip_address * ^required	IP Address	(header)	string
client_id * ^required	Client ID	(header)	string
client_secret * ^required	Client Secret	(header)	string
username * ^required	User Name	(header)	string
auth-token * ^required	Token	(header)	string
gstin * ^required	GSTIN number	(header)	string

Curl

Request URL

Status Code

Response

Name	Description	Parameter Type	Data Type
email * ^required	User Email	(query)	string
irp	e-Invoice Server Type(NIC1/NIC2), given at the time of e-Invoice generation	(query)	string
ip_address * ^required	IP Address	(header)	string
client_id * ^required	Client ID	(header)	string
client_secret * ^required	Client Secret	(header)	string
username * ^required	User Name	(header)	string
auth-token * ^required	Token	(header)	string
gstin * ^required	GSTIN number	(header)	string

Curl

Request URL

Status Code

Response

Name	Description	Parameter Type	Data Type
email * ^required	User Email	(query)	string
ip_address * ^required	IP Address	(header)	string
client_id * ^required	Client ID	(header)	string
client_secret * ^required	Client Secret	(header)	string
username * ^required	User Name	(header)	string
auth-token * ^required	Token	(header)	string
gstin * ^required	GSTIN number	(header)	string

Curl

Request URL

Status Code

Response

Name	Description	Parameter Type	Data Type
param1 * ^required	IRN	(query)	string
supplier_gstn	Supplier GSTN	(query)	string
irp	e-Invoice Server Type(NIC1/NIC2), given at the time of e-Invoice generation	(query)	string
email * ^required	User Email	(query)
ip_address * ^required	IP Address	(header)
client_id * ^required	Client ID	(header)
client_secret * ^required	Client Secret	(header)
username * ^required	User Name	(header)
auth-token * ^required	Token	(header)
gstin * ^required	GSTIN number	(header)