PUT api/v1/portals/{portalUid}/companies/{companyUid}/customer/import/requirements/process/{requirementGuid}

Request Information

URI Parameters

NameDescriptionTypeAdditional information
portalUid

globally unique identifier

Required

companyUid

globally unique identifier

Required

requirementGuid

globally unique identifier

Required

Body Parameters

ProcessedRequirement
NameDescriptionTypeAdditional information
IsProcessed

Has the requirement been processed

boolean

None.

ProcessedDate

When was it processed

date

None.

IsError

Was it processed correctly

boolean

None.

ErrorReason

If there was an error, what was is

string

None.

GeneratedVacancyRefNo

What is the generated referece number

string

None.

GeneratedVacancyOriginalId

The generated id in eclipse

integer

None.

GeneratedPlacementRefNo

The generated placement ref

string

None.

GeneratedPlacementOriginalId

The generated placement id

integer

None.

Request Formats

application/json, text/json

Sample:
{
  "IsProcessed": true,
  "ProcessedDate": "2025-10-27T13:55:16.6083185+00:00",
  "IsError": true,
  "ErrorReason": "sample string 4",
  "GeneratedVacancyRefNo": "sample string 5",
  "GeneratedVacancyOriginalId": 1,
  "GeneratedPlacementRefNo": "sample string 6",
  "GeneratedPlacementOriginalId": 1
}

application/xml, text/xml

Sample:
<ProcessedRequirement xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Eclipse.WebApi.Common.Models">
  <ErrorReason>sample string 4</ErrorReason>
  <GeneratedPlacementOriginalId>1</GeneratedPlacementOriginalId>
  <GeneratedPlacementRefNo>sample string 6</GeneratedPlacementRefNo>
  <GeneratedVacancyOriginalId>1</GeneratedVacancyOriginalId>
  <GeneratedVacancyRefNo>sample string 5</GeneratedVacancyRefNo>
  <IsError>true</IsError>
  <IsProcessed>true</IsProcessed>
  <ProcessedDate>2025-10-27T13:55:16.6083185+00:00</ProcessedDate>
</ProcessedRequirement>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

RequirementImportViewModel
NameDescriptionTypeAdditional information
Guid

Static generated guid

globally unique identifier

None.

RefNo

Vacnacy or placement reference number, if any

string

None.

VacancyOriginalId

The found vacancy id

integer

None.

PlacementOriginalId

The found placement id

integer

None.

Client

The client name or reference

string

None.

ClientGuid

The client guid

globally unique identifier

None.

ClientOriginalId

The clients original id

integer

None.

ClientContact

The client contact name or reference number

string

None.

ClientContactGuid

The client contact guid

globally unique identifier

None.

ClientContactOriginalId

The client contact original id

integer

None.

ClientSite

The client site name or reference number

string

None.

ClientSiteGuid

The client site guid

globally unique identifier

None.

ClientSiteOriginalId

The client sites original id

integer

None.

Candidate

The candidate name or reference number

string

None.

CandidateGuid

The candidate guid

globally unique identifier

None.

CandidateOriginalId

The candidates original id

integer

None.

JobTitle

The vacnacy job title

string

None.

Industry

The industry name or reference number

string

None.

IndustryGuid

The industry guid

globally unique identifier

None.

IndustryOriginalId

The original industry id

integer

None.

Discipline

The discipline name

string

None.

DisciplineGuid

The discipline guid

globally unique identifier

None.

DisciplineOriginalId

The discipline original id

integer

None.

Consultant1

The first consultant name

string

None.

Consultant1Guid

The first consultant guid

globally unique identifier

None.

Consultant1OriginalId

The first consultant original id

integer

None.

Consultant1Split

The first consultant split

decimal number

None.

Consultant2

The second consultant name

string

None.

Consultant2Guid

The second consultant guid

globally unique identifier

None.

Consultant2OriginalId

The second consultant original id

integer

None.

Consultant2Split

The second consultant split

decimal number

None.

Consultant3

