読み込み中...
オンラインヘルプ
ご質問がある場合はお気軽にお問い合わせください

Automatic import »

How to import your data automatically?

Translate this page to JapaneseJapanese ?
読み込み中...
このインターフェースを利用するには、スクリプトを使用して、毎晩（例）、または1日に数回、伝票、顧客、ユーザー（オプション）、連絡先（オプション）のファイルを当社のサーバーに送信してください.
このプログラムは、以下のID、アドレス、構文を使用して、CSVまたはTXTファイル（POSTデータ内でセミコロンで区切られたファイル）を送信する必要があります:
how api works

API 経由でのアカウントへのログイン

ログインには、この ID とパスワードを使用してください:
アドレス / URL:
https://account.mydsomanager.com/api/
この情報を表示するには、ログインする必要があります
例 « Headers » 
POST ...
...
Authorization: この情報を表示するには、ログインする必要があります
...

インポートオプション

必要な場合にのみ、これらのオプションを使用してください:
パラメータ API 説明
encoding all ファイル形式
可能な値: UTF-8 (デフォルト), ISO-8859-1, ...
clear_items_not_modified items 伝票を自動的に決済する?
可能な値:
  • true:\ « STOCK\ » モード → 未決済の伝票（請求書、クレジットノート、各種取引など、まだ消込および決済されていないもの）をすべて自動的にインポートします. この場合、インポート時に存在していた伝票が次のインポート時には存在しない場合、MY DSO MANAGER は自動的にその伝票を決済済みとします.
  • false:\ « DELTA\ » モード → 前回のインポート以降に発行された新しい伝票（請求書、クレジットノート、各種取引など）と、決済済み伝票をすべてインポートします. 決済済み伝票には、'item_date_payment' 項目に、会計システムで各伝票が決済された日付が入力されています. これにより、MY DSO MANAGER もこれらの伝票を決済済みとすることができます.
デフォルト: false
replace_users_association users 顧客/ユーザーの関連付けを置き換える また 新しい顧客/ユーザーの関連付けのみを追加する?
可能な値: 0 また 1
デフォルト: 0
例 « Headers » と « Data » 
POST /api/items?encoding=UTF-8&clear_items_not_modified=true HTTP/1.1
...

data...

伝票（請求書、クレジットノートなど）の追加および変更

SSLを使用して接続を保護する
CSVファイルの列の構文:
列 説明
client_code * 顧客コード
item_amount_initial 当初の金額 税抜
item_amount_initial_inc_tax * 当初の金額 付加価値税込み
例 / 可能な値:
  • 1200
  • 1 200,00
  • 1200.00123
  • ...
item_amount_remaining 残額 税抜
item_amount_remaining_inc_tax 残額 付加価値税込み
item_business_case ケース名
item_currency 通貨
例: EUR, USD, ...
item_date_due * 支払期日
日付フォーマット: YYYY-MM-DD
item_date_issue * 発行日
日付フォーマット: YYYY-MM-DD
item_date_order 発注日
日付フォーマット: YYYY-MM-DD
item_date_payment 支払日
日付フォーマット: YYYY-MM-DD
item_erp_type ERP伝票の種類
item_file_number 書類番号
item_number * 伝票番号
item_order_number 発注番号
item_sales_administrative 営業管理担当
item_sales_manager 営業担当者
item_type * 伝票の種類Link
可能な値: AVO, DPA, FAC, ODI, RGL, TRT
item_unique_key 固有の伝票ID
例 « Headers » と « Data » 
POST /api/items HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: この情報を表示するには、ログインする必要があります
...

"item_type";"item_number";"client_code";"item_date_issue";"item_date_issue";"item_amount_initial_inc_tax";"item_currency"
"FAC";"00000123";"C0001";"2026-03-14";"2026-03-21";"6 580,10";"USD"
...
必須列 : client_code + item_type + item_number + item_date_issue + item_date_due + item_amount_initial_inc_tax

顧客の追加および変更

