Google の電子請求書のリクエスト

このドキュメントでは、Universal Business Language（UBL）2.4 請求書スキーマの概要について説明します。このスキーマは、Google と電子請求ベンダー間での請求データの電子交換を効率化するために特別に設計されています。これにより、請求書情報の標準化された送信が容易になり、ベンダーが処理して政府の税務機関のポータルに送信することが可能になります。

請求書リクエスト スキーマ要素:

  1. 請求書のヘッダー
  2. サプライヤー情報
  3. 購入者情報
  4. 配送情報
  5. 広告申込情報
  6. 合計税額
  7. 源泉徴収税
  8. お支払い条件と方法
  9. 法的な合計金額

1. 請求書のヘッダー

請求書のヘッダーには、識別番号、発行日時、請求書の種類、通貨、為替レートなど、請求書に関する概要情報が含まれています。

要素 説明 例
cbc:UBLVersionID 使用している UBL 請求書標準 2.4
cbc:ID 請求書番号 GCEMEAD0000000001
cbc:UUID Google ベンダー リクエスト ID - この請求書リクエストのレスポンス メッセージに値が存在している必要があります 123e4567-e89b-12d3-a456-426614174000
cbc:IssueDate 請求書の発行日 2023-06-01
cbc:IssueTime 請求書が発行された日時（米国太平洋時間） 08:20:00-08:00
cbc:InvoiceTypeCode 請求書の種類。サポートされている値: 請求書の場合は 380 380
cbc:DocumentCurrencyCode 請求書に表示される通貨 USD
cbc:TaxCurrencyCode TaxAmount の通貨換算が必要な通貨 EUR
cac:TaxExchangeRate
└ cbc:SourceCurrencyCode 為替レートの元の通貨 USD
└ cbc:TargetCurrencyCode 為替レートのターゲット通貨 EUR
└ cbc:CalculationRate 税金計算用の為替レート（小数点以下 2 桁） 0.84
cac:InvoicePeriod
└ cbc:StartDate 請求期間の開始日 2023-05-01
└ cbc:EndDate 請求期間の終了日 2023-05-31
cbc:Note 請求書に関するその他のメモやコメント これは請求書のメモのサンプルです。

例

<Invoice>
  <cbc:UBLVersionID>2.4</cbc:UBLVersionID>
  <cbc:ID schemeID="Google">GCEMEAD0000000001</cbc:ID>
  <cbc:UUID>123e4567-e89b-12d3-a456-426614174000</cbc:UUID>
  <cbc:IssueDate>2023-06-01</cbc:IssueDate>
  <cbc:IssueTime>08:20:00-08:00</cbc:IssueTime>
  <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
  <cbc:DocumentCurrencyCode>USD</cbc:DocumentCurrencyCode>
  <cbc:TaxCurrencyCode>EUR</cbc:TaxCurrencyCode>
  <cac:TaxExchangeRate>
    <cbc:SourceCurrencyCode>USD</cbc:SourceCurrencyCode>
    <cbc:TargetCurrencyCode>EUR</cbc:TargetCurrencyCode>
    <cbc:CalculationRate>0.84</cbc:CalculationRate>
  </cac:TaxExchangeRate>
  <cac:InvoicePeriod>
    <cbc:StartDate>2023-05-01</cbc:StartDate>
    <cbc:EndDate>2023-05-31</cbc:EndDate>
  </cac:InvoicePeriod>
  <cbc:Note>This is a sample note for the invoice.</cbc:Note>
</Invoice>

2. サプライヤー情報

このセクションには、販売者に関する詳細情報（税 ID、名前、住所、連絡先情報など）が記載されています。

2.1 cac:AccountingSupplierParty/cac:Party

この要素は販売者（Google）を表します。

[Path] 説明 例
cac:PartyTaxScheme
└ cbc:CompanyID 販売者の納税者番号 IE 9999999X
└ cbc:CompanyID/@schemeID 税制スキーム ID VAT
cac:PartyName
└ cbc:Name 販売者の名前 Google Ireland Limited
cac:PostalAddress
└ cbc:AddressLine1 販売者の住所 1 行目 Gordon House
└ cbc:AddressLine2 販売者の住所 2 行目 Barrow Street
└ cbc:CityName 販売者の都市 ダブリン
└ cbc:PostalZone 販売者の郵便番号 D04 V4X7
└ cac:Country/cbc:IdentificationCode 販売者の国コード IE
cac:Contact
└ cac:Contact/cbc:Telephone 販売者の連絡先電話番号 545-123-4567
└ cac:Contact/cbc:ElectronicMail 販売者の連絡先メールアドレス invoice@google.com

