売上明細
売上明細API

Supported Formats

json
>>>

GET /ar/balance/:year/:month
指定した年月の売上明細の集計額の一覧を返します。年月パラメータが指定されなかった場合、現在の年月の結果が返されます。

サポートフォーマット

json

エラー

エラーコード エラー説明
401 Not Authorizedアクセストークンが送られていないか正しくありません。もしくはクライアント認証トークンが正しくありません。
403 Forbiddenそのリクエストに必要な権限がありません。
404 Not found指定されたパスは正しくないか、リソースが見つかりません。
422 Unprocessable Entity1つ以上のパラメータが正しくないか不足しています。エラーメッセージで原因が判別できます。
500 Internal Server Errorサーバーで何らかのエラーが起こりました。
503 Service Unavailableあなたの IP アドレスから非常に多くのリクエストがあった場合、このエラーが発生します。次のリクエストまで少し時間を開けてください。

例

[
  {
    "ym": "2017-01",
    "customer_master_code": "0",
    "ar_segment": 1,
    "start_balance": 262510800,
    "finish_balance": 262510800,
    "received_amount": 0,
    "sales": 0,
    "tax": 0,
    "remittance_charge": 0,
    "exchange_gain_and_loss": 0,
    "memo": null,
    "created_at": null
  },
  {
    "ym": "2017-01",
    "customer_master_code": "101",
    "ar_segment": 1,
    "start_balance": 10000,
    "finish_balance": 10000,
    "received_amount": 0,
    "sales": 0,
    "tax": 0,
    "remittance_charge": 0,
    "exchange_gain_and_loss": 0,
    "memo": null,
    "created_at": null
  }
]

パラメータ

パラメータ名 説明
year
必須

年

Validations:

  • Must be a String
month
必須

月

Validations:

  • Must be a String

Returns

コード: 200

説明:

指定した年月の売上明細の集計額の一覧を返します。年月パラメータが指定されなかった場合、現在の年月の結果が返されます。

パラメータ名 説明
ym
任意

年月

Validations:

  • Must be a String
customer_master_code
任意

取引先コード

Validations:

  • Must be a String
ar_segment
任意

販売管理の債権区分

Validations:

  • Must be a String
start_balance
任意

月初残高

Validations:

  • Must be a Integer
finish_balance
任意

月末残高

Validations:

  • Must be a Integer
received_amount
任意

入金予定額

Validations:

  • Must be a String
sales
任意

売上額(税抜)

Validations:

  • Must be a Integer
tax
任意

税額

Validations:

  • Must be a Integer
remittance_charge
任意

当方負担送金手数料

Validations:

  • Must be a Integer
exchange_gain_and_loss
任意

為替差損益

Validations:

  • Must be a Integer
memo
任意

メモ

Validations:

  • Must be a String
created_at
任意

登録日時 (YYYY/MM/DD hh:mm:ss)

Validations:

  • Must be a String
>>>

POST /ar/find_or_create
売上管理レコードが作成済であれば検索し、未作成であれば作成します。

サポートフォーマット

json

エラー

エラーコード エラー説明
401 Not Authorizedアクセストークンが送られていないか正しくありません。もしくはクライアント認証トークンが正しくありません。
403 Forbiddenそのリクエストに必要な権限がありません。
404 Not found指定されたパスは正しくないか、リソースが見つかりません。
422 Unprocessable Entity1つ以上のパラメータが正しくないか不足しています。エラーメッセージで原因が判別できます。
500 Internal Server Errorサーバーで何らかのエラーが起こりました。
503 Service Unavailableあなたの IP アドレスから非常に多くのリクエストがあった場合、このエラーが発生します。次のリクエストまで少し時間を開けてください。

パラメータ

パラメータ名 説明
ccode
任意

法人コード

Validations:

  • Must be a Integer
price_including_tax
任意

税込売上高

Validations:

  • Must be a Integer
realization_timestamp
任意

計上日

Validations:

  • Must be a String
customer_master_code
任意

取引先コード

Validations:

  • Must be a String
dept_code
任意

部門コード

Validations:

  • Must be a String
reason_master_code
任意

原因マスタコード

Validations:

  • Must be a String
dc
任意

増減区分、d: 増加, c: 減少

Validations:

  • Must be a String
memo
任意

メモ

Validations:

  • Must be a String
tax_code
任意

税区分

Validations:

  • Must be a String
sales_tax
任意

消費税システム区分

Validations:

  • Must be a String
scheduled_memo
任意

予定メモ

Validations:

  • Must be a String
scheduled_receive_timestamp
任意

入金予定日

Validations:

  • Must be a String
tag_list
任意

セグメント

Validations:

  • Must be an array of any type
data_partner
任意

外部パートナー情報

Validations:

  • Must be an array of any type
key
任意

システム連携情報管理キー

Validations:

  • Must be a String
balance_band_code
任意

消込区分コード

Validations:

  • Must be a String
currency_code
任意

Translation missing: ja-JP.apidoc.ar_receipt.param.currency_code

Validations:

  • Must be a String
amount_fc
任意

Translation missing: ja-JP.apidoc.ar_receipt.param.amount_fc

Validations:

  • Must be a String
exchange_rate
任意

Translation missing: ja-JP.apidoc.ar_receipt.param.exchange_rate

Validations:

  • Must be a String
conversion_date
任意

Translation missing: ja-JP.apidoc.ar_receipt.param.conversion_date

Validations:

  • Must be a String
rate_type
任意

Translation missing: ja-JP.apidoc.ar_receipt.param.rate_type

Validations:

  • Must be a String

Returns

コード: 200

説明:

売上管理レコードが作成済であれば検索し、未作成であれば作成します。

パラメータ名 説明
id
任意

レコードId

Validations:

  • Must be a Integer
ccode
任意

法人コード

Validations:

  • Must be a Integer
account_code
任意

勘定科目コード

Validations:

  • Must be a String
realization_timestamp
任意

計上日

Validations:

  • Must be a String
customer_master_code
任意

取引先コード

Validations:

  • Must be a String
dept_code
任意

部門コード

Validations:

  • Must be a String
reason_master_code
任意

原因マスタコード

Validations:

  • Must be a String
dc
任意

増減区分、d: 増加, c: 減少

Validations:

  • Must be a String
memo
任意

メモ

Validations:

  • Must be a String
tax_code
任意

税区分

Validations:

  • Must be a String
sales_tax
任意

消費税システム区分

Validations:

  • Must be a String
scheduled_memo
任意

予定メモ

Validations:

  • Must be a String
scheduled_receive_timestamp
任意

入金予定日

Validations:

  • Must be a String
tag_list
任意

セグメント

Validations:

  • Must be an array of any type
data_partner
任意

外部パートナー情報

Validations:

  • Must be an array of any type
price_including_tax
任意

税込売上高

Validations:

  • Must be a Integer
price_excluding_tax
任意

税抜売上高

Validations:

  • Must be a Integer