Accounts

Update accounts

Updates one or more existing accounts in the system. Note this operation supports Portfolio Access Tokens.

Request

[PlatformAddress]/api/connector/v1/accounts/update

{
  "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
  "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D",
  "Client": "Sample Client 1.0.0",
  "AccountUpdates": [
    {
      "Id": "3ff104e6-3ba8-4dfc-8d35-b0ec00c5fd4c",
      "Discriminator": "Company",
      "Customer": null,
      "Company": {
        "Email": {
          "Value": "[e-mail]"
        },
        "TaxIdentifier": {
          "Value": "CZ8810310963"
        },
        "BillingCode": {
          "Value": null
        },
        "AccountingCode": {
          "Value": null
        },
        "Notes": {
          "Value": "Example notes"
        },
        "Name": {
          "Value": "Example company"
        },
        "MotherCompanyId": {
          "Value": "839e9d92-aa8b-48bf-8384-b0ec0081bb34"
        },
        "WebsiteUrl": {
          "Value": "https://www.example.com"
        },
        "InvoiceDueInterval": {
          "Value": null
        },
        "CreditRatingBasic": {
          "Value": "CreditOk"
        },
        "Department": {
          "Value": "Accounting"
        },
        "DunsNumber": {
          "Value": "987654321"
        },
        "ReferenceId": {
          "Value": null
        },
        "ExternalIdentifier": {
          "Value": "COM-123"
        },
        "AdditionalTaxIdentifier": {
          "Value": "XY00112233445"
        },
        "Contact": {
          "Value": "Sample contact"
        },
        "ContactPerson": {
          "Value": "Sample person"
        },
        "FiscalIdentifier": {
          "Value": "FiscalIdentifier"
        },
        "Iata": {
          "Value": "PAO"
        },
        "Telephone": {
          "Value": "111-222-333"
        },
        "SourceId": {
          "Value": "F42098A0-8507-4963-ACC9-B0EC00821949"
        },
        "Classifications": {
          "Corporate": {
            "Value": true
          },
          "Internal": {
            "Value": true
          },
          "Private": {
            "Value": true
          },
          "OnlineTravelAgency": {
            "Value": true
          },
          "GlobalDistributionSystem": {
            "Value": true
          },
          "Marketing": {
            "Value": true
          },
          "Inactive": {
            "Value": true
          }
        },
        "Options": {
          "Invoiceable": {
            "Value": "true"
          },
          "AddFeesToInvoices": {
            "Value": "true"
          }
        }
      }
    },
    {
      "Id": "71db411f-c1d6-4e1c-9cd7-44e8bf45f936",
      "Discriminator": "Customer",
      "Company": null,
      "Customer": {
        "Email": {
          "Value": "[e-mail]"
        },
        "TaxIdentifier": {
          "Value": "CZ8810310963"
        },
        "BillingCode": {
          "Value": null
        },
        "AccountingCode": {
          "Value": null
        },
        "Notes": {
          "Value": "Example notes"
        },
        "LastName": {
          "Value": "Sample"
        },
        "FirstName": {
          "Value": "Sample"
        },
        "SecondLastName": {
          "Value": null
        },
        "BirthPlace": {
          "Value": "Sample place"
        },
        "Telephone": {
          "Value": "111-222-333"
        },
        "Occupation": {
          "Value": null
        },
        "CarRegistrationNumber": {
          "Value": null
        },
        "LoyaltyCode": {
          "Value": null
        },
        "NationalityCode": {
          "Value": "US"
        },
        "CompanyId": {
          "Value": "839e9d92-aa8b-48bf-8384-b0ec0081bb34"
        },
        "BirthDate": {
          "Value": "2000-01-01"
        },
        "Sex": {
          "Value": "Male"
        },
        "Title": {
          "Value": "Mister"
        },
        "PreferredLanguageCode": {
          "Value": null
        },
        "Options": {
          "SendMarketingEmails": {
            "Value": true
          },
          "Invoiceable": {
            "Value": true
          },
          "BillAddressObjection": {
            "Value": true
          }
        },
        "Classifications": {
          "PaymasterAccount": {
            "Value": true
          },
          "Blacklist": {
            "Value": true
          },
          "Media": {
            "Value": true
          },
          "LoyaltyProgram": {
            "Value": true
          },
          "PreviousComplaint": {
            "Value": true
          },
          "Returning": {
            "Value": true
          },
          "Staff": {
            "Value": true
          },
          "FriendOrFamily": {
            "Value": true
          },
          "TopManagement": {
            "Value": true
          },
          "Important": {
            "Value": true
          },
          "VeryImportant": {
            "Value": true
          },
          "Problematic": {
            "Value": true
          },
          "Cashlist": {
            "Value": true
          },
          "DisabledPerson": {
            "Value": true
          },
          "Military": {
            "Value": true
          },
          "Airline": {
            "Value": true
          },
          "HealthCompliant": {
            "Value": true
          },
          "InRoom": {
            "Value": true
          },
          "WaitingForRoom": {
            "Value": true
          },
          "Student": {
            "Value": true
          }
        },
        "LegalEntityIdentifiers": {
          "ItDestinationCode": {
            "Value": null
          },
          "ItFiscalCode": {
            "Value": null
          }
        }
      }
    }
  ]
}

