ユーザーガイド UPS 開発者向けキット 2014 United Parcel Service of America, Inc. UPS UPS のブランドマーク color brown は United Parcel Service of America, Inc. の商標です All right

(1)

UPS ^® 開発者向けキット

(2)

i

UPS開発者向けキットユーザーガイド

はじめる前に

技術的問題点とアクセス要件

. . . . 3

実装

はじめに

. . . . 5

製品概要

出荷と評価ビジネスプロセス

. . . . 18

可視性ビジネスプロセス

. . . . 26

国際貿易ビジネスプロセス

. . . . 30 UPS開発者向けリソースセンター

リソースと技術サポートへのアクセス

. . . . 35

リソース

. . . . 36

技術サポート

. . . . 37

(3)

1 UPS

開発者向けキットユーザーガイドへようこそ。本ガイドでは、開発者向けキットとサーバーにアクセスして、

UPS

とテストし取引する方法についての情報を説明します。操作時間や応答時間を含む、

API

の技術サポートに関する詳細情報も説明します。

UPS

開発者向けキットは、

UPS

の機能性をビジネスシステムおよび

e

コマース

Web

サイトに直接統合する上での柔軟性を提供します。

UPS

は、

API

経由で

11

の機能を提供するため、ビジネスプロセスの効率性を改善し、

顧客の

Web

エクスペリエンスを向上させることができます。

ups.comのUPS開発者向けキットページ

このページにアクセスするには、以下にアクセスします。

ups.com/developerkit

(4)

UPS 開発者向けキット

(5)

3 技術的な問題

APIをダウンロードする前に、以下に精通している必

要があります。

•

URL

またはソケット接続のプログラミング

• セキュア接続のためのSSL標準に対応したセキュアソケットの実装の作成

•

XML

ドキュメントのエンコードとデコード

• エラー処理用の既存のソフトウェアの戦略の設計と実装

利用可能なバージョン（

XML

または

Web Services

）、

モード（

Package

、

LTL Freight

、

Air Freight

）、国をチェックします。

アクセス要件

特定の

API

がテストと本番用アクセスとともに最初のアクセスキーリクエストを提供するかどうか、またはさらなる本番用アクセスリクエストが必要とされるかどうか確認します。ビジネスモデルが各

API

で使用されることが承認されている場合も、確認が必要です。

注:

• アプリケーションのビジネスロジックとデータを

APIに採用するカスタムコードを、API機能をeコマー

スおよびビジネスシステムアプリケーションに統合するために開発する必要があります。インターネットソケット経由のHTTP通信とセキュア接続に対応した、Java、Visual Basic、またはC++ などのプログラミング言語を使用できます。

• TNT APIを効果的に統合できるようにするため、開発者向けキットには、以下のガイドと参考資料が同梱されています。Visual Basic、Java、.Net、C++,

Perl、PHPを含む開発者ガイド（技術FAQを含む）、

UPSロゴとバナー、コードサンプル

(6)

UPS 開発者向けキット

(7)

5 はじめに

i

ups.com

^®でUPS開発者向けキットセクションにアクセスするには、［サポート］メニューの［技術サポート］を選択します。

［技術サポート］ページにアクセスし、[ツール]

と[リソース]の［

UPS

開発者向けキット］を選択します。

(8)

6

手順1: My UPSに登録

すでに登録されている場合、手順4にスキップします。

手順

2

: ログイン

username

を入力します。［次へ］をクリック

します。それから、パスワードを入力するようにプロンプトが表示されます。資料ファイルをダウンロードするためにログインする必要があります。

(9)

7 はじめに

^（続）

手順3: APIの選択

Developer APIで、必要なそれぞれのAPIに対す

る要件を探し、ダウンロード可能なファイルならびに特定の国のアベイラビリティにアクセスすることができます。本ガイドの21ページ目にある製品概要セクションも参考にできます。

(10)

8

手順4: API資料のダウンロード

1. 選択したAPIのzipファイルのダウンロード 2.

プロンプトが表示されたら、［保存］をク

リックします

3. ローカルコンピュータの抽出ファイル

ダウンロードされたファイルには、ソフトウェア開発者向けキットが含まれます。統合する

API

に対する開発者ガイド全体を注意深く確認します。ソフトウェア開発者向けキットには、サンプルコードと

WSDL

も含まれます。

(11)

9 はじめに

^（続）

UPSはすべてのAPIのアクセスキーにアクセス可能なテ

スト環境を提供します。これは、XMLまたはWebサービスリクエストをきちんとフォーマット設定するためにライブでリクエストと、応答メッセージの発信をシミュレーションできます。

