Bizapp icon

Bizapp

Interact with Bizapp API

Overview

This node integrates with the Bizapp API to submit new orders, specifically designed for WooCommerce stores. It collects customer details, order information including products and pricing, and sends this data to Bizapp for processing and tracking.

Common scenarios where this node is beneficial include:

  • Automating order submission from WooCommerce to Bizapp for inventory or order management.
  • Synchronizing orders between WooCommerce and Bizapp without manual entry.
  • Tracking sales and shipments through Bizapp using detailed order data.

Practical example:
A WooCommerce store owner wants to automatically send every new order to Bizapp for fulfillment and tracking. Using this node, they can configure the order details and customer info, then submit the order seamlessly as part of an automated workflow.

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 address of the customer
Selling Price Total selling price for the order (must be greater than 0)
Postage Price Shipping/postage cost (cannot be negative)
Products List of products in the order; each product includes SKU and quantity (quantity > 0 required)
Order Notes Additional notes or instructions related to the order
WooCommerce URL URL of the WooCommerce store
Payment Gateway Payment method used for the order; options: "Cash On Delivery (COD)", "Online Banking"
WooCommerce Order ID WooCommerce order ID; if left empty, auto-generated
Currency Currency code for the order; options: Malaysian Ringgit (MYR), Brunei Dollar (BND), US Dollar (USD), Singapore Dollar (SGD), Indonesian Rupiah (IDR)

Output

The node outputs a JSON object containing the response from the Bizapp API after submitting the order. The output includes:

  • The full API response fields (e.g., status, any returned data).
  • A _metadata field with:
    • submittedAt: ISO timestamp when the order was submitted.
    • customerName: The name used for the customer in the submission.
    • orderTotal: Sum of selling price and postage price.
    • productCount: Number of products included in the order.

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.
  • The WooCommerce store URL must be provided to link the order correctly.
  • No additional external libraries beyond standard HTTP request helpers are needed.

Troubleshooting

  • Selling price validation: If the selling price is zero or less, the node throws an error. Ensure the selling price is positive.
  • Postage price validation: Negative postage prices cause errors. Use zero or positive values.
  • Email format: Invalid email addresses will trigger an error. Provide a valid email or leave blank.
  • Product list: At least one product with a non-empty SKU and quantity > 0 is required. Missing or invalid product data causes errors.
  • Missing credentials: If no API credentials are provided, the node will fail immediately.
  • API errors: If Bizapp returns a failure status, the error message from the API is propagated. Check the API key and request parameters.
  • Auto-generation of missing customer info: If phone is provided but name/email/address are missing, the node auto-generates placeholder values and adds a note indicating this.

Links and References

Discussion