Property	Type	Contract	Description
ClientToken	string	required	Token identifying the client application.
AccessToken	string	required	Access token of the client application.
Client	string	required	Name and version of the client application.
ChainId	string	optional	Unique identifier of the chain. Required when using Portfolio Access Tokens, ignored otherwise.
AccountUpdates	array of Account update parameters	required, max 1000 items	Accounts to be updated.

Account update parameters

Property	Type	Contract	Description
Id	string	required	Unique identifier of the account.
Discriminator	Account type discriminator	required	Type of the account.
Customer	Customer update parameters	optional	Customer data to be updated. Required when Discriminator is Customer.
Company	Company update parameters	optional	Company data to be updated. Required when Discriminator is Company.

Account type discriminator

• Customer
• Company

Customer update parameters

Property	Type	Contract	Description
Email	String update value	optional	Email address (or null if the email should not be updated).
TaxIdentifier	String update value	optional	Tax identification number (or null if the tax identification number should not be updated).
BillingCode	String update value	optional	Billing code (or null if the billing code should not be updated).
AccountingCode	String update value	optional	Accounting code (or null if the accounting code should not be updated).
Notes	String update value	optional	Notes (or null if the notes should not be updated).
LastName	String update value	optional	Last name (or null if the last name should not be updated).
FirstName	String update value	optional	First name (or null if the first name should not be updated).
SecondLastName	String update value	optional	Second last name (or null if the second last name should not be updated).
BirthPlace	String update value	optional	Birth place (or null if the birth place should not be updated).
Telephone	String update value	optional	Telephone number (or null if the telephone should not be updated).
Occupation	String update value	optional	Occupation (or null if the occupation should not be updated).
CarRegistrationNumber	String update value	optional, max length 255 characters	Car registration number (or null if the car registration number should not be updated).
DietaryRequirements	String update value	optional, max length 255 characters	Dietary requirements (or null if the dietary requirements should not be updated).
LoyaltyCode	String update value	optional	Loyalty code (or null if the loyalty code should not be updated).
NationalityCode	String update value	optional	Nationality code (or null if the nationality code should not be updated).
CompanyId	String update value	optional	Unique identifier of the company (or null if the company should not be updated).
BirthDate	String update value	optional	Birth date (or null if the birth date should not be updated).
Sex	String update value	optional	Sex (or null if the sex should not be updated).
Title	String update value	optional	Title (or null if the title should not be updated).
PreferredLanguageCode	String update value	optional	Preferred language code (or null if the preferred language code should not be updated).
Options	Customer update options	optional	Options of the customer.
Classifications	Customer update classifications	optional	Classifications of the customer.
LegalEntityIdentifiers	Customer update legal entity identifiers	optional	Legal entity identifiers of the customer.

Customer update options

Property	Type	Contract	Description
SendMarketingEmails	Bool update value	optional	Send marketing email (or null if the value should not be updated).
Invoiceable	Bool update value	optional	Invoiceable (or null if the value should not be updated).
BillAddressObjection	Bool update value	optional	Bill address objection (or null if the value should not be updated).

Customer update classifications