ほとんどの

API

では、テストと本番用環境の両方にすぐにアクセスできます。しかし、以下の

API

で本番用のアクセスを有効にするためには、

2

回目のリクエストが必要になります。

Locator

および

LTL Freight API

（

Pickup

、

Rating

、

Shipping

）です。

手順5: アクセスキーのリクエスト

ソフトウェア開発者向けキットを確認したら、UPSテスト環境へのアクセス権をリクエストする必要があります。以下を行うように求められます。

1. アカウントの情報の提供 2. アカウント情報の認証

3 .

認証したら、リクエストが受け付けられた

ことの確認通知を受信します。

(12)

10

手順5: アクセスキーのリクエスト（続）アカウント情報の提出

(13)

11 はじめに

^（続）

手順5: アクセスキーのリクエスト（続）

1. アカウント認証の提供

2 .

認証が完了したら、［アクセスキーのリ

クエスト］ページに戻ります。

3 .

下にある［アクセスキーのリクエスト］

をクリックします。

注記: Account Invoice Authentication（AIA）

は、ShippingおよびRating API経由で交渉料金を表示するために必要です。My UPS（ups.com）でAIA認証に対する最新の請求書のコピー（45日間以内）があることを確認します。

(14)

12

手順5: アクセスキーのリクエスト（続）

リクエストが受け付けられた確認通知を見て、確認メールを受信します。

(15)

13 アクセスと管理

アクセスキーの表示/更新

アクセスキーを管理および更新するには、［

UPS

開発者向けキット］ページに移動し、［アクセスと管理］

セクションの［アクセスキーの管理］を選択します。

(16)

14

アクセスキーの表示/更新（続）

• ［アクセスキーの表示/更新］セクションにアクセスキーを入力します。

• 次のセクションでは、入力したキーに対して、ステータスとともに

API

のリスト（テストまたは本番用）

を表示します。

注記: そのページから、本番用アクセスまたは新しいアクセスキーもリクエストします。

(17)

15 アクセスと管理

^（続）

アカウント/連絡先情報の編集

主要連絡先および代替連絡先情報のみならず、アカウント情報を更新するには、［

UPS

開発者向けキット］ページに移動し、［アクセスと管理］セクションの［管理］を選択します。

(18)

16

アカウント/連絡先情報の編集（続）

連絡先情報が表示されます。［編集］を選択して変更します。

注記: UPS証明書に対する変更やその他の大きな変更に関する特定の電子メール通知では、連絡先情報が最新のものであることが非常に重要です。また、インテグレーターを使用した場合、重要な情報を受け取れるように、連絡先情報が会社のIT連絡先に変更されていることが重要です。

変更を行うための新しい画面が表示されます。終了したら、［変更の保存］をクリックします。

(19)

UPS 開発者向けキット

(20)

18

利用可能な国: 米国およびプエルトリコのすべての交通手段

利用可能なバージョン:

XMLのみ

利用可能なモード: すべてのモード

アクセス要件: テストおよび本番用アクセスに1つのリクエスト

アドレス認証API

Web

ページまたは

Web

でないオーダーシステムのいずれに統合するのかにかかわらず、

Address Validation API

を使用すると、バイヤーが提供した市町村-都道府県-郵便番号の組み合わせを

UPS

の中央コンピューター（サーバー）に維持されているものと比較できるようになります。組み合わせが有効ではない場合、

UPS

は市区町村、都道府県、郵便番号の候補のリストをアプリケーションに返します。

UPS

は最大

10

個の住所の候補を提供します。

承認されているビジネスモデル

• 出荷のためにUPSに提供される積荷の住所確認承認されていないビジネスモデル/使用法

• 住所データベースの「スクラビング」

•

UPS

出荷以外の用途のための住所確認

API制限

• 米国およびプエルトリコの住所のみ確認が可能

• API応答では緯度経度座標は提供されません

• 市区町村-都道府県-郵便番号の組合せの確認のみ — 番地を含む住所ではない

•

1回のリクエストあたり1つの市区町村-都道府県-

郵便番号の組合せのみ確認します

•

UPS

住所データベースは、

USPS

によって提供された情報で毎月更新されます

• CASS認定の検証用エンジンではありません

•

CASS AV

ソフトウェアの要件に代わるものではありません

(21)

19

利用可能な国: 米国およびプエルトリコではすべての交通手段利用可能なバージョン:

XMLおよびWebサービス

出荷と評価ビジネスプロセス

^（続）

Address Validation Street Level API

Web

