Overview
This node integrates multiple business services under the "Sahabat Xpert" brand, providing a unified interface for e-commerce, payment processing, shipping management, and CRM operations. It connects to various APIs (Bizapp e-commerce, payment gateway, shipping provider, CRM system) to perform tasks such as retrieving product lists, submitting orders, processing payments, managing shipments, and handling CRM contacts.
Common scenarios where this node is beneficial include:
- Automating order submission from an online store to Bizapp's e-commerce backend.
- Processing or refunding payments via a payment gateway.
- Creating and tracking shipments with a logistics provider.
- Managing customer contact data in a CRM system.
Practical examples:
- Fetching a filtered list of products by SKU from Bizapp e-commerce.
- Submitting a new customer order including products, payment details, and shipping info.
- Processing a payment transaction and obtaining its status.
- Creating a shipment and retrieving estimated delivery dates.
- Adding or updating a contact record in a CRM database.
Properties
| Name | Meaning |
|---|---|
| Service | Select the service category: E-commerce (Bizapp), Payment Processing, Shipping Management, or CRM Integration. |
| E-commerce Operation | Operations available under E-commerce service: Get Product List, Submit Order. |
| Payment Operation | Operations under Payment Processing: Process Payment, Refund Payment, Check Payment Status. |
| Shipping Operation | Operations under Shipping Management: Create Shipment, Track Shipment, Get Shipping Rates. |
| CRM Operation | Operations under CRM Integration: Create Contact, Update Contact, Get Contact. |
| SKU Filter | (E-commerce > Get Product List) Optional filter to retrieve products matching a specific SKU substring. |
| Include Stock Info | (E-commerce > Get Product List) Whether to include stock availability information in the product list response. |
| Customer Name | (E-commerce > Submit Order) Full name of the customer placing the order. |
| Customer Address | (E-commerce > Submit Order) Shipping address; optional, defaults to "Tiada alamat" if empty. |
| Customer Phone | (E-commerce > Submit Order) Customer phone number; formatted automatically. |
| Customer Email | (E-commerce > Submit Order) Customer email address; validated and normalized. |
| Total Price | (E-commerce > Submit Order) Total amount for the order. |
| Products | (E-commerce > Submit Order) Collection of products with SKU and quantity included in the order. |
| Shipping Cost | (E-commerce > Submit Order) Optional shipping cost for the order. |
| Order Notes | (E-commerce > Submit Order) Additional notes or instructions for the order. |
| Order ID | (E-commerce > Submit Order) Optional WooCommerce order ID (max 7 digits); auto-generated if empty. |
| Website URL | (E-commerce > Submit Order) Optional website URL related to the order. |
| Payment Gateway Name | (E-commerce > Submit Order) Text input for payment gateway used (e.g., cod, paypal, stripe). |
| Payment Transaction ID | (E-commerce > Submit Order) Optional payment gateway transaction ID. |
| Payment Type | (E-commerce > Submit Order) Payment type selection: Cash on Delivery or Online Payment. |
| Amount | (Payment > Process/Refund Payment) Amount involved in the payment or refund transaction. |
| Transaction ID | (Payment > Refund Payment / Check Payment Status) Transaction identifier for refund or status query. |
| Customer Email | (Payment > Process Payment) Customer email associated with the payment. |
| Sender Address | (Shipping > Create Shipment / Get Shipping Rates) Full sender address. |
| Recipient Address | (Shipping > Create Shipment / Get Shipping Rates) Full recipient address. |
| Package Weight (kg) | (Shipping > Create Shipment / Get Shipping Rates) Weight of the package in kilograms. |
| Tracking Number | (Shipping > Track Shipment) Tracking number for the shipment to be tracked. |
| Contact Name | (CRM > Create/Update Contact) Full name of the contact person. |
| Contact Email | (CRM > Create/Update Contact) Email address of the contact. |
| Contact Phone | (CRM > Create/Update Contact) Phone number of the contact. |
| Contact ID | (CRM > Update/Get Contact) Identifier of the contact to update or retrieve. |
Output
The node outputs JSON objects containing the results of the selected operation. The structure varies by service and operation but generally includes:
success: Boolean indicating if the operation succeeded.service: The service category (ecommerce, payment, shipping, crm).operation: The specific operation performed.data: The raw or processed data returned from the API or generated internally.- Additional metadata fields such as timestamps, IDs, statuses, and formatted inputs.
Examples of output content per service:
E-commerce:
- For product list retrieval: array of product info, optionally filtered by SKU, with stock info if requested.
- For order submission: confirmation status, Bizapp order ID, formatted customer and payment details.
Payment:
- For payment processing/refund/status check: transaction IDs, amounts, statuses, timestamps.
Shipping:
- For shipment creation/tracking/rates: tracking numbers, addresses, package weights, estimated delivery dates, shipping rates.
CRM:
- For contact create/update/get: contact IDs, names, emails, phones, statuses, timestamps.
The node does not output binary data.
Dependencies
- Requires credentials configured with appropriate API keys or tokens for each service:
- Bizapp e-commerce secret key
- Payment gateway API key
- Shipping provider token
- CRM system token and base URL (optional override)
- Network access to the respective API endpoints:
- Bizapp e-commerce API at
https://woo.bizapp.my - Payment gateway API at
https://api.payment-gateway.com - Shipping provider API at
https://api.shipping-provider.com - CRM system API at configurable base URL or default
https://api.crm-system.com
- Bizapp e-commerce API at
- The node uses HTTP requests with JSON or form-urlencoded payloads.
- Timeout for API calls is set to 30 seconds.
Troubleshooting
Service mismatch error: If the selected service in the node does not match the service type configured in credentials, the node throws an error. Ensure credentials are correctly set for the chosen service.
Order ID length error: When submitting an order, if the provided Order ID exceeds 7 numeric digits, an error is thrown. Provide a valid Order ID or leave empty to auto-generate.
API request failures: Network issues or invalid credentials can cause request errors. Verify API keys/tokens and network connectivity.
Invalid input formatting: Customer phone and email are normalized internally, but malformed inputs may cause unexpected results. Use proper formats.
Empty required fields: Required parameters like customer name, phone, email, total price, and product SKUs must be provided for successful execution.
Timeouts: API calls have a 30-second timeout; slow responses may cause failures.
To resolve errors, review the error messages returned by the node, verify input parameters, and confirm credential configurations.
Links and References
- Bizapp E-commerce API Documentation (hypothetical link)
- Payment Gateway API Documentation (hypothetical link)
- Shipping Provider API Documentation (hypothetical link)
- CRM System API Documentation (hypothetical link)