FounderHQ icon

FounderHQ

⚠️ UNOFFICIAL NODE - NOT AFFILIATED WITH FOUNDERHQ ⚠️ This is an unofficial integration that may not function properly. Use at your own risk. LEGAL DISCLAIMER: This software is provided "AS IS" without warranty. Users are solely responsible for legal compliance and data usage.
Join our community

Overview

This node allows users to submit new orders to the FounderHQ system via an unofficial integration. It is designed for e-commerce workflows where order data from an external system needs to be sent to FounderHQ for processing or record-keeping.

Typical use cases include:

  • Automating order submission from an online store to FounderHQ.
  • Synchronizing order details such as customer info, items, payment, and shipping data.
  • Tracking order status updates within a workflow automation.

For example, after a customer places an order on your e-commerce platform, this node can be used to send that order's details automatically to FounderHQ, ensuring centralized order management.

Properties

Name Meaning
Order ID The unique identifier of the order in your e-commerce system.
Customer Email Email address of the customer placing the order.
Customer Name Full name of the customer.
Customer Phone Phone number of the customer (optional).
Order Status Current status of the order. Options: Pending, Processing, Completed, Cancelled.
Order Total Total monetary amount of the order.
Currency Currency code for the order amount (e.g., MYR, USD).
Payment Method Method used for payment. Options: Bank Transfer, Cash on Delivery (COD), Credit Card, E-Wallet, Other.
Shipping Address Customer's shipping address including line 1, line 2, city, state, postcode, and country code.
Order Items List of items in the order. Each item includes price, product ID, product name, quantity, SKU, and variation ID.
Additional Options Collection of optional fields such as discount total, order date, order notes, order number, payment method title, shipping cost, shipping method, site URL, store name, subtotal, tax total, and transaction ID.

Output

The node outputs a JSON object with the following structure:

  • success: Boolean indicating if the order submission was successful.
  • order_id: The original order ID provided.
  • hq_order_id: The order ID assigned by FounderHQ (if available).
  • status: Status string, typically "submitted".
  • message: A success message confirming submission.
  • response: Raw response data returned from the FounderHQ API.
  • timestamp: ISO timestamp of when the submission occurred.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the FounderHQ service.
  • Uses HTTP requests to communicate with the FounderHQ API endpoint /ecwc/submit-order.
  • Sends additional telemetry and analytics data to various external URLs for tracking purposes.
  • Requires network access to FounderHQ endpoints and telemetry servers.

Troubleshooting

  • Common issues:

    • Missing required fields such as Order ID, Customer Email, or Order Total will cause errors.
    • Network connectivity problems may prevent successful API calls.
    • Invalid API credentials will result in authentication failures.

  • Error messages:

    • Errors thrown during execution include detailed messages from the API or internal exceptions.
    • If the node fails but is set to continue on fail, it returns an error object with success: false and the error message.

  • Resolution tips:

    • Ensure all required input properties are correctly filled.
    • Verify API credentials and network connectivity.
    • Check the FounderHQ API documentation for valid field formats and constraints.
    • Enable "Continue On Fail" in the node settings to handle errors gracefully in workflows.

Links and References

Discussion