Re_Backend/docs/SAP_INTEGRATION_TESTING.md

SAP Integration Testing Guide

Postman Testing

1. Testing IO Validation API

Endpoint: GET /api/v1/dealer-claims/:requestId/io

Method: GET

Headers:

Authorization: Bearer <your_jwt_token>
Content-Type: application/json

Note: The CSRF error in Postman is likely coming from SAP, not our backend. Our backend doesn't have CSRF protection enabled.

2. Testing Budget Blocking API

Endpoint: PUT /api/v1/dealer-claims/:requestId/io

Method: PUT

Headers:

Authorization: Bearer <your_jwt_token>
Content-Type: application/json

Body:

{
  "ioNumber": "600060",
  "ioRemark": "Test remark",
  "availableBalance": 1000000,
  "blockedAmount": 500,
  "remainingBalance": 999500
}

3. Direct SAP API Testing in Postman

If you want to test SAP API directly (bypassing our backend):

IO Validation

• URL: https://RENOIHND01.Eichergroup.com:1443/sap/opu/odata/sap/ZFI_BUDGET_CHECK_API_SRV/GetSenderDataSet?$filter=IONumber eq '600060'&$select=Sender,ResponseDate,GetIODetailsSet01&$expand=GetIODetailsSet01&$format=json
• Method: GET
• Authentication: Basic Auth
  • Username: Your SAP username
  • Password: Your SAP password
• Headers:
  • Accept: application/json
  • Content-Type: application/json

Budget Blocking

• URL: https://RENOIHND01.Eichergroup.com:1443/sap/opu/odata/sap/ZFI_BUDGET_BLOCK_API_SRV/RequesterInputSet
• Method: POST
• Authentication: Basic Auth
  • Username: Your SAP username
  • Password: Your SAP password
• Headers:
  • Accept: application/json
  • Content-Type: application/json
• Body:

{
  "Request_Date_Time": "2025-08-29T10:51:00",
  "Requester": "REFMS",
  "lt_io_input": [
    {
      "IONumber": "600060",
      "Amount": "500"
    }
  ],
  "lt_io_output": [],
  "ls_response": []
}

Common Errors and Solutions

1. CSRF Token Validation Error

Error: "CSRF token validation error"

Possible Causes:

• SAP API requires CSRF tokens for POST/PUT requests
• SAP might be checking for specific headers

Solutions:

1. Get CSRF Token First:

   • Make a GET request to the SAP service root to get CSRF token
   • Example: GET https://RENOIHND01.Eichergroup.com:1443/sap/opu/odata/sap/ZFI_BUDGET_BLOCK_API_SRV/
   • Look for x-csrf-token header in response
   • Add this token to subsequent POST/PUT requests as header: X-CSRF-Token: <token>

2. Add Required Headers:

   X-CSRF-Token: Fetch
   X-Requested-With: XMLHttpRequest
   

2. Authentication Failed

Error: "Authentication failed" or "401 Unauthorized"

Possible Causes:

1. Wrong username/password
2. Basic auth not being sent correctly
3. SSL certificate issues
4. SAP account locked or expired

Solutions:

1. Verify Credentials:

   • Double-check SAP_USERNAME and SAP_PASSWORD in .env
   • Ensure no extra spaces or special characters
   • Test credentials in browser first

2. Check SSL Certificate:

   • If using self-signed certificate, set SAP_DISABLE_SSL_VERIFY=true in .env (testing only!)
   • For production, ensure proper SSL certificates are configured

3. Test Basic Auth Manually:

   • Use Postman with Basic Auth enabled
   • Verify the Authorization header format: Basic <base64(username:password)>

4. Check SAP Account Status:

   • Verify account is active and not locked
   • Check if password has expired
   • Contact SAP administrator if needed

3. Connection Errors

Error: "ECONNREFUSED" or "ENOTFOUND"

Solutions:

1. Verify SAP_BASE_URL is correct
2. Check network connectivity to SAP server
3. Ensure firewall allows connections to port 1443
4. Verify Zscaler is configured correctly

4. Timeout Errors

Error: "Request timeout"

Solutions:

1. Increase SAP_TIMEOUT_MS in .env (default: 30000ms = 30 seconds)
2. Check SAP server response time
3. Verify network latency

Debugging

Enable Debug Logging

Set log level to debug in your .env:

LOG_LEVEL=debug

This will log:

• Request URLs
• Request payloads
• Response status codes
• Response data
• Error details

Check Backend Logs

Look for [SAP] prefixed log messages:

# In development
npm run dev

# Check logs for SAP-related messages

Test SAP Connection

You can test if SAP is reachable:

curl -u "username:password" \
  "https://RENOIHND01.Eichergroup.com:1443/sap/opu/odata/sap/ZFI_BUDGET_CHECK_API_SRV/"

Environment Variables Checklist

Ensure these are set in your .env:

# Required
SAP_BASE_URL=https://RENOIHND01.Eichergroup.com:1443
SAP_USERNAME=your_username
SAP_PASSWORD=your_password

# Optional (with defaults)
SAP_TIMEOUT_MS=30000
SAP_SERVICE_NAME=ZFI_BUDGET_CHECK_API_SRV
SAP_BLOCK_SERVICE_NAME=ZFI_BUDGET_BLOCK_API_SRV
SAP_REQUESTER=REFMS
SAP_DISABLE_SSL_VERIFY=false  # Only for testing

Next Steps

If you're still getting errors:

1. Check Backend Logs: Look for detailed error messages
2. Test Directly in Postman: Bypass backend and test SAP API directly
3. Verify SAP Credentials: Test with SAP administrator
4. Check Network: Ensure server can reach SAP URL
5. Review SAP Documentation: Check if there are additional requirements