TravelSuite / Hotel / StayDoc
Module · Sync

Pulled fromthe portal, daily.

StayDoc is the firm's hotel e-invoice sync module. For any hotel under the e-invoice mandate, the invoice lives on the GST network, and only there. StayDoc fetches it daily, by GSTIN, every property, and queues each one for reconciliation.

Daily
Portal sync cadence
Mandated
E-invoice scope
All states
GSTIN coverage
How the sync actually works

A request to the portal. A response we keep.

Hotel e-invoices live on the GST network, not on the hotel's website. StayDoc authenticates as your entity, asks for what's been raised against your GSTIN in the past 24 hours, and queues every IRN it doesn't already have. Below is what one sync looks like on the wire.

StayDoc → portal
06:00 IST · daily
Authenticate
06:00:01POST /auth
06:00:01GSTIN 29AAACT…1Z5
06:00:02token [issued, 6h ttl]
Query delta
06:00:02GET /irn?date=2025-04-14
06:00:02filter recipient = self
06:00:03pagination page=1, size=100
Fetch each IRN
06:00:04GET /irn/{id} · 14 calls
portal → StayDoc
14 invoices · 1 GSTIN
Auth ack
06:00:02200 OK
06:00:02auth_token [bearer]
IRN list
06:00:03200 OK
06:00:03count 14
06:00:03first_irn 68a5f3…
Invoice payloads
06:00:0814 × 200 OK
06:00:08total ₹ 4,82,140
What StayDoc adds on top
per-GSTIN, per-day
Dedupe
IRNs already on file are skipped. Only net-new invoices are queued.
Retry
Portal rate-limit or 5xx is backed-off and retried in the next window.
Cache
Auth tokens cached for the 6h ttl. No re-authentication mid-window.
Hand off
Net-new invoices are pushed to StayLedger with state-code metadata attached.
Why one sync isn't enough

Every GSTIN gets its own sync.

Hotel ITC eligibility depends on having a GSTIN in the state where the hotel is. So the firm syncs once per registered GSTIN, every day. Here is what that looks like for an enterprise with a multi-state footprint.

State
Registered entity
Property scope
Last sync
Today
29
Acme Tech Pvt Ltd · Karnataka29AAACT…1Z5
Bengaluru, Mysuru, Mangaluru
06:00 IST today
14invoices
27
Acme Tech Pvt Ltd · Maharashtra27AAACT…4Z2
Mumbai, Pune, Nashik
06:00 IST today
22invoices
07
Acme Tech Pvt Ltd · Delhi07AAACT…6Z9
New Delhi, NCR
06:00 IST today
18invoices
33
Acme Tech Pvt Ltd · Tamil Nadu33AAACT…8Z3
Chennai, Coimbatore
06:00 IST today
9invoices
36
Acme Tech Pvt Ltd · Telangana36AAACT…0Z1
Hyderabad
06:00 IST today
11invoices
06
Acme Tech Pvt Ltd · Haryana06AAACT…5Z7
Gurugram
06:00 IST today
7invoices
6 GSTINs synced today
81 invoices · daily
₹ 14,29,400
47Registered GSTINs
×
365Days a year
=
17,155Sync runs the firm executes for one client annually
Why airline and hotel are separate modules

Same family. Different problem.

SkyDoc and StayDoc both capture, but the work they do is fundamentally different. One is a heterogeneity problem; the other is a multi-tenant portal problem. Two engines because no single engine handles both well.

 
SkyDocAirline capture
StayDocHotel sync
Source
Carrier portals, TMC exports, finance records
The GST e-invoice network, queried by GSTIN
Format guarantee
None, ~200 carriers, each with their own layout
Mandated, e-invoice schema is uniform
Auth model
Per-carrier credentials, sometimes none (TMC exports)
Per-GSTIN auth against einvoice1.gst.gov.in
Cadence
Daily ingest of new tickets
Daily sync, once per registered GSTIN
Hard part
Absorbing format variance and normalising it
Authenticating, rate-limit handling, dedupe at scale
Failure mode
Mis-parsed invoice → tax desk reviews manually
Portal rate-limit → backed off, retried next window
Hands to
SkyLedger · reconciliation vs filings
StayLedger · multi-state place-of-supply work
The engine comes with the engagement

See what's been sitting on the portal, unclaimed.

The diagnostic includes a one-time portal sync across your registered GSTINs, returning the full hotel ITC picture for the past twelve months.

Read about the diagnostic Back to TravelSuite