Parent API: GST API Quickstart guide Authentication guide

GSTR-1A E-Commerce Operator Invoices (ECOM)

Q: What parameters and payload format are required for Get ECOM Invoices?

Requests are submitted via HTTP GET to '/gstr1a/ecom'. Required parameters: 'email' (query parameter), 'gstin' (query parameter), 'retperiod' (query parameter), 'gst_username' (header parameter), 'state_cd' (header parameter), 'ip_address' (header parameter), 'txn' (header parameter), 'client_id' (header parameter), 'client_secret' (header parameter). No request body payload is required for this call.

Q: What response status codes and format does Get ECOM Invoices return?

For Get ECOM Invoices (GET '/gstr1a/ecom'), responses are returned in JSON format ('application/json'). Documented response codes in the specification include: HTTP 404 (Not Found. If requested entity is not found or if requested API is not found.), HTTP 500 (Internal server error).

GEThttps://apisandbox.whitebooks.in/gstr1a/ecom

Getting all ECOM invoices for a return period.

Parameters

query parameters

emailstringrequired

gstinstringrequired

GSTIN of the taxpayer

retperiodstringrequired

Return Period format MMYYYY

rtinstringoptional

Recepient of the GSTIN

subsectionstringoptional

Sub Section(ECOM_B2B/ECOM_B2C/ECOM_URP2B/ECOM_URP2C)

fromtimestringoptional

From time format DD-MM-YYYY,20-12-2016

header parameters

gst_usernamestringrequired

GST UserName

state_cdstringrequired

State Code

ip_addressstringrequired

IP Address

txnstringrequired

Transaction

client_idstringrequired

Client ID

client_secretstringrequired

Client Secret

Response

Not Found. If requested entity is not found or if requested API is not found.

Frequently Asked Questions

Requests are submitted via HTTP GET to /gstr1a/ecom. Required parameters: email (query parameter), gstin (query parameter), retperiod (query parameter), gst_username (header parameter), state_cd (header parameter), ip_address (header parameter), txn (header parameter), client_id (header parameter), client_secret (header parameter). No request body payload is required for this call.

For Get ECOM Invoices (GET /gstr1a/ecom), responses are returned in JSON format (application/json). Documented response codes in the specification include: HTTP 404 (Not Found. If requested entity is not found or if requested API is not found.), HTTP 500 (Internal server error).

Getting all ECOM invoices for a return period.

Get Supplier ECOA invoices

Get ECOMA Invoices

GET/gstr1a/ecom

1const response = await fetch('https://apisandbox.whitebooks.in/gstr1a/ecom?email=value&gstin=value&retperiod=value&rtin=value&subsection=value&fromtime=value', {

2 method: 'GET',

3 headers: {

4 gst_username: "value",

5 state_cd: "value",

6 ip_address: "value",

7 txn: "value",

8 client_id: "value",

9 client_secret: "value"

10},

11});

13const data = await response.json();

14console.log(data);

No example available.