ZRA VSDC icon

ZRA VSDC

Interact with Zambia Revenue Authority VSDC Smart Invoice API

Codes → Get Standard Codes

AI-generated

Overview

This node interacts with the Zambia Revenue Authority VSDC Smart Invoice API to retrieve standard codes related to tax and invoicing. Specifically, the 'Get Standard Codes' operation under the 'Codes' resource fetches standard codes updated since a specified last request date. This is useful for keeping tax code data up to date in financial or invoicing systems, ensuring compliance with the latest regulatory standards. For example, a business can use this node to periodically update its tax code database to reflect changes made by the Zambia Revenue Authority.

Use Case Examples

  1. A business automation workflow that updates tax codes daily by fetching standard codes from the VSDC API using the last request date parameter.
  2. An accounting system integration that retrieves the latest standard codes to validate invoice entries before submission to tax authorities.

Properties

Name Meaning
Last Request Date The date and time of the last request in the format yyyyMMddHH24MISS, used to fetch standard codes updated since this timestamp.

Output

JSON

  • data - Array of standard codes retrieved from the VSDC API.

Dependencies

  • Requires an API key credential for the VSDC API, including base URL, TPIN (taxpayer identification number), branch ID, and device serial number.

Troubleshooting

  • HTTP request failures due to network issues or incorrect API credentials. Ensure the API key and other credentials are correctly configured.
  • Invalid date format for 'Last Request Date' can cause the API to reject the request. Use the format yyyyMMddHH24MISS, e.g., 20251110145557.
  • API timeout errors if the VSDC API is slow to respond. The node has a 30-second timeout for requests.

Links

Discussion