The third consultant name

string

None.

Consultant3Guid

The third consultant guid

globally unique identifier

None.

Consultant3OriginalId

The third consultant original id

integer

None.

Consultant3Split

The third consultant split

decimal number

None.

Division

The default division

string

None.

PONumber

The po number to use

string

None.

StartDate

The start date of the rquirements

date

None.

EndDate

The end date of the requirements

date

None.

StartTime

The start time of the requirement

date

None.

EndTime

The end time of the requirement

date

None.

RateTemplate

The rate template to use

string

None.

RateName

The rate to use

string

None.

Pay

The pay value to use

decimal number

None.

Invoice

The invoice value to use

decimal number

None.

Units

The total number of units per requirement

decimal number

None.

IsPAYE

Is the the rate for PAYE

boolean

None.

IsRateUpdate

Should we perform a rate update

boolean

None.

CompanyGuid

Company to create the requirements in

globally unique identifier

None.

CompanyOriginalId

The original company id

integer

None.

UploadedBy

Who uploaded the request

string

None.

UploadedByGuid

Guid of the uploader

globally unique identifier

None.

UploadedByOriginalId

The id of the original uploader

integer

None.

UploadedDate

Date the request was uploaded

date

None.

IsProcessed

Has the request been processed

boolean

None.

ProcessedDate

Date the request was processed

date

None.

IsError

Did the processing result in an error

boolean

None.

ErrorReason

If is error, this is the error description

string

None.

GeneratedVacancyRefNo

If a vacancy was processed this is the reference number

string

None.

GeneratedVacancyOriginalId

The original id of the generated vacancy

integer

None.

GeneratedPlacementRefNo

If a placement was generated this is the reference number

string

None.

GeneratedPlacementOriginalId

The original id of the generated placement

integer

None.

Uid

The GUID.

globally unique identifier

None.

Links

The links.

Collection of Link

None.

DateUpdated

Last time the record was updated

date

None.

UpdatedBy

Who updated the record last

string

None.

Response Formats

application/json, text/json

