POST v1/imports/prior-hours?action={action}&allowSameFile={allowSameFile}

Import Prior Hours

Request Information

URI Parameters

Name	Description	Type	Additional information
action	The import action.	ImportAction	Default value is Insert
allowSameFile	Determines if the import allows the content to be imported multiple times	boolean	Default value is True

Body Parameters

The items to import.

Collection of PriorHoursImportDTO

Name	Type	Additional information
Code	string	Required
Hours	decimal number	None.
In1	FixedDateTime	None.
In2	FixedDateTime	None.
Out1	FixedDateTime	None.
Out2	FixedDateTime	None.
ChargeDate	date	None.
Memo	string	None.
InternalMemo	string	None.
EarningShiftCode	string	None.
EarningCostCenter1Code	string	None.
EarningCostCenter2Code	string	None.
EarningCostCenter3Code	string	None.
EarningCostCenter4Code	string	None.
EarningCostCenter5Code	string	None.
EarningJobCode	string	None.
EmployeeNumber	string	None.
EmployeePersonalId	integer	None.
CheckPeriodBegin	date	None.
CheckPeriodEnd	date	None.
PayNumber	integer	None.
CheckNumber	integer	None.
VoucherNumber	integer	None.
StubMessage	string	None.
PayrollPeriodBegin	date	None.
PayrollPeriodEnd	date	None.
SerializablePayrollKey	globally unique identifier	None.
CheckDate	date	None.
RunNumber	integer	None.
DivisionCode	string	None.
CompanyCode	string	Required

Request Formats

application/json, text/json

Sample:

[
  {
    "code": "sample string 1",
    "hours": 2.0,
    "in1": "0001-02-03T09:05:06.007Z",
    "in2": "0001-02-03T09:05:06.007Z",
    "out1": "0001-02-03T09:05:06.007Z",
    "out2": "0001-02-03T09:05:06.007Z",
    "chargeDate": "0001-02-03",
    "memo": "sample string 3",
    "internalMemo": "sample string 4",
    "earningShiftCode": "sample string 5",
    "earningCostCenter1Code": "sample string 6",
    "earningCostCenter2Code": "sample string 7",
    "earningCostCenter3Code": "sample string 8",
    "earningCostCenter4Code": "sample string 9",
    "earningCostCenter5Code": "sample string 10",
    "earningJobCode": "sample string 11",
    "employeeNumber": "sample string 12",
    "employeePersonalId": 1,
    "checkPeriodBegin": "0001-02-03",
    "checkPeriodEnd": "0001-02-03",
    "payNumber": 13,
    "checkNumber": 14,
    "voucherNumber": 1,
    "stubMessage": "sample string 15",
    "payrollPeriodBegin": "0001-02-03",
    "payrollPeriodEnd": "0001-02-03",
    "serializablePayrollKey": "9c126e24-481e-47c5-b829-8326952aedf5",
    "payrollKey": "9c126e24-481e-47c5-b829-8326952aedf5",
    "checkDate": "0001-02-03",
    "runNumber": 1,
    "divisionCode": "sample string 16",
    "companyCode": "sample string 17"
  },
  {
    "code": "sample string 1",
    "hours": 2.0,
    "in1": "0001-02-03T09:05:06.007Z",
    "in2": "0001-02-03T09:05:06.007Z",
    "out1": "0001-02-03T09:05:06.007Z",
    "out2": "0001-02-03T09:05:06.007Z",
    "chargeDate": "0001-02-03",
    "memo": "sample string 3",
    "internalMemo": "sample string 4",
    "earningShiftCode": "sample string 5",
    "earningCostCenter1Code": "sample string 6",
    "earningCostCenter2Code": "sample string 7",
    "earningCostCenter3Code": "sample string 8",
    "earningCostCenter4Code": "sample string 9",
    "earningCostCenter5Code": "sample string 10",
    "earningJobCode": "sample string 11",
    "employeeNumber": "sample string 12",
    "employeePersonalId": 1,
    "checkPeriodBegin": "0001-02-03",
    "checkPeriodEnd": "0001-02-03",
    "payNumber": 13,
    "checkNumber": 14,
    "voucherNumber": 1,
    "stubMessage": "sample string 15",
    "payrollPeriodBegin": "0001-02-03",
    "payrollPeriodEnd": "0001-02-03",
    "serializablePayrollKey": "9c126e24-481e-47c5-b829-8326952aedf5",
    "payrollKey": "9c126e24-481e-47c5-b829-8326952aedf5",
    "checkDate": "0001-02-03",
    "runNumber": 1,
    "divisionCode": "sample string 16",
    "companyCode": "sample string 17"
  }
]

text/xml

Sample:

<ArrayOfPriorHoursImportDTO xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BDBPayroll.Integration.ServiceContracts.Data.Models">
  <PriorHoursImportDTO>
    <CompanyCode>sample string 17</CompanyCode>
    <DivisionCode>sample string 16</DivisionCode>
    <CheckDate 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>
    </CheckDate>
    <PayrollKey xmlns:d3p1="http://schemas.datacontract.org/2004/07/BDBPayroll.Services.Data.Shared.Keys">
      <d3p1:_entityKey>
        <d3p1:_hasValue>true</d3p1:_hasValue>
        <d3p1:_value>9c126e24-481e-47c5-b829-8326952aedf5</d3p1:_value>
      </d3p1:_entityKey>
    </PayrollKey>
    <RunNumber>1</RunNumber>
    <SerializablePayrollKey>9c126e24-481e-47c5-b829-8326952aedf5</SerializablePayrollKey>
    <PayrollPeriodBegin 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>
    </PayrollPeriodBegin>
    <PayrollPeriodEnd 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>
    </PayrollPeriodEnd>
    <CheckNumber>14</CheckNumber>
    <CheckPeriodBegin 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>
    </CheckPeriodBegin>
    <CheckPeriodEnd 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>
    </CheckPeriodEnd>
    <EmployeeNumber>sample string 12</EmployeeNumber>
    <EmployeePersonalId>1</EmployeePersonalId>
    <PayNumber>13</PayNumber>
    <StubMessage>sample string 15</StubMessage>
    <VoucherNumber>1</VoucherNumber>
    <ChargeDate 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>
    </ChargeDate>
    <Code>sample string 1</Code>
    <EarningCostCenter1Code>sample string 6</EarningCostCenter1Code>
    <EarningCostCenter2Code>sample string 7</EarningCostCenter2Code>
    <EarningCostCenter3Code>sample string 8</EarningCostCenter3Code>
    <EarningCostCenter4Code>sample string 9</EarningCostCenter4Code>
    <EarningCostCenter5Code>sample string 10</EarningCostCenter5Code>
    <EarningJobCode>sample string 11</EarningJobCode>
    <EarningShiftCode>sample string 5</EarningShiftCode>
    <Hours>2</Hours>
    <In1 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>
      <d3p1:Hour>4</d3p1:Hour>
      <d3p1:Minute>5</d3p1:Minute>
      <d3p1:Second>6</d3p1:Second>
      <d3p1:Milisecond>7</d3p1:Milisecond>
    </In1>
    <In2 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>
      <d3p1:Hour>4</d3p1:Hour>
      <d3p1:Minute>5</d3p1:Minute>
      <d3p1:Second>6</d3p1:Second>
      <d3p1:Milisecond>7</d3p1:Milisecond>
    </In2>
    <InternalMemo>sample string 4</InternalMemo>
    <Memo>sample string 3</Memo>
    <Out1 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>
      <d3p1:Hour>4</d3p1:Hour>
      <d3p1:Minute>5</d3p1:Minute>
      <d3p1:Second>6</d3p1:Second>
      <d3p1:Milisecond>7</d3p1:Milisecond>
    </Out1>
    <Out2 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>
      <d3p1:Hour>4</d3p1:Hour>
      <d3p1:Minute>5</d3p1:Minute>
      <d3p1:Second>6</d3p1:Second>
      <d3p1:Milisecond>7</d3p1:Milisecond>
    </Out2>
  </PriorHoursImportDTO>
  <PriorHoursImportDTO>
    <CompanyCode>sample string 17</CompanyCode>
    <DivisionCode>sample string 16</DivisionCode>
    <CheckDate 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>
    </CheckDate>
    <PayrollKey xmlns:d3p1="http://schemas.datacontract.org/2004/07/BDBPayroll.Services.Data.Shared.Keys">
      <d3p1:_entityKey>
        <d3p1:_hasValue>true</d3p1:_hasValue>
        <d3p1:_value>9c126e24-481e-47c5-b829-8326952aedf5</d3p1:_value>
      </d3p1:_entityKey>
    </PayrollKey>
    <RunNumber>1</RunNumber>
    <SerializablePayrollKey>9c126e24-481e-47c5-b829-8326952aedf5</SerializablePayrollKey>
    <PayrollPeriodBegin 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>
    </PayrollPeriodBegin>
    <PayrollPeriodEnd 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>
    </PayrollPeriodEnd>
    <CheckNumber>14</CheckNumber>
    <CheckPeriodBegin 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>
    </CheckPeriodBegin>
    <CheckPeriodEnd 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>
    </CheckPeriodEnd>
    <EmployeeNumber>sample string 12</EmployeeNumber>
    <EmployeePersonalId>1</EmployeePersonalId>
    <PayNumber>13</PayNumber>
    <StubMessage>sample string 15</StubMessage>
    <VoucherNumber>1</VoucherNumber>
    <ChargeDate 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>
    </ChargeDate>
    <Code>sample string 1</Code>
    <EarningCostCenter1Code>sample string 6</EarningCostCenter1Code>
    <EarningCostCenter2Code>sample string 7</EarningCostCenter2Code>
    <EarningCostCenter3Code>sample string 8</EarningCostCenter3Code>
    <EarningCostCenter4Code>sample string 9</EarningCostCenter4Code>
    <EarningCostCenter5Code>sample string 10</EarningCostCenter5Code>
    <EarningJobCode>sample string 11</EarningJobCode>
    <EarningShiftCode>sample string 5</EarningShiftCode>
    <Hours>2</Hours>
    <In1 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>
      <d3p1:Hour>4</d3p1:Hour>
      <d3p1:Minute>5</d3p1:Minute>
      <d3p1:Second>6</d3p1:Second>
      <d3p1:Milisecond>7</d3p1:Milisecond>
    </In1>
    <In2 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>
      <d3p1:Hour>4</d3p1:Hour>
      <d3p1:Minute>5</d3p1:Minute>
      <d3p1:Second>6</d3p1:Second>
      <d3p1:Milisecond>7</d3p1:Milisecond>
    </In2>
    <InternalMemo>sample string 4</InternalMemo>
    <Memo>sample string 3</Memo>
    <Out1 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>
      <d3p1:Hour>4</d3p1:Hour>
      <d3p1:Minute>5</d3p1:Minute>
      <d3p1:Second>6</d3p1:Second>
      <d3p1:Milisecond>7</d3p1:Milisecond>
    </Out1>
    <Out2 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>
      <d3p1:Hour>4</d3p1:Hour>
      <d3p1:Minute>5</d3p1:Minute>
      <d3p1:Second>6</d3p1:Second>
      <d3p1:Milisecond>7</d3p1:Milisecond>
    </Out2>
  </PriorHoursImportDTO>
</ArrayOfPriorHoursImportDTO>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

The results 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>