avanta icon

avanta

Consume avanta API

Actions57

Company → Create or Update

AI-generated

Overview

This node handles the creation or updating of company records via the Avanta API. It supports both single and bulk operations, allowing users to efficiently manage company data such as customer ID, name, status, and various additional fields. It is useful in scenarios where businesses need to automate the management of company information, for example, syncing company data from a CRM system or updating company details in bulk.

Use Case Examples

  1. Creating a new company record with required fields like customer ID, name, and status.
  2. Updating multiple company records in bulk using the bulk API option.
  3. Including additional optional fields such as email, telephone, VAT ID, and extension attributes to enrich company data.

Properties

Name Meaning
Request Options Settings to control API request behavior, including debug mode, SSL certificate validation, and request timeout.
Return to Webhook Whether to return the API response to a webhook, requiring a subsequent 'Respond to Webhook' node.
Use Bulk API Enable bulk processing for multiple company items in one request.
Dataflow ID Optional override for the dataflow ID, automatically read from webhook input if not set.
Customer ID Unique identifier for the customer associated with the company.
Name Name of the company.
Status Active status of the company (true or false).
External Company Customer Group ID Identifier for the external customer group associated with the company.
External SalesOrg ID Identifier for the external sales organization associated with the company.
Additional Fields Optional extra fields to provide more detailed company information, such as alias, DUNS number, email, extension attributes, interim account, internet, logo, store group, telephone, and VAT ID.

Output

JSON

  • id - Unique identifier of the created or updated company.
  • customer_id - Customer ID of the company.
  • name - Name of the company.
  • status - Active status of the company.
  • external_company_customergroup_id - External customer group ID associated with the company.
  • external_sales_org_id - External sales organization ID associated with the company.
  • additionalFields
    • alias - Alias of the company.
    • duns - DUNS number of the company.
    • email - Email address of the company.
    • extension_attributes - Custom extension attributes of the company.
    • interim_account - Interim account number.
    • internet - Internet address or website.
    • logo - Logo URL or identifier.
    • group_id - Store group name or ID.
    • telephone - Telephone number.
    • vat_id - VAT identification number.

Dependencies

  • Avanta API key credential

Troubleshooting

  • Ensure all required fields (customer ID, name, status, external company customer group ID, external sales org ID) are provided to avoid validation errors.
  • If using bulk API, verify that the input data format matches the expected bulk structure to prevent request failures.
  • Enable debug mode to get detailed API request and response information for troubleshooting connectivity or data issues.
  • If SSL certificate validation errors occur, consider enabling the 'Ignore SSL Issues' option, but be aware of security risks.

Links

Discussion