LexwareOffice icon

LexwareOffice

Node to interact with LexwareOffice

Actions29

Contact → Update

AI-generated

Overview

This node updates an existing contact in LexwareOffice by specifying the contact's unique ID and providing updated details such as organization ID, version, roles, company or person information, addresses, email addresses, phone numbers, notes, and archival status. It is useful for maintaining accurate and up-to-date contact information in business workflows, such as updating customer or vendor details after changes in their profile.

Use Case Examples

  1. Updating a customer's contact information with new phone numbers and email addresses.
  2. Modifying a vendor's company details and addresses after a relocation.

Properties

Name Meaning
Contact ID Unique ID of the contact generated on creation by LexwareOffice.
Organization ID Unique ID of the organization the contact belongs to.
Version Version (revision) number which will be increased on each change to handle. Must be 0 for creation.
Roles Defines contact roles and supports further contact information. Each contact must have at least one role.
Company Company details if the contact is of type company. Person details must be absent if company details are provided.
Person Person details if the contact is of type person. Company details must be absent if person details are provided.
Addresses Defines the billing and shipping addresses of the contact.
XRechnung XRechnung related properties of the contact.
Email Addresses Email addresses for the contact, categorized by type (business, office, private, other).
Phone Numbers Phone numbers for the contact, categorized by type (business, office, mobile, private, fax, other).
Note A note to the contact with a maximum length of 1000 characters for additional information.
Archived Whether the contact is archived. This is a read-only property.

Output

JSON

  • id - Unique identifier of the updated contact.
  • organizationId - Identifier of the organization the contact belongs to.
  • version - Current version number of the contact after update.
  • roles - Roles assigned to the contact, such as customer or vendor roles with their numbers.
  • company - Company details if the contact is a company.
  • person - Person details if the contact is a person.
  • addresses
    • billing - List of billing addresses associated with the contact.
    • shipping - List of shipping addresses associated with the contact.
  • xRechnung
    • buyerReference - Customer's Leitweg-ID for XRechnung.
    • vendorNumberAtCustomer - Vendor number as used by the customer for XRechnung.
  • emailAddresses
    • business - List of business email addresses.
    • office - List of office email addresses.
    • private - List of private email addresses.
    • other - List of other email addresses.
  • phoneNumbers
    • business - Business phone number.
    • office - Office phone number.
    • mobile - Mobile phone number.
    • private - Private phone number.
    • fax - Fax number.
    • other - Other phone number.
  • note - Additional note information about the contact.
  • archived - Indicates if the contact is archived.

Dependencies

  • An API key credential for LexwareOffice to authenticate requests.

Troubleshooting

  • Ensure the Contact ID is correctly provided and exists in LexwareOffice to avoid 'contact not found' errors.
  • Verify the version number is accurate to prevent update conflicts due to version mismatches.
  • Check that either company or person details are provided, but not both simultaneously, as this will cause validation errors.
  • Make sure required fields like roles are included to avoid incomplete data errors.

Discussion