地址

“地址”导入端点可用于向供应商和客户添加地址，这些地址随后可用于发货和收货。地址还可以添加为“站点地址”，用于调拨。

链接集成指南：

订单

销售订单

客户

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

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

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

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

地址

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

名称–此地址的唯一名称

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

类型– 地址类型，对于客户端应为 0，对于转账（modlink）站点地址应为 1。

Client_Code – 如果要添加客户地址，则需要此信息以将其与客户/供应商关联。

Line1 –地址的第一行。

Line2 –地址的第二行。

Line3 –地址的第三行。

城市– 该地址所在的城市。

州/省– 地址所在的州/省。

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

邮政编码– 地址的邮政编码。

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

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

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

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

本文将介绍如何为上方 CC 面板中显示的客户添加地址。该客户之前已使用“客户端”端点添加到系统中。

‘地址’导入端点/URI –

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

端点描述

示例：

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

此示例 JSON 文件可在此处下载。

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

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

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

表头/列定义文件名：“address.csvh”

已完成的头文件应放置在：“<安装目录>\SG 控制中心\gateway\import\column_defs”

导入 CSV 文件名：“address-datetime.csv”

用于导入的 CSV 文件应放置在：“<安装目录>\SG 控制中心\gateway\import” 目录下。

示例：

头文件：

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

有关我们如何组织这些文件的更多信息，请参阅主集成页面。此示例头文件可在此处下载。

CSV 导入文件：

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

此示例导入​​文件可在此处下载。

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