chore: import upstream snapshot with attribution

apps/sim/tools/sap_concur/create_purchase_request.ts

@@ -0,0 +1,115 @@
+import type { CreatePurchaseRequestParams, SapConcurProxyResponse } from '@/tools/sap_concur/types'
+import {
+  baseProxyBody,
+  SAP_CONCUR_PROXY_URL,
+  transformSapConcurProxyResponse,
+} from '@/tools/sap_concur/utils'
+import type { ToolConfig } from '@/tools/types'
+
+export const createPurchaseRequestTool: ToolConfig<
+  CreatePurchaseRequestParams,
+  SapConcurProxyResponse
+> = {
+  id: 'sap_concur_create_purchase_request',
+  name: 'SAP Concur Create Purchase Request',
+  description: 'Create a purchase request (POST /purchaserequest/v4/purchaserequests).',
+  version: '1.0.0',
+  params: {
+    datacenter: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description: 'Concur datacenter base URL (defaults to us.api.concursolutions.com)',
+    },
+    grantType: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description: 'OAuth grant type: client_credentials (default) or password',
+    },
+    clientId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Concur OAuth client ID',
+    },
+    clientSecret: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Concur OAuth client secret',
+    },
+    username: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description: 'Username (only for password grant)',
+    },
+    password: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description: 'Password (only for password grant)',
+    },
+    companyUuid: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description: 'Company UUID for multi-company access tokens',
+    },
+    body: {
+      type: 'json',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Purchase request payload',
+    },
+  },
+  request: {
+    url: SAP_CONCUR_PROXY_URL,
+    method: 'POST',
+    headers: () => ({ 'Content-Type': 'application/json' }),
+    body: (params) => ({
+      ...baseProxyBody(params),
+      path: `/purchaserequest/v4/purchaserequests`,
+      method: 'POST',
+      body: params.body,
+    }),
+  },
+  transformResponse: transformSapConcurProxyResponse,
+  outputs: {
+    status: { type: 'number', description: 'HTTP status code returned by Concur' },
+    data: {
+      type: 'json',
+      description: 'Created purchase request payload',
+      properties: {
+        id: {
+          type: 'string',
+          description: 'Identifier of the created purchase request',
+          optional: true,
+        },
+        uri: {
+          type: 'string',
+          description: 'Resource URI for the created purchase request',
+          optional: true,
+        },
+        errors: {
+          type: 'array',
+          description: 'Validation or processing errors returned by Concur',
+          optional: true,
+          items: {
+            type: 'json',
+            properties: {
+              errorCode: { type: 'string', description: 'Error code', optional: true },
+              errorMessage: { type: 'string', description: 'Error message', optional: true },
+              dataPath: {
+                type: 'string',
+                description: 'Path to the request data which has the error',
+                optional: true,
+              },
+            },
+          },
+        },
+      },
+    },
+  },
+}