例

<Invoice>
  ...
    <cac:AccountingSupplierParty>
        <cac:Party>
            <cac:PartyTaxScheme>
                <cbc:CompanyID schemeID="VAT">IE 9999999X</cbc:CompanyID>
            </cac:PartyTaxScheme>
            <cac:PartyName>
                <cbc:Name>Google Ireland Limited</cbc:Name>
            </cac:PartyName>
            <cac:PostalAddress>
                <cbc:AddressLine>Gordon House</cbc:AddressLine>
                <cbc:AddressLine>Barrow Street</cbc:AddressLine>
                <cbc:CityName>Dublin</cbc:CityName>
                <cbc:PostalZone>D04 V4X7</cbc:PostalZone>
                <cac:Country>
                    <cbc:IdentificationCode>IE</cbc:IdentificationCode>
                </cac:Country>
            </cac:PostalAddress>
            <cac:Contact>
                <cbc:Telephone>545-123-4567</cbc:Telephone>
                <cbc:ElectronicMail>invoice@google.com</cbc:ElectronicMail>
            </cac:Contact>
        </cac:Party>
    </cac:AccountingSupplierParty>
  ...
</Invoice>

3. 購入者情報

このセクションには、購入者の詳細（税 ID、名前、住所、連絡先情報など）が含まれます。代理店とエンドバイヤーの両方の情報が必要な場合は、cac:AccountingCustomerParty は代理店情報（プライマリ バイヤー）を表し、cac:BuyerCustomerParty はエンドバイヤー（セカンダリ バイヤー）情報に使用されます。

3.1 cac:AccountingCustomerParty/cac:Party

この要素は、会計上の顧客パーティを表します。代理店の場合は、この要素を使用して代理店情報を送信します。

[Path] 説明 例
cac:PartyTaxScheme/cbc:CompanyID 購入者の納税者番号 0987654321
cac:PartyTaxScheme/cbc:CompanyID/@schemeID 税制スキーム ID（複数の税 ID がある場合は繰り返し可能） TIN、NIP、SIREN、SIRET
cac:PartyLegalEntity/cbc:CompanyLegalFormCode 会社の法的形態を指定します（値は 1（個人）または 2（組織））。 1
cac:PartyLegalEntity/cbc:CompanyLegalForm 会社の法的形態の説明（使用できる値: 「個人」または「組織」） 個人
cac:PartyName
└ cbc:Name 購入者の名前 ジェーン建設会社
cac:PostalAddress
└ cbc:AddressLine1 購入者の住所 1 行目 456 Market St
└ cbc:AddressLine2 購入者の住所 2 行目 4 階
└ cbc:CityName 購入者の都市 ニューヨーク
└ cbc:PostalZone 購入者の郵便番号 10001
└ cac:Country/cbc:IdentificationCode 購入者の国コード 米国
cac:Contact
└ cbc:Telephone 購入者の連絡先の電話番号 987-654-3210
└ cbc:ElectronicMail 購入者の連絡先メールアドレス j@construction.com

3.2 cac:BuyerCustomerParty/cac:Party

この要素は、代理店情報を送信するために cac:AccountingCustomerParty が使用されている場合にのみ使用されます。これらの 2 つの要素では、すべてのサブ要素が同じです。

例

