POST v1/imports/employee-pto-requests?action={action}&allowSameFile={allowSameFile}

Import PTO Requests

Request Information

URI Parameters

Name	Description	Type	Additional information
action	The import action.	ImportAction	Required
allowSameFile	The flag allowing/disallowing import from the same file twice.	boolean	Required

Body Parameters

The items to import.

Collection of EmployeePTORequestImportDTO

Name	Type	Additional information
PTOCode	string	None.
SubmittedOn	date	None.
RequestDate	date	None.
StartTime	date	None.
UtcOffsetMinutes	integer	None.
DurationHours	decimal number	None.
RequestNotes	string	None.
IsApproved	boolean	None.
EmployeeNumber	string	None.
EmployeePersonalId	integer	None.
DivisionCode	string	None.
CompanyCode	string	Required

Request Formats

application/json, text/json

Sample:

[
  {
    "ptoCode": "sample string 1",
    "submittedOn": "2026-05-02T18:25:35.3102599Z",
    "requestDate": "0001-02-03",
    "startTime": "2026-05-02T18:25:35.3102599Z",
    "utcOffsetMinutes": 1,
    "durationHours": 3.0,
    "requestNotes": "sample string 4",
    "isApproved": true,
    "employeeNumber": "sample string 6",
    "employeePersonalId": 1,
    "divisionCode": "sample string 7",
    "companyCode": "sample string 8"
  },
  {
    "ptoCode": "sample string 1",
    "submittedOn": "2026-05-02T18:25:35.3102599Z",
    "requestDate": "0001-02-03",
    "startTime": "2026-05-02T18:25:35.3102599Z",
    "utcOffsetMinutes": 1,
    "durationHours": 3.0,
    "requestNotes": "sample string 4",
    "isApproved": true,
    "employeeNumber": "sample string 6",
    "employeePersonalId": 1,
    "divisionCode": "sample string 7",
    "companyCode": "sample string 8"
  }
]

text/xml

Sample:

<ArrayOfEmployeePTORequestImportDTO xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BDBPayroll.Integration.ServiceContracts.Data.Models">
  <EmployeePTORequestImportDTO>
    <CompanyCode>sample string 8</CompanyCode>
    <DivisionCode>sample string 7</DivisionCode>
    <EmployeeNumber>sample string 6</EmployeeNumber>
    <EmployeePersonalId>1</EmployeePersonalId>
    <DurationHours>3</DurationHours>
    <IsApproved>true</IsApproved>
    <PTOCode>sample string 1</PTOCode>
    <RequestDate xmlns:d3p1="http://schemas.datacontract.org/2004/07/EntireOne.Shared.Dates">
      <d3p1:Year>1</d3p1:Year>
      <d3p1:Month>2</d3p1:Month>
      <d3p1:Day>3</d3p1:Day>
    </RequestDate>
    <RequestNotes>sample string 4</RequestNotes>
    <StartTime>2026-05-02T14:25:35.3102599-04:00</StartTime>
    <SubmittedOn>2026-05-02T14:25:35.3102599-04:00</SubmittedOn>
    <UtcOffsetMinutes>1</UtcOffsetMinutes>
  </EmployeePTORequestImportDTO>
  <EmployeePTORequestImportDTO>
    <CompanyCode>sample string 8</CompanyCode>
    <DivisionCode>sample string 7</DivisionCode>
    <EmployeeNumber>sample string 6</EmployeeNumber>
    <EmployeePersonalId>1</EmployeePersonalId>
    <DurationHours>3</DurationHours>
    <IsApproved>true</IsApproved>
    <PTOCode>sample string 1</PTOCode>
    <RequestDate xmlns:d3p1="http://schemas.datacontract.org/2004/07/EntireOne.Shared.Dates">
      <d3p1:Year>1</d3p1:Year>
      <d3p1:Month>2</d3p1:Month>
      <d3p1:Day>3</d3p1:Day>
    </RequestDate>
    <RequestNotes>sample string 4</RequestNotes>
    <StartTime>2026-05-02T14:25:35.3102599-04:00</StartTime>
    <SubmittedOn>2026-05-02T14:25:35.3102599-04:00</SubmittedOn>
    <UtcOffsetMinutes>1</UtcOffsetMinutes>
  </EmployeePTORequestImportDTO>
</ArrayOfEmployeePTORequestImportDTO>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

The result of the import.

ImportResultDTO

Name	Type	Additional information
NewRecords	integer	None.
UpdatedRecords	integer	None.
Errors	Collection of ImportErrorDTO	None.
NewRecordKeys	Collection of ImportKeyDTO	None.
UpdatedRecordKeys	Collection of ImportKeyDTO	None.
ImportKey	GlobalEntityKeyOfIImportSubmission	None.

