Sahabat Xpert icon

Sahabat Xpert

Sahabat Xpert multi-function node for various business operations

Overview

This node integrates with the Bizapp e-commerce API to perform two main operations: retrieving a list of products and submitting orders. It is useful for automating product data retrieval and order processing workflows within n8n, especially for businesses using the Bizapp platform.

  • Get Product List: Fetches product details from Bizapp, optionally filtered by SKU and including stock information.
  • Submit Order: Sends customer order details, including products, shipping, payment, and contact info, to Bizapp for processing.

Practical examples:

  • Automatically syncing product inventory or catalog updates into your system.
  • Automating order submissions from various sales channels into Bizapp for fulfillment.

Properties

Name Meaning
SKU Filter Filter products by specific SKU (optional). Leave empty to get all products.
Include Stock Info Whether to include stock information in the product list response (true/false).
Customer Name Full name of the customer placing the order (required).
Customer Address Complete shipping address (optional). Defaults to "Tiada alamat" if left empty.
Customer Phone Customer phone number (required).
Customer Email Customer email address (required).
Total Price Total order amount (required).
Products Collection of products in the order; each includes SKU (selected from available SKUs) and quantity.
Shipping Cost Shipping cost for the order (optional).
Order Notes Additional notes or special delivery instructions (optional).
Website URL Website URL related to the order (optional).
Payment Gateway Name Name of the payment gateway used (e.g., cod, paypal, stripe). Auto-formatted to remove spaces.
Shipping Method Shipping method for order delivery (optional). Options include Standard, Express, Next Day, etc.
Payment Transaction ID Payment gateway transaction ID (optional).
Payment Type Payment type selection: Cash on Delivery or Online Payment (optional).

Output

The node outputs JSON data structured as follows:

  • For Get Product List:

    • success: Boolean indicating request success.
    • data: The product list object returned by the API, possibly filtered by SKU.
    • timestamp: ISO string timestamp of the response.
    • api_endpoint: String identifier "getproductlist".
    • sku_filter: The SKU filter applied (empty if none).
    • include_stock: Boolean indicating if stock info was included.

  • For Submit Order:

    • success: Boolean indicating request success.
    • data: Response data from the order submission API.
    • timestamp: ISO string timestamp of the response.
    • api_endpoint: String identifier "wooapi.php".
    • order_id: Generated unique order ID.
    • formatted_data: Object containing original and formatted versions of phone, email, address, total price, and shipping cost.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the Bizapp e-commerce API.
  • Uses HTTP requests to endpoints under https://woo.bizapp.my.
  • Timeout for API calls is set to 30 seconds.
  • The node depends on n8n's helper methods for making authenticated requests and loading dynamic options (e.g., product SKUs).

Troubleshooting

  • Common issues:

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

  • Error messages:

    • Errors thrown during API requests are caught and can be output as error JSON if "Continue On Fail" is enabled.
    • Typical error messages include network errors, invalid credentials, or malformed request data.

  • Resolutions:

    • Verify API credentials and ensure they are correctly configured.
    • Check network connectivity to https://woo.bizapp.my.
    • Ensure required input properties are provided and valid.
    • Use the "Continue On Fail" option to handle partial failures gracefully.

Links and References

Discussion