<Invoice>
  ...
    <cac:AccountingCustomerParty>
        <cac:Party>
            <cac:PartyTaxScheme>
                <cbc:CompanyID schemeID="VAT">0987654321</cbc:CompanyID>
                <cbc:CompanyID schemeID="SIREN">123456789</cbc:CompanyID>
                <cbc:CompanyID schemeID="SIRET">98765432100015</cbc:CompanyID>
            </cac:PartyTaxScheme>
            <cac:PartyLegalEntity>
                <cbc:CompanyLegalFormCode>2</cbc:CompanyLegalFormCode>
                <cbc:CompanyLegalForm>Organization</cbc:CompanyLegalForm>
            </cac:PartyLegalEntity>
            <cac:PartyName>
                <cbc:Name>Jane's Construction Company</cbc:Name>
            </cac:PartyName>
            <cac:PostalAddress>
                <cbc:AddressLine>99 pembroke square</cbc:AddressLine>
                <cbc:CityName>Dublin</cbc:CityName>
                <cbc:PostalZone>D04 P043</cbc:PostalZone>
                <cac:Country>
                    <cbc:IdentificationCode>IE</cbc:IdentificationCode>
                </cac:Country>
            </cac:PostalAddress>
            <cac:Contact>
                <cbc:Telephone>0439843234</cbc:Telephone>
                <cbc:ElectronicMail>advert@ads.com</cbc:ElectronicMail>
            </cac:Contact>
        </cac:Party>
    </cac:AccountingCustomerParty>
    <cac:BuyerCustomerParty>
        <cac:Party>
            <cac:PartyTaxScheme>
                <cbc:CompanyID schemeID="VAT">0987654321</cbc:CompanyID>
                <cbc:CompanyID schemeID="SIREN">123456789</cbc:CompanyID>
            </cac:PartyTaxScheme>
            <cac:PartyName>
                <cbc:Name>Jane's Construction Company</cbc:Name>
            </cac:PartyName>
            <cac:PostalAddress>
                <cbc:AddressLine>456 Market St</cbc:AddressLine>
                <cbc:AddressLine>Floor 4</cbc:AddressLine>
                <cbc:CityName>New York</cbc:CityName>
                <cbc:PostalZone>10001</cbc:PostalZone>
                <cac:Country>
                    <cbc:IdentificationCode>US</cbc:IdentificationCode>
                </cac:Country>
            </cac:PostalAddress>
            <cac:Contact>
                <cbc:Telephone>987-654-3210</cbc:Telephone>
                <cbc:ElectronicMail>j@construction.com</cbc:ElectronicMail>
            </cac:Contact>
        </cac:Party>
    </cac:BuyerCustomerParty>
  ...
</Invoice>

4. お届け先情報

このセクションには、商品やサービスの提供に関する情報が記載されています。

[Path] 説明 例
cbc:ActualDeliveryDate 商品/サービスの提供日 2023-05-17

5. 広告申込情報

項目は、請求書に記載される個々の商品またはサービスです。このスキーマは、請求書ごとに 1 つ以上の広告申込情報をサポートしています。

5.1 cac:InvoiceLine

このセクションには、請求書の各項目の詳細（一意の識別子、数量、単価、税抜きと税込みの合計金額など）が記載されます。請求対象の各項目に関連する費用の内訳がすべて表示されます。

[Path] 説明 例
cbc:ID この広告申込情報の識別子。集計された広告申込情報の請求書の場合、値は 1 です。 1
cbc:InvoicedQuantity 請求対象の項目の数量。集計された広告申込情報の請求書の場合、値は 1 です。 1
cbc:LineExtensionAmount @currencyID 広告申込情報の合計金額（元の通貨、税抜き） 1000
cac:Item/cbc:Name アイテムの名前 Google Cloud
cac:Price/cbc:PriceAmount @currencyID 商品アイテムの元の通貨での単価 1000
cac:TaxTotal
└ cbc:TaxAmount @currencyID 広告申込情報の元の通貨での合計税額 70
└ cac:TaxSubtotal/cbc:TaxableAmount @currencyID 広告申込情報の元の通貨での課税額 1000
└ cac:TaxSubtotal/cbc:TaxAmount @currencyID 広告申込情報の元の通貨での税額 70
└ cac:TaxSubtotal/cac:TaxCategory/cbc:Percent 広告申込情報に適用される税率 7.00
└ cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID この小計の税金の種類 VAT

例

