sap-concur-expense-report

SAP Concur Expense Reports

Server path: /sap-concur-expense-report | Type: Application | PCID required: Yes

Tools

Tool	Description
sap_concur_expense_report_get_reports	Gets all reports
sap_concur_expense_report_get_reports_id	Gets a single report
sap_concur_expense_report_post_reports	Create a new report
sap_concur_expense_report_put_reports_id	Update report

---

sap_concur_expense_report_get_reports

Gets all reports

Parameters:

Parameter	Type	Required	Default	Description
offset	string	No	—	Starting page offset
limit	integer	No	—	Number of records to return (default 25)
user	string	No	—	Optional. The login ID of the report owner(s) to use when searching for reports. If the value is set to LoginID, reports for the report owner with this login ID value are returned. If the value is set to ALL, reports for all report owners are returned. If this parameter is not specified, reports for the OAuth Consumer are returned. The access token owner (OAuth Consumer) must have the Web Services Admin role to use this parameter.
approvalStatusCode	string	No	—	The status code for the Approval Status. The values can include Concur Expense standard codes or custom codes. The Concur Expense standard code values are: A_AAFH - Report submission triggered an anomaly and fraud check; A_ACCO - Report is pending reviews; A_APPR - Report has been approved; A_EXTV - Report is pending external validation; A_FILE - Report has been submitted; A_NOTF - Report has not been submitted; A_PBDG - Report approval is pending Budget approval; A_PECO - Report approval is pending Cost object approval; A_PEND - Report is pending manager approval; A_PVAL - Report is pending prepayment validation; A_RESU - Report needs to be resubmitted; A_RHLD - Report submission is pending receipt images; A_TEXP - Report expired in approval queue. For custom codes, contact Concur Developer Support.
paymentStatusCode	string	No	—	The payment status code for the report. The values can include Concur Expense standard codes or custom codes. The Concur Expense standard code values are: P_HOLD - Report payment is on hold; P_NOTP - Report has not been paid; P_PAID - Report has been paid; P_PAYC - Payment is confirmed. Some or all of the report expenses have been paid; P_PROC - Report is in process to be paid. For custom codes, contact Concur Developer Support.
currencyCode	string	No	—	The 3-letter ISO 4217 currency code for the report currency. Example: USD.
paymentType	string	No	—	The unique identifier for the payment type that is the payment type for at least one expense entry in the report. Use PaymentTypeID from the “GET Expense Group Configurations” function.
reimbursementMethod	string	No	—	The method the report owner will be reimbursed. VALUES: ADPPAYR - ADP Payroll; APCHECK - AP (Company Check); CNQRPAY - Expense Pay; PMTSERV - Other Payment Service. NOTE: PAY_PAL is NOT supported.
approverLoginID	string	No	—	The login ID for the report approver that is the current approver assigned to the report.
expenseTypeCode	string	No	—	The expense type code that is the expense type for at least one expense entry in the report. Use ExpenseTypeCode from the “GET Expense Group Configurations” function.
attendeeTypeCode	string	No	—	The report contains expense entries that have attendees of the specified type.
countryCode	string	No	—	The report country. Maximum 2 characters. Format: The ISO 3166-1 alpha-2 country code. Example: United States is US.
batchID	string	No	—	The unique identifier for a payment batch where there is at least one report payee within the report. Use the BatchID from the “GET Payment Batch List” function.
vendorName	string	No	—	The Vendor Description that is the vendor for at least one expense entry in the report.
hasVAT	boolean	No	—	Determines if the report has at least one expense entry with VAT details. Format: true or false.
hasImages	boolean	No	—	Determines if the report has at least one expense entry with an entry image or if there is a report image for this report. Format: true or false.
hasAttendees	boolean	No	—	Determines if the report has at least one expense entry with an attendee. Format: true or false.
hasBillableExpenses	boolean	No	—	The IsBillable flag for at least one expense entry in the report. Format: true or false.
isTestUser	boolean	No	—	The report owner is a test user using the report for testing purposes in a non-production envirnment. format: true or false.
expenseGroupConfigID	string	No	—	The unique identifier for the expense group configuration associated to the report’s expense group. Use the ID from the “GET Expense Group Configurations” function.
entryTransactionDateBefore	string	No	—	The entry transaction date for at least one expense entry in the report is before this date.Format: YYYY-MM-DD
entryTransactionDateAfter	string	No	—	The entry transaction date for at least one expense entry in the report is after this date.Format: YYYY-MM-DD
createDateBefore	string	No	—	The report create date is before this date.Format: YYYY-MM-DD
createDateAfter	string	No	—	The report create date is after this date.Format: YYYY-MM-DD
userDefinedDateBefore	string	No	—	The report user defined date is before this date.Format: YYYY-MM-DD
userDefinedDateAfter	string	No	—	The report user defined date is after this date.Format: YYYY-MM-DD
submitDateBefore	string	No	—	The report submit date is before this date.Format: YYYY-MM-DD
submitDateAfter	string	No	—	The report submit date is after this date.Format: YYYY-MM-DD
processingPaymentDateBefore	string	No	—	The report processing payment date is before this date.Format: YYYY-MM-DD
processingPaymentDateAfter	string	No	—	The report processing payment date is after this date. Format: YYYY-MM-DD
paidDateBefore	string	No	—	The report paid date is before this date.Format: YYYY-MM-DD
paidDateAfter	string	No	—	The report paid date is after this date.Format: YYYY-MM-DD
modifiedDateBefore	string	No	—	The report modified date is before this date.Format: YYYY-MM-DD
modifiedDateAfter	string	No	—	The report modified date is after this date.Format: YYYY-MM-DD

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "offset": {
      "type": "string",
      "description": "Starting page offset"
    },
    "limit": {
      "type": "integer",
      "description": "Number of records to return (default 25)"
    },
    "user": {
      "type": "string",
      "description": "Optional. The login ID of the report owner(s) to use when searching for reports. If the value is set to LoginID, reports for the report owner with this login ID value are returned. If the value is set to ALL, reports for all report owners are returned. If this parameter is not specified, reports for the OAuth Consumer are returned. The access token owner (OAuth Consumer) must have the Web Services Admin role to use this parameter."
    },
    "approvalStatusCode": {
      "type": "string",
      "description": "The status code for the Approval Status. The values can include Concur Expense standard codes or custom codes. The Concur Expense standard code values are: A_AAFH - Report submission triggered an anomaly and fraud check; A_ACCO - Report is pending reviews; A_APPR - Report has been approved; A_EXTV - Report is pending external validation; A_FILE - Report has been submitted; A_NOTF - Report has not been submitted; A_PBDG - Report approval is pending Budget approval; A_PECO - Report approval is pending Cost object approval; A_PEND - Report is pending manager approval; A_PVAL - Report is pending prepayment validation; A_RESU - Report needs to be resubmitted; A_RHLD - Report submission is pending receipt images; A_TEXP - Report expired in approval queue. For custom codes, contact Concur Developer Support."
    },
    "paymentStatusCode": {
      "type": "string",
      "description": "The payment status code for the report. The values can include Concur Expense standard codes or custom codes. The Concur Expense standard code values are: P_HOLD - Report payment is on hold; P_NOTP - Report has not been paid; P_PAID - Report has been paid; P_PAYC - Payment is confirmed. Some or all of the report expenses have been paid; P_PROC - Report is in process to be paid. For custom codes, contact Concur Developer Support."
    },
    "currencyCode": {
      "type": "string",
      "description": "The 3-letter ISO 4217 currency code for the report currency. Example: USD."
    },
    "paymentType": {
      "type": "string",
      "description": "The unique identifier for the payment type that is the payment type for at least one expense entry in the report. Use PaymentTypeID from the \"GET Expense Group Configurations\" function."
    },
    "reimbursementMethod": {
      "type": "string",
      "description": "The method the report owner will be reimbursed. VALUES: ADPPAYR - ADP Payroll; APCHECK - AP (Company Check); CNQRPAY - Expense Pay; PMTSERV - Other Payment Service. NOTE: PAY_PAL is NOT supported."
    },
    "approverLoginID": {
      "type": "string",
      "description": "The login ID for the report approver that is the current approver assigned to the report."
    },
    "expenseTypeCode": {
      "type": "string",
      "description": "The expense type code that is the expense type for at least one expense entry in the report. Use ExpenseTypeCode from the \"GET Expense Group Configurations\" function."
    },
    "attendeeTypeCode": {
      "type": "string",
      "description": "The report contains expense entries that have attendees of the specified type."
    },
    "countryCode": {
      "type": "string",
      "description": "The report country. Maximum 2 characters. Format: The ISO 3166-1 alpha-2 country code. Example: United States is US."
    },
    "batchID": {
      "type": "string",
      "description": "The unique identifier for a payment batch where there is at least one report payee within the report. Use the BatchID from the \"GET Payment Batch List\" function."
    },
    "vendorName": {
      "type": "string",
      "description": "The Vendor Description that is the vendor for at least one expense entry in the report."
    },
    "hasVAT": {
      "type": "boolean",
      "description": "Determines if the report has at least one expense entry with VAT details. Format: true or false."
    },
    "hasImages": {
      "type": "boolean",
      "description": "Determines if the report has at least one expense entry with an entry image or if there is a report image for this report. Format: true or false."
    },
    "hasAttendees": {
      "type": "boolean",
      "description": "Determines if the report has at least one expense entry with an attendee. Format: true or false."
    },
    "hasBillableExpenses": {
      "type": "boolean",
      "description": "The IsBillable flag for at least one expense entry in the report. Format: true or false."
    },
    "isTestUser": {
      "type": "boolean",
      "description": "The report owner is a test user using the report for testing purposes in a non-production envirnment. format: true or false."
    },
    "expenseGroupConfigID": {
      "type": "string",
      "description": "The unique identifier for the expense group configuration associated to the report's expense group. Use the ID from the \"GET Expense Group Configurations\" function."
    },
    "entryTransactionDateBefore": {
      "type": "string",
      "description": "The entry transaction date for at least one expense entry in the report is before this date.Format: YYYY-MM-DD"
    },
    "entryTransactionDateAfter": {
      "type": "string",
      "description": "The entry transaction date for at least one expense entry in the report is after this date.Format: YYYY-MM-DD"
    },
    "createDateBefore": {
      "type": "string",
      "description": "The report create date is before this date.Format: YYYY-MM-DD"
    },
    "createDateAfter": {
      "type": "string",
      "description": "The report create date is after this date.Format: YYYY-MM-DD"
    },
    "userDefinedDateBefore": {
      "type": "string",
      "description": "The report user defined date is before this date.Format: YYYY-MM-DD"
    },
    "userDefinedDateAfter": {
      "type": "string",
      "description": "The report user defined date is after this date.Format: YYYY-MM-DD"
    },
    "submitDateBefore": {
      "type": "string",
      "description": "The report submit date is before this date.Format: YYYY-MM-DD"
    },
    "submitDateAfter": {
      "type": "string",
      "description": "The report submit date is after this date.Format: YYYY-MM-DD"
    },
    "processingPaymentDateBefore": {
      "type": "string",
      "description": "The report processing payment date is before this date.Format: YYYY-MM-DD"
    },
    "processingPaymentDateAfter": {
      "type": "string",
      "description": "The report processing payment date is after this date. Format: YYYY-MM-DD"
    },
    "paidDateBefore": {
      "type": "string",
      "description": "The report paid date is before this date.Format: YYYY-MM-DD"
    },
    "paidDateAfter": {
      "type": "string",
      "description": "The report paid date is after this date.Format: YYYY-MM-DD"
    },
    "modifiedDateBefore": {
      "type": "string",
      "description": "The report modified date is before this date.Format: YYYY-MM-DD"
    },
    "modifiedDateAfter": {
      "type": "string",
      "description": "The report modified date is after this date.Format: YYYY-MM-DD"
    }
  },
  "required": [
    "PCID"
  ]
}

