取引先を登録します。取引先は販売管理・販売管理で使われます。
■API通信プロトコル
HTTPS POST
■URL
https://tsubaiso.net/customer_masters/create
■事前認証
このメソッドは事前に CL_CUSTOMER_MASTER_MGR ドメインを所有する権限での認証が必要です。
■パラメータ形式
HTTP FORM REQUEST / XML
■パラメータ
authenticity_token (必須) : 認証時に取得した値を使います。
customer_master[code] (必須): 識別コード。ユニークに設定します。
customer_master[name] (必須) : 名称
customer_master[name_kana] (必須) : 名称カタカナ
customer_master[zip] : 郵便番号
customer_master[address] : 住所
customer_master[tel] : 電話番号
customer_master[fax] : ファックス番号
customer_master[email] : メールアドレス
customer_master[administrator_name] : 取引先担当者名
customer_master[sender_name] : 振込人名 ※販売管理で銀行入金時に記載される名称を設定することで、消込時の消込先として自動選択されます。
customer_master[need_tax_deductions] :源泉徴収の有無 ※購買管理で源泉徴収対象の取引先(個人事業主の一部、弁護士等)の場合には、1 を設定します。
customer_master[dept_code] : 部門コード ※部門管理を行わない場合は不要です。
customer_master[sort_no] : 表示順序 ※識別コード順の順序で構わない場合は不要です。
customer_master[start_timestamp] : 利用開始日 ※ YYYY-MM-DD
customer_master[finish_timestamp] : 利用終了日 ※ YYYY-MM-DD
customer_master[used_in_ar] (必須): 販売管理での利用及び区分 ※ 0:使用しない 1:売掛金として 2:未収入金として
customer_master[used_in_ap] (必須): 購買管理での利用及び区分 ※ 0:使用しない 1:未払金として 2:買掛金として
customer_master[is_valid] (必須): ステータス ※有効にする場合は 1 を設定します。
customer_master[tax_type_for_remittance_charge] : 支払手数料の課税区分 ※主に海外取引が生じる場合に設定します。 0:対象外又は非課税仕入 3:共通売上分
※XML 形式でリクエストする場合は、
ルートノードは <xml> とし、その中にパラメータを記載します。
customer_master[xxx] の名称のパラメータについては、<xml> ノードの中に <customer_master> ノードを作成し、
その中にそれぞれのパラメータノードを作成して下さい。
■レスポンス形式
html / xml
※xml に指定する場合はパラメータに format=xml を指定して下さい。
■リクエスト・レスポンス例
◆リクエスト
[URL]
https://tsubaiso.net/customer_masters/create
[Message body]
authenticity_token=abc&customer_master[code]=1234&customer_master[name]=name&customer_master[tel]=03-6912-8500&customer_master[used_in_ar]=1&customer_master[used_in_ap]=0&customer_master[is_valid]=1&format=xml
◆レスポンス
<?xml version="1.0" encoding="UTF-8"?> <envelope xmlns="http://tsubaiso.jp/2009"> <authenticity_token>q4m6f+DwYJQYkPsJxEjn52h5PciRtMfGnrTuSE2e2Uw=</authenticity_token> <created_at>2011-10-14</created_at> <entry> <result>1</result> </entry> </envelope>
result は追加された場合には 1 を、追加に失敗した場合は 0 を返します。