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

Transcription

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

2 目次 はじめる前に技術的問題点とアクセス要件... 3 実装はじめに... 5 製品概要出荷と評価ビジネスプロセス 可視性ビジネスプロセス 国際貿易ビジネスプロセス UPS 開発者向けリソースセンターリソースと技術サポートへのアクセス リソース 技術サポート i

3 へようこそ 本ガイドでは 開発者向けキットとサーバーにアクセスして UPS とテストし取引する方法についての情報を説明します 操作時間や応答時間を含む API の技術サポートに関する詳細情報も説明します ups.com の UPS 開発者向けキットページこのページにアクセスするには 以下にアクセスします ups.com/developerkit UPS 開発者向けキットは UPS の機能性をビジネスシステムおよび e コマース Web サイトに直接統合する上での柔軟性を提供します UPS は API 経由で 11 の機能を提供するため ビジネスプロセスの効率性を改善し 顧客の Web エクスペリエンスを向上させることができます 1

4 はじめる前に UPS 開発者向けキット

5 技術的な問題 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 ロゴとバナー コードサンプル 3

6 実装 UPS 開発者向けキット

7 はじめに iups.com で UPS 開発者向けキットセクションにアクセスするには [ サポート ] メニューの [ 技術サポート ] を選択します [ 技術サポート ] ページにアクセスし [ ツール ] と [ リソース ] の [UPS 開発者向けキット ] を選択します 5

8 はじめに ( 続 ) 手順 1: My UPS に登録すでに登録されている場合 手順 4 にスキップします 手順 2: ログイン username を入力します [ 次へ ] をクリックします それから パスワードを入力するようにプロンプトが表示されます 資料ファイルをダウンロードするためにログインする必要があります 6

9 はじめに ( 続 ) 手順 3: API の選択 Developer API で 必要なそれぞれの API に対する要件を探し ダウンロード可能なファイルならびに特定の国のアベイラビリティにアクセスすることができます 本ガイドの 21 ページ目にある製品概要セクションも参考にできます 7

10 はじめに ( 続 ) 手順 4: API 資料のダウンロード 1. 選択した API の zip ファイルのダウンロード 2. プロンプトが表示されたら [ 保存 ] をクリックします 3. ローカルコンピュータの抽出ファイル ダウンロードされたファイルには ソフトウェア開発者向けキットが含まれます 統合する API に対する開発者ガイド全体を注意深く確認します ソフトウェア開発者向けキットには サンプルコードと WSDL も含まれます 8

11 はじめに ( 続 ) UPS はすべての API のアクセスキーにアクセス可能なテスト環境を提供します これは XML または Web サービスリクエストをきちんとフォーマット設定するためにライブでリクエストと 応答メッセージの発信をシミュレーションできます ほとんどの API では テストと本番用環境の両方にすぐにアクセスできます しかし 以下の API で本番用のアクセスを有効にするためには 2 回目のリクエストが必要になります Locator および LTL Freight API(Pickup Rating Shipping) です 手順 5: アクセスキーのリクエストソフトウェア開発者向けキットを確認したら UPS テスト環境へのアクセス権をリクエストする必要があります 以下を行うように求められます 1. アカウントの情報の提供 2. アカウント情報の認証 3. 認証したら リクエストが受け付けられたことの確認通知を受信します 9

12 はじめに ( 続 ) 手順 5: アクセスキーのリクエスト ( 続 ) アカウント情報の提出 10

13 はじめに ( 続 ) 手順 5: アクセスキーのリクエスト ( 続 ) 1. アカウント認証の提供 2. 認証が完了したら [ アクセスキーのリクエスト ] ページに戻ります 3. 下にある [ アクセスキーのリクエスト ] をクリックします 注記 : Account Invoice Authentication(AIA) は Shipping および Rating API 経由で交渉料金を表示するために必要です My UPS(ups.com) で AIA 認証に対する最新の請求書のコピー (45 日間以内 ) があることを確認します 11

14 はじめに ( 続 ) 手順 5: アクセスキーのリクエスト ( 続 ) リクエストが受け付けられた確認通知を見て 確認メールを受信します 12

15 アクセスと管理 アクセスキーの表示 / 更新 アクセスキーを管理および更新するには [UPS 開発者向けキット ] ページに移動し [ アクセスと管理 ] セクションの [ アクセスキーの管理 ] を選択します 13

