---
# API: Payment Advice - Send Cancellation
# File: CO_EDI_PAYM_ADV_CANCEL_OUT.md
# Version: 1.0.0
# Status: ACTIVE
# Protocol: SOAP (Outbound)
# Source URL: https://api.sap.com/api/CO_EDI_PAYM_ADV_CANCEL_OUT/overview
# Generated: 2026-07-23 14:17:02
---

# Payment Advice - Send Cancellation / 付款通知 - 发送取消 API

> **API 版本:** 1.0.0 | **状态:** ACTIVE | **协议:** SOAP  
> **技术名称:** `CO_EDI_PAYM_ADV_CANCEL_OUT`  
> **WSDL 绑定:** `/sap/bc/srt/wsdl/flv_10002A111AD1/bndr_url/sap/bc/srt/rfc/sap/co_edi_paym_adv_cancel_out/100/co_edi_paym_adv_cancel_out/binding`  
> **SAP 通信场景:** `SAP_COM_0113`

## 概述 / Overview

该 SOAP 出站服务用于将付款通知取消信息从 SAP S/4HANA 发送到外部系统。支持付款通知的撤销、冲销和取消操作。

This SOAP outbound service sends payment advice cancellation information from SAP S/4HANA to external systems. It supports reversal, write-off, and cancellation of payment advices.

**API 业务加速器中心:** [https://api.sap.com/api/CO_EDI_PAYM_ADV_CANCEL_OUT/overview](https://api.sap.com/api/CO_EDI_PAYM_ADV_CANCEL_OUT/overview)

---

## 消息结构 / Message Structure

| # | 结构名称 | 描述 (EN) | 描述 (CN) |
|---|----------|-----------|-----------|
| 1 | `PaymentAdviceCancellationRequest` | Payment Advice Cancellation Request | 付款通知取消请求 |
| 2 | `PaymentAdviceCancellationResponse` | Payment Advice Cancellation Response | 付款通知取消响应 |

---

## 1. 请求结构: PaymentAdviceCancellationRequest / 付款通知取消请求

**命名空间:** `urn:sap-com:document:sap:soap:functions:mc-style`

| # | 字段名称 | 类型 | 描述 (EN) | 描述 (CN) | 必填 |
|---|----------|------|-----------|-----------|------|
| 1 | `PaymentAdviceNumber` | CHAR(16) | Payment Advice Number | 付款通知编号 | 是 |
| 2 | `CompanyCode` | CHAR(4) | Company Code | 公司代码 | 是 |
| 3 | `FiscalYear` | NUMC(4) | Fiscal Year | 会计年度 | 是 |
| 4 | `CancellationReason` | CHAR(2) | Cancellation Reason | 取消原因 | 是 |
| 5 | `CancellationDate` | DATE | Cancellation Date | 取消日期 | 是 |
| 6 | `ReferenceDocument` | CHAR(16) | Reference Document | 参考凭证 | 否 |
| 7 | `CancellationText` | CHAR(40) | Cancellation Text | 取消文本 | 否 |
| 8 | `VendorID` | CHAR(10) | Vendor ID | 供应商编号 | 是 |
| 9 | `AmountInLocalCurrency` | CURRENCY(13,2) | Amount in Local Currency | 本币金额 | 是 |
| 10 | `Currency` | CHAR(5) | Currency | 货币码 | 是 |
| 11 | `PaymentMethod` | CHAR(1) | Payment Method | 付款方式 | 否 |
| 12 | `BankAccount` | CHAR(18) | Bank Account | 银行账户 | 否 |
| 13 | `ReasonCode` | CHAR(3) | Reason Code | 原因代码 | 否 |

---

## 2. 响应结构: PaymentAdviceCancellationResponse / 付款通知取消响应

**命名空间:** `urn:sap-com:document:sap:soap:functions:mc-style`

| # | 字段名称 | 类型 | 描述 (EN) | 描述 (CN) | 必填 |
|---|----------|------|-----------|-----------|------|
| 1 | `PaymentAdviceNumber` | CHAR(16) | Payment Advice Number | 付款通知编号 | 是 |
| 2 | `Status` | CHAR(1) | Status (S-success/E-error) | 状态 (S-成功/E-错误) | 是 |
| 3 | `Message` | CHAR(200) | Message | 消息 | 否 |

---

## SOAP XML 示例 / SOAP XML Example

### 请求 / Request

```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:urn="urn:sap-com:document:sap:soap:functions:mc-style">
  <soap:Header/>
  <soap:Body>
    <urn:PaymentAdviceCancellationRequest>
      <PaymentAdviceNumber>PA-100001</PaymentAdviceNumber>
      <CompanyCode>1000</CompanyCode>
      <FiscalYear>2026</FiscalYear>
      <CancellationReason>01</CancellationReason>
      <CancellationDate>2026-07-23</CancellationDate>
      <ReferenceDocument>INV-2026-0001</ReferenceDocument>
      <CancellationText>Cancellation due to duplicate payment</CancellationText>
      <VendorID>V-10001</VendorID>
      <AmountInLocalCurrency>5000.00</AmountInLocalCurrency>
      <Currency>CNY</Currency>
      <PaymentMethod>T</PaymentMethod>
      <BankAccount>1234567890</BankAccount>
      <ReasonCode>001</ReasonCode>
    </urn:PaymentAdviceCancellationRequest>
  </soap:Body>
</soap:Envelope>
```

### 响应 / Response

```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:urn="urn:sap-com:document:sap:soap:functions:mc-style">
  <soap:Header/>
  <soap:Body>
    <urn:PaymentAdviceCancellationResponse>
      <PaymentAdviceNumber>PA-100001</PaymentAdviceNumber>
      <Status>S</Status>
      <Message>Cancellation processed successfully</Message>
    </urn:PaymentAdviceCancellationResponse>
  </soap:Body>
</soap:Envelope>
```

---

## 变更记录 / Change Log

| 版本 | 日期 | 描述 |
|------|------|------|
| 1.0.0 | 2026-07-23 | 初始版本 / Initial version |