Person Change One

POST /People/Update/OneChange

Authorization key & Authorization date & Authorization hmac

This process updates a single people record. If there is a StrandVision record id or your employee id passed, there will be an exact match to update. If not, we search based on the sound of the first and last name. If a match is not found, a new record is added. If found, the person is updated. This returns the values after the update. *Secret Hmac Required. Do Not Cache this call.

Body

Custno number

The optional customer number to retrieve
Person object
Hide Person attributes Show Person attributes object
- FirstName string
  
  required contact first name
- LastName string
  
  required contact last name
- Emp_Id string
  
  Recommended people / staff id
- Birthday string
  
  The recommended birthday preferably in the format MM-DD. If sent as YYYY-MM-DD format with a year, the year will be replaced with an invalid year.
- HireDate string
  
  The recommended hire date for showing the years they have worked in YYYY-MM-DD format.
- TermDate string
  
  The optional Termination Date if you want to display people who will leave soon in YYYY-MM-DD format.
- Source_Id string
  
  optional employee or other id from the source database
- Location string
  
  optional location code specified from the source database
- Email string
  
  optional email address
- NickName string
  
  optional name they go by
- Phone string
  
  optional direct phone number
- Web string
  
  optional link to their record on internal web site
- Photo string
  
  optional location of uploaded photo
- Gender string
  
  M for male, F for female, U for Unknown or Undisclosed
- Dept string
  
  optional Department that they work in
- Title string
  
  optional title of the employee
- Skip string
  
  Skip Display Options (Birthday, Annivarsiary, Termination)

Responses

200

Person successfully updated
Hide response attributes Show response attributes object
- Id number
  
  the StrandVision record id needed for individual update or remove
- Emp_Id string
  
  people / staff id
- Created string
  
  date/time created
- Deleted number
  
  Whether the staff member is deleted
- Parent number
  
  Parent User Number
- Custno number
  
  User Customer Number
- DispGroup string
  
  the display group that this user is in
- Source_Id string
  
  employee or other id from the source database
- Location string
  
  location code specified from the source database
- Email string
  
  email address
- FirstName string
  
  contact first name
- LastName string
  
  contact last name
- NickName string
  
  name they go by
- Phone string
  
  direct phone number
- Web string
  
  link to their record on internal web site
- Photo string
  
  location of uploaded photo
- Gender string
  
  M for male, F for female, U for Unknown or Undisclosed
- Dept string
  
  Department that they work in
- Title string
  
  title of the employee
- Birthday string
  
  Birthday with invalid year
- HireDate string
  
  Hire Date
- TermDate string
  
  Termination Date (if any)
- Skip string
  
  Skip Display Options (Birthday, Annivarsiary, Termination)
- DateLast string
  
  Last Date/Time used
- DateEdit string
  
  Last Date/Time that the employee was updated

POST /People/Update/OneChange

curl \
 -X POST https://Api.StrandVision.com/v1.0/People/Update/OneChange \
 -H "Authorization: X-apikey $ACCESS_TOKEN" \
 -H "Authorization: X-apidate $ACCESS_TOKEN" \
 -H "Authorization: X-apihmac $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"Custno":10028,"Person":{"FirstName":"Ingred","LastName":"Bergman","Emp_Id":1016,"Birthday":"12-04","HireDate":"2010-01-15","TermDate":0,"Source_Id":1016,"Location":"Washington","Email":"csstrand@strandvision.com","NickName":"string","Phone":"string","Web":"string","Photo":"https://strandvision.com/.?ImageDB=LG4FX874KHC52OFCA7RXL","Gender":"Female","Dept":"Quality Assurance","Title":"Quality Assurance Manager","Skip":"Birthdays"}}'

Request example

{
  "Custno": 10028,
  "Person": {
    "FirstName": "Ingred",
    "LastName": "Bergman",
    "Emp_Id": 1016,
    "Birthday": "12-04",
    "HireDate": "2010-01-15",
    "TermDate": 0,
    "Source_Id": 1016,
    "Location": "Washington",
    "Email": "csstrand@strandvision.com",
    "NickName": "string",
    "Phone": "string",
    "Web": "string",
    "Photo": "https://strandvision.com/.?ImageDB=LG4FX874KHC52OFCA7RXL",
    "Gender": "Female",
    "Dept": "Quality Assurance",
    "Title": "Quality Assurance Manager",
    "Skip": "Birthdays"
  }
}

Request examples

{
  "Custno": 10028,
  "Person": {
    "FirstName": "Ingred",
    "LastName": "Bergman",
    "Emp_Id": 1016,
    "Birthday": "12-04",
    "HireDate": "2010-01-15",
    "TermDate": 0,
    "Source_Id": 1016,
    "Location": "Washington",
    "Email": "csstrand@strandvision.com",
    "NickName": "string",
    "Phone": "string",
    "Web": "string",
    "Photo": "https://strandvision.com/.?ImageDB=LG4FX874KHC52OFCA7RXL",
    "Gender": "Female",
    "Dept": "Quality Assurance",
    "Title": "Quality Assurance Manager",
    "Skip": "Birthdays"
  }
}

Response examples (200)

{
  "Id": 1234,
  "Emp_Id": 1001,
  "Created": "Thu, 21 Aug 2014 15:43:00 GMT",
  "Deleted": 0,
  "Parent": 10028,
  "Custno": 10028,
  "DispGroup": "Menomonie, WI (10)",
  "Source_Id": 1001,
  "Location": "Menomonie",
  "Email": "mjstrand@strandvision.com",
  "FirstName": "Mike",
  "LastName": "Strand",
  "NickName": "",
  "Phone": "",
  "Web": "",
  "Photo": "https://strandvision.com/.?ImageDB=PF4FX87QKHC52OFCA7RXL",
  "Gender": "Male",
  "Dept": "Administration",
  "Title": "President & CEO",
  "Birthday": "Sat, 01 Aug 2037 01:02:03 GMT",
  "HireDate": "Thu, 02 Aug 2029 01:02:03 GMT",
  "TermDate": "",
  "Skip": "Birthdays",
  "DateLast": "Fri, 04 Aug 2023 14:25:00 GMT",
  "DateEdit": "Thu, 21 Aug 2014 15:43:00 GMT"
}

Response examples (200)

{
  "Id": 1016,
  "Emp_Id": 1016,
  "Created": "Thu, 21 Aug 2014 15:43:00 GMT",
  "Deleted": 0,
  "Parent": 10028,
  "Custno": 10028,
  "DispGroup": "Menomonie, WI (10)",
  "Source_Id": 1016,
  "Location": "Washington",
  "Email": "csstrand@strandvision.com",
  "FirstName": "Ingred",
  "LastName": "Bergman",
  "NickName": "string",
  "Phone": "string",
  "Web": "string",
  "Photo": "https://strandvision.com/.?ImageDB=LG4FX874KHC52OFCA7RXL",
  "Gender": "Female",
  "Dept": "Quality Assurance",
  "Title": "Quality Assurance Manager",
  "Birthday": "Sun, 09 Aug 2037 01:02:03 GMT",
  "HireDate": "Mon, 10 Aug 2015 01:02:03 GMT",
  "TermDate": 0,
  "Skip": "Birthdays",
  "DateLast": "Fri, 21 Jul 2023 22:52:00 GMT",
  "DateEdit": "Thu, 21 Aug 2014 15:43:00 GMT"
}