iotoms Docs

Export an invoice to Tally XML

POST
/api/v1/integrations/tally/invoices/{invoiceId}/export

Returns the Tally import XML for one sales invoice as a file download and records the attempt as EXPORTED. Fails if Tally settings are missing or any master (customer, item, unit, tax ledger) is not mapped. Exporting does not mark the invoice as imported into Tally.

How to use it

  1. Save Tally settings, then run Check an invoice's Tally export readiness and map every missing master.
  2. Send the request; the response is the Tally import XML file (tally-invoice-.xml). It fails if any mapping is missing.
  3. The attempt is recorded as EXPORTED. Import the file into Tally, then call Mark an invoice as imported into Tally.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

invoiceId*string

ID of the sales invoice, from List sales invoices.

Formatuuid

Header Parameters

X-TenantID*string

Your merchant's tenant code — the value typed in the Domain field on the iotoms login screen. See Concepts.

Response Body

OK

response?stringapplication/xml
Example Request
curl -X POST 'https://beta.iotoms.com/api/v1/integrations/tally/invoices/497f6eca-6276-4993-bfeb-53cbbbba6f08/export' \  -H 'X-TenantID: your-tenant-code'
Example Response
"string"