Adds an ExpenseItem.
| Name | Description | Additional information |
|---|---|---|
| request | The ExpenseItem to add.
When adding a new ExpenseItem through the API, the following properties are required:
Id: Must be set to 0.
All Ids e.g. currencyId, reasonId must be valid. |
Define this parameter in the request body. |
{
"Id": 0,
"ReferenceNumber": "Ref234234",
"ExpenseSubCategoryId": 2123,
"ExpenseSubCategoryDescription": null,
"ParentId": 10,
"SplitItems": null,
"ClaimId": 1223,
"ClaimReasonId": 1,
"ClaimReasonInfo": "Claim Reason",
"CurrencyId": 1,
"CurrencySymbol": "£",
"CountryId": 1,
"ItemType": 1,
"Date": "2014-12-25T00:00:00",
"PrimaryItem": true,
"Returned": true,
"DisputeNotes": "Dispute Note",
"TempAllow": false,
"Corrected": false,
"ItemCheckerId": null,
"ItemCheckerTeamId": null,
"FloatId": 1,
"AdvanceDescription": null,
"TransactionId": 0,
"Quantity": 1.0,
"Net": 100.0,
"VAT": 10.0,
"Total": 100.0,
"AmountPayable": 100.0,
"VATNumber": "VAT34245",
"AccountCode": "Acc1637",
"BaseCurrency": 1,
"BaseCurrencyGlobal": 1,
"ForeignVAT": 10.0,
"ExchangeRate": 1.0,
"ExchangeRateGlobal": 2.0,
"ConvertedTotal": 10.0,
"GrandTotal": 50.0,
"GlobalTotal": 100.0,
"GrandTotalGlobal": 20.0,
"GrandTotalConverted": 0.0,
"GrandTotalNet": 10.0,
"GrandTotalVAT": 10.0,
"GrandTotalAmountPayable": 20.0,
"GrandTotalOther": 1,
"GrandTotalRemoteWorkers": 2,
"GrandTotalPersonalGuests": 5,
"UserSaysHasReceipts": true,
"NormalReceipt": true,
"ReceiptAttached": true,
"CarId": 1,
"VehicleDescription": null,
"MileageId": 1,
"JourneySteps": null,
"DistanceUom": 0,
"HomeToOfficeDeductionMethod": 1,
"NumPassengers": 2,
"Miles": 50.0,
"MileageBusiness": 1.0,
"MileagePersonal": 10.0,
"FuelLitresPersonal": 2,
"FuelLitresBusiness": 1,
"Attendees": "staff",
"NumStaff": 10,
"NumDirectors": 3,
"NumPersonalGuests": 3,
"NumRemoteWorkers": 5,
"NumOthers": 1,
"EventInHomeCity": false,
"Tip": 10.0,
"NumRooms": 1,
"NumNights": 1,
"HotelId": 1,
"HotelName": "California",
"Reason": "Expense Reason",
"Notes": "Notes",
"CompanyId": 1,
"CompanyName": "Dummy Company",
"FromId": 1,
"FromDescription": null,
"ToId": 1,
"ToDescription": null,
"AllowanceId": 1,
"AllowanceStartDate": "2014-12-25T00:00:00",
"AllowanceEndDate": "2014-12-25T00:00:00",
"AllowanceDeduction": 1.0,
"CostCentreBreakdowns": null,
"Flags": null,
"BlockedFlags": null,
"UserDefined": null,
"AddedAsMobileExpense": true,
"ESRAssignmentId": 1,
"ESRAssignmentDescription": null,
"ValidationProgress": 10,
"ValidationResults": null,
"Edited": false,
"Paid": false,
"OriginalExpenseId": 10,
"BankAccountId": 1,
"OperatorValidationProgress": 0,
"ExpenseActionOutcome": 0,
"MobileMetricDeviceId": null,
"WalletReceiptId": 0
}
<ExpenseItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Types"> <AccountCode>Acc1637</AccountCode> <AddedAsMobileExpense>true</AddedAsMobileExpense> <AdvanceDescription i:nil="true" /> <AllowanceDeduction>1</AllowanceDeduction> <AllowanceEndDate>2014-12-25T00:00:00</AllowanceEndDate> <AllowanceId>1</AllowanceId> <AllowanceStartDate>2014-12-25T00:00:00</AllowanceStartDate> <AmountPayable>100</AmountPayable> <Attendees>staff</Attendees> <BankAccountId>1</BankAccountId> <BaseCurrency>1</BaseCurrency> <BaseCurrencyGlobal>1</BaseCurrencyGlobal> <BlockedFlags i:nil="true" /> <CarId>1</CarId> <ClaimId>1223</ClaimId> <ClaimReasonId>1</ClaimReasonId> <ClaimReasonInfo>Claim Reason</ClaimReasonInfo> <CompanyId>1</CompanyId> <CompanyName>Dummy Company</CompanyName> <ConvertedTotal>10</ConvertedTotal> <Corrected>false</Corrected> <CostCentreBreakdowns xmlns:d2p1="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Types.Employees" i:nil="true" /> <CountryId>1</CountryId> <CurrencyId>1</CurrencyId> <CurrencySymbol>£</CurrencySymbol> <Date>2014-12-25T00:00:00</Date> <DisputeNotes>Dispute Note</DisputeNotes> <DistanceUom>Mile</DistanceUom> <ESRAssignmentDescription i:nil="true" /> <ESRAssignmentId>1</ESRAssignmentId> <Edited>false</Edited> <EventInHomeCity>false</EventInHomeCity> <ExchangeRate>1</ExchangeRate> <ExchangeRateGlobal>2</ExchangeRateGlobal> <ExpenseActionOutcome>Successs</ExpenseActionOutcome> <ExpenseSubCategoryDescription i:nil="true" /> <ExpenseSubCategoryId>2123</ExpenseSubCategoryId> <Flags i:nil="true" /> <FloatId>1</FloatId> <ForeignVAT>10</ForeignVAT> <FromDescription i:nil="true" /> <FromId>1</FromId> <FuelLitresBusiness>1</FuelLitresBusiness> <FuelLitresPersonal>2</FuelLitresPersonal> <GlobalTotal>100</GlobalTotal> <GrandTotal>50</GrandTotal> <GrandTotalAmountPayable>20</GrandTotalAmountPayable> <GrandTotalConverted>0</GrandTotalConverted> <GrandTotalGlobal>20</GrandTotalGlobal> <GrandTotalNet>10</GrandTotalNet> <GrandTotalOther>1</GrandTotalOther> <GrandTotalPersonalGuests>5</GrandTotalPersonalGuests> <GrandTotalRemoteWorkers>2</GrandTotalRemoteWorkers> <GrandTotalVAT>10</GrandTotalVAT> <HomeToOfficeDeductionMethod>CalculateHomeAndOfficeToLocationDiff</HomeToOfficeDeductionMethod> <HotelId>1</HotelId> <HotelName>California</HotelName> <Id>0</Id> <ItemCheckerId i:nil="true" /> <ItemCheckerTeamId i:nil="true" /> <ItemType>Cash</ItemType> <JourneySteps i:nil="true" /> <MileageBusiness>1</MileageBusiness> <MileageId>1</MileageId> <MileagePersonal>10</MileagePersonal> <Miles>50</Miles> <MobileMetricDeviceId i:nil="true" /> <Net>100</Net> <NormalReceipt>true</NormalReceipt> <Notes>Notes</Notes> <NumDirectors>3</NumDirectors> <NumNights>1</NumNights> <NumOthers>1</NumOthers> <NumPassengers>2</NumPassengers> <NumPersonalGuests>3</NumPersonalGuests> <NumRemoteWorkers>5</NumRemoteWorkers> <NumRooms>1</NumRooms> <NumStaff>10</NumStaff> <OperatorValidationProgress>Available</OperatorValidationProgress> <OriginalExpenseId>10</OriginalExpenseId> <Paid>false</Paid> <ParentId>10</ParentId> <PrimaryItem>true</PrimaryItem> <Quantity>1</Quantity> <Reason>Expense Reason</Reason> <ReceiptAttached>true</ReceiptAttached> <ReferenceNumber>Ref234234</ReferenceNumber> <Returned>true</Returned> <SplitItems i:nil="true" /> <TempAllow>false</TempAllow> <Tip>10</Tip> <ToDescription i:nil="true" /> <ToId>1</ToId> <Total>100</Total> <TransactionId>0</TransactionId> <UserDefined i:nil="true" /> <UserSaysHasReceipts>true</UserSaysHasReceipts> <VAT>10</VAT> <VATNumber>VAT34245</VATNumber> <ValidationProgress>InProgress</ValidationProgress> <VehicleDescription i:nil="true" /> <WalletReceiptId>0</WalletReceiptId> </ExpenseItem>
Sample not available.
{
"Item": {
"Id": 0,
"ReferenceNumber": "Ref234234",
"ExpenseSubCategoryId": 2123,
"ExpenseSubCategoryDescription": null,
"ParentId": 10,
"SplitItems": null,
"ClaimId": 1223,
"ClaimReasonId": 1,
"ClaimReasonInfo": "Claim Reason",
"CurrencyId": 1,
"CurrencySymbol": "£",
"CountryId": 1,
"ItemType": 1,
"Date": "2014-12-25T00:00:00",
"PrimaryItem": true,
"Returned": true,
"DisputeNotes": "Dispute Note",
"TempAllow": false,
"Corrected": false,
"ItemCheckerId": null,
"ItemCheckerTeamId": null,
"FloatId": 1,
"AdvanceDescription": null,
"TransactionId": 0,
"Quantity": 1.0,
"Net": 100.0,
"VAT": 10.0,
"Total": 100.0,
"AmountPayable": 100.0,
"VATNumber": "VAT34245",
"AccountCode": "Acc1637",
"BaseCurrency": 1,
"BaseCurrencyGlobal": 1,
"ForeignVAT": 10.0,
"ExchangeRate": 1.0,
"ExchangeRateGlobal": 2.0,
"ConvertedTotal": 10.0,
"GrandTotal": 50.0,
"GlobalTotal": 100.0,
"GrandTotalGlobal": 20.0,
"GrandTotalConverted": 0.0,
"GrandTotalNet": 10.0,
"GrandTotalVAT": 10.0,
"GrandTotalAmountPayable": 20.0,
"GrandTotalOther": 1,
"GrandTotalRemoteWorkers": 2,
"GrandTotalPersonalGuests": 5,
"UserSaysHasReceipts": true,
"NormalReceipt": true,
"ReceiptAttached": true,
"CarId": 1,
"VehicleDescription": null,
"MileageId": 1,
"JourneySteps": null,
"DistanceUom": 0,
"HomeToOfficeDeductionMethod": 1,
"NumPassengers": 2,
"Miles": 50.0,
"MileageBusiness": 1.0,
"MileagePersonal": 10.0,
"FuelLitresPersonal": 2,
"FuelLitresBusiness": 1,
"Attendees": "staff",
"NumStaff": 10,
"NumDirectors": 3,
"NumPersonalGuests": 3,
"NumRemoteWorkers": 5,
"NumOthers": 1,
"EventInHomeCity": false,
"Tip": 10.0,
"NumRooms": 1,
"NumNights": 1,
"HotelId": 1,
"HotelName": "California",
"Reason": "Expense Reason",
"Notes": "Notes",
"CompanyId": 1,
"CompanyName": "Dummy Company",
"FromId": 1,
"FromDescription": null,
"ToId": 1,
"ToDescription": null,
"AllowanceId": 1,
"AllowanceStartDate": "2014-12-25T00:00:00",
"AllowanceEndDate": "2014-12-25T00:00:00",
"AllowanceDeduction": 1.0,
"CostCentreBreakdowns": null,
"Flags": null,
"BlockedFlags": null,
"UserDefined": null,
"AddedAsMobileExpense": true,
"ESRAssignmentId": 1,
"ESRAssignmentDescription": null,
"ValidationProgress": 10,
"ValidationResults": null,
"Edited": false,
"Paid": false,
"OriginalExpenseId": 10,
"BankAccountId": 1,
"OperatorValidationProgress": 0,
"ExpenseActionOutcome": 0,
"MobileMetricDeviceId": null,
"WalletReceiptId": 0
},
"ResponseInformation": null
}
<ExpenseItemResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Responses">
<ResponseInformation i:nil="true" xmlns="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Common" />
<Item xmlns:d2p1="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Types" xmlns="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Common">
<d2p1:AccountCode>Acc1637</d2p1:AccountCode>
<d2p1:AddedAsMobileExpense>true</d2p1:AddedAsMobileExpense>
<d2p1:AdvanceDescription i:nil="true" />
<d2p1:AllowanceDeduction>1</d2p1:AllowanceDeduction>
<d2p1:AllowanceEndDate>2014-12-25T00:00:00</d2p1:AllowanceEndDate>
<d2p1:AllowanceId>1</d2p1:AllowanceId>
<d2p1:AllowanceStartDate>2014-12-25T00:00:00</d2p1:AllowanceStartDate>
<d2p1:AmountPayable>100</d2p1:AmountPayable>
<d2p1:Attendees>staff</d2p1:Attendees>
<d2p1:BankAccountId>1</d2p1:BankAccountId>
<d2p1:BaseCurrency>1</d2p1:BaseCurrency>
<d2p1:BaseCurrencyGlobal>1</d2p1:BaseCurrencyGlobal>
<d2p1:BlockedFlags i:nil="true" />
<d2p1:CarId>1</d2p1:CarId>
<d2p1:ClaimId>1223</d2p1:ClaimId>
<d2p1:ClaimReasonId>1</d2p1:ClaimReasonId>
<d2p1:ClaimReasonInfo>Claim Reason</d2p1:ClaimReasonInfo>
<d2p1:CompanyId>1</d2p1:CompanyId>
<d2p1:CompanyName>Dummy Company</d2p1:CompanyName>
<d2p1:ConvertedTotal>10</d2p1:ConvertedTotal>
<d2p1:Corrected>false</d2p1:Corrected>
<d2p1:CostCentreBreakdowns xmlns:d3p1="http://schemas.datacontract.org/2004/07/SpendManagementApi.Models.Types.Employees" i:nil="true" />
<d2p1:CountryId>1</d2p1:CountryId>
<d2p1:CurrencyId>1</d2p1:CurrencyId>
<d2p1:CurrencySymbol>£</d2p1:CurrencySymbol>
<d2p1:Date>2014-12-25T00:00:00</d2p1:Date>
<d2p1:DisputeNotes>Dispute Note</d2p1:DisputeNotes>
<d2p1:DistanceUom>Mile</d2p1:DistanceUom>
<d2p1:ESRAssignmentDescription i:nil="true" />
<d2p1:ESRAssignmentId>1</d2p1:ESRAssignmentId>
<d2p1:Edited>false</d2p1:Edited>
<d2p1:EventInHomeCity>false</d2p1:EventInHomeCity>
<d2p1:ExchangeRate>1</d2p1:ExchangeRate>
<d2p1:ExchangeRateGlobal>2</d2p1:ExchangeRateGlobal>
<d2p1:ExpenseActionOutcome>Successs</d2p1:ExpenseActionOutcome>
<d2p1:ExpenseSubCategoryDescription i:nil="true" />
<d2p1:ExpenseSubCategoryId>2123</d2p1:ExpenseSubCategoryId>
<d2p1:Flags i:nil="true" />
<d2p1:FloatId>1</d2p1:FloatId>
<d2p1:ForeignVAT>10</d2p1:ForeignVAT>
<d2p1:FromDescription i:nil="true" />
<d2p1:FromId>1</d2p1:FromId>
<d2p1:FuelLitresBusiness>1</d2p1:FuelLitresBusiness>
<d2p1:FuelLitresPersonal>2</d2p1:FuelLitresPersonal>
<d2p1:GlobalTotal>100</d2p1:GlobalTotal>
<d2p1:GrandTotal>50</d2p1:GrandTotal>
<d2p1:GrandTotalAmountPayable>20</d2p1:GrandTotalAmountPayable>
<d2p1:GrandTotalConverted>0</d2p1:GrandTotalConverted>
<d2p1:GrandTotalGlobal>20</d2p1:GrandTotalGlobal>
<d2p1:GrandTotalNet>10</d2p1:GrandTotalNet>
<d2p1:GrandTotalOther>1</d2p1:GrandTotalOther>
<d2p1:GrandTotalPersonalGuests>5</d2p1:GrandTotalPersonalGuests>
<d2p1:GrandTotalRemoteWorkers>2</d2p1:GrandTotalRemoteWorkers>
<d2p1:GrandTotalVAT>10</d2p1:GrandTotalVAT>
<d2p1:HomeToOfficeDeductionMethod>CalculateHomeAndOfficeToLocationDiff</d2p1:HomeToOfficeDeductionMethod>
<d2p1:HotelId>1</d2p1:HotelId>
<d2p1:HotelName>California</d2p1:HotelName>
<d2p1:Id>0</d2p1:Id>
<d2p1:ItemCheckerId i:nil="true" />
<d2p1:ItemCheckerTeamId i:nil="true" />
<d2p1:ItemType>Cash</d2p1:ItemType>
<d2p1:JourneySteps i:nil="true" />
<d2p1:MileageBusiness>1</d2p1:MileageBusiness>
<d2p1:MileageId>1</d2p1:MileageId>
<d2p1:MileagePersonal>10</d2p1:MileagePersonal>
<d2p1:Miles>50</d2p1:Miles>
<d2p1:MobileMetricDeviceId i:nil="true" />
<d2p1:Net>100</d2p1:Net>
<d2p1:NormalReceipt>true</d2p1:NormalReceipt>
<d2p1:Notes>Notes</d2p1:Notes>
<d2p1:NumDirectors>3</d2p1:NumDirectors>
<d2p1:NumNights>1</d2p1:NumNights>
<d2p1:NumOthers>1</d2p1:NumOthers>
<d2p1:NumPassengers>2</d2p1:NumPassengers>
<d2p1:NumPersonalGuests>3</d2p1:NumPersonalGuests>
<d2p1:NumRemoteWorkers>5</d2p1:NumRemoteWorkers>
<d2p1:NumRooms>1</d2p1:NumRooms>
<d2p1:NumStaff>10</d2p1:NumStaff>
<d2p1:OperatorValidationProgress>Available</d2p1:OperatorValidationProgress>
<d2p1:OriginalExpenseId>10</d2p1:OriginalExpenseId>
<d2p1:Paid>false</d2p1:Paid>
<d2p1:ParentId>10</d2p1:ParentId>
<d2p1:PrimaryItem>true</d2p1:PrimaryItem>
<d2p1:Quantity>1</d2p1:Quantity>
<d2p1:Reason>Expense Reason</d2p1:Reason>
<d2p1:ReceiptAttached>true</d2p1:ReceiptAttached>
<d2p1:ReferenceNumber>Ref234234</d2p1:ReferenceNumber>
<d2p1:Returned>true</d2p1:Returned>
<d2p1:SplitItems i:nil="true" />
<d2p1:TempAllow>false</d2p1:TempAllow>
<d2p1:Tip>10</d2p1:Tip>
<d2p1:ToDescription i:nil="true" />
<d2p1:ToId>1</d2p1:ToId>
<d2p1:Total>100</d2p1:Total>
<d2p1:TransactionId>0</d2p1:TransactionId>
<d2p1:UserDefined i:nil="true" />
<d2p1:UserSaysHasReceipts>true</d2p1:UserSaysHasReceipts>
<d2p1:VAT>10</d2p1:VAT>
<d2p1:VATNumber>VAT34245</d2p1:VATNumber>
<d2p1:ValidationProgress>InProgress</d2p1:ValidationProgress>
<d2p1:VehicleDescription i:nil="true" />
<d2p1:WalletReceiptId>0</d2p1:WalletReceiptId>
</Item>
</ExpenseItemResponse>