16 アクセスと管理 ( 続 ) アクセスキーの表示 / 更新 ( 続 ) [ アクセスキーの表示 / 更新 ] セクションにアクセスキーを入力します 次のセクションでは 入力したキーに対して ステータスとともに API のリスト ( テストまたは本番用 ) を表示します 注記 : そのページから 本番用アクセスまたは新しいアクセスキーもリクエストします 14

17 アクセスと管理 ( 続 ) アカウント / 連絡先情報の編集 主要連絡先および代替連絡先情報のみならず アカウント情報を更新するには [UPS 開発者向けキット ] ページに移動し [ アクセスと管理 ] セクションの [ 管理 ] を選択します 15

18 アクセスと管理 ( 続 ) アカウント / 連絡先情報の編集 ( 続 ) 連絡先情報が表示されます [ 編集 ] を選択して変更します 注記 : UPS 証明書に対する変更やその他の大きな変更に関する特定の電子メール通知では 連絡先情報が最新のものであることが非常に重要です また インテグレーターを使用した場合 重要な情報を受け取れるように 連絡先情報が会社の IT 連絡先に変更されていることが重要です 変更を行うための新しい画面が表示されます 終了したら [ 変更の保存 ] をクリックします 16

19 製品概要 UPS 開発者向けキット

20 出荷と評価ビジネスプロセス アドレス認証 API Web ページまたは Web でないオーダーシステムのいずれに統合するのかにかかわらず Address Validation API を使用すると バイヤーが提供した市町村 - 都道府県 - 郵便番号の組み合わせを UPS の中央コンピューター ( サーバー ) に維持されているものと比較できるようになります 組み合わせが有効ではない場合 UPS は市区町村 都道府県 郵便番号の候補のリストをアプリケーションに返します UPS は最大 10 個の住所の候補を提供します 承認されているビジネスモデル 出荷のために UPS に提供される積荷の住所確認 承認されていないビジネスモデル / 使用法 住所データベースの スクラビング UPS 出荷以外の用途のための住所確認 利用可能な国 : 利用可能なバージョン : 利用可能なモード : アクセス要件 : API 制限 米国およびプエルトリコのすべての交通手段 XML のみ すべてのモード テストおよび本番用アクセスに 1 つのリクエスト 米国およびプエルトリコの住所のみ確認が可能 API 応答では緯度経度座標は提供されません 市区町村 - 都道府県 - 郵便番号の組合せの確認のみ 番地を含む住所ではない 1 回のリクエストあたり 1 つの市区町村 - 都道府県 - 郵便番号の組合せのみ確認します UPS 住所データベースは USPS によって提供された情報で毎月更新されます CASS 認定の検証用エンジンではありません CASS AV ソフトウェアの要件に代わるものではありません 18

21 出荷と評価ビジネスプロセス ( 続 ) Address Validation Street Level API Web ページまたは Web でないオーダーシステムのいずれに統合するのかにかかわらず Address Validation Street Level (AVSL) API を使用すると バイヤーが提供した番地 - 市町村 - 都道府県 - 郵便番号の組み合わせを UPS の中央コンピューター ( サーバー ) に維持されているものと比較できるようになります 組み合わせが有効ではない場合 UPS は番地 市区町村 都道府県 郵便番号の候補のリストをアプリケーションに返します UPS は最大 10 個の住所の候補を返します さらに 米国とカナダ ( 分類は USPS 情報に基づかない UPS 内部の活動分類 ) について AVSL API は事業用 / 住宅の住所を分類します 承認されているビジネスモデル 配送のために UPS によって提供される住所確認 承認されていないビジネスモデル / 使用法 住所データベースの スクラビング UPS 出荷以外の用途のための住所の確認 利用可能な国 : 利用可能なバージョン : 利用可能なモード : アクセス要件 : API 制限 米国およびプエルトリコではすべての交通手段 XML および Web サービス すべてのモード テストおよび本番用アクセスに 1 つのリクエスト 米国およびプエルトリコの住所のみ確認が可能 米国およびカナダの住所のみを分類 ( 商業 / 住居 ) します リクエストあたり 1 つの番地 市区町村 都道府県 郵便番号の組合せのみ確認します アパートメントまたは部屋が API リクエスト内で提供される場合 またはアパートメントまたは部屋が UPS データベースに存在する場合のみ アパートメントまたは部屋を検証します API 応答では緯度経度座標は提供されません UPS 住所データベースは USPS によって提供された情報で毎月更新されます CASS 証明アプリケーションではありません CASS AV ソフトウェアの要件に代わるものではありません 19

