ZRA VSDC icon

ZRA VSDC

Interact with Zambia Revenue Authority VSDC Smart Invoice API

Actions14

Sales → Create Credit Note

AI-generated

Overview

This node interacts with the Zambia Revenue Authority VSDC Smart Invoice API to create a credit note under the Sales resource. It allows users to specify the invoice number, payment method, and items involved in the credit note transaction. This node is useful for businesses needing to issue credit notes for returned goods or adjustments to previous sales invoices, ensuring compliance with tax regulations and proper record-keeping.

Use Case Examples

  1. A retail business issuing a credit note for a returned product to a customer.
  2. An accounting department adjusting a previously invoiced sale by creating a credit note with detailed item information.

Properties

Name Meaning
Invoice Number The unique identifier of the invoice for which the credit note is being created.
Payment Method The method of payment used for the credit note transaction, such as Cash, Credit, Mobile Money, Bank Transfer, or Cheque.
Items A JSON array representing the items included in the credit note, detailing quantities, descriptions, and other relevant item data.

Output

JSON

  • data - The response data from the VSDC API after creating the credit note, typically including confirmation and details of the created credit note.

Dependencies

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

Troubleshooting

  • Common issues include HTTP request failures due to network problems or incorrect API credentials. The node throws errors with messages indicating HTTP request failures, which can be resolved by verifying network connectivity and ensuring correct API credentials are provided.
  • Errors may also occur if required parameters like invoice number or items are missing or malformed. Users should ensure all required fields are correctly filled and JSON items are properly formatted.

Links

  • Zambia Revenue Authority - Official website for Zambia Revenue Authority, providing resources and documentation related to VSDC Smart Invoice API.

Discussion