POST api/Import/CustomImport/Upload

Upload a file to the custom importer

Request Information

URI Parameters

None.

Body Parameters

In request Body: File details

Name	Description	Type	Additional information
FileName	FileName with extension	string	Required
ImportFormat	Custom Import Name	string	Required
DateCreated		date	Nullable
ImportStatus		integer	None.
DateImported		date	Nullable
Detail		string	None.
Rows		integer	Nullable
Progress		integer	Nullable
DateImportStarted		date	Nullable
DateImportFinished		date	Nullable
Disabled		boolean	None.
ImportFormatVersion		date	Nullable
IsPartial		boolean	None.
Guid		globally unique identifier	Nullable
FileData	Byte Array of file data - used in import	Collection of byte	None.
DocumentId		globally unique identifier	None.
PayrollId		globally unique identifier	Nullable
SheetIds		Collection of globally unique identifier	Nullable

Request Formats

application/json, text/json

Sample:

{
  "FileName": "sample string 1",
  "ImportFormat": "sample string 2",
  "DateCreated": "2025-06-07T14:11:53.7431239+01:00",
  "ImportStatus": 3,
  "DateImported": "2025-06-07T14:11:53.7431239+01:00",
  "Detail": "sample string 4",
  "Rows": 1,
  "Progress": 1,
  "DateImportStarted": "2025-06-07T14:11:53.7431239+01:00",
  "DateImportFinished": "2025-06-07T14:11:53.7431239+01:00",
  "Disabled": true,
  "ImportFormatVersion": "2025-06-07T14:11:53.7431239+01:00",
  "IsPartial": true,
  "Guid": "9812a0c8-3760-4a8c-b4f7-7aaa3b90d41c",
  "FileData": "QEA=",
  "DocumentId": "f2cad89a-8a83-464d-ad71-2eeb88df7cde",
  "PayrollId": "db566707-9e46-440b-892d-3928d9e82df9",
  "SheetIds": [
    "85f2858d-e1d0-4246-9216-d59525a46c75",
    "44169f4d-1e06-4129-8325-21e1d814fce0"
  ]
}

application/xml, text/xml

Sample:

<ImportDetail xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/WebServicesRESTful.Models">
  <DateCreated>2025-06-07T14:11:53.7431239+01:00</DateCreated>
  <DateImportFinished>2025-06-07T14:11:53.7431239+01:00</DateImportFinished>
  <DateImportStarted>2025-06-07T14:11:53.7431239+01:00</DateImportStarted>
  <DateImported>2025-06-07T14:11:53.7431239+01:00</DateImported>
  <Detail>sample string 4</Detail>
  <Disabled>true</Disabled>
  <DocumentId>f2cad89a-8a83-464d-ad71-2eeb88df7cde</DocumentId>
  <FileData>QEA=</FileData>
  <FileName>sample string 1</FileName>
  <Guid>9812a0c8-3760-4a8c-b4f7-7aaa3b90d41c</Guid>
  <ImportFormat>sample string 2</ImportFormat>
  <ImportFormatVersion>2025-06-07T14:11:53.7431239+01:00</ImportFormatVersion>
  <ImportStatus>3</ImportStatus>
  <IsPartial>true</IsPartial>
  <PayrollId>db566707-9e46-440b-892d-3928d9e82df9</PayrollId>
  <Progress>1</Progress>
  <Rows>1</Rows>
  <SheetIds xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:guid>85f2858d-e1d0-4246-9216-d59525a46c75</d2p1:guid>
    <d2p1:guid>44169f4d-1e06-4129-8325-21e1d814fce0</d2p1:guid>
  </SheetIds>
</ImportDetail>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Status message

ResultWithMessage

Name	Description	Type	Additional information
result	'OK', 'Error'	string	None.
message	Returns if result is Error	string	None.
returnValue		string	None.

Response Formats

application/json, text/json

Sample:

{
    "result": "OK"
}

{
    "result": "Error",
    "message": "Unable to save: the..."
}

application/xml, text/xml

Sample:

<ResultWithMessage>
    <result>OK</result>
</ResultWithMessage>

<ResultWithMessage>  
    <result>Error</result>
    <message>Unable to save: the...</message>
</ResultWithMessage>