ZRA VSDC icon

ZRA VSDC

Interact with Zambia Revenue Authority VSDC Smart Invoice API

Actions14

Sales → Create Normal Sale

AI-generated

Overview

This node interacts with the Zambia Revenue Authority VSDC Smart Invoice API to create a normal sales transaction. It is useful for businesses needing to register sales with the ZRA system, ensuring compliance and proper tax reporting. For example, a retail store can use this node to record each sale with details like invoice number, payment method, and items sold.

Use Case Examples

  1. Creating a normal sale transaction with invoice number, payment method, and item details to report to ZRA.
  2. Automating sales data submission to the ZRA VSDC system for tax compliance.

Properties

Name Meaning
Invoice Number Unique identifier for the sales invoice, required to track the transaction.
Payment Method Method used to pay for the sale, such as Cash, Credit, Mobile Money, Bank Transfer, or Cheque.
Items Array of items sold in the transaction, provided in JSON format, detailing each item's specifics.

Output

JSON

  • data - Response data from the VSDC API after creating the sale, typically including confirmation and details of the recorded transaction.

Dependencies

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

Troubleshooting

  • Common issues include HTTP request failures due to network problems or incorrect credentials. The node throws errors with messages like 'HTTP request failed' which indicate connectivity or authentication issues.
  • Ensure the API credentials (base URL, TPIN, branch ID, device serial number) are correctly configured and valid.
  • Verify the JSON format of the 'Items' property to avoid malformed data errors.

Discussion