Overview

This node interacts with the KiotViet API to manage invoices. Specifically, for the 'Lấy Theo ID' (Get by ID) operation, it retrieves an invoice from KiotViet using the provided invoice ID. This is useful for scenarios where you need to fetch detailed information about a specific invoice, such as for review, processing, or integration with other systems.

Use Case Examples

1. Retrieve an invoice by its unique ID to display its details in a dashboard.
2. Fetch invoice data to synchronize with an external accounting system.

Properties

Output

JSON

• id - The unique identifier of the invoice.
• branchId - The branch ID where the invoice was created.
• totalPayment - 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 - 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 sold the products.
• orderId - ID of the related order.
• saleChannelId - ID of the sales channel.
• isApplyVoucher - Indicates if a voucher was applied to the invoice.

Dependencies

• Requires KiotViet API credentials for authentication.

Troubleshooting

• Common issues include invalid or missing invoice ID, resulting in errors when fetching the invoice.
• API errors due to incorrect or expired credentials can prevent successful retrieval.
• The node throws errors if the KiotViet API does not support the requested operation or if network issues occur.

Links

• KiotViet Official Website - Official site for KiotViet, providing API documentation and support.