ページまたは

Web

でないオーダーシステムのいずれに統合するのかにかかわらず、

Address Validation Street Level (AVSL) API を使用すると、バイヤーが提

供した番地-市町村-都道府県-郵便番号の組み合わせを

UPS

の中央コンピューター（サーバー）に維持されているものと比較できるようになります。組み合わせが有効ではない場合、

UPS

は番地、市区町村、都道府県、郵便番号の候補のリストをアプリケーションに返します。

UPS

は最大

10

個の住所の候補を返します。

さらに、米国とカナダ（分類は

USPS

情報に基づかない

UPS

内部の活動分類）について、

AVSL API

は事業用/住宅の住所を分類します。

• 配送のために

UPS

によって提供される住所確認承認されていないビジネスモデル/使用法

• 住所データベースの「スクラビング」

• UPS出荷以外の用途のための住所の確認

API制限

• 米国およびプエルトリコの住所のみ確認が可能

• 米国およびカナダの住所のみを分類（商業/住居）

します

• リクエストあたり

1

つの番地、市区町村、都道府県、

郵便番号の組合せのみ確認します

• アパートメントまたは部屋がAPIリクエスト内で提供される場合、またはアパートメントまたは部屋が

UPSデータベースに存在する場合のみ、アパートメ

ントまたは部屋を検証します。

•

API

応答では緯度経度座標は提供されません

• UPS住所データベースは、USPSによって提供された情報で毎月更新されます

•

CASS

証明アプリケーションではありません

• CASS AVソフトウェアの要件に代わるものではありません

(22)

20

スモールパッケージにのみ27カ国で利用可能です利用可能なバージョン:

XML

利用可能なモード: パッケージ

アクセス要件: テストおよび本番用アクセスにつき2つの別のリクエスト

Locator API

では、住所や電話番号を使用して、ユー

ザーが地域の

UPS

サービスを見つけることができます。

Locator API

では

UPS

のフルサービスおよびセルフサービスの場所、営業時間、ピックアップ時間を提供します。

Locator API

は、所在地、追加のサービス、

プログラムタイプ、タイプコード、所在地が店舗の場合を含む、別の構成情報を示すようにカスタマイズできます。さらに、

Locator

はインタラクティブなマップを提供し、最大

10

の

UPS

所在地と経路案内を表示します（利用可能な場合）。

次のような所在地の検索:

• The UPS Store^®

•

Mail Boxes Etc

.^®

• UPSお客様サービスセンター

•

UPS

ドロップボックス

• UPS Express^®

•

UPS

提携店

• UPSリテールパートナー

•

UPS

指定の取扱い業者

• マーチャントの

Web

サイトと

Web

でないバックエンドシステムで使用

承認されていないビジネスモデル/使用法

• サードパーティのロジスティクスプロバイダーで使用

API制限

• 緯度経度座標は提供されません

• マップは提供されません

(23)

21

スモールパッケージとLTL Freightについては36か国で利用可能利用可能なバージョン:

Webサービス

利用可能なモード:

Package、LTL Freight

アクセス要件: テストおよび本番用アクセスに対して

Pickup API Small Packageのリクエス

ト1つ、テストおよび本番用アクセスに対してPickup API Ground Freightの別のリクエスト2つ

出荷と評価ビジネスプロセス

^（続）

Pickup API

では、ユーザーが自宅やオフィスからの

UPS

の

ピックアップをスケジュールできます。前に処理されたパッケージ、運賃発送、または新しい出荷のピックアップもスケジュールできます。さらに、

UPS

の環境にやさしい収集オプションは、スモールパッケージ

Pickup API

で利用できます。

• マーチャントのWebサイトとWebでないバックエンドシステムで使用

• ピックアップリクエストのサードパーティのホスティング

API制限

• なし

(24)

22

スモールパッケージでは66か国で、LTL Freightでは4か国で、Air

Freightでは36か国（Gemini API）で利用できます

XMLおよびWebサービス（メモを参

照）

Package、LTL Freight

⁽¹⁾、Air Freight⁽²⁾ アクセス要件:

LTL Freightに対するテストおよび本

番用アクセスの異なる2つのリクエスト、Gemini APIリクエストフォーム経由のAir Freightに対する手動リクエスト（ups .comでUPS開発者向けキットのリンクを参照してください）

Rating API

は、

UPS

によるサービスが利用可能なすべての目的地に対して、

UPS

スモールパッケージおよび

UPS Freight

^®

LTL

サービスレベルの料金（毎日のピックアップ、オンデマンド、または店舗）を提供します。

