売上を登録します。
事前に対象の取引先が登録されている必要があります。
部門を指定する場合は、事前に対象の部門が登録されている必要があります。
オリジナルの原因を指定する場合は、事前に対象の原因が登録されている必要があります。
■API通信プロトコル
HTTPS POST
■URL
https://tsubaiso.net/auth/auth
■事前認証
このメソッドは事前に AR_RECEIPT ドメインを所有する権限での認証が必要です。
■パラメータ形式
HTTP FORM REQUEST / XML
■パラメータ
authenticity_token (必須) : 認証時に取得した値を使います。
year 年
month 月
realization_timestamp 実現日 (YYYY-MM-DD)
ar_receipt[customer_master_code] 取引先コード
ar_receipt[reason_master_code] 原因コード
ar_receipt[tax_code] 税区分コード
price 税込金額
sales_tax 消費税額
ar_receipt[dc] 貸借区分 (売掛金が増加する場合はd、減少する場合はc)
ar_receipt[memo] メモ
ar_receipt[dept_code] 部門コード
※XML 形式でリクエストする場合は、
ルートノードは <xml> とし、その中にパラメータを記載します。
ar_receipt[xxx] の名称のパラメータについては、<xml> ノードの中に <ar_receipt> ノードを作成し、
その中にそれぞれのパラメータノードを作成して下さい。
■レスポンス形式
html / xml
※xml に指定する場合はパラメータに format=xml を指定して下さい。
■リクエスト・レスポンス例
◆リクエスト
[URL]
https://tsubaiso.net/ar/create
[Message body]
authenticity_token=abc&year=2011&month=10&price=10500&sales_tax=500&realization_timestamp=20111015&ar_receipt[customer_master_code]=FIRST_CUSTOMER&ar_receipt[reason_master_code]=SALES&ar_receipt[tax_code]=1&ar_receipt[dc]=d&ar_receipt[memo]=MEMO&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 を返します。