avanta icon

avanta

Consume avanta API

Actions57

Sales Organization → Create or Update

AI-generated

Overview

This node handles the creation or updating of a Sales Organization within the Avanta API. It is useful for automating the management of sales organizations, including setting their name, status, external ID, and associating them with store groups. It supports additional detailed fields such as contact information, business hours, and tax IDs, allowing comprehensive configuration of sales organizations.

Use Case Examples

  1. Creating a new sales organization with a specific name, status, and external ID.
  2. Updating an existing sales organization with new contact details and business hours.
  3. Using the bulk API to process multiple sales organizations at once for efficient data management.

Properties

Name Meaning
Request Options Options to control API request behavior such as debug mode, SSL validation, and timeout settings.
Return to Webhook Whether to return the response to a webhook, requiring a 'Respond to Webhook' node after this 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.
Name Name of the sales organization.
Store Group Name or ID Select or specify the store group associated with the sales organization.
External ID External identifier for the sales organization.
Status Indicates whether the sales organization is active.
Additional Fields Additional optional fields to provide more details about the sales organization, such as agreement identifiers, alias, business hours, CEO, contact details, address, tax information, and extension attributes.

Output

JSON

  • id - Unique identifier of the created or updated sales organization.
  • name - Name of the sales organization.
  • status - Active status of the sales organization.
  • external_id - External ID associated with the sales organization.
  • group_id - ID of the associated store group.
  • additionalFields - Additional detailed information about the sales organization, including contact info, business hours, tax IDs, and other metadata.

Dependencies

  • Avanta API with appropriate API key credentials

Troubleshooting

  • Ensure the API credentials are correctly configured and have the necessary permissions to create or update sales organizations.
  • If using the bulk API, verify that the dataflow ID is correctly set or available in the webhook input data when triggered via a dataflow profile.
  • Check network connectivity and SSL settings if encountering connection issues, especially if 'Ignore SSL Issues' is disabled.
  • Timeout errors may occur if the server is slow to respond; adjust the timeout setting accordingly.

Discussion