Property	Type	Contract	Description
PaymasterAccount	Bool update value	optional	Paymaster account (or null if the value should not be updated).
Blocklist	Bool update value	optional	Blocklist (or null if the value should not be updated).
Media	Bool update value	optional	Media (or null if the value should not be updated).
LoyaltyProgram	Bool update value	optional	Loyalty program (or null if the value should not be updated).
PreviousComplaint	Bool update value	optional	Previous complaint (or null if the value should not be updated).
Returning	Bool update value	optional	Returning (or null if the value should not be updated).
Staff	Bool update value	optional	Staff (or null if the value should not be updated).
FriendOrFamily	Bool update value	optional	Friend or family (or null if the value should not be updated).
TopManagement	Bool update value	optional	Top management (or null if the value should not be updated).
Important	Bool update value	optional	Important (or null if the value should not be updated).
VeryImportant	Bool update value	optional	Very important (or null if the value should not be updated).
Problematic	Bool update value	optional	Problematic (or null if the value should not be updated).
Cashlist	Bool update value	optional	Cashlist (or null if the value should not be updated).
DisabledPerson	Bool update value	optional	Disabled person (or null if the value should not be updated).
Military	Bool update value	optional	Military (or null if the value should not be updated).
Airline	Bool update value	optional	Airline (or null if the value should not be updated).
HealthCompliant	Bool update value	optional	Health compliant (or null if the value should not be updated).
InRoom	Bool update value	optional	In room (or null if the value should not be updated).
WaitingForRoom	Bool update value	optional	Waiting for room (or null if the value should not be updated).
Student	Bool update value	optional	Student (or null if the value should not be updated).
Blacklist	Bool update value	optional	Synonym of Blocklist, left for backward compatibility (null if the value should not be updated). Deprecated! Use Blocklist instead.

Customer update legal entity identifiers

Property	Type	Contract	Description
ItDestinationCode	String update value	optional	Italian destination code (or null if the Italian destination code should not be updated).
ItFiscalCode	String update value	optional	Italian fiscal code (or null if the Italian fiscal code should not be updated).
ItLotteryCode	String update value	optional, max length 15 characters	Italian lottery code (or null if the Italian lottery code should not be updated).

Company update parameters

Property	Type	Contract	Description
Email	String update value	optional	Email address (or null if the email should not be updated).
TaxIdentifier	String update value	optional	Tax identification number (or null if the tax identification number should not be updated).
BillingCode	String update value	optional	Billing code (or null if the billing code should not be updated).
AccountingCode	String update value	optional	Accounting code (or null if the accounting code should not be updated).
Notes	String update value	optional	Notes (or null if the notes should not be updated).
Name	String update value	optional	Name (or null if the name should not be updated).
MotherCompanyId	String update value	optional	Mother company identifier (or null if the mother company identifier should not be updated).
WebsiteUrl	String update value	optional	Website url (or null if the website url should not be updated).
InvoiceDueInterval	String update value	optional	Invoice due interval (or null if the invoice due interval should not be updated).
Classifications	Company update classifications	optional	Classifications of the company.
Options	Company update options	optional	Options of the company.
CreditRatingBasic	Credit rating basic	optional	Basic credit rating (or null if the basic credit rating should not be updated).
Department	String update value	optional	Department (or null if the department should not be updated).
DunsNumber	String update value	optional	Duns number (or null if the duns number should not be updated).
ReferenceId	String update value	optional	Reference identifier (or null if the reference identifier should not be updated).
ExternalIdentifier	String update value	optional, max length 255 characters	External identifier (or null if the external identifier should not be updated).
AdditionalTaxIdentifier	String update value	optional	Additional tax identifier (or null if the additional tax identifier should not be updated).
Contact	String update value	optional	Contact (or null if the contact should not be updated).
ContactPerson	String update value	optional	Contact person (or null if the contact person should not be updated).
FiscalIdentifier	String update value	optional	Fiscal identifier (or null if the fiscal identifier should not be updated).
Iata	String update value	optional	IATA of the company (or null if the iata should not be updated).
Telephone	String update value	optional	Telephone number (or null if the telephone number should not be updated).
SourceId	String update value	optional	Source identifier (or null if the source identifier should not be updated).

Company update classifications

