GoSell icon

GoSell

Interact with GoSell API

Draft Order → Create Draft Order

AI-generated

Overview

This node creates a new draft order in the GoSell system. It is useful for scenarios where you want to prepare an order with customer details, items, and other order-related information before finalizing or processing it. For example, you can use this node to create a draft order with customer information, sales channel, payment method, and a list of items either through form inputs or JSON input.

Use Case Examples

  1. Creating a draft order with customer details and multiple items from form inputs.
  2. Creating a draft order by pasting a JSON array of items for bulk order creation.

Properties

Name Meaning
Order Details Collection of details about the draft order including customer information, sales channel, carrier, payment method, sale staff, note, and order date.
Items Input Type Specifies whether the items are provided via form input or JSON input.
Items List List of items to include in the draft order when using form input. Each item includes product SKU, price, and quantity.
Items JSON A JSON array of items to include in the draft order when using JSON input. Each item should have product SKU, price, and quantity.

Output

JSON

  • json - The response from the GoSell API representing the created draft order details.

Dependencies

  • Requires GoSell API credentials with an API key and environment setting (live or test).
  • Uses GoSell API endpoints to create the draft order.

Troubleshooting

  • Error 'Please add at least one item' occurs if no items are provided in the draft order. Ensure at least one item is added either via form or JSON input.
  • Invalid JSON format error occurs if the JSON input for items is malformed. Validate the JSON before submitting.
  • API errors from GoSell are propagated with messages extracted from the response. Check API key validity and network connectivity if errors occur.
  • Ensure that required fields in the order details such as customer name and payment method are correctly filled to avoid validation errors.

Discussion