Overview

This node interacts with the KiotViet API to manage invoices. Specifically, the 'Lấy Theo Mã' (Get By Code) operation retrieves an invoice using its unique invoice code. This is useful for scenarios where you need to fetch detailed invoice information based on a known invoice code, such as verifying invoice details or integrating invoice data into other workflows.

Use Case Examples

1. Retrieve an invoice by its code to display detailed billing information in a customer service application.
2. Fetch invoice data by code to automate accounting or reporting processes.

Properties

Output

JSON

• id - The unique identifier of the invoice.
• invoiceCode - The code of the invoice.
• branchId - The branch identifier where the invoice was created.
• totalPayment - The total payment amount of the invoice.
• invoiceDetails - List of products included in the invoice with details such as product ID, code, name, quantity, price, discounts, notes, and serial numbers.
• customerId - Identifier of the customer associated with the invoice.
• purchaseDate - The date when the purchase was made.
• discount - Total discount applied to the invoice.
• method - Payment method used for the invoice.
• accountId - Bank account ID used for payment if applicable.
• usingCod - Indicates if Cash on Delivery (COD) was used.
• soldById - ID of the employee who made the sale.
• orderId - ID of the related order.
• saleChannelId - ID of the sales channel.
• isApplyVoucher - Indicates if a voucher was applied to the invoice.

Dependencies

• KiotViet API with authentication credentials

Troubleshooting

• Ensure the invoice code provided is correct and exists in the KiotViet system to avoid 'not found' errors.
• Check API credentials and permissions if the node fails to authenticate or retrieve data.
• If the API does not support the requested operation, the node will throw an error indicating the operation is unsupported.

Links

• KiotViet API Documentation - Official API documentation for KiotViet, useful for understanding available endpoints and data structures.