# CO_EDI_PAYM_ADV_NOTIFIC_OUT

**SOAP v1.0.0 — ACTIVE**

## Title / 标题
**Payment Advice - Send / 付款通知 - 发送**

## Operation / 操作
`PaymentAdviceSend`

---

## Description / 描述
This service sends payment advice notifications to business partners, detailing outgoing payments, clearing information, and remittance data.

该服务向业务合作伙伴发送付款通知，详细说明付款、清账信息和汇款数据。

---

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

## Message Structure / 消息结构

### Request / 请求
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `PaymentAdvice` | `PAYM_ADV` | Payment advice header | 付款通知抬头 |
| `– CompanyCode` | `CHAR(4)` | Company code | 公司代码 |
| `– Vendor` | `CHAR(10)` | Vendor account number | 供应商账户 |
| `– PaymentDate` | `DATE` | Date of payment | 付款日期 |
| `– PaymentMethod` | `CHAR(1)` | Payment method | 付款方式 |
| `– Amount` | `DECIMAL` | Payment amount in document currency | 凭证货币金额 |
| `– Currency` | `CUKY(5)` | Document currency | 凭证货币 |
| `ClearingItems` | Table | Cleared invoice items | 已清账发票项目 |
| `– InvoiceNo` | `CHAR(10)` | Invoice document number | 发票凭证编号 |
| `– FiscalYear` | `NUMC(4)` | Fiscal year | 会计年度 |
| `– ClearingAmount` | `DECIMAL` | Amount cleared | 清账金额 |

### Response / 响应
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `Return` | `BAPIRETURN` | Application log message | 应用程序日志消息 |
| `– Type` | `CHAR(1)` | Message type (S/E/W/I) | 消息类型（成功/错误/警告/信息） |
| `– Message` | `CHAR(220)` | Message text | 消息文本 |

---

## Example Request / 请求示例
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <PaymentAdviceSend>
      <PaymentAdvice>
        <CompanyCode>1000</CompanyCode>
        <Vendor>0000501234</Vendor>
        <PaymentDate>2026-07-23</PaymentDate>
        <PaymentMethod>C</PaymentMethod>
        <Amount>15000.00</Amount>
        <Currency>CNY</Currency>
      </PaymentAdvice>
      <ClearingItems>
        <item>
          <InvoiceNo>5100000001</InvoiceNo>
          <FiscalYear>2026</FiscalYear>
          <ClearingAmount>15000.00</ClearingAmount>
        </item>
      </ClearingItems>
    </PaymentAdviceSend>
  </soap:Body>
</soap:Envelope>
```

## Example Response / 响应示例
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <PaymentAdviceSendResponse>
      <Return>
        <Type>S</Type>
        <Message>Payment advice sent successfully / 付款通知已成功发送</Message>
      </Return>
    </PaymentAdviceSendResponse>
  </soap:Body>
</soap:Envelope>
```

---

## Error Codes / 错误代码
| Code | Description (EN) | Description (CN) |
|------|------------------|------------------|
| PAY_001 | Vendor not found | 供应商未找到 |
| PAY_002 | Invalid company code | 无效的公司代码 |
| PAY_003 | Payment amount exceeds invoice total | 付款金额超过发票总额 |
| PAY_004 | Communication failure | 通信失败 |

---

## Notes / 备注
- Ensure vendor master data is up-to-date before sending / 发送前确保供应商主数据为最新
- Maximum 100 clearing items per request / 每个请求最多100个清账项目
- Timeout: 60 seconds / 超时时间：60秒