This template is designed to guide integration architects and developers in documenting all required information for an interface. Each section includes a short explanation (tooltip) and example values to clarify usage.

Lifecycle & Changes

Historical context and milestones.

Status	Active
Created	2025-01-01
Updated	2025-05-01 – linked to O2C

Integration Description

What is this interface about? Who uses it and for what purpose?

Summary

This integration creates the purchase order in 11VMS when the Shopping Cart is approved in SAP SRM7

Use Case Reference

Overview

Basic metadata and lifecycle of the interface.

Smart ID/Legacy IDs	PROC-SRM7-11VMS-PURCHASE-ORDER-V1
Artefact(s)	API proxy(s) 11VMSProxy_V2
LeanIX Fact Sheet(s)
Service Pool / Process / Domain	Procurement Data
Integration Style	Application Integration
Data Volume	Low - 1,000 per day
Frequency	Batch running on SAP SRM7
Source System	SAP SRM7
Source Protocol	REST
Source Data Format	JSON
Source Authentication mechanism	OAuth2
Target System	11VMS
Target Protocol	REST
Target Data Format	JSON
Target Authentication mechanism	OAuth2
SLA	Go to Source and Target Application in LeanIX and look at Business Criticality and Functional Fit section
Version	V2

Functional Requirements & Rules

Integration Flow

Technical Components Involved

Detailed list of systems and middleware used.

Component Type	Name / Detail	Role / Description
Integration Flow	`N/A`	Executes logic
API Management	11VMSProxy_V2	Secures and routes requests
Event System	`N/A`	Publishes asynchronous events
File Gateway	`N/A`	For batch file interfaces
Monitoring	CPI Logs	Monitoring tools

Integration Design

Core interface behaviour and configuration.

Attribute	Description	Example
Direction	Data flow orientation	`Outbound`
Versioning Strategy	How interface versioning is managed	`URI`

Transformation

Link to Mapping Spreadsheet

Security & Access Control

Per-component security model.

Component	Authentication	Transport Security	Authorization	Notes
CPI	`OAuth2`	`HTTPS`	`Token Scopes`	Dedicated user
11 VMS	`OAuth2`	`HTTPS`	`Token Scopes`	Dedicated user

Error & Exception Handling

Resilience and error management.

Retry Logic	3x every 30s, exponential backoff
Dead Letter Queue	`N/A`
Alerting	SAP Cloud Alert Notification
Error Logging	CPI Logs

Monitoring & Runbook

How is the interface observed and troubleshooted.

Monitoring Tool
Runbook Location
Dashboard URL

Other Artefacts

Implementation assets.

Artefact	Notes
Git Repository
API Specification
Test Results

Step by Step Configuration

Related Interfaces

Grouped interfaces or dependencies.