AddVendor

Overview

Adds a single Vendor to the system. Returns Success/Error code plus primary key of Vendor added.

Request Information

Method

POST - api/Vendor/AddVendor

URI Parameters

None.

Body Parameters

AddUpdateVendorViewModel

Name	Description	Type	Additional information
VendorId	Conditional: Represents the PK of the Vendor. Only populated when calling an Update method.	globally unique identifier	None.
Name	Required: Represents the name of the Vendor. Max Length = 50	string	None.
ACSystemId	Required: Represents the PK of the Access Control System that the Vendor belongs to.	globally unique identifier	None.
OccupancyId	Optional: Represents the PK of the Occupancy the Vendor performs work for (if applicable)	globally unique identifier	None.
CompanyId	Required: Represents the PK of the global company that the Vendor is an instance of.	globally unique identifier	None.
StreetAddress1	Required: Represents the primary street address of the Vendor	string	None.
StreetAddress2	Optional: Represents the secondary street address of the Vendor	string	None.
City	Required:Represents the city of the Vendor	string	None.
RegionId	Required:Represents the PK of the region (State, Province, County, etc) of the Vendor	globally unique identifier	None.
CountryId	Required:Represents the PK of the country of the Vendor	globally unique identifier	None.
PostalCode	Required: Represents the Postal Code/Zip Code of the Vendor	string	None.
Phone	Optional: Represents the primary phone number of the Vendor	string	None.
VendorNumber	Optional: Represents the vendor number used to refer to the vendor (typically from an accounting package)	string	None.
TimeZoneInfoId	Required: Represents the TimeZone of the Facility	string	None.
Deleted	Represents the deleted status of the Vendor	boolean	None.

JSON

{
  "VendorId": "4cb4b352-ed48-4119-aaaa-39c64469625a",
  "Name": "sample string 1",
  "ACSystemId": "2d074777-5f3d-450a-b8ac-dd9eca3d69d0",
  "OccupancyId": "23b2bf1b-8471-4943-9c97-c924f8199a3e",
  "CompanyId": "9231569c-5adc-490e-8ac8-bb2b93204a8a",
  "StreetAddress1": "sample string 4",
  "StreetAddress2": "sample string 5",
  "City": "sample string 6",
  "RegionId": "43c3d508-7ed2-475c-84b6-3bcf4d49afd2",
  "CountryId": "4dc0c503-0bc8-4d31-b02b-727cd98de517",
  "PostalCode": "sample string 9",
  "Phone": "sample string 10",
  "VendorNumber": "sample string 11",
  "TimeZoneInfoId": "sample string 12",
  "Deleted": true
}

XML

<AddUpdateVendorViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BluSKYWebAPI.Controllers">
  <ACSystemId>2d074777-5f3d-450a-b8ac-dd9eca3d69d0</ACSystemId>
  <City>sample string 6</City>
  <CompanyId>9231569c-5adc-490e-8ac8-bb2b93204a8a</CompanyId>
  <CountryId>4dc0c503-0bc8-4d31-b02b-727cd98de517</CountryId>
  <Deleted>true</Deleted>
  <Name>sample string 1</Name>
  <OccupancyId>23b2bf1b-8471-4943-9c97-c924f8199a3e</OccupancyId>
  <Phone>sample string 10</Phone>
  <PostalCode>sample string 9</PostalCode>
  <RegionId>43c3d508-7ed2-475c-84b6-3bcf4d49afd2</RegionId>
  <StreetAddress1>sample string 4</StreetAddress1>
  <StreetAddress2>sample string 5</StreetAddress2>
  <TimeZoneInfoId>sample string 12</TimeZoneInfoId>
  <VendorId>4cb4b352-ed48-4119-aaaa-39c64469625a</VendorId>
  <VendorNumber>sample string 11</VendorNumber>
</AddUpdateVendorViewModel>

Response Information

Resource Description

ResultWithGuid

Name	Description	Type	Additional information
ResultCode	Represents the result code	integer	None.
Description	Represents a description of the result code	string	None.
Value	Represents the PK value that was created as a result of an add	globally unique identifier	None.

Response Formats

JSON

{
  "ResultCode": 1,
  "Description": "sample string 2",
  "Value": "cfba0ef5-4748-4a38-b157-48c619053e7f"
}

XML

<ResultWithGuid xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BluSKYWebAPI.Controllers">
  <Description>sample string 2</Description>
  <ResultCode>1</ResultCode>
  <Value>cfba0ef5-4748-4a38-b157-48c619053e7f</Value>
</ResultWithGuid>