Overview
This node integrates directly with the Bizapp order management system, allowing users to submit e-commerce orders bypassing WordPress or WooCommerce limitations. It is designed for professional order management workflows where direct API submission to Bizapp is preferred over traditional WooCommerce order processing.
Typical use cases include:
- Submitting customer orders from custom frontends or other systems directly into Bizapp.
- Automating order entry workflows without relying on WooCommerce's native order handling.
- Managing orders with enhanced control over product SKUs, pricing, and payment gateways.
For example, an online store can use this node to send order details including customer info, products, prices, and payment method directly to Bizapp for processing and tracking.
Properties
| Name | Meaning |
|---|---|
| Customer Name | Name of the customer placing the order |
| Customer Email | Email address of the customer |
| Customer Phone | Phone number of the customer |
| Customer Address | Shipping or billing address of the customer |
| Selling Price | Total selling price (excluding postage) for the order |
| Postage Price | Shipping or postage cost for the order |
| Products | List of products in the order; each includes SKU and quantity |
| Order Notes | Additional notes or instructions related to the order |
| WooCommerce URL | URL of the WooCommerce store (used for reference in Bizapp) |
| Payment Gateway | Payment method used for the order; options: "Cash On Delivery (COD)" or "Online Banking" |
| WooCommerce Order ID | Optional WooCommerce order ID; if empty, auto-generated |
| Currency | Currency code for the order; options include MYR, BND, USD, SGD, IDR |
Output
The node outputs a JSON object containing the response from the Bizapp API after submitting the order. The output includes:
- Status of the API call (
successorfail) - Any error messages if the submission failed
- Metadata such as submission timestamp, customer name, total order amount, and product count
Example output structure:
{
"status": "success",
"order_id": "123456",
"_metadata": {
"submittedAt": "2024-06-01T12:00:00.000Z",
"customerName": "John Doe",
"orderTotal": 150.00,
"productCount": 3
}
}
No binary data is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the Bizapp API.
- Needs network access to the Bizapp API endpoint specified in the credentials.
- Optionally uses an environment variable
DEBUG_WEBHOOK_URLfor sending debug logs about order submissions.
Troubleshooting
- Missing Credentials: If no API credentials are provided, the node will throw an error. Ensure that a valid API key credential is configured.
- Invalid Input Data:
- Selling price must be greater than zero.
- Postage price cannot be negative.
- Customer email must be in a valid format if provided.
- At least one product with a non-empty SKU and quantity > 0 is required.
- API Errors: If the Bizapp API returns a failure status, the node throws an error with the API's error message.
- Network Issues: Failure to reach the Bizapp API or webhook URL may cause errors or warnings in debug logs.
- Auto-generation of Fields: If customer name, email, or address are missing but phone number is provided, the node auto-generates placeholder values to ensure order submission.
Links and References
- Bizapp Official Website (replace with actual URL if available)
- WooCommerce Documentation
- n8n Documentation on Creating Custom Nodes