Rating API

は、利用可能なすべての料金（「ショップ」オプション）や、特定のサービスレベルの料金（「料金]オプション）を示すように設定できます。公表されている料金がデフォルトで示されます。アカウント固有の交渉料金は、

My UPS

タブにある

ups

.

com

の［アカウントサマリ］または［アカウントメンテナンス］ページにある［アカウント請求書による承認］によって有効にすることができます。詳細については、本ガイドの

11

ページを参照してください。

Rating API

は、

Ground

（

Time-

in-Transit API

がこの情報に使用される必要があります）

以外のすべてのサービスの配送日と配送時間をお知らせします。

• 競合料金と並べて比較したUPS料金の表示

注:

(1) LTL Freight 専用のWebサービス (2) Gemini API XML経由専用のAir Freight

API制限

• 単一パッケージの発送料金のみ

• 限定された付帯項目のみをサポート:

– 保険価額 – 土曜集荷 – 土曜配達 – 追加取扱

•

Air Freightの料金は、Gemini APIsを使用する必要が

あります。Gemini APIsリクエストフォームおよび開発者ガイドへのリンクについては、UPS開発者向けキットホームページと、AnnouncementsおよびAPI

Updateセクションを参照してください。このAPIへア

クセスするには、リクエストフォームをきちんと読んでください。

(25)

23 出荷と評価ビジネスプロセス

^（続）

Shipping API

は、企業システムと

Web

サイトでの

UPS

の出荷機能の統合をサポートします。統合では、出荷への便利で管理されたアクセスにより内部プロセスをサポートしながら、ユーザーがキーを入力する必要なく、送り主のアプリケーションからのデータを使用できます。

Shipping API は、海外からの返品を含む、

スモールパッケージ全体の

UPS Returns

^®ポートフォリオもサポートします。

UPS

の住宅/事業用住所の分類と、市区町村、都道府県、郵便番号の確認も行われます。

UPS Shipping API

の統合は、大幅なプログラミング時間と専門知識が必要です。

Shipping APIの能力

プロセスは次の2段階で構成されます。［Ship

Confirm（出荷確認）］段階は、［Ship Accept（出荷

受付）］段階に続きます。XMLリクエスト/応答のペアは、それぞれの段階でクライアントとサーバーの間で交換されます。出荷のキャンセルや無効化は手順とメッセージの入力を必要とすることに注意してください。

• アクセスのためのコントロールを

Web

サイトに組み込むとき

スモールパッケージでは66か国で、LTL Freightでは4か国で、

Air Freightでは36か国（Gemini API）で利用できます

XMLおよびWebサービス（メモを

参照）

Package、LTL Freight

⁽¹⁾、Air Freight⁽²⁾ アクセス要件:

LTL Freightに対するテストおよび本

番用アクセスの異なる2つのリクエスト、Gemini APIリクエストフォーム経由のAir Freightに対する手動リクエスト（ups .comでUPS開発者向けキットのリンクを参照してください）

注:

(1) LTL FreightはWebサービス専用です (2) Gemini API XML経由専用のAir Freight

(26)

24 Shipping API（続）

• 競合料金と並べて比較した

UPS

料金の表示

• 外部または

Web

ベースの実装において、競合者と並べての比較は行わないこと

•

Web

サイトで

Shipping API

のホスティングを行わないこと

API制限

• 処理時間の平均はトランザクションごとに

8

秒です。

大容量の本番用の出荷環境には適しません

• 公表されている料金がデフォルトで示されます。

アカウント固有の交渉料金は、

My UPS

タブにある

ups

.

com

の［アカウントサマリ］または［アカウントメンテナンス］ページにある［アカウント請求書による承認］によって有効にすることができます。

詳細については、本ガイドの

11

ページを参照してください。

• サポートされていません。危険物質、World Ease^®、バッチ処理、

UPS Hundredweight Service

^®集約

(27)

25

スモールパッケージにのみ66カ国で利用可能です利用可能なバージョン:

XMLおよびWebサービス

アクセス要件:

UPS承認ビジネスモデルについて

はテストおよび本番用アクセスのために1つのリクエスト

出荷と評価ビジネスプロセス

^（続）

Time-in-Transit API

では、ユーザーがサービスごとの配送スピードを比較します。それにより、出荷に最適なサービスを選択できます。この

API

は、世界中の

UPS

が配送する場所で利用可能なすべての

UPS

出荷サービスへアクセスできるようにします。情報には、配送日と時間、配送日数のスケジュールを含みます。

UPS