22 出荷と評価ビジネスプロセス ( 続 ) Locator API Locator API では 住所や電話番号を使用して ユーザーが地域の UPS サービスを見つけることができます Locator API では UPS のフルサービスおよびセルフサービスの場所 営業時間 ピックアップ時間を提供します Locator API は 所在地 追加のサービス プログラムタイプ タイプコード 所在地が店舗の場合を含む 別の構成情報を示すようにカスタマイズできます さらに Locator はインタラクティブなマップを提供し 最大 10 の UPS 所在地と経路案内を表示します ( 利用可能な場合 ) 次のような所在地の検索 : The UPS Store Mail Boxes Etc. UPS お客様サービスセンター UPS ドロップボックス スモールパッケージにのみ 27 カ国で利用可能です 利用可能なバージョン : 利用可能なモード : アクセス要件 : XML 承認されているビジネスモデル パッケージ テストおよび本番用アクセスにつき 2 つの別のリクエスト マーチャントの Web サイトと Web でないバックエンドシステムで使用 承認されていないビジネスモデル / 使用法 サードパーティのロジスティクスプロバイダーで使用 API 制限 緯度経度座標は提供されません マップは提供されません UPS Express UPS 提携店 UPSリテールパートナー UPS 指定の取扱い業者 20

23 出荷と評価ビジネスプロセス ( 続 ) Pickup API Pickup API では ユーザーが自宅やオフィスからの UPS のピックアップをスケジュールできます 前に処理されたパッケージ 運賃発送 または新しい出荷のピックアップもスケジュールできます さらに UPS の環境にやさしい収集オプションは スモールパッケージ Pickup API で利用できます スモールパッケージと LTL Freight については 36 か国で利用可能 利用可能なバージョン : 利用可能なモード : アクセス要件 : Web サービス Package LTL Freight テストおよび本番用アクセスに対して Pickup API Small Package のリクエスト 1 つ テストおよび本番用アクセスに対して Pickup API Ground Freight の別のリクエスト 2 つ 承認されているビジネスモデル マーチャントの Web サイトと Web でないバックエンドシステムで使用 承認されていないビジネスモデル / 使用法 ピックアップリクエストのサードパーティのホスティング サードパーティのロジスティクスプロバイダーで使用 API 制限 なし 21

