avanta icon

avanta

Consume avanta API

Actions57

Servicecenter - Order → Create or Update

AI-generated

Overview

This node interacts with the Avanta API to create or update orders within the Servicecenter resource. It supports detailed order creation including customer and company IDs, customer order ID, and flexible order positions either through mapped fields or raw JSON. It also allows adding document files and various additional fields such as billing, shipping, custom dates, prices, and comments. The node can operate in bulk mode for processing multiple items and supports options like debug mode, SSL certificate validation bypass, and request timeout configuration. This node is useful for automating order management workflows, integrating order data from external systems, and handling complex order details programmatically.

Use Case Examples

  1. Creating a new order with multiple order positions and custom fields for a customer in a specific company.
  2. Updating an existing order with additional document files and custom comments.
  3. Using bulk API to process multiple orders efficiently in a single workflow execution.

Properties

Name Meaning
Request Options Options to configure API request behavior such as debug mode, SSL certificate validation, and timeout.
Return to Webhook Whether to return the response to a webhook (requires a Respond to Webhook node).
Use Bulk API Whether to use the bulk API for processing multiple items.
Dataflow ID Optional override for the dataflow ID, automatically read from webhook input if not set.
Customer ID ID of the customer for the order.
Company ID ID of the company for the order.
Customer Order ID Order ID provided by the customer.
Order Positions Type Method to add order positions, either mapped fields or raw JSON.
Order Positions Collection of order positions with detailed fields such as item position, name, price, quantity, SKU, subtotal, and additional optional fields.
Order Positions JSON Raw JSON input for order positions when using JSON input type.
Document Files Order document files provided either as a UI collection or raw JSON array.
Additional Fields Additional optional fields for the order such as custom dates, prices, texts, extension attributes, billing and shipping details, comments, and status.

Output

JSON

  • order_id - Internal order ID assigned by the system.
  • customer_id - ID of the customer associated with the order.
  • company_id - ID of the company associated with the order.
  • customer_orderid - Order ID provided by the customer.
  • order_positions - Array of order positions with details such as item position, name, price, quantity, SKU, and subtotal.
  • document_files - Array of document files associated with the order.
  • additional_fields - Additional optional fields and metadata related to the order.

Dependencies

  • Avanta API key credential

Troubleshooting

  • Ensure required fields like Customer ID, Company ID, and Customer Order ID are provided to avoid validation errors.
  • If using bulk API, verify that the input data structure matches the expected format for bulk processing.
  • Enable Debug Mode to get detailed API request and response information for troubleshooting.
  • If SSL certificate errors occur, consider enabling 'Ignore SSL Issues' option, but be aware of security risks.
  • Timeout errors may occur if the server is slow to respond; increase the Timeout value if needed.

Discussion