# EDI

> 電子データ交換（EDI）発注書システムにより、発注書が貴社のERPや注文管理システムに直接送信され、注文の受け取りが簡素化されます。

Source: https://www.purchaseplus.com/ja/docs/for-suppliers/electronic-data-interchange-edi-purchase-orders

Markdown: https://www.purchaseplus.com/ja/docs/for-suppliers/electronic-data-interchange-edi-purchase-orders.md

# EDI
移動先：

-   [概要](#Overview)
-   [メリット](#Benefits)
-   [利用の開始手順](#GettingStartedWithEDI)
-   [対応データ形式](#SupportedFormats)
-   [JSONペイロードのサンプル](#SampleJSONPayload)
-   [重要なフィールド](#ImportantFields)

### 概要

当社の電子データ交換（EDI）発注書システムは、発注書を貴社のERPまたは注文管理システムに直接送信することで注文の受け取りを効率化し、手動でのデータ入力の手間を省きます。

発注書の受け取りには、特に中規模から大規模のサプライヤー様や、高度なシステム連携機能を備えたサプライヤー様にEDIをお勧めしています。

### メリット

EDI発注書を導入すると、ERP（Enterprise Resource Planning）や注文管理システムに発注書を手動で入力する必要がなくなるため、サプライヤー業務の効率化が図れます。また、入力ミスが減ることで精度が向上し、バイヤーとサプライヤー間の注文処理スピードも向上します。データ交換が迅速かつ正確になれば、注文に関するトラブルが減少し、バイヤー、サプライヤー、そして当社の三者すべてにメリットがもたらされます。

従来、スパムフィルターにより誤ってメールがブロックされ、サプライヤーに発注書のメールが届かないというトラブルが発生することがありました。マネージドメールサービスを使用しているものの、このようなメールブロックを完全に防ぐことはできません。

また、EDIで使用されるHTTPSやSFTPといったプロトコルは、メールに比べて安全かつ堅牢に機密性の高い注文情報をやり取りできる手段であると考えています。

### 利用の開始手順

1.  エンドポイントの設定: 注文を受信するためのエンドポイントを設定する必要があります。または、貴社側もしくは当社側でSFTPディレクトリを設定することも可能です。
    
2.  お問い合わせ: エンドポイントの準備が整いましたら（またはSFTPディレクトリの作成をご希望の場合）、エンドポイントの詳細を添えて当社チーム（[help.suppliers@purchaseplus.com](mailto:help.suppliers@purchaseplus.com)）までご連絡ください。
    
3.  統合・連携: 貴社のエンドポイントを当社のシステムに登録します。
    
4.  テスト: スムーズな移行を確実にするため、1〜2社のバイヤーを新しいエンドポイントに切り替えて小規模なテストを実施できます。あるいは、試用期間中にメールとEDIを並行して運用することも可能です。
    
5.  パイロット運用: 貴社と協力してテスト用の顧客グループを少数選定し、新しいエンドポイントへ切り替えます。
    
6.  本番適用: 問題がないことを確認した上で、すべての注文をEDIに切り替えます。
    

### 対応データ形式

EDIトランザクションでは主にJSONをサポートしています。XMLでの送信も可能であり、ご要望に応じてサンプルペイロードを提供できますが、cXMLには対応していません。

### JSONペイロードのサンプル

`{     "purchase_orders": [       {         "purchase_order": {           "identity": "singer.test.sleep",           "purchaser": {             "id": 262388,             "name": "Sample Purchaser",             "customer_number": "PUR12345",             "requestor": "Han Solo",             "phone": "1300 123 456",             "email": "han.solo@purchaseplus.com"           },           "supplier": {             "name": "Sample Supplier",             "vendor_number": "SUP98765"           },           "purchase_order_number": "PO00001",           "purchaser_reference": "Daily food order",           "supplier_reference": null,           "expected_delivery_date": "2025-03-15",           "sent_date": "2025-03-15T05:51:57.122Z",           "cancelled": false,           "comments": [],           "confirmation_instructions": "Confirmation instructions example.",           "delivery_instructions": "Delivery instructions example.",           "delivery_address": {             "location_name": "Default",             "line1": "Level 4, 11 York Street",             "line2": "",             "city": "Sydney",             "state_province": "NSW",             "postal_code": "2000",             "country_code": "AU"           },           "currency": "AUD",           "net_amount": 826.1,           "delivery_amount": 0,           "tax_amount": 20.25,           "gross_amount": 846.35,           "lines": [             {               "code": "YOGH",               "brand": "Farmers Union",               "item_description": "Greek Style Yoghurt : Natural",               "item_size": 1,               "item_measure": "lt",               "item_package": "tub",               "pack_quantity": 1,               "pack_name": "each",               "gs1_code": null,               "order_instruction": null,               "unit_price": 6.75,               "quantity": 30,               "net_amount": 202.5,               "tax_amount": 20.25,               "gross_amount": 222.75,               "is_purchaser_price": true             },             {               "code": "WMBD",               "brand": "Mighty Soft",               "item_description": "Bread Sliced Wholemeal Sandwich Frozen",               "item_size": 650,               "item_measure": "g",               "item_package": null,               "pack_quantity": 10,               "pack_name": "carton",               "gs1_code": null,               "order_instruction": null,               "unit_price": 20,               "quantity": 25,               "net_amount": 500,               "tax_amount": 0,               "gross_amount": 500,               "is_purchaser_price": true             },             {               "code": "MILK",               "brand": "Pauls - Professional",               "item_description": "Milk : Full Cream",               "item_size": 3,               "item_measure": "lt",               "item_package": "bottle",               "pack_quantity": 6,               "pack_name": "carton",               "gs1_code": null,               "order_instruction": null,               "unit_price": 8.24,               "quantity": 15,               "net_amount": 123.6,               "tax_amount": 0,               "gross_amount": 123.6,               "is_purchaser_price": true             }           ]         }       }     ]   }` 

### キャンセル処理

稀に、バイヤーがユーザーインターフェースから注文をキャンセルし、キャンセル通知の送信を選択する場合があります。この場合、cancelled フィールドが true に設定された webhook ペイロードの複製が送信されます。

これらを完全に除外して処理するか、サポートチームへ通知するように設定してください。

システムによるキャンセル処理が常に確実に行われるとは限らないため、注文のキャンセルや変更を行いたい場合は、直接サプライヤーに連絡するようユーザーに案内しています。

### 重要なフィールド

| **フィールド** | **説明** |
| --- | --- |
| `identity` | 特定のサプライヤーアカウントとバイヤーアカウントの関係を表す、一意の3単語の識別子です。この識別子はバイヤーとサプライヤーの組み合わせごとに固有であり、PurchasePlus に請求書を送信する際の `identity` として使用できます。 |
| `vendor_number` | 貴社のシステム内で各バイヤーに割り当てる一意の識別子です。これにより、異なるシステム間でバイヤーのクロスリファレンスが可能になります。このフィールドは PurchasePlus ポータルで更新できます。 |
| `purchase_order_number` | バイヤーによって割り当てられた発注書番号です。グローバルで一意ではありませんが、単一のバイヤーのコンテキスト内では一意です。一意のキーを作成するには、このフィールドと vendor_number フィールドを連結します。重要：PurchasePlus ユーザーが「購入者コード」フィールドを空白のままにした場合、この連結を一意のキーとして使用すると問題が発生する可能性があります。 |
| `cancelled` | MarketBoomer UI でバイヤーによって発注書がキャンセルされたかどうかを示すブール値フラグです。`true` の場合、発注書はキャンセルされています。キャンセルが発生すると、MarketBoomer はこのフィールドを `true` に設定して発注書を再送信します。貴社システムが注文キャンセルに対応していない場合、このフィールドの処理は任意ですが、対応を推奨します。 |
| `lines.code` | 当社システム内の各製品に割り当てられた一意の製品コードです。このフィールドは、新しい PurchasePlus の「オーナーコード」または Legacy PurchasePlus の「サプライヤーコード」に対応します。このコードは各 PurchasePlus インターフェース内で更新できます。 |

当社システム内の各製品に割り当てる一意の製品コードです。このフィールドは、PurchasePlus の「オーナーコード」または Legacy PurchasePlus の「サプライヤーコード」に対応します。このコードはそれぞれの PurchasePlus インターフェース内で更新できます。