の祝日と週末を考慮に入れた、グラウンドパッケージの配送の日付と時間を提供します。

• トランザクションの関係者でない第三者の情報ロジスティクスプロバイダーによる使用

•

UPS

の機密情報から

Time

-

in

-

Transit

表を作成

API制限

• なし

(28)

26

スモールパッケージのみ31カ国で利用可能です利用可能なバージョン:

XML

Quantum View™ API

Quantum View™Data

は、スプレッドシートや簡単なデータベースから

ERP

システムまで、社内の内部アプリケーションにシームレスに統合可能な総合追跡情報を提供します。

出荷状況の更新は、多くの一般的なデータファイル形式（

CSV

、

XML

、

TXT

または

EDI ANSI

または

EDI EDIFACT

）で、必要に応じて毎時間の頻度で内部システムに自動的にダウンロードできます。

• アウトバウンド

• インバウンド

• 第三者 - 運賃着払、第三者、UPS 荷受人請求を通してUPSのアカウントに請求される出荷に関する最新の情報。

XML Quantum Viewサービスを理解する

Quantum Viewは情報を「イベント」として示します。

このAPIで、お客様のアプリケーションで自動的に

Quantum Viewイベントを取得したり、これらのイベン

トを他の情報システムの処理に統合したりすることが可能になります。

この機能でどのタイプの

Quantum View

イベントを取得するか指定できます。アウトバウンド出荷、インバウンド出荷、代理請求を使用した出荷に対して、購読をセットアップできます。これらの購読には、マニフェスト、出荷元、配送、例外アクティビティを含むことができます。

Quantum View

購読は、

ups

.

com

を通して作成されます。受け取る情報や購読のタイプを管理するには、

ups

.

com

ですべて行うことができます。購読を有効にするには、営業担当者に連絡する必要があります。

ブックマーク

アクティビティ量が多いユーザーに関して、そしてネットワークリソースの負荷を軽減するために、

Quantum View API

は、単一のリクエストに返す情報

量を制限できます。この制限は、複数を組み合わせたファイルついてはおよそ

150KB

、単一のファイルでは

500KB

です。制限を超えたファイルについては、

UPS

は

情報の一部を返し、特別なブックマーク要素を応答に加えます。追加情報を取得するには、元のリクエストをブックマーク要素を追加した状態で再発行します。

(29)

27 可視性ビジネスプロセス

^（続）

Quantum View API（続）

情報形式

アプリケーションが

Quantum View

イベントをリクエストしたとき、

API

は前に表示していないイベントのみを返します。ファイル名と日付/時間のリクエストは、このルールにのみ期待されます。

• マーチャントWebサイトとWebでないバックエンドシステムで使用します

API制限

• 更新はバッチで処理され、1時間ごとの更新に制限されます

• 変更されたもののみが１時間ごとのファイル更新に含まれるように、ファイルを既存のデータにアペンドする必要があります。

• マニフェスト、期待、配送スキャンのみがファイル内で提供されます。中間のスキャンではありません（移動中のスキャン）

(30)

28

すべての出荷モードは66か国で利用可能

XMLおよびWebサービス

追跡API

Tracking API

は透明性を提供し、顧客がリファレンスま

たは注文番号を使用した

e

コマースサイトから、出荷を追跡できるようにします。顧客のパッケージが最終目的地に向かう間、スキャンが発生するたびに、時刻や場所など出荷状況の具体的な情報が提供されます。さらに、お客様のサイトの外観に合わせて、追跡情報をシームレスに混ぜることも可能です。

• 指定されたイベントまでアウトバウンドパッケージごとに追跡する「

robots

」で使用します

API制限

• 出荷サイズに関係なく応答あたり

64KB

の制限

• 50パッケージの出荷では、パッケージでどれほどの追跡情報が利用可能なのかによって、最初の15パッケージのみを返すことができます。

• バッチではない処理と追跡番号のバッチアップロードをしないこと

•

API

は単一の追跡または各追跡リクエストのリファレンス番号のみを追跡します。

• パッケージスキャンと重量情報は

6

か月利用できます

• リファレンス番号追跡は

4

か月利用可能です

• 配送スキャン情報は

18

か月利用可能です

(31)

29

スモールパッケージのみ45カ国で利用可能です利用可能なバージョン:

XMLおよびWebサービス

利用可能なモード: パッケージのみ

アクセス要件:

UPS承認ビジネスモデルについて

はテストおよび本番用アクセスのために1つのリクエスト

可視性ビジネスプロセス

^（続）

UPS Signature Tracking® API

UPS Signature Tracking API

は

Tracking API

