ZRA VSDC icon

ZRA VSDC

Interact with Zambia Revenue Authority VSDC Smart Invoice API

Actions14

Device → Initialize

AI-generated

Overview

This node interacts with the Zambia Revenue Authority VSDC Smart Invoice API to perform various operations related to devices, codes, items, sales, and stock. Specifically, the 'Device - Initialize' operation initializes a device and retrieves security keys, which is essential for setting up the device to communicate securely with the VSDC system. This node is beneficial for businesses in Zambia that need to integrate their sales and inventory systems with the VSDC for compliance and reporting purposes.

Use Case Examples

  1. Initialize a device to obtain security keys before processing sales transactions.
  2. Check the status of a device to ensure it is active and properly configured.

Properties

Name Meaning
Resource The category of operations to perform, e.g., Device, Codes, Item, Sales, or Stock.
Operation The specific action to perform within the selected resource. For the Device resource, options include Initialize and Check Status.

Output

JSON

  • data - The response data from the VSDC API, which varies depending on the operation performed. For 'Initialize' operation, it includes security keys and device initialization details.

Dependencies

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

Troubleshooting

  • HTTP request failures due to network issues or incorrect API credentials. Ensure the API credentials (base URL, TPIN, branch ID, device serial number) are correctly configured.
  • Errors from the VSDC API indicating invalid parameters or device not registered. Verify the device details and parameters sent in the request.
  • Timeout errors if the VSDC API does not respond within 30 seconds. Check network connectivity and API service status.

Links

Discussion