> **Legal basis:** GSTN Advisory dated 17 June 2026 on e-Invoice API and e-Way Bill by IRN API structural changes — Effective: 1 August 2026. Source: https://tutorial.gst.gov.in/downloads/news/advisory_einvoice_api_ewb_by_irn_approved.pdf. Last updated: January 2026.

On 17 June 2026, GSTN issued an advisory introducing two structural changes to the e-Invoice API and the e-Way Bill by IRN API. These changes went live in production on 1 August 2026. If your ERP, GSP, or accounting software generates e-invoices with split Bill-to and Ship-to addresses, and your integration has not been updated, your goods movement may already be blocked.

## What Changed: Two New Structural Requirements

### Mandatory Ship-to GSTIN in e-Invoice and e-Way Bill APIs

Previously, the Ship-to GSTIN field was optional. From 1 August 2026, it is **conditionally mandatory**:

- If the Ship-to address differs from Bill-to AND an e-Way Bill is required AND the consignee is GST-registered → `ShipDtls.Gstin` must be populated with the consignee's GSTIN.
- If the consignee is unregistered → enter `"URP"` (Unregistered Person).
- In the e-Way Bill by IRN API, `ExpShipDtls.Gstin` is now mandatory when generating e-Way Bills from existing IRNs.

### Voluntary e-Way Bill Closure Facility

A new optional feature allows suppliers, recipients, transporters, or drivers to formally close an e-Way Bill post-delivery via the GSTN portal or API, creating a clean delivery audit trail.

## Who Is Affected

Any business that:
- Has aggregate turnover exceeding ₹5 crore in any preceding financial year from 2017–18 onwards (mandatorily generates e-invoices under Rule 48(4) CGST Rules, 2017)
- Uses ERP or accounting software integrated via API, GSP/ASP, or third-party IRP
- Has **Bill-to and Ship-to addresses that differ** — supplies to warehouses, job work premises, branch offices, or dealer godowns

Exempt categories — SEZ units (outward supplies), insurance companies, banks, NBFCs, GTAs, and passenger transport operators — are unaffected.

| Scenario | Mandatory Ship-to GSTIN | Action Required |
| --- | --- | --- |
| Bill-to and Ship-to addresses are identical | No | No change; existing e-invoice flow applies |
| Ship-to differs; consignee is GST-registered | Yes | Populate `ShipDtls.Gstin` with consignee GSTIN |
| Ship-to differs; consignee is unregistered | Yes | Enter `"URP"` in Ship-to GSTIN field |
| Export invoice with foreign consignee | Conditional | Use `"URP"`; verify treatment with IRP/GSP vendor |

## Practical Impact for Your Business

A Mumbai-based MSME manufacturer (aggregate turnover ₹8 crore) supplies goods to a Pune distributor's Chennai warehouse. Bill-to: distributor's Karnataka GSTIN. Ship-to: distributor's Tamil Nadu warehouse. Before 1 August 2026, the Ship-to GSTIN field was optional. After 1 August 2026, the API expects the Tamil Nadu GSTIN — a blank or incorrect value triggers error 2325 and the **e-invoice is rejected**. Rejected e-invoice means no valid IRN → goods cannot move legally → Section 129 CGST Act detention and penalty risk.

> **Key point:** From 1 August 2026, unpopulated or incorrect Ship-to GSTIN in split-address e-invoices causes API rejection and blocks legitimate goods movement.

## Steps to Take Immediately

- **Verify ERP readiness**: Ask your ERP vendor for the patch release note explicitly referencing the GSTN advisory dated 17 June 2026. Request written confirmation that the update is deployed in production.
- **Audit master data**: Identify all Bill-to and Ship-to split configurations in your customer and vendor records. Ensure the consignee's GSTIN for each Ship-to state is captured and current.
- **Configure unregistered party handling**: If the Ship-to party is unregistered (e.g., job worker's unregistered premises), configure your system to pass `"URP"` in the Ship-to GSTIN field.
- **Test in GSTN Sandbox**: If your integration is API-based, generate test e-invoices with split addresses and validate the updated payload. Monitor for error codes 2323, 2325, 3039, 2324, and 4074.
- **Establish closure workflow**: The voluntary e-Way Bill closure facility is optional but recommended for maintaining a clean delivery audit trail.

## Risk of Non-Compliance

API rejection halts e-invoice generation. Without a valid IRN, goods cannot be moved under Section 129 CGST Act. Detention and late fee penalties apply. Recovery of consignments in transit becomes an administrative and legal burden.

I'm CA Harun Raaj, Visakhapatnam. If your business generates e-invoices with split delivery addresses and you need an integration audit or clarification on the GSTN advisory, reach out — I help businesses avoid these compliance traps.

<!-- ORIGINAL_GRAPHIC
url: /graphics/einvoice-shipto-gstin-mandatory-flow.png
alt: A process flow diagram showing an e-invoice with split Bill-to and Ship-to addresses, indicating the mandatory GSTIN field validation gate at the GSTN API, with a red block for empty or mismatched GSTIN and green flow for correct GSTIN entry.
caption: From 1 August 2026, the e-Invoice API rejects invoices with missing or incorrect Ship-to GSTIN when addresses differ.
brief: Create a decision-tree diagram titled 'e-Invoice Ship-to GSTIN Validation Flow (1 August 2026+)'. Start with a decision diamond: 'Do Bill-to and Ship-to addresses differ?' Branch left for 'No' → straight pass to IRN issuance. Branch right for 'Yes' → next diamond: 'Is consignee GST-registered?' If yes, show box: 'Populate ShipDtls.Gstin with consignee GSTIN'. If no, show box: 'Enter URP'. Both paths converge at a validation gate labeled 'GSTN API Validation'. Show a green checkmark path to 'Valid IRN Issued' and a red X path to 'Error 2325 – Rejection'. Use HRA brand blue/grey, clear sans-serif labels, and avoid showing sample PAN numbers or individual names. Include footer: 'Source: GSTN Advisory, 17 June 2026'.">
-->

---

## See Also

- ["Exports are zero-rated, so the refund is automatic": what Rule 89 actually requires](https://www.harunraaj.com/blog/gst-refund-on-exports-rule-89-documents-time-limit)
- ["GSTR-9 is optional if my turnover is small": what Section 44 actually says](https://www.harunraaj.com/blog/gstr-9-annual-return-who-must-file-late-fee)
- ["E-invoicing only applies to big companies": what the 2026 GST rules actually say](https://www.harunraaj.com/blog/gst-e-invoicing-threshold-2026-irn-applicability)

Canonical: https://www.harunraaj.com/blog/einvoice-shipto-gstin-mandatory-august-2026