# vat_query_api.php 从 SaaS 获取的字段清单

> 文件：`server/vat_query_api.php`（L1-1363）
> 功能：德国 VAT 查询五合一和验证 API，通过 `vatBusinessRecordId` 从 SaaS（SQL Server）读取注册数据，生成 5 合一 PDF 并上传 OSS。

## 一、主查询（五表联查）

来源：[vat_query_api.php#L203-L210](file:///d:/phpstudy_pro/WWW/vat_api_de_client/server/vat_query_api.php#L203-L210)

```sql
SELECT TOP 1 vi.ID as VATRegInfoId, dr.*, dr.ID as RegisterID, br.CompanyID, br.Code as tid,
dr.Attachment as Attachment_id, br.VATTaxNumberID, br.CustomerID as VATBusinessCustomerID,
sp.NameEng as BusinessPlatform_En, bp.SellerID as ShopAccount, bp.ProductRange as ProductsRange
FROM DEVAT_Register dr
LEFT JOIN VATRegInfo vi ON dr.ID = vi.VATBusinessRecordId
LEFT JOIN VATBusinessRecord br on br.ID = dr.ID
LEFT JOIN Base_Sales_Platform_Shop bp on br.Base_shopinfoid = bp.ID
LEFT JOIN Base_Sales_Platform sp on bp.SalesPlatformID = sp.SalesPlatformID
WHERE br.Country = 'DE' AND vi.ID=:ID and vi.PushType='101'
```

| 字段名（别名） | 来源表 | 说明 |
|---|---|---|
| tid（Code） | VATBusinessRecord.Code | 业务单号，用于 OSS 文件名前缀 |

## 二、DEVAT_Register 表字段（dataRow，dr.*）

| 字段名 | 说明 | 用途 |
|---|---|---|
| DELogisticsSituation | 德国仓储物流合作情况 | 必填校验、特殊字符校验 |
| ExpectedSalesYear1 | 注册后第一年预计销售额 | 必填校验、数字校验 |
| ExpectedSalesYear2 | 注册后第二年预计销售额 | 必填校验、数字校验 |
| ProductsRange | 销售商品种类 | 必填校验、不含中文校验 |
| BusinessPlatform_En | 对应店铺平台 | 必填校验、判断 Amazon 需 FBA 截图 |
| StoreWarehouseAddressScreenShot | 店铺仓库地址截图（附件 ID） | 必填校验、下载转 PDF |
| StoreFBAAcitveSetSetScreenShot | FBA 开启截图（附件 ID） | Amazon 平台必填、下载转 PDF |
| StoreOtherSetScreenShot | 店铺其他截图（附件 ID） | 下载转 PDF |
| StoreOverseaWarehouseContract | 海外仓合同文件（附件 ID） | 非 Amazon 平台必填、下载转 PDF |
| StoreSellerProfileScreenShot | 店铺卖家资料截图（附件 ID） | 下载转 PDF |
| Code | 业务编号 | 日志记录 |

> 注：5 个截图/合同字段在 `generateScreenshotsAllfile()`（L518-604）中被遍历下载并合并为 `AllScreenshots.pdf`。

## 三、Base_Customer_Company 表字段（companyresults，SELECT *）

| 字段名 | 说明 | 用途 |
|---|---|---|
| Country | 公司注册所在国（中国/香港） | 国家判断、流程分支（香港走 BR/CR/NNC1） |
| NameEng | 公司英文名称 | 必填、文档替换 |
| CompanyAddressLine1En | 公司地址行 1 | 必填校验、英文校验 |
| CompanyAddressLine2En | 公司地址行 2 | 校验不能含中文 |
| CompanyAddressProvinceEn | 公司所在省份 | 英文校验 |
| RegNumber | 营业执照号 | 必填、Gewerbeschein 文档 |
| RegisteredCapital | 注册资本金额 | 必填、数字校验 |
| RegisteredCapitalCurrency | 注册资本货币单位 | 必填校验 |
| CompanyAddressPostcode | 邮政编码 | 必填校验 |
| CityEngName | 公司所在城市 | 必填、Gewerbeschein 文档 |
| RegAddressEng | 公司注册地址（英文） | Gewerbeschein 文档 |
| LegalPersonFullNamePinYin |  |  |
| LegalPersonNamePinyin / LegalPersonSurnamePinyin | 法人名 / 姓拼音 | 必填 SaaS 新字段（组合成全名） |
| LegalPersonAddressLine1En | 法人地址行 1 | 必填校验、英文校验 |
| LegalPersonAddressPostcode | 法人地址邮政编码 | 必填校验 |
| LegalPersonCityEngName | 法人地址城市 | 必填、ID 发证机关 authority |
| LegalPersonIDCardAddressEng | 法人身份证住址 | 必填、Vollmacht / ID 文档 |
| LegalPersonCountry | 法人所在国 | 必填校验 |
| LegalPersonRoomNumberSuffix | 法人门牌号后缀 | 数字校验 |
| RoomNumberSuffix | 房间号后缀 | 不能含中文校验 |
| LegalPersonBirthDate | 出生日期 | 必填、日期格式、文档替换 |
| LegalPersonIdStartDate | 身份证有效期开始日期 | 必填、ID 文档 |
| LegalPersonIdEndDate | 身份证有效期结束日期 | 必填、ID 文档（2099=langfristig） |
| LegalPersonIdNumber | 法人身份证号 | 必填、Vollmacht / ID 文档 |
| LegalPersonGender | 法人性别（1 男 / 0 女） | 必填、ID 文档 männlich / weiblich |
| Nationality | 民族 | 必填、ID 文档 |
| EstablishmentDate | 成立日期 | 必填、日期格式、Gewerbeschein |
| SignatureDate | 签发日期 | 必填、Gewerbeschein 文档 |
| LegalPersonPhone | 法人手机号 | 必填、Vollmacht 文档、号码格式化 |
| LegalSignedFile | 法人签字扫描件（附件 ID） | 必填、签名替换 |
| LegalPersonIdNumberFrontPic | 身份证正面（附件 ID） | 必须非空、转 PDF |
| LegalPersonIdNumberBackPic | 身份证反面（附件 ID） | 正面非 PDF 时必须非空、转 PDF |
| BusinessLicensePic | 营业执照图片（中国）/ BR 证件（香港） | 转 PDF 合并 |
| BusinessCRFile | 香港公司注册证书 CR（附件 ID） | 香港必填、转 PDF |
| BusinessNNC1File | 香港法团成立表格 NNC1（附件 ID） | 可选，有才合并 |

## 四、Base_Customer / Base_Agent 表字段（邮件授权用）

来源：[vat_query_api.php#L752-L761](file:///d:/phpstudy_pro/WWW/vat_api_de_client/server/vat_query_api.php#L752-L761)

```sql
SELECT t.TaxEmail, c.Isagent
FROM Base_Customer c
JOIN Base_Agent t ON t.CustomerID = c.ID
WHERE c.ID = :fId ORDER BY t.CreationDate DESC
```

| 字段名 | 来源表 | 说明 |
|---|---|---|
| Isagent | Base_Customer | 是否代理（'True' 时使用代理邮箱） |
| TaxEmail | Base_Agent | 代理税务对接邮箱；散客固定 vat03@seamew.de |

## 五、说明

1. 文件类字段（截图、证件、签名）存的是**附件 ID**，通过 `processFileField` 再向 SaaS 附件库下载实际文件。
2. 香港公司 CR/BR 证件在 L249-255 有必填校验（NNC1 可为空）。
3. 生成 5 合一文件顺序：Gewerbeschein（营业执照/香港 BR+CR+NNC1）→ ID（身份证）→ Vollmacht（地址授权）→ eMailKommNEU（邮件授权）→ AllScreenshots(店铺平台和仓库等截图)