Batch Integrate Companies with an External Data Source
post
/primeapi/restapi/company/syncBatch
Send a request to this endpoint to create or update one or more integrated companies. If an object provided in the request body does not exist in the application, an object is created using the request data. Integrated objects can only be modified using the API.
Request
Supported Media Types
- application/json
The unique identifier of company data in an external source.S
Root Schema : List<ApiEntityExternallySourcedCompany>
Type:
array
Title:
Show Source
List<ApiEntityExternallySourcedCompany>
Nested Schema : ApiEntityExternallySourcedCompany
Type:
Show Source
object
-
addressLine1(optional):
string
The first line of the address of a location.
This might be the building number and street address. -
addressLine2(optional):
string
The second line of the address of a location.
This might be a neighborhood or town. -
cityName(optional):
string
The city name for a location.
-
companyConfiguredFields(optional):
object ApiEntityCompanyConfiguredFields
-
companyId(optional):
integer(int64)
The system-generated identifier of a company.
-
companyName:
string
Allowed Values:
[ "Length[1-255]" ]
The name of the company. -
countryCode:
string
The country for a location.
-
description(optional):
string
Allowed Values:
[ "Length[1-4000]" ]
Additional information about the company. -
fax(optional):
string
Allowed Values:
[ "Length[1-32]" ]
The fax number for the company. -
isTenantOwned(optional):
boolean
Does the company belong to the tenant.
-
latitude(optional):
number(double)
The latitude of a company.
-
link(optional):
string(url)
Read Only:
true
-
locationName(optional):
string
A name for the location that your users will understand and recognize.
-
longitude(optional):
number(double)
The geographical coordinate for the longitude of the location.
The default format for longitude is decimal degrees format, but the format you need to use will depend on your geolocation service. -
offices(optional):
array offices
Read Only:
true
Unique Items Required:true
Offices associated with the company. -
organizationId(optional):
integer(int64)
The unique identifier for the organisation.
-
otherPhone(optional):
string
Allowed Values:
[ "Length[1-32]" ]
An alternate phone number for a company. -
performanceRating(optional):
string
Allowed Values:
[ "PERFORMANCE_LEVEL_ONE", "PERFORMANCE_LEVEL_TWO", "PERFORMANCE_LEVEL_THREE", "PERFORMANCE_LEVEL_FOUR", "PERFORMANCE_LEVEL_FIVE", "NO_PERFORMANCE_RATING" ]
Performance Rating of a Company determined by the tenant. -
phone(optional):
string
Allowed Values:
[ "Length[1-32]" ]
The phone number for the company. -
postalCode:
string
The postal code, post code, or zip code of a location.
-
pushDownType(optional):
string
Allowed Values:
[ "MANUAL", "AUTOMATIC" ]
The push down type of the workspace company. -
qualificationStatus(optional):
string
Allowed Values:
[ "QUALIFIED", "CONDITIONALLY_QUALIFIED", "NOT_QUALIFIED", "NO_STATUS" ]
Qualification status of a Company according to the tenant -
sourceId(optional):
string
The unique identifer of company data in an external source.Example:
coarse
-
sourceSiteId(optional):
string
The unique identifier of a company site in an external source.
-
stateCode(optional):
string
A unique identifier for the state or province.
-
stateName(optional):
string
The state, region, or province of a location.
-
status(optional):
string
Allowed Values:
[ "ACTIVE", "INACTIVE" ]
The status of the company. Valid values are Active and Inactive. -
type(optional):
string
Allowed Values:
[ "OWNER", "VENDOR", "RESELLER", "DESIGN_CONSULTANT", "SUB_CONTRACTOR", "SUPPLIER", "OTHER", "ARCHITECT", "OWNER_REP", "GC", "CONSULTANT", "ARCHITECT_ENGINEER", "CONTRACTOR", "CONSTRUCTION_MANAGER", "ENGINEER", "CUSTOMER" ]
The type of company. Valid values are Owner, Vendor, Reseller, Design Consultant, Sub Contractor, and Supplier. -
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
url(optional):
string
Allowed Values:
[ "Length[1-255]" ]
The website of the company. -
workspaceCode(optional):
string
-
workspaceId(optional):
integer(int64)
The workspace that the company was created in. All changes to the company must be made in the owning workspace.
Nested Schema : ApiEntityCompanyConfiguredFields
Type:
Show Source
object
-
companyId(optional):
integer(int64)
-
costFlexMap(optional):
object costFlexMap
Additional Properties Allowed: additionalPropertiesThe cost fields associated with a company.
-
link(optional):
string(url)
Read Only:
true
-
otherFlexMap(optional):
object otherFlexMap
Additional Properties Allowed: additionalPropertiesThe cost fields associated with a company.
-
textFlexMap(optional):
object textFlexMap
Additional Properties Allowed: additionalPropertiesThe cost fields associated with a company.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : offices
Type:
array
Read Only:
true
Unique Items Required:
true
Offices associated with the company.
Show Source
Nested Schema : costFlexMap
Type:
object
Additional Properties Allowed
Show Source
The cost fields associated with a company.
Nested Schema : otherFlexMap
Type:
object
Additional Properties Allowed
Show Source
The cost fields associated with a company.
Nested Schema : textFlexMap
Type:
object
Additional Properties Allowed
Show Source
The cost fields associated with a company.
Nested Schema : additionalProperties
Type:
object
Nested Schema : additionalProperties
Type:
object
Nested Schema : additionalProperties
Type:
object
Nested Schema : ApiEntityOffice
Type:
Show Source
object
-
addressLine1(optional):
string
The first line of the address of a location.
This might be the building number and street address. -
addressLine2(optional):
string
The second line of the address of a location.
This might be a neighborhood or town. -
cityName(optional):
string
The city name for a location.
-
companyId:
integer(int64)
The unique identifier of a company of an office.
-
companyName(optional):
string
Allowed Values:
[ "Length[1-255]" ]
The name of the company. -
countryCode(optional):
string
The country for a location.
-
fax(optional):
string
The fax number for the office.
-
isCorporateOffice(optional):
boolean
If the office is the Head office of the company.
-
latitude(optional):
number(double)
The geographical coordinate for the latitude of the location.
The default format for latitude is decimal degrees format, but the format you need to use will depend on your geolocation service. -
link(optional):
string(url)
Read Only:
true
-
longitude(optional):
number(double)
The geographical coordinate for the longitude of the location.
The default format for longitude is decimal degrees format, but the format you need to use will depend on your geolocation service. -
officeCountryCode:
string
The country for a location.
-
officeId(optional):
integer(int64)
The unique identifier of an office.
-
officeName:
string
Allowed Values:
[ "Length[1-255]" ]
The name of the office. -
officePostalCode:
string
The postal code, post code, or zip code of a location.
-
orgOfficeId(optional):
integer(int64)
The unique identifier of the organization of the office.
-
phone(optional):
string
The phone number for the office.
-
postalCode(optional):
string
The postal code, post code, or zip code of a location.
-
stateName(optional):
string
The state, region, or province of a location.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Response
Supported Media Types
- application/json
207 Response
The object was sucessfully integrated.
Nested Schema : ApiEntityERPSyncApiResponse
Type:
Show Source
object
-
link(optional):
string(url)
Read Only:
true
-
message(optional):
string
-
primaryKey(optional):
integer(int64)
-
primaryKeyName(optional):
string
-
primaryKeyValue(optional):
integer(int64)
-
sourceId(optional):
string
-
statusCode(optional):
integer(int32)
-
uniqueName(optional):
string
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
400 Response
Invalid Input.