概要
- インボイスの登録番号を、国税庁のAPIに問い合わせて情報を取得し表示します。
このインボイス用関数を利用するには、適格請求書発行事業者公表システムWeb-API機能で、アプリケーションIDを申請する必要があります。詳しくは、後述の利用の準備を、確認願います。
Invoice(登録番号,日付形式)
登録番号を国税庁のAPIに問合せ、データを取得する。
登録状況, 氏名または名称, 所在地, 屋号, 登録年月日, 更新年月日の順に表示。
引数
- 登録番号 登録番号を国税庁のAPIに問合せ、データを取得する。最初のTは省略可。
- 日付形式 TRUEは日付を文字列として表示。FALSEは日付を数値として表示するので、Excelの表示形式で日付にする必要がある。省略時は、TRUE。
登録状況
- 登録状況 取得したデータを基に以下の登録状況を算出します。
- 登録 取消年月日・失効年月日がなく、登録されている場合
- 登録解除予定 取消年月日か失効年月日のうち、より早い日付が、当日より後。つまり、今後、取消か失効される予定になっている。
- 登録解除 取消年月日か失効年月日のうち、より早い日付が、当日以前。つまり、すでに、取消されているか失効されている。
- 未登録 登録番号は存在しない場合。
その他項目
以下は、国税庁のAPIから取得したデータをそのまま表示します。
- 氏名または名称 適格請求書発行事業者の「氏名又は名称」を表す。
- 所在地 本店又は主たる事務所の所在地（法人）。法人（人格のない社団等を除く）の本店又は主たる事務所の所在地を表す。
- 屋号 主たる屋号。「適格請求書発行事業者の公表事項の公表（変更）申出書」に記載された「主たる屋号」を表す（個人の場合に限る）。
- 登録年月日 適格請求書発行事業者として登録された年月日を表す。
- 更新年月日 Web-API又はダウンロード機能で取得した適格請求書発行事業者の情報を更新したシステム上の日付を表す。
「適格請求書発行事業者公表システムリソース定義書 1.4版」（国税庁 課税部 軽減税率・インボイス制度対応室）より引用。
InvoiceRegistration(登録番号)
登録番号を国税庁のAPIに問合せ、データを取得する。
登録状況を表示。
引数
- 登録番号 登録番号を国税庁のAPIに問合せ、データを取得する。最初のTは省略可。
ログ
1 | C:\Users\<ユーザー名>\AppData\Roaming\Ganges\Ganges XL Add-In\Logs |
に、問い合わせた時の、Windowsユーザー名、登録番号を記録します。
例：
1 | 2024-03-28 22:15:05,184 [1] [INFO ] InvoiceHelper.WriteLog - ■■ T△△△ |
■■ は、Windowsユーザー名
△△△ は、情報を取得できた登録番号
設定画面のログフォルダを開く、でログファイルを確認できます。
制限
一度に、大量の登録番号を問い合わせると、国税庁のAPIで制限がかかるため、
エラー：問い合わせに失敗しました。
と表示します。
インボイス用関数向け設定
Web-API用のアプリケーションIDを入力して保存して下さい。
この関数について
- このサービスは、国税庁適格請求書発行事業者公表システムのWeb-API機能を利用して取得した情報をもとに作成していますが、サービスの内容は国税庁によって保証されたものではありません。
- サービスを提供できる条件を国税庁に確認の上、このサービスを作成しました。ただし、繰り返しますが、国税庁によって保証されたものではありません。
ガンジス XL アドインヘルプ
- ガンジス XL アドイン 全般の解説と、名前・電話番号・郵便番号の関数の解説。
- ガンジス XL アドイン：インボイス用関数 このページです。
- ガンジス XL アドイン：ライセンス
利用の準備
- 適格請求書発行事業者公表システムWeb-API機能で、「Web-API機能アプリケーションID発行手続き」をして下さい。
- 発行されたアプリケーションIDを、Ganges XL Add-In設定で設定して下さい。
発行手続きの例
2024-03-29時点
- 「アプリケーションID発行届出」ボタンから手続き
- 発行申請書（エクセル）を、メールで提出
発行申請書（エクセル）の例：
- プログラム・システム等の名称
ガンジス XL アドイン にします。 - 取得した公表情報の利用方法
例えば「登録番号から、実在確認」です。業務内容に合わせて、利用方法を入力して下さい。 - ダウンロードファイルの利用有無
無し にします。
ガンジス XL アドインで、登録番号を入力して情報（データ）を表示するだけで、
取得したデータを保存しないのでしたら、個人情報の保存はない、にチェックでOKです。
取得したデータを、別途保存するなら、適宜、チェックして下さい。
未確認ですが、このヘルプページをPDFにしたもので、OKのように思えます。
このヘルプページの仕様に関わる部分（「利用の準備」を除く）をPDFにしたものを、次に準備しました。
このPDFを添付して、申請してみて下さい。
申請がうまくいったようでしたら、ガンジスにもご連絡頂けるとありがたいです。