Sample:
{
  "Guid": "e5fdaca3-d0c7-4f8f-b2df-87bd9b03d69a",
  "RefNo": "sample string 2",
  "VacancyOriginalId": 1,
  "PlacementOriginalId": 1,
  "Client": "sample string 3",
  "ClientGuid": "7b3af396-2fd1-4df2-828e-19dedaf51ba8",
  "ClientOriginalId": 1,
  "ClientContact": "sample string 4",
  "ClientContactGuid": "8924713a-c814-49bb-a4d9-e214b535ae5a",
  "ClientContactOriginalId": 1,
  "ClientSite": "sample string 5",
  "ClientSiteGuid": "c15eebca-7040-492b-aa87-6140180bee81",
  "ClientSiteOriginalId": 1,
  "Candidate": "sample string 6",
  "CandidateGuid": "b9c6e4f7-edbe-4c97-88f4-9d765c696538",
  "CandidateOriginalId": 1,
  "JobTitle": "sample string 7",
  "Industry": "sample string 8",
  "IndustryGuid": "ee2b710d-237e-45e1-afa2-a394b2377a0a",
  "IndustryOriginalId": 1,
  "Discipline": "sample string 9",
  "DisciplineGuid": "3a3227df-f0ee-47f8-9e71-cb90a2a0d9fa",
  "DisciplineOriginalId": 1,
  "Consultant1": "sample string 10",
  "Consultant1Guid": "bc55d84e-ea7c-4649-a3be-61402fa7c30c",
  "Consultant1OriginalId": 1,
  "Consultant1Split": 1.1,
  "Consultant2": "sample string 11",
  "Consultant2Guid": "c19e064b-f20c-4c50-a184-3d12c6fb89b9",
  "Consultant2OriginalId": 1,
  "Consultant2Split": 1.1,
  "Consultant3": "sample string 12",
  "Consultant3Guid": "05cbc16d-ba1c-4b70-982f-dc6798832700",
  "Consultant3OriginalId": 1,
  "Consultant3Split": 1.1,
  "Division": "sample string 13",
  "PONumber": "sample string 14",
  "StartDate": "2025-10-27T13:55:16.6083185+00:00",
  "EndDate": "2025-10-27T13:55:16.6083185+00:00",
  "StartTime": "2025-10-27T13:55:16.6083185+00:00",
  "EndTime": "2025-10-27T13:55:16.6083185+00:00",
  "RateTemplate": "sample string 15",
  "RateName": "sample string 16",
  "Pay": 1.1,
  "Invoice": 1.1,
  "Units": 1.1,
  "IsPAYE": true,
  "IsRateUpdate": true,
  "CompanyGuid": "19f0d093-cabc-4242-9f1c-0d1d6e57af5e",
  "CompanyOriginalId": 1,
  "UploadedBy": "sample string 20",
  "UploadedByGuid": "e242bf45-1df5-4d46-b69c-280b457f1d65",
  "UploadedByOriginalId": 1,
  "UploadedDate": "2025-10-27T13:55:16.6083185+00:00",
  "IsProcessed": true,
  "ProcessedDate": "2025-10-27T13:55:16.6083185+00:00",
  "IsError": true,
  "ErrorReason": "sample string 24",
  "GeneratedVacancyRefNo": "sample string 25",
  "GeneratedVacancyOriginalId": 1,
  "GeneratedPlacementRefNo": "sample string 26",
  "GeneratedPlacementOriginalId": 1,
  "Uid": "6ff2a55e-caf3-4d27-90f0-ecdf453bfc8d",
  "Links": [
    {
      "Href": "http://webapihelppage1.com",
      "Method": "sample string 2",
      "Rel": "sample string 3",
      "Title": "sample string 4",
      "Type": "sample string 5"
    },
    {
      "Href": "http://webapihelppage1.com",
      "Method": "sample string 2",
      "Rel": "sample string 3",
      "Title": "sample string 4",
      "Type": "sample string 5"
    }
  ],
  "DateUpdated": "2025-10-27T13:55:16.623945+00:00",
  "UpdatedBy": "sample string 28"
}

application/xml, text/xml