と同じ情報を提供します。

• 受取人の名前と住所

• C .O .D.集金額

•

Proof of Delivery

(

POD

)署名画像

マーチャントはPOD文字画像をシステムに統合し、バイヤーに積極的にPODレターを自動的に、または不払いまたはPODのリクエストに対応して、電子メール、

郵送、またはファックスします。POD文字に受取人の署名が含まれる場合（集荷時）、このソリューションは標準的なTracking APIにより提供される「明確な」

（UPSドライバーサービスプロバイダーによって入力される）署名情報を満たさないバイヤーの要求を満たすことができます。

注記: リクエストの処理には、アカウント番号がMy

UPS IDアカウントサマリに含まれており、追跡される

追跡番号がそのアカウント番号で生成されていることが必要です。アカウントがXMLリクエストで使用されるMy UPS IDに対するMy UPS IDアカウントサマリに追加されない限り、ほかのアカウントで生成された追跡番号は使用できません。

• マーチャントの

Web

サイトと

Web

でないバックエンドシステムで使用

• 指定されたイベントまでアウトバウンドパッケージごとに追跡する「

robots

」で使用します

API制限

•

Tracking APIと同じ

• 署名の保管に関する追加の制限は

18

か月です

(32)

30 Paperless Document API

Paperless Document API

は、発送に関連する資料画像をアップロードする機能があります。これは、紙の出荷書類をパッケージに添付する必要性や、処理の遅延に関連する問題をなくします。この

API

は、

Shipping API

や他の積荷目録システムに関連して使用されます。この機能は本質的に、書類が紛失したり損傷したりしてしまうわずらわしさをなくし、処理のために必要な出荷と書類画像のシームレスで自動的なリンクを可能にします。

注記: 有効な6桁の番号を持ち、UPSバックエンドシステム内のアカウントのUPS Account Managerによって有効にして、ups .comのUpload My Formsまたは Paperless Document APIを使用する必要があります。Upload Formsの送り主の番号がバックエンドシステム内で有効ではない場合、Paperless Document API では難しいエラーが発生します。

スモールパッケージは66カ国で利用可能です利用可能なバージョン:

Webサービス

利用可能なモード: スモールパッケージ

アクセス要件:

UPS承認ビジネスについては

テストおよび本番用アクセスに1つのリクエスト

Paperless Document API処理の理解

•

Paperless Document APIWeb

サービスは

3

つの操作で構成されています。

1 . Forms Historyに資料をアップロードします（34ペ

ージのAPI制限を参照）。

2

. アップロードされた資料を削除します（リクエストを削除するごとに

1

つの資料

ID

）。

3

.

Image Repository

にアップロードされた資料をプッシュします。

注記: 作成された資料画像のアップロード、削除、プッシュリクエストを開始するために、アプリケーションによって必要な情報を収集する入力画像を構築する必要があります。

(33)

31 国際貿易ビジネスプロセス

^（続）

Paperless Document API（続）

Shipping API

または他の積荷目録システムとともに

Paperless Document API

を使用する時、

2

つのオプションがあります。

オプション1:

手順

1

:

Paperless Document API

に進み、アップロードリクエストを完了します。

Forms History

に資料をアップロードし、ドキュメント

ID

を受け取ります。

手順2:

Shipping APIに進み、リクエストを提出して、

手順1からドキュメントIDとともに国内または国際出荷を作成します。Shipping APIは、資料をフォームリポジトリに内部でプッシュし、応答でフォームグループIDを返します。

オプション2:

手順1:

Paperless Document APIに進み、アップロード

リクエストを完了します。Forms Historyに資料をアップロードし、ドキュメントIDを受け取ります。

手順

2

:

Shipping API

に進み、リクエストを提出して、

国内または国際出荷を作成します。出荷

ID

番号および追跡番号を受け取ります。

手順

3

:

Paperless Document API

に進み、手順

1

のドキュメント

ID

と手順

2

の出荷

ID

番号と追跡番号を提供します。

Push To Image Repository

Request

に記入します。これは、資料をフォー

ムリポジトリにプッシュし、フォームグループ

ID

をお客様に返します。

• 国際ビジネスプロセスまたは他のバックエンドシステム内の資料を必要とする出荷で使用します。

これは、

Web

のホスティング用ではありません。

API制限

•

API

は複数のファイルと各ファイルの複数の資料を処理する能力があります。

– すべてのファイルの最大許可サイズが

5MB

なのに対して、各ファイルの最大許可サイズは

1MB

です。

