improved

Introducing Criss-Cross Operations for Reliable e-Invoicing

We’re excited to introduce criss-cross operations, enabling seamless failover management between the two NIC portals: e-Invoice 1 (primary) and e-Invoice 2 (secondary).

This feature is available for below APIs:

  • Cancel e-Invoice
  • Get e-Invoice by IRN
  • Get e-Invoice by Document Data
  • Generate E-Way Bill by IRN
  • Get E-Way Bill by IRN

New Headers: x-source and x-proxy

  • x-source: Specifies the source to access, either primary (e-Invoice 1 portal) or secondary (e-Invoice 2 portal).
  • x-proxy: Enables criss-cross operations by routing requests through the specified source (e.g., access primary via secondary if primary is unavailable).

How These Work Together:

Normal Flow: The client sets x-source to primary, and the system retrieves data directly from the primary source (e-Invoice 1 portal).

Failover or Criss-cross Access: If the primary portal is inaccessible, the client can use x-proxy to specify an alternate route. For example:

  • x-source: primary (Target is e-Invoice 1 portal)
  • x-proxy: secondary (Route through e-Invoice 2 portal to access data of e-Invoice 1 portal)

This feature enhances reliability, minimizes disruptions, and provides businesses with robust failover management for critical e-Invoice operations.