本文档全面介绍了通用企业语言 (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 | 账单的开具时间(以美国太平洋时间 [PT] 表示) | 08:20:00-08:00 |
cbc:InvoiceTypeCode | 账单类型。支持的值:380(账单) | 380 |
cbc:DocumentCurrencyCode | 账单的币种 | 美元 |
cbc:TaxCurrencyCode | 需要将 TaxAmount 转换为的币种 | EUR |
cac:TaxExchangeRate | ||
└ cbc:SourceCurrencyCode | 汇率的来源币种 | 美元 |
└ 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. 供应商信息
此部分包含卖家的详细信息,包括税号、姓名、地址和联系信息。
2.1 cac:AccountingSupplierParty/cac:Party
此元素代表卖方(Google)。
路径 | 说明 | 示例 |
---|---|---|
cac:PartyTaxScheme | ||
└ cbc:CompanyID | 卖家的税号 | IE 9999999X |
└ cbc:CompanyID/@schemeID | 税制标识符 | 增值税 (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. 买方信息
此部分包含买方的详细信息,包括税号、姓名、地址和联系信息。如果需要同时包含代理机构和最终买方信息,cac:AccountingCustomerParty
将用于表示代理机构信息(主要买方),cac:BuyerCustomerParty
将用于表示最终买方(次要买方)信息。
3.1 cac:AccountingCustomerParty/cac:Party
此元素代表会计客户方。对于代理机构,此元素将用于发送代理机构信息。
路径 | 说明 | 示例 |
---|---|---|
cac:PartyTaxScheme/cbc:CompanyID | 买方的税号 | 0987654321 |
cac:PartyTaxScheme/cbc:CompanyID/@schemeID | 税制标识符,如果存在多个税号,则可以重复 | 纳税人识别号 (TIN)、NIP、SIREN、SIRET |
cac:PartyLegalEntity/cbc:CompanyLegalFormCode | 用于指定公司法律形式的代码(可能的值:1 表示个人,2 表示组织) | 1 |
cac:PartyLegalEntity/cbc:CompanyLegalForm | 公司法律形式的说明(可能的值:“个人”或“组织”) | 个人 |
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 用于发送代理机构信息时,才会使用此元素。这两个元素中的所有子元素都相同。
示例
<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
此部分详细介绍了账单上的每个项目,包括唯一标识符、数量、单价以及税前和税后总金额。其中会详细列出与每项账单项相关的费用。
路径 | 说明 | 示例 |
---|---|---|
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
此元素表示账单适用的总税费。当需要同时显示原始货币和本地货币时,此元素会重复显示。
路径 | 说明 | 示例 |
---|---|---|
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 | 税制名称,支持特定国家/地区税代码列表的枚举 | 增值税 (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
元素的总和。
路径 | 说明 | 示例 |
---|---|---|
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(用于贷记通知单方案) | 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>