Sample:
<RequirementImportViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Eclipse.WebApi.Common.ViewModels">
  <DateUpdated>2025-10-27T13:55:16.623945+00:00</DateUpdated>
  <Links xmlns:d2p1="http://schemas.datacontract.org/2004/07/Eclipse.WebApi.Common.Models">
    <d2p1:Link>
      <d2p1:Href>http://webapihelppage1.com/</d2p1:Href>
      <d2p1:Method>sample string 2</d2p1:Method>
      <d2p1:Rel>sample string 3</d2p1:Rel>
      <d2p1:Title>sample string 4</d2p1:Title>
      <d2p1:Type>sample string 5</d2p1:Type>
    </d2p1:Link>
    <d2p1:Link>
      <d2p1:Href>http://webapihelppage1.com/</d2p1:Href>
      <d2p1:Method>sample string 2</d2p1:Method>
      <d2p1:Rel>sample string 3</d2p1:Rel>
      <d2p1:Title>sample string 4</d2p1:Title>
      <d2p1:Type>sample string 5</d2p1:Type>
    </d2p1:Link>
  </Links>
  <Uid>6ff2a55e-caf3-4d27-90f0-ecdf453bfc8d</Uid>
  <UpdatedBy>sample string 28</UpdatedBy>
  <Candidate>sample string 6</Candidate>
  <CandidateGuid>b9c6e4f7-edbe-4c97-88f4-9d765c696538</CandidateGuid>
  <CandidateOriginalId>1</CandidateOriginalId>
  <Client>sample string 3</Client>
  <ClientContact>sample string 4</ClientContact>
  <ClientContactGuid>8924713a-c814-49bb-a4d9-e214b535ae5a</ClientContactGuid>
  <ClientContactOriginalId>1</ClientContactOriginalId>
  <ClientGuid>7b3af396-2fd1-4df2-828e-19dedaf51ba8</ClientGuid>
  <ClientOriginalId>1</ClientOriginalId>
  <ClientSite>sample string 5</ClientSite>
  <ClientSiteGuid>c15eebca-7040-492b-aa87-6140180bee81</ClientSiteGuid>
  <ClientSiteOriginalId>1</ClientSiteOriginalId>
  <CompanyGuid>19f0d093-cabc-4242-9f1c-0d1d6e57af5e</CompanyGuid>
  <CompanyOriginalId>1</CompanyOriginalId>
  <Consultant1>sample string 10</Consultant1>
  <Consultant1Guid>bc55d84e-ea7c-4649-a3be-61402fa7c30c</Consultant1Guid>
  <Consultant1OriginalId>1</Consultant1OriginalId>
  <Consultant1Split>1.1</Consultant1Split>
  <Consultant2>sample string 11</Consultant2>
  <Consultant2Guid>c19e064b-f20c-4c50-a184-3d12c6fb89b9</Consultant2Guid>
  <Consultant2OriginalId>1</Consultant2OriginalId>
  <Consultant2Split>1.1</Consultant2Split>
  <Consultant3>sample string 12</Consultant3>
  <Consultant3Guid>05cbc16d-ba1c-4b70-982f-dc6798832700</Consultant3Guid>
  <Consultant3OriginalId>1</Consultant3OriginalId>
  <Consultant3Split>1.1</Consultant3Split>
  <Discipline>sample string 9</Discipline>
  <DisciplineGuid>3a3227df-f0ee-47f8-9e71-cb90a2a0d9fa</DisciplineGuid>
  <DisciplineOriginalId>1</DisciplineOriginalId>
  <Division>sample string 13</Division>
  <EndDate>2025-10-27T13:55:16.6083185+00:00</EndDate>
  <EndTime>2025-10-27T13:55:16.6083185+00:00</EndTime>
  <ErrorReason>sample string 24</ErrorReason>
  <GeneratedPlacementOriginalId>1</GeneratedPlacementOriginalId>
  <GeneratedPlacementRefNo>sample string 26</GeneratedPlacementRefNo>
  <GeneratedVacancyOriginalId>1</GeneratedVacancyOriginalId>
  <GeneratedVacancyRefNo>sample string 25</GeneratedVacancyRefNo>
  <Guid>e5fdaca3-d0c7-4f8f-b2df-87bd9b03d69a</Guid>
  <Industry>sample string 8</Industry>
  <IndustryGuid>ee2b710d-237e-45e1-afa2-a394b2377a0a</IndustryGuid>
  <IndustryOriginalId>1</IndustryOriginalId>
  <Invoice>1.1</Invoice>
  <IsError>true</IsError>
  <IsPAYE>true</IsPAYE>
  <IsProcessed>true</IsProcessed>
  <IsRateUpdate>true</IsRateUpdate>
  <JobTitle>sample string 7</JobTitle>
  <PONumber>sample string 14</PONumber>
  <Pay>1.1</Pay>
  <PlacementOriginalId>1</PlacementOriginalId>
  <ProcessedDate>2025-10-27T13:55:16.6083185+00:00</ProcessedDate>
  <RateName>sample string 16</RateName>
  <RateTemplate>sample string 15</RateTemplate>
  <RefNo>sample string 2</RefNo>
  <StartDate>2025-10-27T13:55:16.6083185+00:00</StartDate>
  <StartTime>2025-10-27T13:55:16.6083185+00:00</StartTime>
  <Units>1.1</Units>
  <UploadedBy>sample string 20</UploadedBy>
  <UploadedByGuid>e242bf45-1df5-4d46-b69c-280b457f1d65</UploadedByGuid>
  <UploadedByOriginalId>1</UploadedByOriginalId>
  <UploadedDate>2025-10-27T13:55:16.6083185+00:00</UploadedDate>
  <VacancyOriginalId>1</VacancyOriginalId>
</RequirementImportViewModel>