– 各ファイルまたは発送ごとの合計で、13ファイル以上にならないリクエストにつき、最大13ファイル許可されます。

• 各資料画像に対して

2

つの手順があります。

手順1: 画像をアップロードします。

手順

2

:

Shipping API またはPaperless Document API

のどちらかで画像を提出します。

(34)

32

スモールパッケージは32か国で利用可能です利用可能なバージョン:

Webサービス

アクセス要件:

UPS承認ビジネスについては

テストおよび本番用アクセスに1つのリクエスト

UPS TradeAbility® APIs

UPS TradeAbility

は、情報ベースのサービスを提供し、

国際的な商品の移動を効率的に管理できるようにします。

TradeAbility APIs

は、規制コンプライアンスを改善し、運営費用を削減して、グローバルなサプライチェーンと国際貿易のプロセスを合理化します。

•

Landed Cost API

国際出荷のコストをなくします。関税、税が含まれます。

Landed Cost

の見積りにはデフォルトで特定関税料金が含まれる場合があります。適用されるこれらの料金については、出荷時に、送り主が適切な資料を同封して提出する必要があります。

トランザクションは

1

カ所から

1

カ所への発送につき、最大

99

製品を含むことが可能です。ランデッドコストのもっとも正確な予想を提供するため、

サービスはインタラクティブなクエリで予想を絞り込み、

QueryRequest

要素を使用して返答することができます。ユーザーはリクエストを再発行し、

EstimateRequest

要素を使用して回答を含めます。

UPS

が必要な情報をすべて受け取ったら、ランデッドコストの予想が提供されます。

•

Denied Party Screener API

1つのソースから、米国政府の監視対象である人物を

判断し、最新の正確な政府規制コンプライアンスに順守します。単一のトランザクションと、異なるマッチ設定を許可することで、名前が付いたパーティと目的地の国について、単一ソースの幅広い検索とチェックを可能にします。さらに、否定についての特定の理由とリストソースについての特定の理由を提供します。

•

Import Compliance API

輸入前に、国特有の貿易関係、手順、規制を最大限遵守して、国境での遅延をなくすようにサポートします。

Import Compliance

トランザクションの詳細は保管され、

90

日間アクセスできます。トランザクションは

1

カ所から

1

カ所への発送につき、最大

99

製品を含むことが可能です。

•

Export License Detector API

目的地の国や輸出分類番号などの商品情報に基づいて、最新の米国輸出ライセンス要件にアクセスし、罰金や制裁のリスクをなくすようにサポートします。

(35)

33 国際貿易ビジネスプロセス

^（続）

UPS TradeAbility API（続）

• エンドユーザー向けの承認

• 未承認サードパーティによる

TradeAbility API

のホスティングをしてはなりません

API制限

• 統一コードの検索機能を提供してはなりません

• 時代遅れの関税コードと地方の規則

(36)

ソースセンター

UPS 開発者向けキット

(37)

35 リソースと技術サポートへのアクセス

UPS開発者向けキットのユーザーは、UPS開発者向け

リソースセンターを通して、情報にアクセスし、ツールをダウンロードし、技術サポートをリクエストできます。

以下の手順で開発者向けリソースセンターにアクセスできます。

手順1: ups .comにアクセスします

手順

2

: サポートタブにマウスを置き、技術サポートを選択します

手順

3

: ページの左にあるナビゲーションパネルで、

リンク開発者向けリソースセンターを選択します

(38)

36

情報にアクセスし、UPS開発者向けリソースセンターを通してツールとアプリケーションをダウンロードします。

UPS開発者向けキットソリューション

• 開発者向け

API

UPS

開発者向けキットのアプリケーションプログラムインターフェース（

API

）とともに、

UPS

の機能をお客様のアプリケーションおよびビジネスシステムに統合します。

• データファイルと管理アプリケーション

請求データ情報、請求分析ツール、

ups.com

からお客様のコンピュータに自動的にファイルをダウンロードする機能などを備えています。

•

UPS Information Exchange

UPS

システムへ安全にアクセスするためのその他のツールとアプリケーションを検索できるほか、

PLD

0200

準拠のマニフェストデータをアップロードしたり、

CSV

ファイルおよび

XML

(可能な場合)ファイルをダウンロードしたりすることができます。

(39)

37 技術サポート

UPS開発者向けキットAPIのサポートを得るには4つの

方法があります。すべてはUPS開発者向けリソースセンターを通してアクセスできます。UPS開発者向けリソースセンターへのアクセスに関する指示は、38ページを参照してください。

UPS開発者向けキットサポート

•

UPS開発者向けキットコミュニティ

