Create a business location
post
/fscmRestApi/resources/11.13.18.05/publicSectorBusinessRegistrations/{BusinessEntityKey}/child/BusinessLocation
Request
Path Parameters
-
BusinessEntityKey(required): integer(int64)
System-generated identifier for a business entity.
Header Parameters
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
-
Upsert-Mode:
When set to true, the server will perform an Upsert operation instead of a Create. In an Upsert operation the server attempts to find an existing resource that matches the payload. If found, the server updates the existing resource instead of creating a new one. If not found, or when set to false (the default), a Create is performed.
Supported Media Types
- application/json
The following table describes the body parameters in the request for this task.
Root Schema : schema
Type:
Show Source
object
-
Address1: string
First line of the physical address.
-
Address2: string
Second line of the physical address.
-
Address3: string
Third line of the physical address.
-
Address4: string
Fourth line of the physical address.
-
AddressCode: string
Maximum Length:
32
Unique identifier for the parcel address. -
AddressId: integer
(int64)
The unique identifier for the address.
-
AddressType: string
Maximum Length:
20
Attribute used for address point validation. Possible values might be main address, virtual address, shipping gate address, or others. -
AgencyId: integer
(int32)
The unique identifier of the agency associated with the business location.
-
AltPhoneAreaCode: string
Alternate phone area code.
-
AltPhoneContactPointId: integer
(int64)
Unique identifier for the alternate phone contact.
-
AltPhoneCountryCode: string
Alternate phone country code.
-
AltPhoneExtension: string
Alternate phone extension number of the location.
-
AltPhoneNumber: string
Alternate phone number of the location.
-
AltPhoneType: string
Alternate phone type of the location.
-
AltRawPhoneNumber: string
Alternate raw phone number of the location.
-
AreaSize: integer
(int64)
Size of the business location.
-
AreaSizeUom: string
Maximum Length:
10
Unit of measure for the business location size. -
BuildingType: string
Maximum Length:
20
Building type used for parcel address searches. -
BusCategory: string
Maximum Length:
50
The category for the business. -
BusDbaBusinessName: string
The operating name of the business.
-
BusDescription: string
Description of the business.
-
BusinessEntityId: string
Maximum Length:
50
The unique identifier for the business entity associated with the location. -
BusinessEntityKey: integer
(int64)
System-generated identifier for a business entity.
-
BusinessLocationId: string
Maximum Length:
50
The unique identifier for the business location. -
BusinessLocationKey: integer
(int64)
System-generated unique identifier for a business location.
-
BusinessLocationPartyId: integer
(int64)
The unique identifier for the party associated with the business location.
-
BusStateTaxId: string
Maximum Length:
20
State tax ID of the business location. -
BusSubCategory: string
Maximum Length:
50
The subcategory for the business. -
City: string
The location address city.
-
CityTaxId: string
Maximum Length:
20
The unique tax identifier issued to the business by the city. -
CoordinateX: number
Geographic X-coordinate of the parcel address location.
-
CoordinateY: number
Geographic Y-coordinate of the parcel address location.
-
Country: string
The location address country.
-
County: string
Physical address county.
-
CrossroadOne: string
Maximum Length:
240
Cross road 1 that is part of parcel address. -
CrossroadTwo: string
Maximum Length:
240
Cross road 2 that is part of parcel address. -
CtyFoodSerLicExp: string
(date)
Expiration date of the county food service license associated with the business location.
-
CtyFoodSerLicNum: string
Maximum Length:
30
County food service license number of the business location. -
EcontactAvailabilityOne: string
Maximum Length:
1000
Availability of the primary emergency contact. -
EcontactAvailabilityTwo: string
Maximum Length:
1000
Availability of the secondary emergency contact. -
EcontactEmailOne: string
Maximum Length:
320
Email address of the primary emergency contact. -
EcontactEmailTwo: string
Maximum Length:
320
Email address of the secondary emergency contact. -
EcontactFirstNameOne: string
Maximum Length:
150
First name of the primary emergency contact. -
EcontactFirstNameTwo: string
Maximum Length:
150
First name of the secondary emergency contact. -
EcontactLastNameOne: string
Maximum Length:
150
Last name of the primary emergency contact. -
EcontactLastNameTwo: string
Maximum Length:
150
Last name of the secondary emergency contact. -
EcontactPhoneAreaCodeOne: string
Primary emergency contact area code.
-
EcontactPhoneAreaCodeTwo: string
Secondary emergency contact area code.
-
EcontactPhoneCountryOne: string
Primary emergency contact country.
-
EcontactPhoneCountryTwo: string
Secondary emergency contact country code.
-
EcontactPhoneExtensionOne: string
Primary emergency contact phone extension number of the location.
-
EcontactPhoneExtensionTwo: string
Secondary emergency contact phone extension number of the location.
-
EcontactPhoneNumberOne: string
Primary emergency contact phone number of the location.
-
EcontactPhoneNumberTwo: string
Secondary emergency contact phone number of the location.
-
EcontactPhoneTypeOne: string
Phone type of the primary emergency contact for the location.
-
EcontactPhoneTypeTwo: string
Secondary emergency contact phone type of the location.
-
EcontactRawPhoneNumberOne: string
Primary emergency contact raw phone number of the location.
-
EcontactRawPhoneNumberTwo: string
Secondary emergency contact raw phone number of the location.
-
EmailAddress: string
Maximum Length:
320
Email address of the location. -
EmployeeTotal: integer
Total number of employees in organization.
-
EnabledFlag: string
Maximum Length:
1
Indicates whether the business location has been enabled. -
EndDate: string
(date)
The end date of the business location.
-
EOnePhoneContactPointId: integer
(int64)
The unique identifier for the primary phone contact.
-
ETwoPhoneContactPointId: integer
(int64)
The unique identifier for the secondary phone contact.
-
Floor: string
The floor number of the physical address.
-
InactiveReason: string
Maximum Length:
1000
The reason that the business location was inactivated. -
Landmark: string
Maximum Length:
200
Landmark for the parcel address. -
Latitude: number
Latitude of the location.
-
Longitude: number
Longitude of the location.
-
MailingAddress1: string
First line of the location mailing address.
-
MailingAddress2: string
Third line of the location mailing address.
-
MailingAddress3: string
Second line of the location mailing address.
-
MailingAddress4: string
Fourth line of the location mailing address.
-
MailingCity: string
Location mailing address city.
-
MailingCountry: string
Location mailing address country.
-
MailingCounty: string
Location mailing address county.
-
MailingPostalCode: string
Location mailing address postal code.
-
MailingPostalPlusFourCode: string
Location mailing postal plus 4 code.
-
MailingProvince: string
Location mailing address province.
-
MailingState: string
Location mailing address state.
-
MobileBusFlag: string
Maximum Length:
1
Indicates whether the business is a mobile product or provides mobile service. -
MunicipalityId: string
Maximum Length:
20
The municipality in which the parcel address is located. -
ObjectVersionNumber: integer
(int32)
Workflow project revision number used to define the workflow.
-
OtherTaxId: string
Maximum Length:
20
The unique tax identifier issued to the business by the county. -
ParcelId: integer
(int64)
The unique identifier for the parcel.
-
ParcelIdEntered: string
Maximum Length:
30
The parcel number. -
PostalCode: string
Physical address postal code.
-
PostalPlus4Code: string
Physical address postal plus 4 code.
-
PrimaryPhoneAreaCode: string
Primary phone area code.
-
PrimaryPhoneCountryCode: string
Primary phone country code.
-
PrimaryPhoneExtension: string
Primary phone extension number of the location.
-
PrimaryPhoneNumber: string
Primary phone number of the location.
-
PrimaryPhoneType: string
Primary phone type of the location.
-
PrimaryRawPhoneNumber: string
Primary raw phone number of the location.
-
PrimPhoneContactPointId: integer
(int64)
The unique identifier of the primary phone contact.
-
Province: string
Physical address province.
-
RentalUnitNum: integer
(int64)
Number of rental units for the business location.
-
SameMailAddressFlag: string
Maximum Length:
1
Indicates whether the mailing address is same as mailing address. -
SellPerNum: string
Maximum Length:
30
Business sellers permit number of the location. -
SellPerNumExp: string
(date)
Expiration date of the business sellers permit number associated with the location.
-
StartDate: string
(date)
The start date of the business location.
-
State: string
Physical address state.
-
Status: string
Maximum Length:
20
Current status of the location. -
StQualPerNum: string
Maximum Length:
30
The ID number issued to the business by the State Equalization Board. -
StreetDirection: string
Street direction of the location.
-
StreetName: string
Maximum Length:
240
Street name used for parcel address searches. -
StreetNumber: string
Street number of the location.
-
StreetSuffix: string
Maximum Length:
20
Street name that describes the street. -
StreetType: string
Maximum Length:
20
Street type used for parcel address searches. -
TaxClass: string
Maximum Length:
30
Municipal tax class of the business location. -
UnitNumber: string
Maximum Length:
30
Apartment unit number used for parcel address searches. -
Website: string
Maximum Length:
1000
Website address of the location. -
WithinJurisdictionFlag: string
Maximum Length:
1
Indicates whether the business is located within the agency's jurisdiction.
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context(required):
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version(required):
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : publicSectorBusinessRegistrations-BusinessLocation-item-response
Type:
Show Source
object
-
Address1: string
First line of the physical address.
-
Address2: string
Second line of the physical address.
-
Address3: string
Third line of the physical address.
-
Address4: string
Fourth line of the physical address.
-
AddressCode: string
Maximum Length:
32
Unique identifier for the parcel address. -
AddressId: integer
(int64)
The unique identifier for the address.
-
AddressType: string
Maximum Length:
20
Attribute used for address point validation. Possible values might be main address, virtual address, shipping gate address, or others. -
AgencyId: integer
(int32)
The unique identifier of the agency associated with the business location.
-
AltPhoneAreaCode: string
Alternate phone area code.
-
AltPhoneContactPointId: integer
(int64)
Unique identifier for the alternate phone contact.
-
AltPhoneCountryCode: string
Alternate phone country code.
-
AltPhoneExtension: string
Alternate phone extension number of the location.
-
AltPhoneNumber: string
Alternate phone number of the location.
-
AltPhoneType: string
Alternate phone type of the location.
-
AltRawPhoneNumber: string
Alternate raw phone number of the location.
-
AreaSize: integer
(int64)
Size of the business location.
-
AreaSizeUom: string
Maximum Length:
10
Unit of measure for the business location size. -
BuildingType: string
Maximum Length:
20
Building type used for parcel address searches. -
BusCategory: string
Maximum Length:
50
The category for the business. -
BusDbaBusinessName: string
The operating name of the business.
-
BusDescription: string
Description of the business.
-
BusinessEntityId: string
Maximum Length:
50
The unique identifier for the business entity associated with the location. -
BusinessEntityKey: integer
(int64)
System-generated identifier for a business entity.
-
BusinessLocationId: string
Maximum Length:
50
The unique identifier for the business location. -
BusinessLocationKey: integer
(int64)
System-generated unique identifier for a business location.
-
BusinessLocationPartyId: integer
(int64)
The unique identifier for the party associated with the business location.
-
BusStateTaxId: string
Maximum Length:
20
State tax ID of the business location. -
BusSubCategory: string
Maximum Length:
50
The subcategory for the business. -
City: string
The location address city.
-
CityTaxId: string
Maximum Length:
20
The unique tax identifier issued to the business by the city. -
CoordinateX: number
Geographic X-coordinate of the parcel address location.
-
CoordinateY: number
Geographic Y-coordinate of the parcel address location.
-
Country: string
The location address country.
-
County: string
Physical address county.
-
CreationDate: string
(date-time)
Read Only:
true
The date that the business location was created. -
CrossroadOne: string
Maximum Length:
240
Cross road 1 that is part of parcel address. -
CrossroadTwo: string
Maximum Length:
240
Cross road 2 that is part of parcel address. -
CtyFoodSerLicExp: string
(date)
Expiration date of the county food service license associated with the business location.
-
CtyFoodSerLicNum: string
Maximum Length:
30
County food service license number of the business location. -
EcontactAvailabilityOne: string
Maximum Length:
1000
Availability of the primary emergency contact. -
EcontactAvailabilityTwo: string
Maximum Length:
1000
Availability of the secondary emergency contact. -
EcontactEmailOne: string
Maximum Length:
320
Email address of the primary emergency contact. -
EcontactEmailTwo: string
Maximum Length:
320
Email address of the secondary emergency contact. -
EcontactFirstNameOne: string
Maximum Length:
150
First name of the primary emergency contact. -
EcontactFirstNameTwo: string
Maximum Length:
150
First name of the secondary emergency contact. -
EcontactLastNameOne: string
Maximum Length:
150
Last name of the primary emergency contact. -
EcontactLastNameTwo: string
Maximum Length:
150
Last name of the secondary emergency contact. -
EcontactPhoneAreaCodeOne: string
Primary emergency contact area code.
-
EcontactPhoneAreaCodeTwo: string
Secondary emergency contact area code.
-
EcontactPhoneCountryOne: string
Primary emergency contact country.
-
EcontactPhoneCountryTwo: string
Secondary emergency contact country code.
-
EcontactPhoneExtensionOne: string
Primary emergency contact phone extension number of the location.
-
EcontactPhoneExtensionTwo: string
Secondary emergency contact phone extension number of the location.
-
EcontactPhoneNumberOne: string
Primary emergency contact phone number of the location.
-
EcontactPhoneNumberTwo: string
Secondary emergency contact phone number of the location.
-
EcontactPhoneTypeOne: string
Phone type of the primary emergency contact for the location.
-
EcontactPhoneTypeTwo: string
Secondary emergency contact phone type of the location.
-
EcontactRawPhoneNumberOne: string
Primary emergency contact raw phone number of the location.
-
EcontactRawPhoneNumberTwo: string
Secondary emergency contact raw phone number of the location.
-
EmailAddress: string
Maximum Length:
320
Email address of the location. -
EmployeeTotal: integer
Total number of employees in organization.
-
EnabledFlag: string
Maximum Length:
1
Indicates whether the business location has been enabled. -
EndDate: string
(date)
The end date of the business location.
-
EOnePhoneContactPointId: integer
(int64)
The unique identifier for the primary phone contact.
-
ETwoPhoneContactPointId: integer
(int64)
The unique identifier for the secondary phone contact.
-
Floor: string
The floor number of the physical address.
-
InactiveReason: string
Maximum Length:
1000
The reason that the business location was inactivated. -
Landmark: string
Maximum Length:
200
Landmark for the parcel address. -
LastUpdateDate: string
(date-time)
Read Only:
true
The date that the business location was last updated. -
LastUpdateLogin: string
Read Only:
true
Maximum Length:32
The login identifier of the person who last updated the business location. -
Latitude: number
Latitude of the location.
-
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
Longitude: number
Longitude of the location.
-
MailingAddress1: string
First line of the location mailing address.
-
MailingAddress2: string
Third line of the location mailing address.
-
MailingAddress3: string
Second line of the location mailing address.
-
MailingAddress4: string
Fourth line of the location mailing address.
-
MailingCity: string
Location mailing address city.
-
MailingCountry: string
Location mailing address country.
-
MailingCounty: string
Location mailing address county.
-
MailingPostalCode: string
Location mailing address postal code.
-
MailingPostalPlusFourCode: string
Location mailing postal plus 4 code.
-
MailingProvince: string
Location mailing address province.
-
MailingState: string
Location mailing address state.
-
MobileBusFlag: string
Maximum Length:
1
Indicates whether the business is a mobile product or provides mobile service. -
MunicipalityId: string
Maximum Length:
20
The municipality in which the parcel address is located. -
ObjectVersionNumber: integer
(int32)
Workflow project revision number used to define the workflow.
-
OtherTaxId: string
Maximum Length:
20
The unique tax identifier issued to the business by the county. -
ParcelId: integer
(int64)
The unique identifier for the parcel.
-
ParcelIdEntered: string
Maximum Length:
30
The parcel number. -
PostalCode: string
Physical address postal code.
-
PostalPlus4Code: string
Physical address postal plus 4 code.
-
PrimaryPhoneAreaCode: string
Primary phone area code.
-
PrimaryPhoneCountryCode: string
Primary phone country code.
-
PrimaryPhoneExtension: string
Primary phone extension number of the location.
-
PrimaryPhoneNumber: string
Primary phone number of the location.
-
PrimaryPhoneType: string
Primary phone type of the location.
-
PrimaryRawPhoneNumber: string
Primary raw phone number of the location.
-
PrimPhoneContactPointId: integer
(int64)
The unique identifier of the primary phone contact.
-
Province: string
Physical address province.
-
RentalUnitNum: integer
(int64)
Number of rental units for the business location.
-
SameMailAddressFlag: string
Maximum Length:
1
Indicates whether the mailing address is same as mailing address. -
SellPerNum: string
Maximum Length:
30
Business sellers permit number of the location. -
SellPerNumExp: string
(date)
Expiration date of the business sellers permit number associated with the location.
-
StartDate: string
(date)
The start date of the business location.
-
State: string
Physical address state.
-
Status: string
Maximum Length:
20
Current status of the location. -
StQualPerNum: string
Maximum Length:
30
The ID number issued to the business by the State Equalization Board. -
StreetDirection: string
Street direction of the location.
-
StreetName: string
Maximum Length:
240
Street name used for parcel address searches. -
StreetNumber: string
Street number of the location.
-
StreetSuffix: string
Maximum Length:
20
Street name that describes the street. -
StreetType: string
Maximum Length:
20
Street type used for parcel address searches. -
TaxClass: string
Maximum Length:
30
Municipal tax class of the business location. -
UnitNumber: string
Maximum Length:
30
Apartment unit number used for parcel address searches. -
Website: string
Maximum Length:
1000
Website address of the location. -
WithinJurisdictionFlag: string
Maximum Length:
1
Indicates whether the business is located within the agency's jurisdiction.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]
The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object
-
changeIndicator: string
Change indicator or the ETag value of the resource instance.