Parent API: GST API Quickstart guide Authentication guide

File GSTR-3B Return with DSC

Q: What parameters and payload format are required for File GSTR3B data?

Requests are submitted via HTTP POST to '/gstr3b/retfile'. Required parameters: 'email' (query parameter), 'pan' (query parameter), 'gstin' (header parameter), 'ret_period' (header parameter), 'gst_username' (header parameter), 'state_cd' (header parameter), 'ip_address' (header parameter), 'txn' (header parameter), 'client_id' (header parameter), 'client_secret' (header parameter). A JSON request body ('Content-Type: application/json') is accepted per the schema specifications shown in the request documentation.

Q: What response status codes and format does File GSTR3B data return?

For File GSTR3B data (POST '/gstr3b/retfile'), 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).

POSThttps://apisandbox.whitebooks.in/gstr3b/retfile

Used to File GSTR3B invoices.

Instant Filing

Explore Feature

GSTR-3B 1-Click Return Filing & Challan Pay

File GSTR-3B with single-click EVC/DSC authorization and instant payment challan generation.

Parameters

query parameters

emailstringrequired

API Developer User Email

panstringrequired

PAN Number

header parameters

gstinstringrequired

GST Number

ret_periodstringrequired

Return Period (MMYYYY)

gst_usernamestringrequired

GST UserName

state_cdstringrequired

State Code

ip_addressstringrequired

IP Address

txnstringrequired

Transaction

client_idstringrequired

Client ID

client_secretstringrequired

Client Secret

Request Body

application/jsonrequired

Response

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

Frequently Asked Questions

Requests are submitted via HTTP POST to /gstr3b/retfile. Required parameters: email (query parameter), pan (query parameter), gstin (header parameter), ret_period (header parameter), gst_username (header parameter), state_cd (header parameter), ip_address (header parameter), txn (header parameter), client_id (header parameter), client_secret (header parameter). A JSON request body (Content-Type: application/json) is accepted per the schema specifications shown in the request documentation.

For File GSTR3B data (POST /gstr3b/retfile), 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).

Used to File GSTR3B invoices.

Save past liability breakup GSTR3B Data

File GSTR3B data

POST/gstr3b/retfile

1const response = await fetch('https://apisandbox.whitebooks.in/gstr3b/retfile?email=value&pan=value', {

2 method: 'POST',

3 headers: {

4 gstin: "value",

5 ret_period: "value",

6 gst_username: "value",

7 state_cd: "value",

8 ip_address: "value",

9 txn: "value",

10 client_id: "value",

11 client_secret: "value",

12 Content-Type: "application/json"

13},

14 body: JSON.stringify({

15 "gstin": "05AVHPB7348G1ZP",

16 "ret_period": "042024",

17 "sup_details": {

18 "osup_det": {

19 "txval": 250,

20 "iamt": 100,

21 "camt": 200,

22 "samt": 300,

23 "csamt": 400

24 },

25 "osup_zero": {

26 "txval": 250,

27 "iamt": 100,

28 "csamt": 400

29 },

30 "osup_nil_exmp": {

31 "txval": 250

32 },

33 "isup_rev": {

34 "txval": 250,

35 "iamt": 100,

36 "camt": 200,

37 "samt": 300,

38 "csamt": 400

39 },

40 "osup_nongst": {

41 "txval": 250

42 }

43 },

44 "inter_sup": {

45 "unreg_details": {},

46 "comp_details": {},

47 "uin_details": {}

48 },

49 "eco_dtls": {

50 "eco_sup": {

51 "txval": 250,

52 "iamt": 100,

53 "camt": 200,

54 "samt": 300,

55 "csamt": 400

56 },

57 "eco_reg_sup": {

58 "txval": 250

59 }

60 },

61 "itc_elg": {

62 "itc_avl": {},

63 "itc_rev": {},

64 "itc_net": {

65 "camt": 274,

66 "csamt": 103,

67 "iamt": 136.53,

68 "samt": 162.99

69 },

70 "itc_inelg": {}

71 },

72 "inward_sup": {

73 "isup_details": {}

74 },

75 "tx_pmt": {

76 "tx_py": [

77 {

78 "trans_typ": 30002,

79 "trans_desc": "Other than reverse charge",

80 "liab_ldg_id": 11191,

81 "cgst": {

82 "intr": 100,

83 "tx": 100,

84 "fee": 100

85 },

86 "sgst": {

87 "intr": 100,

88 "tx": 100,

89 "fee": 100

90 },

91 "cess": {

92 "intr": 100,

93 "tx": 100

94 },

95 "igst": {

96 "intr": 100,

97 "tx": 100

98 }

99 }

100 ],

101 "pdcash": [

102 {

103 "liab_ldg_id": 1233,

104 "trans_typ": 30002,

105 "ipd": 3517817,

106 "cpd": 3517817,

107 "spd": 3517817,

108 "cspd": 3517817,

109 "i_intrpd": 20,

110 "c_intrpd": 30,

111 "s_intrpd": 10,

112 "cs_intrpd": 15,

113 "c_lfeepd": 13,

114 "s_lfeepd": 13

115 }

116 ],

117 "pditc": {

118 "liab_ldg_id": 12321,

119 "trans_typ": 30002,

120 "i_pdi": 3517817,

121 "i_pdc": 2290459,

122 "i_pds": 2290459,

123 "c_pdi": 3517817,

124 "c_pdc": 2290459,

125 "s_pdi": 3517817,

126 "s_pds": 2290459,

127 "cs_pdcs": 2290459

128 }

129 }

130}),

131});

132

133const data = await response.json();

134console.log(data);

No example available.