SSLを使用して接続を保護する
CSVファイルの列の構文:
列 説明
client_address_city 所在地 (市町村)
client_address_country 所在地 (国)
client_address_postbox 所在地 (私書箱)
client_address_state 所在地 (都道府県)
client_address_street 所在地 (番地)
client_address_street_line2 所在地 (番地 行 2)
client_address_street_line3 所在地 (番地 行 3)
client_address_street_number 所在地 (n° 番地)
client_address_zip 所在地 (郵便番号)
client_blocked ブロックされたアカウント (はい / いいえ)
可能な値: 0, 1 (デフォルト: 0 <=> いいえ)
client_blocked_date ブロックされたアカウント / 日付
日付フォーマット: YYYY-MM-DD
client_business_line 市場
client_business_name * 会社名
client_code * 顧客コード
client_comments コメント
client_commercial_email 顧客に関連付けられた営業担当者 / Eメール
client_commercial_fax 顧客に関連付けられた営業担当者 / Fax
client_commercial_firstname 顧客に関連付けられた営業担当者 / 最初の名前
client_commercial_lastname 顧客に関連付けられた営業担当者 / 名
client_commercial_matricule 顧客に関連付けられた営業担当者 / 社員番号
client_commercial_phone 顧客に関連付けられた営業担当者 / 電話
client_commercial_phone_cell 顧客に関連付けられた営業担当者 / 携帯電話
client_credit_limit リスク / 与信限度額
client_email Eメール
client_fax Fax
client_group グループ
顧客グループのリスト（カンマ区切り）
client_guarantee_insurer リスク / 保険会社保証
client_guarantee_insurer_reference リスク / 保険会社照会
client_guarantee_score リスク / スコア
client_guarantee_temporary リスク / 一時保証
client_guarantee_temporary_date_end リスク / 一時保証 / 終了日
client_guarantee_temporary_date_start リスク / 一時保証 / 開始日
client_guarantee_type リスク / 保証の種類
client_guarantees_currency リスク / 保証通貨
client_id 法的識別子
client_order_backlog オーダーリスト
client_others_guarantees リスク / その他の保証
client_payment_mean 支払い方法
client_payment_term 支払期間
client_phone 電話
client_phone_cell 携帯電話
client_siret Siret
(フランスの企業向け)
client_trading_name 登録名
client_unique_key 固有の顧客ID
client_url 会社のウェブサイト
client_vat 自社のVAT番号
例 « Headers » と « Data » 
POST /api/clients HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: この情報を表示するには、ログインする必要があります
...

"client_business_name";"client_code";"client_id";"client_address_country"
"My company";"C0001";"FR12345678";"France"
...
必須列 : client_code + client_business_name

顧客への連絡先の追加

SSLを使用して接続を保護する
CSVファイルの列の構文:
列 説明
client_code * 顧客コード
contact_collection 債権回収のための連絡先 (はい / いいえ)
可能な値: 0, 1 (デフォルト: 0 <=> いいえ)
contact_comments コメント
contact_email Eメール
contact_email_copy_collection_auto 自動配信メールのコピー (はい / いいえ)
可能な値: 0, 1 (デフォルト: 0 <=> いいえ)
contact_fax Fax
contact_firstname 最初の名前
contact_lastname * 名
contact_phone 電話
contact_phone_cell 携帯電話
contact_role 役職
可能な値:
  • accounting: 会計係
  • buyer: 仕入れ担当
  • company: 会社名
  • manager: マネージャー
  • other: その他 (デフォルト)
contact_title タイトル (様...)
contact_unique_key 固有のコンタクトID
例 « Headers » と « Data » 
POST /api/contacts HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: この情報を表示するには、ログインする必要があります
...

"contact_firstname";"contact_lastname";"contact_role";"client_code"
"Mike";"Jackson";"other";"C0001"
...
必須列 : client_code + contact_lastname

ユーザーと顧客の関連付け

SSLを使用して接続を保護する
CSVファイルの列の構文:
列 説明
client_code * 顧客コード
user_email Eメール
user_firstname 最初の名前
user_lastname * 名
user_matricule 社員番号
例 « Headers » と « Data » 
POST /api/users HTTP/1.1
Host: account.mydsomanager.com
...
Authorization: この情報を表示するには、ログインする必要があります
...

"user_firstname";"user_lastname";"client_code"
"John";"Roy";"C0001"
...
必須列 : client_code + user_lastname
If you want, you can use the path "/apiPutFiles/" to import the files asynchronously.

返されるデータ

これらのデータをPOSTした後、MY DSO MANAGERは直ちにデータを処理し、エラーの有無や追加・変更されたデータ量について応答します.
この応答は JSON 形式で、以下の情報を返します:
項目 説明
success インポートが正常に完了したかどうかを示します
可能な値: true, false
error_code エラーコード（エラーが発生した場合）
可能な値: ACCESS_DENIED, CSV_EMPTY, CSV_BAD_SYNTAX, ...
error_description エラーメッセージ（エラーが発生した場合）
exception_lines 無視された行（無視された行がない場合は定義されません）
nb_client_added 件の顧客追加
nb_client_modified 件の顧客情報の変更
nb_contact_added 件の連絡先追加
nb_item_added 件の伝票追加
nb_item_modified 件の伝票変更
nb_user_added 件のユーザー追加
nb_user_modified 件のユーザー情報変更
例 « Response » 
{
	"success": "true",
	"nb_client_added": 0,
	"nb_client_modified": 0,
	"nb_contact_added": 0,
	"nb_item_added": 5,
	"nb_item_modified": 2,
	"nb_user_added": 0,
	"nb_user_modified": 0,
	"exception_lines": {
		"line 3": "Column count doesn't match (defined=8, found=10)",
	},
}
← 戻る : オンラインヘルプ » その他の質問