Response Formats

application/json, text/json

Sample:

{
  "newRecords": 1,
  "updatedRecords": 2,
  "errors": [
    {
      "index": 1,
      "details": [
        {
          "propertyName": "sample string 1",
          "arrayIndex": 1,
          "errorMessages": [
            "sample string 1",
            "sample string 2"
          ]
        },
        {
          "propertyName": "sample string 1",
          "arrayIndex": 1,
          "errorMessages": [
            "sample string 1",
            "sample string 2"
          ]
        }
      ]
    },
    {
      "index": 1,
      "details": [
        {
          "propertyName": "sample string 1",
          "arrayIndex": 1,
          "errorMessages": [
            "sample string 1",
            "sample string 2"
          ]
        },
        {
          "propertyName": "sample string 1",
          "arrayIndex": 1,
          "errorMessages": [
            "sample string 1",
            "sample string 2"
          ]
        }
      ]
    }
  ],
  "newRecordKeys": [
    {
      "index": 1,
      "key": "sample string 2"
    },
    {
      "index": 1,
      "key": "sample string 2"
    }
  ],
  "updatedRecordKeys": [
    {
      "index": 1,
      "key": "sample string 2"
    },
    {
      "index": 1,
      "key": "sample string 2"
    }
  ],
  "importKey": "<empty>"
}

text/xml

Sample:

<ImportResultDTO xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BDBPayroll.Integration.Data.Models">
  <Errors>
    <ImportErrorDTO>
      <Details>
        <ImportErrorDetailsDTO>
          <ArrayIndex>1</ArrayIndex>
          <ErrorMessages xmlns:d6p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <d6p1:string>sample string 1</d6p1:string>
            <d6p1:string>sample string 2</d6p1:string>
          </ErrorMessages>
          <PropertyName>sample string 1</PropertyName>
        </ImportErrorDetailsDTO>
        <ImportErrorDetailsDTO>
          <ArrayIndex>1</ArrayIndex>
          <ErrorMessages xmlns:d6p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <d6p1:string>sample string 1</d6p1:string>
            <d6p1:string>sample string 2</d6p1:string>
          </ErrorMessages>
          <PropertyName>sample string 1</PropertyName>
        </ImportErrorDetailsDTO>
      </Details>
      <Index>1</Index>
    </ImportErrorDTO>
    <ImportErrorDTO>
      <Details>
        <ImportErrorDetailsDTO>
          <ArrayIndex>1</ArrayIndex>
          <ErrorMessages xmlns:d6p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <d6p1:string>sample string 1</d6p1:string>
            <d6p1:string>sample string 2</d6p1:string>
          </ErrorMessages>
          <PropertyName>sample string 1</PropertyName>
        </ImportErrorDetailsDTO>
        <ImportErrorDetailsDTO>
          <ArrayIndex>1</ArrayIndex>
          <ErrorMessages xmlns:d6p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <d6p1:string>sample string 1</d6p1:string>
            <d6p1:string>sample string 2</d6p1:string>
          </ErrorMessages>
          <PropertyName>sample string 1</PropertyName>
        </ImportErrorDetailsDTO>
      </Details>
      <Index>1</Index>
    </ImportErrorDTO>
  </Errors>
  <ImportKey xmlns:d2p1="http://schemas.datacontract.org/2004/07/BDBPayroll.Services.Data.Shared.Keys">
    <d2p1:_entityKey>
      <d2p1:_hasValue>false</d2p1:_hasValue>
      <d2p1:_value>00000000-0000-0000-0000-000000000000</d2p1:_value>
    </d2p1:_entityKey>
  </ImportKey>
  <NewRecordKeys>
    <ImportKeyDTO>
      <Index>1</Index>
      <Key>sample string 2</Key>
    </ImportKeyDTO>
    <ImportKeyDTO>
      <Index>1</Index>
      <Key>sample string 2</Key>
    </ImportKeyDTO>
  </NewRecordKeys>
  <NewRecords>1</NewRecords>
  <UpdatedRecordKeys>
    <ImportKeyDTO>
      <Index>1</Index>
      <Key>sample string 2</Key>
    </ImportKeyDTO>
    <ImportKeyDTO>
      <Index>1</Index>
      <Key>sample string 2</Key>
    </ImportKeyDTO>
  </UpdatedRecordKeys>
  <UpdatedRecords>2</UpdatedRecords>
</ImportResultDTO>