---

sap_concur_expense_report_get_reports_id

Gets a single report

Parameters:

Parameter	Type	Required	Default	Description
id	string	Yes	—	Report ID
user	string	No	—	Optional. The login ID of the report owner(s) to use when searching for reports. If the value is set to LoginID, reports for the report owner with this login ID value are returned. If the value is set to ALL, reports for all report owners are returned. If this parameter is not specified, reports for the OAuth Consumer are returned. The access token owner (OAuth Consumer) must have the Web Services Admin role to use this parameter.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "Report ID"
    },
    "user": {
      "type": "string",
      "description": "Optional. The login ID of the report owner(s) to use when searching for reports. If the value is set to LoginID, reports for the report owner with this login ID value are returned. If the value is set to ALL, reports for all report owners are returned. If this parameter is not specified, reports for the OAuth Consumer are returned. The access token owner (OAuth Consumer) must have the Web Services Admin role to use this parameter."
    }
  },
  "required": [
    "PCID",
    "id"
  ]
}

---

sap_concur_expense_report_post_reports

Create a new report

Parameters:

Parameter	Type	Required	Default	Description
user	string	No	—	Optional. The login ID for the Report Owner.
body	object	Yes	—	Report object to create

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "user": {
      "type": "string",
      "description": "Optional. The login ID for the Report Owner."
    },
    "body": {
      "description": "Report object to create"
    }
  },
  "required": [
    "PCID",
    "body"
  ]
}

---

sap_concur_expense_report_put_reports_id

Update report

Parameters:

Parameter	Type	Required	Default	Description
id	string	Yes	—	The unique identifier for the report.
user	string	No	—	Optional. The login ID for the Report Owner.
body	object	Yes	—	The report object to update

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "The unique identifier for the report."
    },
    "user": {
      "type": "string",
      "description": "Optional. The login ID for the Report Owner."
    },
    "body": {
      "description": "The report object to update"
    }
  },
  "required": [
    "PCID",
    "id",
    "body"
  ]
}