<Invoice>
...
<cac:InvoiceLine>
  <cbc:ID>1</cbc:ID>
  <cbc:InvoicedQuantity>1</cbc:InvoicedQuantity>
  <cbc:LineExtensionAmount currencyID="USD">1000</cbc:LineExtensionAmount>
  <cac:Item>
    <cbc:Name>Google Cloud</cbc:Name>
  </cac:Item>
  <cac:Price>
    <cbc:PriceAmount currencyID="USD">1000</cbc:PriceAmount>
  </cac:Price>
  <cac:TaxTotal>
    <cbc:TaxAmount currencyID="USD">230</cbc:TaxAmount>
    <cac:TaxSubtotal>
      <cbc:TaxableAmount currencyID="USD">1000</cbc:TaxableAmount>
      <cbc:TaxAmount currencyID="USD">230</cbc:TaxAmount>
      <cac:TaxCategory>
        <cbc:Percent>23.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:TaxCategory>
    </cac:TaxSubtotal>
  </cac:TaxTotal>
</cac:InvoiceLine>
...
</Invoice>

6. 合計税額

このセクションには、請求書に適用される税金の合計額が表示されます。

6.1 cac:TaxTotal

この要素は、請求書に適用される税金の合計金額を表します。元の通貨と現地通貨の両方を表示する必要がある場合は、この要素を繰り返します。

[Path] 説明 例
cac:TaxTotal/cbc:TaxAmount 請求書に適用される税金の合計 70.00
cac:TaxTotal/cbc:TaxAmount/@currencyID 税額の通貨 ID USD

6.2 cac:TaxSubtotal

この要素には、単一の税金カテゴリの内訳が示されます。この要素は、さまざまな種類の税金を表現するために繰り返すことができます。

[Path] 説明 例
cac:TaxTotal/cac:TaxSubtotal/cbc:TaxableAmount @currencyID 元の通貨での課税総額 1000.00
cac:TaxTotal/cac:TaxSubtotal/cbc:TaxAmount @currencyID 課税対象金額に対する税額（元の通貨） 70.00
cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:Percent 課税額に適用される税率 7
cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID 税制スキーム名。国固有の税コードのリストをサポートする列挙型 VAT

例

<Invoice>
  ...
  <cac:TaxTotal>
    <cbc:TaxAmount currencyID="USD">230</cbc:TaxAmount>
    <cac:TaxSubtotal>
      <cbc:TaxableAmount currencyID="USD">1000</cbc:TaxableAmount>
      <cbc:TaxAmount currencyID="USD">230</cbc:TaxAmount>
      <cac:TaxCategory>
        <cbc:Percent>23.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:TaxCategory>
    </cac:TaxSubtotal>
  </cac:TaxTotal>
  <cac:TaxTotal>
    <cac:TaxSubtotal>
      <cbc:TaxAmount currencyID="PLN">920</cbc:TaxAmount>
      <cbc:TaxableAmount currencyID="PLN">4000</cbc:TaxableAmount>
      <cbc:TaxAmount currencyID="PLN">920</cbc:TaxAmount>
      <cac:TaxCategory>
        <cbc:Percent>23.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:TaxCategory>
    </cac:TaxSubtotal>
  </cac:TaxTotal>
  ...
</Invoice>

7. 源泉徴収税

請求書に適用される源泉徴収税。源泉徴収とは、所得の支払い者が支払いから税金を源泉徴収または控除し、その税金を政府に納付することを政府が義務付けているものです。

7.1 cac:WithholdingTaxTotal

この要素は、請求書に適用される源泉徴収税の合計額を表します。すべての cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:TaxAmount 要素の合計にする必要があります。

[Path] 説明 例
cac:WithholdingTaxTotal/cbc:TaxAmount @currencyID 源泉徴収税の合計額 6.5

7.2 cac:TaxSubtotal

この要素には、単一の源泉徴収税カテゴリの内訳が示されます。

[Path] 説明 例
cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:TaxableAmount @currencyID 源泉徴収カテゴリの課税対象（税引き前）金額 1000
cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:TaxAmount @currencyID 源泉徴収カテゴリの税額 6.5
cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:Percent 源泉徴収カテゴリの税率 0.65
cac:WithholdingTaxTotal/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID 源泉徴収税カテゴリの税の種類 PIS_WTH

例