これは開発者向けのコミュニティフォーラムで、別の質問に回答し、情報を共有します。応答時間は変わる場合があります。

• 電子メールによる技術サポート（推奨される方法）

これは、技術サポートと

API

統合に関する質問に対するサポート方法です。

My UPS

にログインし、

XML

リクエスト/応答ファイルと、統合に関する別の適切な情報を添付することでアクセスできます。

UPS

の電子メールによる技術サポートは、

XML

リクエスト/応答ペアのみをサポートします。彼らは、

XML

を内部および購入済みのソフトウェアに統合する方法については、お客様と開発者に助言できません。

(40)

38 UPS開発者向けキットサポート（続）

• 一般的な質問に対する電話サポート

電話サポートは、開発者のための最少の包括的なサポートメカニズムです。このサポート方法は、

ups i

.

com

でユーザーインターフェースについての質問と、

API

へのアクセス方法に対処し、アクセスキーリクエストプロセスに移動します。

XML

リクエスト/応答の問題と質問に対する技術サポートを提供しません。これらのタイプの質問は、

UPS

電子メール技術サポートを経由する必要があります。

•

UPS開発者向けキットの知識ベース

これは、開いたりダウンロード可能な、セルフサービスサポートのPDF資料です。これには、UPS開発者向けキットAPIによってサポートされるすべてのモードとサービスに関する、よくある質問を240個以上含みます。また、UPS開発者向けキットコミュニティでは、オンラインバージョンもご用意しています。

(41)

39 技術サポート

^（続）

一般的な電子メールによる技術サポート

手順

1

: 開発者向けリソースセンターページから、

右のカラムにある

E

-

mail UPS

を選択します。

手順

2

: 名前、電子メールアドレスフィールドに記入し、サポートカテゴリは技術サポートにして、サポートトピックは開発者向けリソースにして、次へをクリックします。

(42)

40

一般的な電子メールによる技術サポート（続）

手順

3

: ページをスクロールダウンし、フォームの残りに記入します。

– 電話番号 – 開発段階

– 統合する

API

である開発者向けリソース

•

XML

リクエスト/応答ペアに添付する添付ファイル

• ［質問とコメント］「フィールドに問題の適切な説明を含みます。

• ［電子メールの送信］ボタンを選択します。

(43)

41 技術サポート

^（続）

技術サポートの営業時間

UPS

は、統合プロセス中はいつでも、お客様の知りたいことを教える方法をたくさん用意しています。

UPS

開発者向けリソースセンターは、さまざまなサポートオプションを提供します。

ups.com/content/jp/ja/resources/techsupport/

developercenter.html

注記: 電子メールのリクエストを送信すると、応答時間は変わる場合があり、トランザクションと上申によってプロセスが遅延する場合があります。XMLリクエスト/応答メッセージおよびエラーを含むファイルを添付する必要があります。UPSでは可能な限り、24時間以内に対応いたします。

ユーザーガイド UPS 開発者向けキット 2014 United Parcel Service of America, Inc. UPS UPS のブランドマーク color brown は United Parcel Service of America, Inc. の商標です All right

UPS ® 開発者向けキット

i

UPS開発者向けキットユーザーガイド

. . . . 3

. . . . 5

. . . . 18

. . . . 26

. . . . 30 UPS開発者向けリソースセンター

. . . . 35

. . . . 36

. . . . 37

1

UPS

UPS

API

UPS

UPS

e

Web

UPS

API

11

Web

ups.comのUPS開発者向けキットページ

ups.com/developerkit

UPS 開発者向けキット

3

技術的な問題

APIをダウンロードする前に、以下に精通している必

URL

XML

XML

Web Services

Package

LTL Freight

Air Freight

API

API

APIに採用するカスタムコードを、API機能をeコマー

Perl、PHPを含む開発者ガイド（技術FAQを含む）、

UPSロゴとバナー、コードサンプル

UPS 開発者向けキット

5

はじめに

i

ups.com

UPS

6

2

username

7

はじめに

Developer APIで、必要なそれぞれのAPIに対す

8

1. 選択したAPIのzipファイルのダウンロード 2.

3. ローカルコンピュータの抽出ファイル

API

WSDL

9

はじめに

UPSはすべてのAPIのアクセスキーにアクセス可能なテ

API

API

2

Locator

LTL Freight API

Pickup

Rating

Shipping

1. アカウントの情報の提供 2. アカウント情報の認証

3 .

10

11

はじめに

1. アカウント認証の提供

2 .

3 .

12

13

UPS ^® 開発者向けキット