Sahabat Xpert icon

Sahabat Xpert

Sahabat Xpert multi-function node for various business operations
Join our community

Overview

This node integrates with the Bizapp e-commerce API to perform two main operations:

  • Get Product List: Retrieve a list of products from the Bizapp platform, optionally filtered by SKU and including stock information.
  • Submit Order: Submit a new customer order to the Bizapp system with detailed customer and order information.

This node is useful for automating product data retrieval and order submission workflows in e-commerce scenarios. For example, you can use it to sync product catalogs or automate order processing from external systems into Bizapp.

Properties

Name Meaning
Bizapp Operation Choose between "Get Product List" (retrieve products) or "Submit Order" (send a new order).

When "Get Product List" is selected:

Name Meaning
SKU Filter Optional string to filter products by SKU; leave empty to get all products.
Include Stock Info Boolean to include stock availability details in the response.

When "Submit Order" is selected:

Name Meaning
Customer Name Full name of the customer (required).
Customer Address Shipping address (optional). If empty, defaults to "Tiada alamat".
Customer Phone Customer phone number (required). The node formats this to international format automatically.
Customer Email Customer email address (required). The node normalizes and validates the email format.
Total Price Total amount of the order (required).
Products Collection of products to order, each with SKU (selected from available SKUs) and quantity (required).
Shipping Cost Optional shipping cost amount.
Order Notes Additional notes or instructions for the order (optional).
Website URL Optional website URL related to the order.
Payment Gateway Name Name of the payment gateway used (e.g., cod, paypal, stripe). Spaces are removed automatically.
Shipping Method Shipping method chosen for delivery (e.g., standard, express, pickup, courier, etc.). Optional.
Payment Transaction ID Optional transaction ID from the payment gateway.
Payment Type Payment type selection: "Cash on Delivery" or "Online Payment" (optional).

Output

The node outputs JSON data structured as follows depending on the operation:

  • Get Product List:

    • success: boolean indicating if the request succeeded.
    • data: object containing product information returned by the API, possibly filtered by SKU.
    • timestamp: ISO timestamp of the response.
    • api_endpoint: string identifying the API endpoint called ("getproductlist").
    • sku_filter: the SKU filter applied (empty if none).
    • include_stock: boolean indicating if stock info was included.

  • Submit Order:

    • success: boolean indicating if the order submission succeeded.
    • data: response data from the Bizapp API after submitting the order.
    • timestamp: ISO timestamp of the response.
    • api_endpoint: string identifying the API endpoint called ("wooapi.php").
    • order_id: generated unique order ID.
    • formatted_data: object showing normalized inputs such as formatted phone, email, address, total price, and shipping cost.

The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the Bizapp API.
  • Calls Bizapp endpoints hosted at https://woo.bizapp.my.
  • Uses HTTP GET for product listing and HTTP POST with form data for order submission.
  • Timeout for API requests is set to 30 seconds.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Network timeouts or connectivity issues may result in request failures.
    • Improperly formatted phone numbers or emails might be auto-corrected but could still cause errors downstream.
    • Submitting orders without required fields (customer name, phone, email, total price, products) will fail.

  • Error messages:

    • Errors thrown by the underlying HTTP request helper will propagate unless "Continue On Fail" is enabled.
    • Error messages typically contain the API error or network failure reason.

  • Resolutions:

    • Ensure valid API credentials are configured.
    • Verify required input properties are correctly filled.
    • Check network connectivity to Bizapp API endpoints.
    • Use "Continue On Fail" option to handle partial failures gracefully.

Links and References

Discussion