<Invoice>
  ...
  <cac:WithholdingTaxTotal>
    <cbc:TaxAmount currencyID="USD">6.5</cbc:TaxAmount>
    <cac:TaxSubtotal>
      <cbc:TaxableAmount currencyID="USD">1000</cbc:TaxableAmount>
      <cbc:TaxAmount currencyID="USD">6.5</cbc:TaxAmount>
      <cac:TaxCategory>
        <cbc:Percent>6.5</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>PIS_WTH</cbc:ID>
        </cac:TaxScheme>
      </cac:TaxCategory>
    </cac:TaxSubtotal>
  </cac:WithholdingTaxTotal>
  ...
</Invoice>

8. お支払い条件と方法

[お支払い条件と方法] セクションでは、想定されるお支払い方法、お支払いチャネル、支払い期限など、お支払いに関する要件を概説します。

8.1 cac:PaymentMeans/cbc:PaymentMeansCode

この要素は、お支払い方法を表します。PaymentMeansCode は UN/ECE 4461 コードリストに従います。注: PaymentMeansCode は UN/ECE 4461 コードリストに準拠しています。31 はデビット（電信）送金を表します。

[Path] 説明 例
cbc:PaymentMeansCode お支払い方法 30: クレジット移行、31: デビット移行
cbc:PaymentDueDate お支払い期限 2023-08-01
cac:PayeeFinancialAccount/cbc:ID Google の金融口座 ID（請求書スキームで使用） GB99DEMO12345678901
cac:PayerFinancialAccount
└ cbc:ID Google の金融口座 ID（CreditNote スキームで使用） GB99DEMO12345678901
└ cbc:Name Google の銀行口座の名前 Google 銀行
└ cbc:AccountTypeCode Google 銀行口座の種類を示すコード UNKNOWN_ACCOUNT_TYPE = 0; CHECKING = 1; SAVINGS = 2; CURRENT = 3

8.2 cac:PaymentTerms/cbc:Note

この要素には、追加のお支払い条件に関する情報をテキスト形式で指定します。

[Path] 説明 例
cac:PaymentTerms/cbc:Note その他のお支払い条件に関する情報 30 日間支払い猶予

例

<Invoice>
  ...
    <cac:PaymentMeans>
        <cbc:PaymentMeansCode>30</cbc:PaymentMeansCode>
        <cbc:PaymentDueDate>2023-08-01</cbc:PaymentDueDate>
        <cac:PayerFinancialAccount>
            <cbc:ID>GB99DEMO12345678901</cbc:ID>
        </cac:PayerFinancialAccount>
    </cac:PaymentMeans>
    <cac:PaymentTerms>
        <cbc:Note>Net 30 terms</cbc:Note>
    </cac:PaymentTerms>
  ...
</Invoice>

[Legal Monetary Total] セクションには、適用される手当や料金、税金、源泉徴収、最終支払い額など、請求書の支払い合計額の概要が表示されます。

9.1 cac:LegalMonetaryTotal

[Path] 説明 例
cbc:LineExtensionAmount @currencyID 減額や請求が適用される前の、すべての請求明細行の合計金額。 1000.00
cbc:AllowanceTotalAmount @currencyID 請求書の合計控除額 0.00
cbc:TaxExclusiveAmount @currencyID すべての請求明細行の合計額（減額または請求が適用された後、税金が適用される前） 950.00
cbc:TaxInclusiveAmount @currencyID 減額や請求額、税金を適用した後のすべての請求明細の合計金額 1,071.50
cbc:PayableAmount @currencyID 購入者が支払う合計金額 1,065.00

例

<Invoice>
  ...
  <cac:LegalMonetaryTotal>
    <cbc:LineExtensionAmount currencyID="USD">1000.00</cbc:LineExtensionAmount>
    <cbc:AllowanceTotalAmount currencyID="USD">0.00</cbc:AllowanceTotalAmount>
    <cbc:TaxExclusiveAmount currencyID="USD">1000.00</cbc:TaxExclusiveAmount>
    <cbc:TaxInclusiveAmount currencyID="USD">1230.00</cbc:TaxInclusiveAmount>
    <cbc:PayableAmount currencyID="USD">1230.00</cbc:PayableAmount>
  </cac:LegalMonetaryTotal>
  ...
</Invoice>