24 出荷と評価ビジネスプロセス ( 続 ) Rating API Rating API は UPS によるサービスが利用可能なすべての目的地に対して UPS スモールパッケージおよび UPS Freight LTL サービスレベルの料金 ( 毎日のピックアップ オンデマンド または店舗 ) を提供します Rating API は 利用可能なすべての料金 ( ショップ オプション ) や 特定のサービスレベルの料金 ( 料金 ] オプション ) を示すように設定できます 公表されている料金がデフォルトで示されます アカウント固有の交渉料金は My UPS タブにある ups.com の [ アカウントサマリ ] または [ アカウントメンテナンス ] ページにある [ アカウント請求書による承認 ] によって有効にすることができます 詳細については 本ガイドの 11 ページを参照してください Rating API は Ground(Timein-Transit API がこの情報に使用される必要があります ) 以外のすべてのサービスの配送日と配送時間をお知らせします 承認されているビジネスモデル マーチャントの Web サイトと Web でないバックエンドシステムで使用 承認されていないビジネスモデル / 使用法 競合料金と並べて比較した UPS 料金の表示 スモールパッケージでは 66 か国で LTL Freight では 4 か国で Air Freight では 36 か国 (Gemini API) で利用できます 利用可能なバージョン : 照 ) XML および Web サービス ( メモを参 利用可能なモード : Package LTL Freight (1) Air Freight (2) アクセス要件 : 注 : (1) LTL Freight 専用の Web サービス (2) Gemini API XML 経由専用の Air Freight API 制限 単一パッケージの発送料金のみ 限定された付帯項目のみをサポート : 保険価額 土曜集荷 土曜配達 追加取扱 LTL Freight に対するテストおよび本番用アクセスの異なる 2 つのリクエスト Gemini API リクエストフォーム経由の Air Freight に対する手動リクエスト (ups.com で UPS 開発者向けキットのリンクを参照してください ) Air Freight の料金は Gemini APIs を使用する必要があります Gemini APIs リクエストフォームおよび開発者ガイドへのリンクについては UPS 開発者向けキットホームページと Announcements および API Update セクションを参照してください この API へアクセスするには リクエストフォームをきちんと読んでください 22

25 出荷と評価ビジネスプロセス ( 続 ) Shipping API Shipping API は 企業システムと Web サイトでの UPS の出荷機能の統合をサポートします 統合では 出荷への便利で管理されたアクセスにより内部プロセスをサポートしながら ユーザーがキーを入力する必要なく 送り主のアプリケーションからのデータを使用できます Shipping API は 海外からの返品を含む スモールパッケージ全体の UPS Returns ポートフォリオもサポートします UPS の住宅 / 事業用住所の分類と 市区町村 都道府県 郵便番号の確認も行われます UPS Shipping API の統合は 大幅なプログラミング時間と専門知識が必要です Shipping API の能力 プロセスは次の 2 段階で構成されます [Ship Confirm( 出荷確認 )] 段階は [Ship Accept( 出荷受付 )] 段階に続きます XML リクエスト / 応答のペアは それぞれの段階でクライアントとサーバーの間で交換されます 出荷のキャンセルや無効化は手順とメッセージの入力を必要とすることに注意してください スモールパッケージでは 66 か国で LTL Freight では 4 か国で Air Freight では 36 か国 (Gemini API) で利用できます 利用可能なバージョン : XML および Web サービス ( メモを参照 ) 利用可能なモード : Package LTL Freight (1) Air Freight (2) アクセス要件 : 注 : (1) LTL Freight は Web サービス専用です (2) Gemini API XML 経由専用の Air Freight LTL Freight に対するテストおよび本番用アクセスの異なる 2 つのリクエスト Gemini API リクエストフォーム経由の Air Freight に対する手動リクエスト (ups.com で UPS 開発者向けキットのリンクを参照してください ) 承認されているビジネスモデル マーチャントの Web サイトと Web でないバックエンドシステムで使用 アクセスのためのコントロールを Web サイトに組み込むとき 23

26 出荷と評価ビジネスプロセス ( 続 ) Shipping API( 続 ) 承認されていないビジネスモデル / 使用法 競合料金と並べて比較した UPS 料金の表示 外部または Web ベースの実装において 競合者と並べての比較は行わないこと Web サイトで Shipping API のホスティングを行わないこと API 制限 処理時間の平均はトランザクションごとに 8 秒です 大容量の本番用の出荷環境には適しません 公表されている料金がデフォルトで示されます アカウント固有の交渉料金は My UPS タブにある ups.com の [ アカウントサマリ ] または [ アカウントメンテナンス ] ページにある [ アカウント請求書による承認 ] によって有効にすることができます 詳細については 本ガイドの 11 ページを参照してください サポートされていません 危険物質 World Ease バッチ処理 UPS Hundredweight Service 集約 24

27 出荷と評価ビジネスプロセス ( 続 ) Time-in-Transit API Time-in-Transit API では ユーザーがサービスごとの配送スピードを比較します それにより 出荷に最適なサービスを選択できます この API は 世界中の UPS が配送する場所で利用可能なすべての UPS 出荷サービスへアクセスできるようにします 情報には 配送日と時間 配送日数のスケジュールを含みます UPS の祝日と週末を考慮に入れた グラウンドパッケージの配送の日付と時間を提供します スモールパッケージにのみ 66 カ国で利用可能です 利用可能なバージョン : 利用可能なモード : アクセス要件 : XML および Web サービス パッケージ UPS 承認ビジネスモデルについてはテストおよび本番用アクセスのために 1 つのリクエスト 承認されているビジネスモデル マーチャントの Web サイトと Web でないバックエンドシステムで使用 承認されていないビジネスモデル / 使用法 トランザクションの関係者でない第三者の情報ロジスティクスプロバイダーによる使用 UPS の機密情報から Time-in-Transit 表を作成 API 制限 なし 25

28 可視性ビジネスプロセス Quantum View API Quantum View Data は スプレッドシートや簡単なデータベースから ERP システムまで 社内の内部アプリケーションにシームレスに統合可能な総合追跡情報を提供します 出荷状況の更新は 多くの一般的なデータファイル形式 (CSV XML TXT または EDI ANSI または EDI EDIFACT) で 必要に応じて毎時間の頻度で内部システムに自動的にダウンロードできます アウトバウンド インバウンド 第三者 - 運賃着払 第三者 UPS 荷受人請求を通して UPS のアカウントに請求される出荷に関する最新の情報 XML Quantum View サービスを理解する Quantum View は情報を イベント として示します この API で お客様のアプリケーションで自動的に Quantum View イベントを取得したり これらのイベントを他の情報システムの処理に統合したりすることが可能になります スモールパッケージのみ 31 カ国で利用可能です 利用可能なバージョン : 利用可能なモード : アクセス要件 : XML パッケージ テストおよび本番用アクセスに 1 つのリクエスト 購読この機能でどのタイプの Quantum View イベントを取得するか指定できます アウトバウンド出荷 インバウンド出荷 代理請求を使用した出荷に対して 購読をセットアップできます これらの購読には マニフェスト 出荷元 配送 例外アクティビティを含むことができます Quantum View 購読は ups.com を通して作成されます 受け取る情報や購読のタイプを管理するには ups.com ですべて行うことができます 購読を有効にするには 営業担当者に連絡する必要があります ブックマークアクティビティ量が多いユーザーに関して そしてネットワークリソースの負荷を軽減するために Quantum View API は 単一のリクエストに返す情報量を制限できます この制限は 複数を組み合わせたファイルついてはおよそ 150KB 単一のファイルでは 500KB です 制限を超えたファイルについては UPS は情報の一部を返し 特別なブックマーク要素を応答に加えます 追加情報を取得するには 元のリクエストをブックマーク要素を追加した状態で再発行します 26

29 可視性ビジネスプロセス ( 続 ) Quantum View API( 続 ) 情報形式アプリケーションが Quantum View イベントをリクエストしたとき API は前に表示していないイベントのみを返します ファイル名と日付 / 時間のリクエストは このルールにのみ期待されます 承認されているビジネスモデル マーチャント Web サイトと Web でないバックエンドシステムで使用します 承認されていないビジネスモデル / 使用法 サードパーティのロジスティクスプロバイダーで使用 API 制限 更新はバッチで処理され 1 時間ごとの更新に制限されます 変更されたもののみが 1 時間ごとのファイル更新に含まれるように ファイルを既存のデータにアペンドする必要があります マニフェスト 期待 配送スキャンのみがファイル内で提供されます 中間のスキャンではありません ( 移動中のスキャン ) 27

30 可視性ビジネスプロセス ( 続 ) 追跡 API Tracking API は透明性を提供し 顧客がリファレンスまたは注文番号を使用した e コマースサイトから 出荷を追跡できるようにします 顧客のパッケージが最終目的地に向かう間 スキャンが発生するたびに 時刻や場所など出荷状況の具体的な情報が提供されます さらに お客様のサイトの外観に合わせて 追跡情報をシームレスに混ぜることも可能です 承認されているビジネスモデル マーチャントの Web サイトと Web でないバックエンドシステムで使用 承認されていないビジネスモデル / 使用法 トランザクションの関係者でない第三者の情報ロジスティクスプロバイダーによる使用 指定されたイベントまでアウトバウンドパッケージごとに追跡する robots で使用します すべての出荷モードは 66 か国で利用可能 利用可能なバージョン : 利用可能なモード : アクセス要件 : API 制限 XML および Web サービス すべてのモード テストおよび本番用アクセスに 1 つのリクエスト 出荷サイズに関係なく応答あたり 64KB の制限 50 パッケージの出荷では パッケージでどれほどの追跡情報が利用可能なのかによって 最初の 15 パッケージのみを返すことができます バッチではない処理と追跡番号のバッチアップロードをしないこと API は単一の追跡または各追跡リクエストのリファレンス番号のみを追跡します パッケージスキャンと重量情報は 6 か月利用できます リファレンス番号追跡は 4 か月利用可能です 配送スキャン情報は 18 か月利用可能です 28

31 可視性ビジネスプロセス ( 続 ) 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 アカウントサマリに追加されない限り ほかのアカウントで生成された追跡番号は使用できません スモールパッケージのみ 45 カ国で利用可能です 利用可能なバージョン : 利用可能なモード : アクセス要件 : 承認されているビジネスモデル XML および Web サービス パッケージのみ UPS 承認ビジネスモデルについてはテストおよび本番用アクセスのために 1 つのリクエスト マーチャントの Web サイトと Web でないバックエンドシステムで使用 承認されていないビジネスモデル / 使用法 トランザクションの関係者でない第三者の情報ロジスティクスプロバイダーによる使用 指定されたイベントまでアウトバウンドパッケージごとに追跡する robots で使用します API 制限 Tracking API と同じ 署名の保管に関する追加の制限は 18 か月です 29

32 国際貿易ビジネスプロセス 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 サービス Paperless Document API 処理の理解 スモールパッケージ UPS 承認ビジネスについてはテストおよび本番用アクセスに 1 つのリクエスト Paperless Document APIWeb サービスは 3 つの操作で構成されています 1. Forms History に資料をアップロードします (34 ページの API 制限を参照 ) 2. アップロードされた資料を削除します ( リクエストを削除するごとに 1 つの資料 ID) 3. Image Repository にアップロードされた資料をプッシュします 注記 : 作成された資料画像のアップロード 削除 プッシュリクエストを開始するために アプリケーションによって必要な情報を収集する入力画像を構築する必要があります 30

33 国際貿易ビジネスプロセス ( 続 ) 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 のどちらかで画像を提出します 31

34 国際貿易ビジネスプロセス ( 続 ) UPS TradeAbility APIs UPS TradeAbility は 情報ベースのサービスを提供し 国際的な商品の移動を効率的に管理できるようにします TradeAbility APIs は 規制コンプライアンスを改善し 運営費用を削減して グローバルなサプライチェーンと国際貿易のプロセスを合理化します Landed Cost API 国際出荷のコストをなくします 関税 税が含まれます Landed Cost の見積りにはデフォルトで特定関税料金が含まれる場合があります 適用されるこれらの料金については 出荷時に 送り主が適切な資料を同封して提出する必要があります トランザクションは 1 カ所から 1 カ所への発送につき 最大 99 製品を含むことが可能です ランデッドコストのもっとも正確な予想を提供するため サービスはインタラクティブなクエリで予想を絞り込み QueryRequest 要素を使用して返答することができます ユーザーはリクエストを再発行し EstimateRequest 要素を使用して回答を含めます UPS が必要な情報をすべて受け取ったら ランデッドコストの予想が提供されます スモールパッケージは 32 か国で利用可能です 利用可能なバージョン : 利用可能なモード : アクセス要件 : Web サービス パッケージ UPS 承認ビジネスについてはテストおよび本番用アクセスに 1 つのリクエスト Denied Party Screener API 1 つのソースから 米国政府の監視対象である人物を判断し 最新の正確な政府規制コンプライアンスに順守します 単一のトランザクションと 異なるマッチ設定を許可することで 名前が付いたパーティと目的地の国について 単一ソースの幅広い検索とチェックを可能にします さらに 否定についての特定の理由とリストソースについての特定の理由を提供します Import Compliance API 輸入前に 国特有の貿易関係 手順 規制を最大限遵守して 国境での遅延をなくすようにサポートします Import Compliance トランザクションの詳細は保管され 90 日間アクセスできます トランザクションは 1 カ所から 1 カ所への発送につき 最大 99 製品を含むことが可能です Export License Detector API 目的地の国や輸出分類番号などの商品情報に基づいて 最新の米国輸出ライセンス要件にアクセスし 罰金や制裁のリスクをなくすようにサポートします 32

35 国際貿易ビジネスプロセス ( 続 ) UPS TradeAbility API( 続 ) 承認されているビジネスモデル エンドユーザー向けの承認 承認されていないビジネスモデル / 使用法 未承認サードパーティによる TradeAbility API のホスティングをしてはなりません API 制限 統一コードの検索機能を提供してはなりません 時代遅れの関税コードと地方の規則 33

36 UPS 開発者向けリ ソースセンター UPS 開発者向けキット

37 リソースと技術サポートへのアクセス UPS 開発者向けキットのユーザーは UPS 開発者向けリソースセンターを通して 情報にアクセスし ツールをダウンロードし 技術サポートをリクエストできます 以下の手順で開発者向けリソースセンターにアクセスできます 手順 1: ups.com にアクセスします 手順 2: サポートタブにマウスを置き 技術サポートを選択します 手順 3: ページの左にあるナビゲーションパネルで リンク開発者向けリソースセンターを選択します 35

38 リソース 情報にアクセスし UPS 開発者向けリソースセンターを通してツールとアプリケーションをダウンロードします UPS 開発者向けキットソリューション 開発者向け API UPS 開発者向けキットのアプリケーションプログラムインターフェース (API) とともに UPS の機能をお客様のアプリケーションおよびビジネスシステムに統合します データファイルと管理アプリケーション請求データ情報 請求分析ツール ups.com からお客様のコンピュータに自動的にファイルをダウンロードする機能などを備えています UPS Information Exchange UPS システムへ安全にアクセスするためのその他のツールとアプリケーションを検索できるほか PLD 0200 準拠のマニフェストデータをアップロードしたり CSV ファイルおよび XML( 可能な場合 ) ファイルをダウンロードしたりすることができます 36

39 技術サポート UPS 開発者向けキット API のサポートを得るには 4 つの方法があります すべては UPS 開発者向けリソースセンターを通してアクセスできます UPS 開発者向けリソースセンターへのアクセスに関する指示は 38 ページを参照してください UPS 開発者向けキットサポート UPS 開発者向けキットコミュニティこれは開発者向けのコミュニティフォーラムで 別の質問に回答し 情報を共有します 応答時間は変わる場合があります 電子メールによる技術サポート ( 推奨される方法 ) これは 技術サポートと API 統合に関する質問に対するサポート方法です My UPS にログインし XML リクエスト / 応答ファイルと 統合に関する別の適切な情報を添付することでアクセスできます UPS の電子メールによる技術サポートは XML リクエスト / 応答ペアのみをサポートします 彼らは XML を内部および購入済みのソフトウェアに統合する方法については お客様と開発者に助言できません 37

40 技術サポート ( 続 ) UPS 開発者向けキットサポート ( 続 ) 一般的な質問に対する電話サポート電話サポートは 開発者のための最少の包括的なサポートメカニズムです このサポート方法は iups.com でユーザーインターフェースについての質問と API へのアクセス方法に対処し アクセスキーリクエストプロセスに移動します XML リクエスト / 応答の問題と質問に対する技術サポートを提供しません これらのタイプの質問は UPS 電子メール技術サポートを経由する必要があります UPS 開発者向けキットの知識ベースこれは 開いたりダウンロード可能な セルフサービスサポートの PDF 資料です これには UPS 開発者向けキット API によってサポートされるすべてのモードとサービスに関する よくある質問を 240 個以上含みます また UPS 開発者向けキットコミュニティでは オンラインバージョンもご用意しています 38

41 技術サポート ( 続 ) 一般的な電子メールによる技術サポート 手順 1: 開発者向けリソースセンターページから 右のカラムにある UPS を選択します 手順 2: 名前 電子メールアドレスフィールドに記入し サポートカテゴリは技術サポートにして サポートトピックは開発者向けリソースにして 次へをクリックします 39

42 技術サポート ( 続 ) 一般的な電子メールによる技術サポート ( 続 ) 手順 3: ページをスクロールダウンし フォームの残りに記入します 電話番号 開発段階 統合する API である開発者向けリソース XML リクエスト / 応答ペアに添付する添付ファイル [ 質問とコメント ] フィールドに問題の適切な説明を含みます [ 電子メールの送信 ] ボタンを選択します 40

43 技術サポート ( 続 ) 技術サポートの営業時間 UPS は 統合プロセス中はいつでも お客様の知りたいことを教える方法をたくさん用意しています UPS 開発者向けリソースセンターは さまざまなサポートオプションを提供します ups.com/content/jp/ja/resources/techsupport/ developercenter.html 注記 : 電子メールのリクエストを送信すると 応答時間は変わる場合があり トランザクションと上申によってプロセスが遅延する場合があります XML リクエスト / 応答メッセージおよびエラーを含むファイルを添付する必要があります UPS では可能な限り 24 時間以内に対応いたします 41