本文件提供通用商業語言 (UBL) 2.4 發票結構定義的完整概略,這項結構定義專門用於簡化 Google 與電子發票供應商之間的發票資料電子交換作業。這有助於以標準化方式傳送發票資訊,這對供應商處理並提交給政府稅務機關的入口網站至關重要。
月結單要求結構定義元素:
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 | 月結單所使用的幣別 | 美元 |
cbc:TaxCurrencyCode | 需要將 TaxAmount 轉換為的貨幣 | 歐元 |
cac:TaxExchangeRate | ||
└ cbc:SourceCurrencyCode | 匯率的來源貨幣 | 美元 |
└ cbc:TargetCurrencyCode | 匯率的目標幣別 | 歐元 |
└ 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)。
路徑 | 說明 | 範例 |
---|---|---|
cac:PartyTaxScheme | ||
└ cbc:CompanyID | 賣家的稅務識別碼 | IE 9999999X |
└ cbc:CompanyID/@schemeID | 稅務方案 ID | 加值稅 |
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
這個元素代表會計客戶方。如果是代理商,這個元素會用來傳送代理商資訊。
路徑 | 說明 | 範例 |
---|---|---|
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 | 公司法律形式的說明 (可能的值:"Individual" 或 "Organization") | 個人 |
cac:PartyName | ||
└ cbc:Name | 買方名稱 | Jane 的建築公司 |
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. 寄送資訊
本節包含商品和服務的供應資訊。
路徑 | 說明 | 範例 |
---|---|---|
cbc:ActualDeliveryDate | 商品/服務供應日期 | 2023-05-17 |
5. 委刊項
明細項目是指發票中列舉的個別商品或服務。此結構定義支援每張發票有一或多個委刊項。
5.1 cac:InvoiceLine
本節會詳細說明帳單上的每項項目,包括專屬 ID、數量、單價,以及稅前和稅後的總金額。這份報表會提供與每項開立帳單項目相關的完整費用明細。
路徑 | 說明 | 範例 |
---|---|---|
cbc:ID | 這個委刊項的 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 | 此小計的稅金類型 | 加值稅 |
範例
<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
這個元素代表月結單適用的總稅額。當需要同時顯示原始幣別和當地幣別時,這個元素會重複出現。
路徑 | 說明 | 範例 |
---|---|---|
cac:TaxTotal/cbc:TaxAmount | 適用於月結單的總稅額 | 70.00 |
cac:TaxTotal/cbc:TaxAmount/@currencyID | 稅額的貨幣 ID | 美元 |
6.2 cac:TaxSubtotal
這個元素提供單一稅務類別的明細資料。這個元素可重複使用,用於表示不同類型的稅金。
路徑 | 說明 | 範例 |
---|---|---|
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 | 稅務配置名稱,列舉支援國家/地區特定稅務代碼的清單 | 加值稅 |
範例
<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
元素的總和。
路徑 | 說明 | 範例 |
---|---|---|
cac:WithholdingTaxTotal/cbc:TaxAmount @currencyID | 預扣稅總額 | 6.5 |
7.2 cac:TaxSubtotal
這個元素提供單一預扣稅類別的明細。
路徑 | 說明 | 範例 |
---|---|---|
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 代表扣款 (電匯) 轉帳。
路徑 | 說明 | 範例 |
---|---|---|
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
這個元素會以文字形式提供任何額外的付款條件資訊。
路徑 | 說明 | 範例 |
---|---|---|
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>
9. 合法金錢總額
「Legal Monetary Total」(法律貨幣總額) 部分會列出應付帳單的總金額,包括任何適用的津貼或費用、稅金、預扣稅額,以及最終應付金額。
9.1 cac:LegalMonetaryTotal
路徑 | 說明 | 範例 |
---|---|---|
cbc:LineExtensionAmount @currencyID | 套用任何費用或收費前,所有應付憑據明細的總金額。 | 1000.00 |
cbc:AllowanceTotalAmount @currencyID | 月結單的總折扣 | 0.00 |
cbc:TaxExclusiveAmount @currencyID | 套用所有津貼或費用後,所有應付憑據明細的總金額 (尚未套用任何稅金) | 950.00 |
cbc:TaxInclusiveAmount @currencyID | 套用任何津貼或費用和稅金後,所有應付憑據明細的總金額 | 1071.50 |
cbc:PayableAmount @currencyID | 買家須支付的總金額 | 1065.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>