地址

“地址”导入端点可用于向供应商和客户添加地址，然后可用于 航运 以及 接收. 地址也可以添加为 '站点地址' 用于 转让.

链接集成指南：

订单

销售订单

客户

本指南将重点介绍如何使用此“地址”端点，包括通过 CSV 导入和通过 V5 API 使用 JSON。

1. 控制中心布局
2. 接口链接
3. 地址现场指南
   1. 主键
   2. 必填字段
   3. 附加字段
4. 示例数据集
5. 研究方法
   1. 1. JSON – 导入
      2. CSV – 导入

关于如何将地址端点与我们在 V5 控制中心看到的内容关联起来，我们将在这里查看“客户”表。“供应商”表的工作方式完全相同，因为供应商和客户共享相同的“客户”端点。

要了解有关此“地址”数据库类的定义的更多信息，请参阅以下链接：

地址

对于通过“地址”端点导入，主键是：

姓名 – 此地址的唯一名称

在 V5 中创建有效条目所需的其他字段：

类型 – 地址类型，当用于客户端时应为 0，当用作传输 (modlink) 的站点地址时应为 1。

客户端代码 – 如果添加客户地址，则需要将其与客户/供应商绑定。

Line1 – 地址的第一行。

Line2 – 地址的第二行。

Line3 – 地址的第三行。

城市 – 地址所在的城市。

州 – 地址所在的州。

国家 – 地址所在的国家/地区。

压缩 – 地址的邮政编码。

联系我们 – 地址的联系人姓名。

电话 – 与地址关联的电话号码。

邮箱 – 与该地址关联的电子邮件地址。

还可以在此处添加送货地址（如果与使用上面详细信息输入的地址不同）和紧急召回联系人/详细信息，但在我们的示例中我们将只使用上述数据点。

对于这部分，我们将尝试为上面 CC 面板中显示的客户添加一个地址。此客户之前已使用“客户' 端点。

‘地址’导入端点/URI –

http://host:port/V5-API/api/integrate/import/address

端点描述

示例：

使用“地址”端点，我们可以为上述添加的内容构建一个导入文件，如下所示：

可以下载此示例 JSON 文件 开始.

一旦我们将其发布到系统，我们就可以看到该地址已添加到“CUS01”客户：

由于客户/供应商可以分配多个地址，我们只需为上面的 JSON 示例中添加的“CUS01”客户添加另一个地址。

对于 CSV 导入，我们首先需要为导入构建一个头文件。

标题/列定义文件名： “地址.csvh”

完成的头文件应放置在： “ \SG 控制中心\网关\导入\column_defs”

导入 CSV 文件名： “地址-日期时间.csv”

用于导入的 CSV 应放置在： “ \SG 控制中心\网关\导入”

示例：

头文件：

下面是一个示例头文件。我们将使用与 JSON 导入相同的字段。

有关我们如何构建这些文件的更多信息，请参阅 主集成页面。 可以下载此示例头文件 开始.

CSV 导入文件：

然后，我们可以使用标题中定义的数据点顺序来构造我们的导入文件。请注意，控制中心可以忽略第一行，因此在提交导入时可以将其保留在文件中。根据我们上述要求的示例导入如下所示：

可以下载此示例导入​​文件 开始.

然后，我们可以将此文件放入上面定义的导入文件夹中，导入完成后，我们就可以看到该地址已添加到同一个客户。