Property	Type	Contract	Description
Corporate	Bool update value	optional	Corporate (or null if the value should not be updated).
Internal	Bool update value	optional	Internal (or null if the value should not be updated).
Private	Bool update value	optional	Private (or null if the value should not be updated).
OnlineTravelAgency	Bool update value	optional	Online travel agency (or null if the value should not be updated).
GlobalDistributionSystem	Bool update value	optional	Global distribution system (or null if the value should not be updated).
Marketing	Bool update value	optional	Marketing (or null if the value should not be updated).
Inactive	Bool update value	optional	Inactive (or null if the value should not be updated).
GovernmentEntity	Bool update value	optional	Government Entity (or null if the value should not be updated).

Credit rating basic

• CreditOk - Company can book services.
• PaymentRequiredUpfront - Company must pay upfront.
• LocalDecisionRequired - Requires local approval.

Response

Property	Type	Contract	Description
Accounts	array of Account	required, max 1000 items	Updated accounts.

Account

Property	Type	Contract	Description
Id	string	required	Unique identifier of the account.
Discriminator	Account type	required	Type of the account.
Customer	Customer	optional	Updated customer data.
Company	Company	optional	Updated company data.

Account type

• Company
• Customer

Customer

Updated customer data.

Property	Type	Contract	Description
ChainId	string	required	Unique identifier of the chain.
CreatedUtc	string	required	Creation date and time of the customer in UTC timezone in ISO 8601 format.
UpdatedUtc	string	required	Last update date and time of the customer in UTC timezone in ISO 8601 format.
UpdaterProfileId	string	required	Unique identifier of the user who updated the customer.
Email	string	optional	Email address of the customer.
TaxIdentifier	string	optional	Tax identification number of the customer.
BillingCode	string	optional	Billing code of the customer.
AccountingCode	string	optional	Accounting code of the customer.
Notes	string	optional	Internal notes about the customer.
LastName	string	required	Last name of the customer.
FirstName	string	optional	First name of the customer.
SecondLastName	string	optional	Second last name of the customer.
BirthPlace	string	optional	Place of birth.
Telephone	string	optional	Telephone number of the customer (possibly mobile).
Occupation	string	optional	Occupation of the customer.
CarRegistrationNumber	string	optional, max length 255 characters	Registration number of the customer's car.
DietaryRequirements	string	optional, max length 255 characters	Dietary requirements of the customer.
LoyaltyCode	string	optional	Loyalty code of the customer.
NationalityCode	string	optional	ISO 3166-1 code of the Country.
CompanyId	string	optional	Unique identifier of Company the customer is associated with.
BirthDate	string	optional	Date of birth in ISO 8601 format.
Sex	string	optional	Sex of the customer.
Title	Title	optional	Title prefix of the customer.
PreferredLanguageCode	string	optional	Language and culture code of the customer's preferred language. E.g. en-US or fr-FR.
Options	Customer options	required	Options of the customer.
Classifications	Customer classifications	required	Classifications of the customer.
LegalEntityIdentifiers	Customer legal identifiers	required	Legal entity identifiers of the customer.

Customer options

Property	Type	Contract	Description
SendMarketingEmails	boolean	required	Send marketing emails.
Invoiceable	boolean	required	Invoiceable.
BillAddressObjection	boolean	required	Bill address objection.

Customer classifications

Property	Type	Contract	Description
PaymasterAccount	boolean	required	Paymaster account.
Blocklist	boolean	required	Blocklist.
Media	boolean	required	Media.
LoyaltyProgram	boolean	required	Loyalty program.
PreviousComplaint	boolean	required	Previous complaint.
Returning	boolean	required	Returning.
Staff	boolean	required	Staff.
FriendOrFamily	boolean	required	Friend or family.
TopManagement	boolean	required	Top management.
Important	boolean	required	Important.
VeryImportant	boolean	required	Very important.
Problematic	boolean	required	Problematic.
Cashlist	boolean	required	Cash list.
DisabledPerson	boolean	required	Disabled person.
Military	boolean	required	Military.
Airline	boolean	required	Airline.
HealthCompliant	boolean	required	Health compliant.
InRoom	boolean	required	In room.
WaitingForRoom	boolean	required	Waiting for room.
Student	boolean	required	Student.
Blacklist	boolean	required	Synonym of Blocklist, left for backward compatibility. Deprecated! Use Blocklist instead.

Customer legal identifiers

Property	Type	Contract	Description
ItDestinationCode	string