# CO_PPKAB_ESR_JITCALL_NOTIF_OUT

**SOAP v1.0.0 — ACTIVE**

## Title / 标题
**JIT Call Notification / JIT呼叫通知**

## Operation / 操作
`JITCallNotification`

---

## Description / 描述
This service sends Just-In-Time (JIT) call notifications from SAP S/4HANA Cloud to external systems, providing real-time demand signals for production and supply chain synchronization.

该服务从 SAP S/4HANA Cloud 向外部系统发送即时（JIT）呼叫通知，提供实时需求信号以支持生产和供应链同步。

---

## Endpoint / 端点
| Environment | URL |
|-------------|-----|
| Production | `https://sap.example.com/sap/bc/srt/rfc/sap/CO_PPKAB_ESR_JITCALL_NOTIF_OUT` |
| Test | `https://sap-test.example.com/sap/bc/srt/rfc/sap/CO_PPKAB_ESR_JITCALL_NOTIF_OUT` |

## Message Structure / 消息结构

### Request / 请求
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `JITCallNotification` | `BAPIJITCALL` | JIT call notification header | JIT呼叫通知抬头 |
| `?Customer` | `CHAR(10)` | Customer number | 客户编号 |
| `?Plant` | `CHAR(4)` | Supplying plant | 供应工厂 |
| `?CallID` | `CHAR(35)` | JIT call identifier | JIT呼叫标识符 |
| `?CallType` | `CHAR(2)` | Call type (JI=JIT, JS=JIS) | 呼叫类型（JI=JIT，JS=JIS） |
| `?CallDate` | `DATE` | Call creation date | 呼叫创建日期 |
| `?CallTime` | `TIME` | Call creation time | 呼叫创建时间 |
| `?DeliveryDate` | `DATE` | Requested delivery date | 要求交货日期 |
| `?SequenceNo` | `CHAR(6)` | Delivery sequence number | 交货顺序号 |
| `Items` | Table | JIT call items | JIT呼叫项目 |
| `?Material` | `CHAR(40)` | Material number | 物料编号 |
| `?Quantity` | `QUAN(13)` | Required quantity | 需求数量 |
| `?Unit` | `UNIT(3)` | Base unit of measure | 基本计量单位 |
| `?StorageLoc` | `CHAR(4)` | Storage location | 存储地点 |
| `?ProductionVersion` | `CHAR(4)` | Production version | 生产版本 |
| `?UsageFlag` | `CHAR(1)` | Usage flag (N=new, C=change, D=delete) | 使用标志（N=新增，C=变更，D=删除） |

### Response / 响应
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `Return` | `BAPIRETURN` | Application log message | 应用程序日志消息 |
| `?Type` | `CHAR(1)` | Message type (S/E/W/I) | 消息类型（成功/错误/警告/信息） |
| `?Code` | `CHAR(20)` | Message code | 消息代码 |
| `?Message` | `CHAR(220)` | Message text | 消息文本 |
| `AckStatus` | `CHAR(1)` | Acknowledgment status (A=acked, P=pending) | 确认状态（A=已确认，P=待定） |

---

## Example Payload / 示例负载

### Request
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <JITCallNotification>
      <Customer>CUST-5000</Customer>
      <Plant>PL01</Plant>
      <CallID>JIT-20260723-001</CallID>
      <CallType>JI</CallType>
      <CallDate>2026-07-23</CallDate>
      <CallTime>08:30:00</CallTime>
      <DeliveryDate>2026-07-25</DeliveryDate>
      <SequenceNo>000001</SequenceNo>
      <Items>
        <item>
          <Material>WHEEL-ASSY-001</Material>
          <Quantity>200</Quantity>
          <Unit>PC</Unit>
          <StorageLoc>FG01</StorageLoc>
          <UsageFlag>N</UsageFlag>
        </item>
        <item>
          <Material>BRAKE-ASSY-002</Material>
          <Quantity>150</Quantity>
          <Unit>PC</Unit>
          <StorageLoc>FG01</StorageLoc>
          <UsageFlag>N</UsageFlag>
        </item>
      </Items>
    </JITCallNotification>
  </soap:Body>
</soap:Envelope>
```

### Response
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <JITCallNotificationResponse>
      <Return>
        <Type>S</Type>
        <Code>JIT_001</Code>
        <Message>JIT call received successfully / JIT呼叫已成功接收</Message>
      </Return>
      <AckStatus>A</AckStatus>
    </JITCallNotificationResponse>
  </soap:Body>
</soap:Envelope>
```

---

## Error Codes / 错误代码
| Code | Description (EN) | Description (CN) |
|------|------------------|------------------|
| `JIT_001` | Invalid customer number | 无效的客户编号 |
| `JIT_002` | Material not released for JIT | 物料未发布用于JIT |
| `JIT_003` | Duplicate call ID | 重复的呼叫ID |
| `JIT_004` | Delivery date is before call date | 交货日期早于呼叫日期 |

---

## Notes / 备注
- Usage flag N=new call, C=change to existing call, D=delete/cancel call / 使用标志 N=新呼叫，C=变更现有呼叫，D=删除/取消呼叫
- Sequence number determines delivery priority order / 顺序号决定交货优先级顺序
- JIS (Just-In-Sequence) calls include sequence information for assembly line ordering / JIS（同步排序）呼叫包括装配线排序的顺序信息