# CO_TAX_JURI_GET_CHANGE_LIST

**SOAP v1.0.0 — ACTIVE**

## Title / 标题
**External Tax - Get Changed Jurisdiction Code List / 外部税务 - 获取已更改的管辖区代码列表**

## Operation / 操作
`TaxJurGetChangedJurisdictionCodeList`

---

## Description / 描述
This synchronous outbound service retrieves a table of changed tax jurisdiction codes from an external tax system, based on a specified date range, for synchronizing jurisdiction code changes.

该同步出站服务根据指定日期范围从外部税务系统检索已更改的税务管辖区代码表，用于同步管辖区代码变更。

---

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

## Message Structure / 消息结构

### Request / 请求
| Element | Type | Description (EN) | Description (CN) |
|---------|------|------------------|------------------|
| `ControlData` | `TAX_CONTROL` | Control parameters | 控制参数 |
| `?LastRequestDate` | `DATE` | Last request date | 上次请求日期 |
| `?Language` | `LANG(2)` | Language key | 语言代码 |
| `RequestId` | `CHAR(32)` | Request identification | 请求标识 |

### 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 | 消息文本 |
| `JurisdictionCodes` | Table | List of changed codes | 已更改代码列表 |
| `?JurisdictionCode` | `CHAR(15)` | Tax jurisdiction code | 税务管辖区代码 |
| `?Country` | `CHAR(3)` | Country key | 国家代码 |
| `?ChangedOn` | `DATE` | Date of change | 更改日期 |
| `?ChangedBy` | `CHAR(12)` | User who made the change | 更改用户 |

---

## Example Payload / 示例负载

### Request
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <TaxJurGetChangedJurisdictionCodeList>
      <ControlData>
        <LastRequestDate>2026-06-01</LastRequestDate>
        <Language>EN</Language>
      </ControlData>
      <RequestId>REQ-20260723-001</RequestId>
    </TaxJurGetChangedJurisdictionCodeList>
  </soap:Body>
</soap:Envelope>
```

### Response
```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <TaxJurGetChangedJurisdictionCodeListResponse>
      <Return>
        <Type>S</Type>
        <Message>Data retrieved successfully / 数据检索成功</Message>
      </Return>
      <JurisdictionCodes>
        <item>
          <JurisdictionCode>US-CA-001</JurisdictionCode>
          <Country>US</Country>
          <ChangedOn>2026-06-15</ChangedOn>
          <ChangedBy>TAXADMIN</ChangedBy>
        </item>
        <item>
          <JurisdictionCode>US-NY-002</JurisdictionCode>
          <Country>US</Country>
          <ChangedOn>2026-07-01</ChangedOn>
          <ChangedBy>TAXADMIN</ChangedBy>
        </item>
      </JurisdictionCodes>
    </TaxJurGetChangedJurisdictionCodeListResponse>
  </soap:Body>
</soap:Envelope>
```

---

## Error Codes / 错误代码
| Code | Description (EN) | Description (CN) |
|------|------------------|------------------|
| `TAX_001` | External tax system unavailable | 外部税务系统不可用 |
| `TAX_002` | Invalid date range | 无效的日期范围 |
| `TAX_003` | No changes found for the period | 该期间未找到更改 |
| `TAX_004` | Request ID already processed | 请求ID已处理 |

---

## Notes / 备注
- Maximum date range is 31 days per request / 每次请求最大日期范围为31天
- This service is outbound-only; the SAP system calls the external tax provider / 该服务仅为出站服务，SAP系统调用外部税务提供商
- Jurisdiction codes are returned in alphabetical order / 管辖区代码按字母顺序返回