Pharma e-Way Bill APIs — Batch + Expiry-Aware, Distributor-Friendly, NDPS-Compliant
Generate batch-aware EWBs with expiry validation in under 200 ms. Pulls HSN automatically. Compliance-ready audit log.
See a batch+expiry EWB sample payload — Postman collection auto-populated
The problem
For IT Head at a pharma distributor / CMO / hospital chain. Pharma EWBs need batch + expiry + cold-chain compliance fields. NDPS-controlled items have additional documentation. You need this inside your DRP / WMS, not as portal data-entry.
How WhiteBooks solves it
- eway.generate accepts batch number + manufacturing date + expiry date + cold-chain flag as first-class fields — no custom JSON gymnastics.
- HSN auto-fill: send the drug name and we resolve to the correct HSN code (3003 / 3004 / etc.) with GST rate.
- NDPS-controlled items get an additional NDPS-license metadata block accepted on the same call.
- Cold-chain validity-extension rule supported: temperature-breach reason code on eway.extend_validity.
Key APIs
| Tool / Endpoint | What it does | Path |
|---|---|---|
eway.generate | Batch + expiry + cold-chain fields | /api/v1/generate |
eway.extend_validity | Cold-chain delay reason codes | /api/v1/extend |
einvoice.generate_irn | With line-item batch metadata | /api/v1/generate-irn |
gst.search_hsn | Auto-fill pharma HSNs | /api/v1/hsn-sac/search |
Compliance angle
Drugs & Cosmetics Act + e-Way Bill batch tracking, CDSCO trace requirements, cold-chain validity-extension rules, NDPS-controlled-substance audit logs, schedule-H / H1 / X drug routing.
Live numbers
- Throughput: 1,000 invoices / EWBs per single API call (bulk mode).
- Latency: p50 87 ms IRN, p95 312 ms — live at whitebooks.in/status.
- Uptime: 99.994% rolling 30-day; 99.99% SLA with credits on Enterprise.
- Region: Mumbai + Hyderabad active-active; KSA in
me-south-1.
Sample architecture
Sample customer pattern
A pharma distributor with 240 retail stockists routes batch-level EWBs through WhiteBooks. Each consignment carries batch number + manufacturing date + expiry + cold-chain flag. Temperature-breach extensions are logged with a reason code so the regulator audit trail is reconcilable.
Frequently asked questions
Do you support batch and expiry fields on the EWB payload?
Yes. eway.generate accepts batchNumber, mfgDate, expDate, and isColdChain as named fields — they map to the NIC additional-detail block automatically. Your distributor TMS does not need to construct custom JSON.
How do you handle cold-chain temperature breaches that delay the truck?
eway.extend_validity accepts a temperature-breach reason code (NIC reason "trans-shipment" with our cold_chain_breach=true flag). The breach is logged in the audit trail so the CDSCO trace requirement is satisfied without manual record-keeping.
Can you auto-fill HSN for pharma products?
Yes. gst.search_hsn accepts the drug name and returns the canonical HSN with GST rate (3003 for unmixed, 3004 for measured doses, etc.). Our HSN catalogue is updated quarterly with CBIC notifications.
What about NDPS-controlled items?
NDPS-controlled items accept an additional NDPS-license metadata block on eway.generate (license number, issuing authority, expiry). The block is mirrored to the audit log for regulator inspection.
Do you support schedule-H / H1 / X drug routing?
Yes. The schedule classification is part of our HSN catalogue. Schedule-H1 (controlled antibiotics) and schedule-X (psychotropics) carry the additional license metadata automatically when generate_irn / eway.generate is called for those line items.
Get started
Related use cases: Logistics · Retail · Manufacturing · Fintech · Pharma · E-Commerce · SaaS · CA Firms · ERP Providers
Reference: All APIs hub · /docs/gst · /docs/einvoice · /docs/eway · Pricing · Architecture · Status · Changelog