Zalo OAInstall

Overview

This node interacts with the Zalo Official Account (OA) API to retrieve detailed information about a specific order. It is designed for scenarios where users need to fetch order details from their Zalo OA store, such as verifying order status, checking purchased items, or integrating order data into workflows for further processing.

Practical examples include:

• Automatically fetching order details after receiving an order notification.
• Integrating order information into CRM or inventory systems.
• Triggering follow-up actions based on order contents or status.

Properties

Output

The node outputs a JSON object containing the detailed information of the specified order as returned by the Zalo OA API. The structure typically includes fields such as order ID, user information, list of ordered items, shipping details, payment status, and other metadata related to the order.

No binary data output is involved in this operation.

Dependencies

• Requires a valid API authentication token (access token) for the Zalo Official Account API.
• The node expects proper configuration of credentials that provide access tokens and refresh tokens for the Zalo OA.
• Network connectivity to the Zalo OA API endpoint (https://openapi.zalo.me/v3.0/oa/store/order/getorderinfo or similar) is necessary.

Troubleshooting

• Common issues:

  • Invalid or expired access token leading to authentication errors.
  • Incorrect or non-existent order ID causing the API to return errors or empty results.
  • Insufficient permissions granted to the API token for accessing order information.

• Error messages and resolutions:

  • "Please check the order parameters and OA access permissions."
    Indicates either the order ID is invalid or the access token lacks required permissions. Verify the order ID and ensure the token has the correct scopes.
  • Network or API call failures may result in error objects with messages describing the failure; check network connectivity and API status.
  • If the node throws an error about missing input property "ID Đơn Hàng," ensure that the order ID parameter is provided and correctly mapped.

Links and References

• Zalo Official Account API Documentation
• Zalo OA Store Order API Reference
• n8n documentation on Creating Custom Nodes