25 Jul NIC Introduces Cross-Portal API Features for e-Invoice and e-Way Bill Systems
The National Informatics Centre (NIC) has introduced new API features enhancing interoperability between e-Invoice and e-Way Bill systems. These updates enable seamless cross-portal access and operations, including generating and canceling IRNs and e-Way Bills. Key improvements include unified authentication tokens, expanded cross-portal functionalities, and additional error codes for precise issue tracking. Developers are encouraged to test these APIs in the sandbox environment before production deployment.
Key Updates in E-Invoice API Features
- Unified Authentication Token: Users can now generate a single authentication token from any of the portals—e-Invoice1, e-Invoice2, e-Waybill1, or e-Waybill2. This token grants access to services across all portals, eliminating the need for separate tokens.
- Cross-Portal Access: Services between e-Invoice1 and e-Invoice2 are now interoperable. IRNs generated on one portal can be accessed for cancellation and e-Waybill generation on the other. For cross-portal services, use the header parameter ‘irp’ with values ‘NIC1’ or ‘NIC2’ to specify the originating portal.
- New API Endpoints: The APIs support operations such as:
- Get IRN Details
- Cancel IRN
- Get IRN Details by Document
- Generate e-Waybill by IRN
- Get e-Waybill Details by IRN
- Additional Error Code:
- 3098: Invalid IRP code
- Testing and Documentation: Detailed API specifications and testing URLs are available on the NIC sandbox portal. Developers must test these APIs in the sandbox before deploying them in the production environment. Visit NIC API Sandbox for more information.
Key Updates in E-Way Bill API Features
- Direct E-Waybill Operations: e-Waybill1 and e-Waybill2 systems are now operational in the sandbox environment, offering critical functionalities like:
- Generate E-Way Bill
- Update Vehicle Details
- Update Transporter Details
- Get E-Way Bill
- Cancel E-Way Bill
- Common Authentication Token: A unified authentication token is now available across e-Invoice1, e-Invoice2, e-Waybill1, and e-Waybill2, simplifying access.
- Interoperable Services: e-Waybill1 and e-Waybill2 systems can now perform cross-portal operations, such as retrieving and updating e-Waybills. e-Waybill2 synchronizes with e-Waybill1 within seconds
- New Error Codes:
- 117: Option not enabled in E-Waybill2
- 118: Try after 5 minutes
- 444: E-Waybill cannot be canceled; generated from NIC1
- 445: E-Waybill cannot be canceled; generated from NIC2
- 446: Transport details cannot be updated; generated from NIC1
- 447: Transport details cannot be updated; generated from NIC2
- 448: Part B cannot be updated; E-Waybill Part A generated in NIC1
- 449: Part B cannot be updated; E-Waybill Part A generated in NIC2
- 452: Consolidated E-Waybill cannot be generated; Part A generated in NIC2
- Testing and Documentation: For changes in API specifications and testing URLs, access the NIC API Sandbox. Ensure thorough testing in the sandbox environment before going live.
The full update can be accessed here.
No Comments