Push IRM Request Fields

JSON	Name	Req	Format	Description
`recordResCount`	Record request count	Y	`int(4)`	Total IRM invoice mappings in this message. At most 999 per message.
`uploadType`	eBRC type	Y	`int(3)`	eBRC type: 101 Direct Export, 102 Softex, 103 Service Non IT, 104 Deemed. Sent as a string, e.g. `"101"`.
`decalarationFlag`	Declaration Flag	Y	`string(1)`	Exporter declaration confirming correctness of data. Spelling preserved exactly for wire compatibility.

IRM identification

JSON	Name	Req	Format	Description
`serialNo`	Serial Number	Y	`number(3)`	Unique serial within the message; 1-999.
`branchSlNo`	IEC branch Serial number	Y	`int(3)`	IEC branch where invoice is generated. Default 0. A whole number, 0-999.
`irmNumber`	IRM Number	Y	`string(50)`	IRM number.
`irmDt`	IRM date	Y	`date(ddMMyyyy)`	IRM date.
`irmIfscCode`	IFSC Code	Y	`string(11)`	Bank IFSC for the IRM.
`irmAdCode`	AD Code	Y	`string(7)`	AD code of Shipping bill/SOFTEX/Invoice.
`irmFCC`	IRM foreign currency code	Y	`string(3)`	IRM FC code. See Currency Codes.
`irmPurposeCode`	Purpose Code	Y	`string(5)`	Purpose code of IRM: `P` followed by four digits. Must match the purpose on the IRM itself, or the filing is warned and DGFT answers ERR22. See Purpose Codes.

These five fields are checked against the IRM we hold for the exporter, and a disagreement is reported in the warnings array of an accepted filing rather than refused: irmIfscCode, irmAdCode, irmDt, irmFCC and irmPurposeCode. DGFT compares the same five and answers ERR15, ERR16, ERR19, ERR20 and ERR22 on the status poll hours later, so the warning is the same finding, earlier. See Errors.

Invoice references

JSON	Name	Req	Format	Description
`sbCumInvoiceNumber`	Shipping bill/SOFTEX/Invoice Number	Y	`string(20)`	Which document this is depends on `uploadType` — see below. Shipping bill for Direct Export, SOFTEX for software exports, invoice number for other service exports.
`sbCumInvoiceDate`	Shipping Bill/SOFTEX/Invoice date	Y	`date(ddMMyyyy)`	Date of whichever document `sbCumInvoiceNumber` carries.
`portCode`	Port Code	Y	`string(6)`	As per DGFT master data. See Port Codes.
`sbCumInvoiceFCC`	Shipping Bill/SOFTEX/Invoice FC Code	Y	`string(3)`	FC code for the invoice. See Currency Codes.
`sbCumInvoiceValueinFCC`	Total Shipping Bill/SOFTEX/Invoice Value in FCC	Y	`number(16,2)`	Invoice value in FCC.
`billNo`	Bill Number	Y	`string(20)`	The bill/invoice number the IRM is mapped against within the shipping bill or SOFTEX. This is not the same field as `sbCumInvoiceNumber`. For service exports other than software the invoice number and bill number may be identical.

sbCumInvoiceNumber carries three different documents, and Direct Export has a stricter rule than the string(20) above.

`uploadType`	What `sbCumInvoiceNumber` must contain	Constraint
`101` Direct Export	The shipping bill number	Digits only, at most 7
`102` Softex	The SOFTEX number	Up to 20 characters
`103` Service Non-IT	The invoice number	Up to 20 characters
`104` Deemed	Not specified by DGFT	Up to 20 characters

For a Direct Export, an invoice-style reference such as EX/25-26/028 or SB7654321 is rejected with 400 before the filing is sent to DGFT. The invoice reference belongs in billNo.

Direct export (uploadType 101)

{
  "uploadType": 101,
  "sbCumInvoiceNumber": "9489431",      // shipping bill number - digits, max 7
  "billNo": "EX/25-26/028"              // your invoice reference
}

Swapping these two is the most common cause of a rejected Direct Export filing. DGFT’s own error for it is ERR25 — “Invalid shipping bill number. It cannot be greater than 7 digit” — which would otherwise surface hours later on the status poll rather than at submission.

Amounts and currency

JSON	Name	Req	Format	Description
`irmRemitAmtFCC`	Remittance Amount Available in FCC	Y	`number(16,2)`	Total remittance available in FCC.
`mappedIRMAmountFCC`	IRM FCC Amount mapped	Y	`number(16,2)`	IRM amount mapped against invoice.
`mappedORMAmountFCC`	ORM Amount mapped	Y	`number(16,2)`	ORM amount mapped in invoice.

Vostro and third-party

JSON	Name	Req	Format	Description
`isVostro`	IsVostro Payment	Y	`string(1)`	Y if payment received in Vostro account.
`vostroType`	Vostro Type	O	`string(4)`	SVRA or NVRA.
`isThirdPartyExport`	Third Party Export	Y	`string(1)`	Y if remittance received by a third party.

Deductions (optional)

JSON	Name	Req	Format	Description
`commissionValDeduct`	Commission Value to be deducted	N	`number(16,2)`	Commission to deduct from IRM FCC.
`commissionValInfo`	Commission Value Info	N	`number(16,2)`	Commission for information in invoice FCC.
`discountValDeduct`	Discount value to be deducted	N	`number(16,2)`	Discount to deduct from IRM FCC.
`discountValInfo`	Discount value Info	N	`number(16,2)`	Discount for information in invoice FCC.
`insuranceValDeduct`	Insurance value to be deducted	N	`number(16,2)`	Insurance to deduct from IRM FCC.
`insuranceValInfo`	Insurance value Info	N	`number(16,2)`	Insurance for information in invoice FCC.
`otherDeductionDeduct`	Other deduction to be deducted	N	`number(16,2)`	Other deduction to deduct from IRM FCC.
`otherdeductionsInfo`	Other deduction for info	N	`number(16,2)`	Other deduction for information in invoice FCC. Spelling preserved exactly for wire compatibility.
`freightValDeduct`	Freight value to be deducted	N	`number(16,2)`	Freight to deduct from IRM FCC.
`freightValInfo`	Freight value for info	N	`number(16,2)`	Freight for information in invoice FCC.

Services (optional)

JSON	Name	Req	Format	Description
`sacCode1`	SAC Code	N	`string(8)`	SAC code for service export.
`sacCode2`	SAC Code 2	N	`string(8)`	Second SAC code, if applicable.
`serviceTypeModesValue`	Mode of Export of Services	O	`string`	Cross-border, Consumption Abroad, Commercial Presence, Presence of Natural Persons.

GST details

JSON	Name	Req	Format	Description
`isGstAvail`	GSTIN Available	Y	`string(1)`	Whether to avail GSTIN benefit. `Y` or `N`. Cannot be null or empty.
`gstinInvoiceNumber`	GST Invoice No	O(M)	`string(30)`	Mandatory if `isGstAvail` is `Y`; must be `null` if `isGstAvail` is `N`.
`gstinInvoiceDate`	GST Invoice Date	O(M)	`date(ddMMyyyy)`	Mandatory if `isGstAvail` is `Y`; must be `null` if `isGstAvail` is `N`.

Reference data

Push IRM Request Fields

Message fields

Item fields (`ebrcBulkGenDtos[]`)

Used by

​Message fields

​Item fields (ebrcBulkGenDtos[])

​Used by

Message fields

Item fields (`ebrcBulkGenDtos[]`)

Used by