Zalo OAInstall

Overview

This node integrates with the Zalo Official Account (OA) API to update the status of an existing order. It allows users to change the order's state, such as marking it as pending, confirmed, shipping, delivered, or canceled, and optionally provide a reason for the status update.

Typical use cases include:

• Automating order management workflows by syncing order statuses from external systems into Zalo OA.
• Notifying customers about changes in their order status via Zalo OA.
• Managing order lifecycle states directly within n8n workflows connected to Zalo OA.

For example, after receiving a shipment confirmation from a logistics provider, this node can update the order status to "Đang Giao Hàng" (shipping) with a note explaining the update.

Properties

Output

The node outputs a JSON object representing the response from the Zalo OA API after attempting to update the order. This typically includes details about the success or failure of the operation, any updated order information, and error messages if applicable.

No binary data output is produced by this operation.

Dependencies

• Requires an API key credential for authenticating with the Zalo Official Account API.
• The node uses the Zalo OA API v3.0 endpoint https://openapi.zalo.me/v3.0/oa/store/order/update to perform the update.
• Proper permissions must be granted to the API token to allow order updates.
• Network access to the Zalo OA API endpoints is necessary.

Troubleshooting

• Common Issues:

  • Invalid or expired API tokens will cause authentication failures.
  • Incorrect order IDs may result in errors indicating the order does not exist.
  • Insufficient permissions on the API token can lead to authorization errors.
  • Providing an invalid status value outside the allowed options will cause request rejection.

• Error Messages and Resolutions:

  • "Please check the order parameters and OA access permissions."
    Ensure that the order ID is correct and that the API token has the required scopes.
  • API response errors with HTTP status codes like 401 or 403
    Verify that the API key credential is valid and has not expired.
  • Network errors or timeouts
    Check network connectivity and firewall settings allowing access to openapi.zalo.me.
  • If the node returns an error with a message about missing or invalid parameters, double-check the input fields for correctness.

Links and References

• Zalo Official Account API Documentation
• Zalo OA Store Order Update API Reference

If you need further assistance configuring or troubleshooting this node, consult the official Zalo OA API documentation or reach out to the Zalo developer support channels.