TRA VFD API

Send X-Api-Key on every request. Create the key under Settings, API. Save the TRA base URL, username, and password before issuing receipts. This API calls TRA for you.

Base URL https://erp-api.strutstechnology.co.ke

Open Swagger

POST

/api/v1/external/tra/invoices

Issue a fiscal receipt. Send the TRA Generate Receipt body: traderInvoiceNo, totalAmount, paymentType, customer fields, currency, exchangeRate, dateTime, and salesItems.

GET

/api/v1/external/tra/invoices

List receipts. Filter with page, per, search, start_date, and end_date.

GET

/api/v1/external/tra/invoices/{id}

Read one receipt, including line items, verification code, and the TRA response.

GET

/api/v1/external/tra/invoices/{id}/pdf

Download the receipt PDF.

GET

/api/v1/external/tra/zreports?date=YYYY-MM-DD

Z-report for one business day.

GET

/api/v1/external/tra/periodic-reports?from=YYYY-MM-DD&to=YYYY-MM-DD

Periodic report for a date range.

POST /generate-invoices from the vendor collection is not part of this API. Use POST /api/v1/external/tra/invoices. API-key calls are logged with IP address, forwarded-for, user agent, and device details.