chandraxdev/whitebooks-developer
Answer questions about, and build, GST, e-Invoice and e-Way Bill integrations on the WhiteBooks APIs: endpoints, payloads and errors explained, sample requests in any language, and ready-made client code in Java, TypeScript and Python to add to an existing app.
Use when a developer is adding e-Invoice (IRN) generation, cancellation, lookup or QR code to their code through WhiteBooks, or asks to generate or cancel an IRN directly. Covers the NIC sign-in, duplicate IRN handling (error 2150), the not-found read-back (2154), and what to do when a generate call times out. Also use for any e-Invoice question, with or without a project, such as what a field or error code means, which endpoint to call, the JSON body for an invoice, or a sample request in curl or any language.
Use when a developer is adding e-Way Bill generation, Part-B vehicle updates, consolidation, validity extension, cancellation or rejection, multi-vehicle movement, or lookups to their code through WhiteBooks, or asks to generate or cancel an e-Way Bill directly. Covers the NIC sign-in and what to do when a generate call times out. Also use for any e-Way Bill question, with or without a project, such as when one is needed, what a field or error code means, which endpoint to call, the JSON body for a consignment, or a sample request in curl or any language.
Use when a developer is adding GST returns to their code through WhiteBooks, or asks to file, submit, save, amend, reset or check any GST return, or to supply an EVC or DSC OTP. Covers GSTR-1, GSTR-1A (amending or adding records of the same period), GSTR-2A, GSTR-2B, GSTR-2X, GSTR-3B, GSTR-4, GSTR-4A, GSTR-4 annual, GSTR-5, GSTR-6, GSTR-6A, GSTR-7, GSTR-8, GSTR-9, GSTR-9A, GSTR-9C, CMP composition returns, ITC-03, ITC-04, IMS, ledgers, challans and payments, late fees, notices, e-Invoice data on the GST portal, the DRC-01B and DRC-01C mismatch data, return tracking and GSTIN search, status polling, filing with EVC or DSC, and what to do when a save times out. Also use for any GST returns question, with or without a project, such as which return or amendment to use, what a return section, status or error code means, which endpoint to call, the JSON for a save, or a sample request in curl or any language.
Use when a developer wants a WhiteBooks GST integration (GST returns, e-Invoice or e-Way Bill) reviewed, debugged or made production-safe, whether it uses the ready-made client, hand-written code or another provider's API, or pastes code, a log or an error to explain. Covers sessions and token refresh, the registered IP address, polling, retries, unknown outcomes after timeouts, irreversible calls, logging and expired taxpayer consent. Also use for questions on these topics with or without a project, and for a corrected sample request in curl or any language.
Use when a repository has a whitebooks/ client folder, or a developer mentions WhiteBooks, GST, GSTIN, e-Invoice or e-Way Bill credentials, a client id or client secret, a NIC username or password, an OTP, WB_* environment variables or a .env file (which this skill never opens), including pasting a secret or asking to put values into config. Also use when starting a WhiteBooks GST integration (GST returns, e-Invoice or e-Way Bill), asking how sessions, sandbox and production, credentials or taxpayer consent work, scaffolding the client in TypeScript, Python or Java, upgrading an installed client, or needing a client in another language. Also use for plain questions with or without a project open, such as what something is, how sign-in or sessions work, which endpoint to call, what an error means, or a sample request in curl or any language.