Guides

Taiwan TWF: Example Documents

View the examples for Taiwan.

Suggest Edits

Invoice

The following is an example Taiwanese invoice (as indicated by the Invoice Type Code being 380):

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
  <ubl:Invoice xmlns:ubl="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2" xmlns:cec="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2" xmlns:vrbl="urn:vertexinc:vrbl:ExtensionComponent:1">
      <!-- Required UBL extensions -->
      <cec:UBLExtensions>
          <cec:UBLExtension>
              <cec:ExtensionContent>
                  <vrbl:InvoiceExtension>
                      <vrbl:RoutingDetails>
                          <!-- Unique sender ID. In case of Belgium always the sender's VAT ID -->
                          <vrbl:Sender>VERTEX_DEV_TEMPLATE</vrbl:Sender>
                          <!-- Unique receiver ID. In case of Taiwan B2C via Taxamo always a static value -->
                          <vrbl:Receiver>GENERIC_TAXAMO_JSON_TW_1p0</vrbl:Receiver>
                      </vrbl:RoutingDetails>
                  </vrbl:InvoiceExtension>
              </cec:ExtensionContent>
          </cec:UBLExtension>
      </cec:UBLExtensions>
      <cbc:CustomizationID>urn:vertexinc:vrbl:billing:1</cbc:CustomizationID>
      <cbc:ProfileID>urn:vertexinc:vrbl:billing:1</cbc:ProfileID>
      <cbc:ID>INV-12345-001</cbc:ID>
      <cbc:IssueDate>2025-02-10</cbc:IssueDate>
      <cbc:IssueTime>15:30:00Z</cbc:IssueTime>
      <cbc:DueDate>2025-02-20</cbc:DueDate>
      <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
      <cbc:Note>This is an invoice free-text</cbc:Note>
      <cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
      <cbc:BuyerReference>buyer_ref_number234</cbc:BuyerReference>
      <cac:InvoicePeriod>
          <cbc:StartDate>2024-11-26</cbc:StartDate>
          <cbc:EndDate>2024-11-30</cbc:EndDate>
          <cbc:Description>Monthly</cbc:Description>
      </cac:InvoicePeriod>
      <cac:OrderReference>
          <cbc:ID>PO987654</cbc:ID>
          <cbc:SalesOrderID>SalesOrderID123456</cbc:SalesOrderID>
      </cac:OrderReference>
      <cac:DespatchDocumentReference>
          <cbc:ID>DespatchDocument123456</cbc:ID>
      </cac:DespatchDocumentReference>
      <cac:AccountingSupplierParty>
          <cac:Party>
              <!-- The GLN of the sender -->
              <cac:PartyIdentification>
                  <cbc:ID>0123456789012</cbc:ID>
              </cac:PartyIdentification>
              <cac:PartyName>
                  <cbc:Name>SenderCompanyName</cbc:Name>
              </cac:PartyName>
              <cac:PostalAddress>
                  <cbc:StreetName>Streetname 3</cbc:StreetName>
                  <cbc:CityName>Taipei City</cbc:CityName>
                  <cbc:PostalZone>111</cbc:PostalZone>
                  <cac:Country>
                      <cbc:IdentificationCode>TW</cbc:IdentificationCode>
                  </cac:Country>
              </cac:PostalAddress>
              <cac:PartyTaxScheme>
                  <cbc:CompanyID>73251209</cbc:CompanyID>
                  <cac:TaxScheme>
                      <cbc:ID>VAT</cbc:ID>
                  </cac:TaxScheme>
              </cac:PartyTaxScheme>
              <cac:PartyLegalEntity>
                  <cbc:RegistrationName>SenderRegisteredName</cbc:RegistrationName>
              </cac:PartyLegalEntity>
              <cac:Contact>
                  <cbc:Name>Customer service</cbc:Name>
                  <cbc:ElectronicMail>[email protected]</cbc:ElectronicMail>
              </cac:Contact>
          </cac:Party>
      </cac:AccountingSupplierParty>
      <cac:AccountingCustomerParty>
          <cac:Party>
              <cac:PartyName>
                  <cbc:Name>Mr. John Doe</cbc:Name>
              </cac:PartyName>
              <cac:PostalAddress>
                  <cbc:StreetName>Streetname 4</cbc:StreetName>
                  <cbc:CityName>Taipei City</cbc:CityName>
                  <cbc:PostalZone>111</cbc:PostalZone>
                  <cac:Country>
                      <cbc:IdentificationCode>TW</cbc:IdentificationCode>
                  </cac:Country>
              </cac:PostalAddress>
              <cac:PartyLegalEntity>
                  <cbc:RegistrationName>BuyerRegisteredName</cbc:RegistrationName>
              </cac:PartyLegalEntity>
              <cac:Contact>
                  <cbc:Telephone>09/000 88 00</cbc:Telephone>
                  <cbc:ElectronicMail>[email protected]</cbc:ElectronicMail>
              </cac:Contact>
          </cac:Party>
      </cac:AccountingCustomerParty>
      <cac:PaymentMeans>
          <cbc:PaymentMeansCode>31</cbc:PaymentMeansCode>
          <cac:PayeeFinancialAccount>
              <cbc:ID>TW123456788901234</cbc:ID>
              <cbc:Name>BankAccountOwner</cbc:Name>
              <cac:FinancialInstitutionBranch>
                  <cbc:ID>GEBABEBB</cbc:ID>
              </cac:FinancialInstitutionBranch>
          </cac:PayeeFinancialAccount>
      </cac:PaymentMeans>
      <cac:PaymentTerms>
          <cbc:Note>Up to 10.10.2024 without deduction</cbc:Note>
      </cac:PaymentTerms>
      <cac:AllowanceCharge>
          <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
          <cbc:AllowanceChargeReason>Sample Description</cbc:AllowanceChargeReason>
          <cbc:Amount currencyID="EUR">100</cbc:Amount>
          <cac:TaxCategory>
              <cbc:ID>S</cbc:ID>
              <cbc:Percent>5</cbc:Percent>
              <cac:TaxScheme>
                  <cbc:ID>VAT</cbc:ID>
              </cac:TaxScheme>
          </cac:TaxCategory>
      </cac:AllowanceCharge>
      <cac:AllowanceCharge>
          <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
          <cbc:AllowanceChargeReason>Service charge</cbc:AllowanceChargeReason>
          <cbc:Amount currencyID="EUR">100</cbc:Amount>
          <cac:TaxCategory>
              <cbc:ID>S</cbc:ID>
              <cbc:Percent>5</cbc:Percent>
              <cac:TaxScheme>
                  <cbc:ID>VAT</cbc:ID>
              </cac:TaxScheme>
          </cac:TaxCategory>
      </cac:AllowanceCharge>
      <cac:TaxTotal>
          <cbc:TaxAmount currencyID="EUR">20</cbc:TaxAmount>
          <cac:TaxSubtotal>
              <cbc:TaxableAmount currencyID="EUR">400</cbc:TaxableAmount>
              <cbc:TaxAmount currencyID="EUR">20</cbc:TaxAmount>
              <cac:TaxCategory>
                  <cbc:ID>S</cbc:ID>
                  <cbc:Percent>5</cbc:Percent>
                  <cac:TaxScheme>
                      <cbc:ID>VAT</cbc:ID>
                  </cac:TaxScheme>
              </cac:TaxCategory>
          </cac:TaxSubtotal>
      </cac:TaxTotal>
      <cac:LegalMonetaryTotal>
          <cbc:LineExtensionAmount currencyID="EUR">400</cbc:LineExtensionAmount>
          <cbc:TaxExclusiveAmount currencyID="EUR">400</cbc:TaxExclusiveAmount>
          <cbc:TaxInclusiveAmount currencyID="EUR">420</cbc:TaxInclusiveAmount>
          <cbc:AllowanceTotalAmount currencyID="EUR">100</cbc:AllowanceTotalAmount>
          <cbc:ChargeTotalAmount currencyID="EUR">100</cbc:ChargeTotalAmount>
          <cbc:PayableAmount currencyID="EUR">420</cbc:PayableAmount>
      </cac:LegalMonetaryTotal>
      <cac:InvoiceLine>
          <cbc:ID>000010</cbc:ID>
          <cbc:Note>ItemDecription</cbc:Note>
          <cbc:InvoicedQuantity unitCode="H87">3</cbc:InvoicedQuantity>
          <cbc:LineExtensionAmount currencyID="EUR">300</cbc:LineExtensionAmount>
          <cac:OrderLineReference>
              <cbc:LineID>000001</cbc:LineID>
          </cac:OrderLineReference>
          <cac:Item>
              <cbc:Name>ItemName</cbc:Name>
              <cac:SellersItemIdentification>
                  <cbc:ID>730430</cbc:ID>
              </cac:SellersItemIdentification>
              <!-- GTIN13 of the item -->
              <cac:StandardItemIdentification>
                  <cbc:ID schemeID="0160">1234567890128</cbc:ID>
              </cac:StandardItemIdentification>
              <cac:ClassifiedTaxCategory>
                  <cbc:ID>S</cbc:ID>
                  <cbc:Percent>5</cbc:Percent>
                  <cac:TaxScheme>
                      <cbc:ID>VAT</cbc:ID>
                  </cac:TaxScheme>
              </cac:ClassifiedTaxCategory>
              <cac:AdditionalItemProperty>
                  <cbc:Name>Purchase Order Number</cbc:Name>
                  <cbc:Value>PO987654</cbc:Value>
              </cac:AdditionalItemProperty>
          </cac:Item>
          <cac:Price>
              <cbc:PriceAmount currencyID="EUR">100</cbc:PriceAmount>
              <cbc:BaseQuantity unitCode="H87">1</cbc:BaseQuantity>
          </cac:Price>
      </cac:InvoiceLine>
      <cac:InvoiceLine>
          <cbc:ID>000020</cbc:ID>
          <cbc:Note>Item Description</cbc:Note>
          <cbc:InvoicedQuantity unitCode="H87">2</cbc:InvoicedQuantity>
          <cbc:LineExtensionAmount currencyID="EUR">100</cbc:LineExtensionAmount>
          <cac:OrderLineReference>
              <cbc:LineID>000002</cbc:LineID>
          </cac:OrderLineReference>
          <cac:AllowanceCharge>
              <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
              <cbc:AllowanceChargeReason>Sample Description</cbc:AllowanceChargeReason>
              <cbc:MultiplierFactorNumeric>10.00</cbc:MultiplierFactorNumeric>
              <cbc:Amount currencyID="EUR">10.00</cbc:Amount>
              <cbc:BaseAmount currencyID="EUR">100.00</cbc:BaseAmount>
          </cac:AllowanceCharge>
          <cac:AllowanceCharge>
              <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
              <cbc:AllowanceChargeReason>Sample Description</cbc:AllowanceChargeReason>
              <cbc:MultiplierFactorNumeric>10.00</cbc:MultiplierFactorNumeric>
              <cbc:Amount currencyID="EUR">10.00</cbc:Amount>
              <cbc:BaseAmount currencyID="EUR">100.00</cbc:BaseAmount>
          </cac:AllowanceCharge>
          <cac:Item>
              <cbc:Name>ItemName</cbc:Name>
              <cac:SellersItemIdentification>
                  <cbc:ID>730430</cbc:ID>
              </cac:SellersItemIdentification>
              <!-- GTIN13 of the item -->
              <cac:StandardItemIdentification>
                  <cbc:ID schemeID="0160">1234567890128</cbc:ID>
              </cac:StandardItemIdentification>
              <cac:ClassifiedTaxCategory>
                  <cbc:ID>S</cbc:ID>
                  <cbc:Percent>5</cbc:Percent>
                  <cac:TaxScheme>
                      <cbc:ID>VAT</cbc:ID>
                  </cac:TaxScheme>
              </cac:ClassifiedTaxCategory>
              <cac:AdditionalItemProperty>
                  <cbc:Name>Purchase Order Number</cbc:Name>
                  <cbc:Value>PO987654</cbc:Value>
              </cac:AdditionalItemProperty>
          </cac:Item>
          <cac:Price>
              <cbc:PriceAmount currencyID="EUR">50</cbc:PriceAmount>
              <cbc:BaseQuantity unitCode="H87">1</cbc:BaseQuantity>
          </cac:Price>
      </cac:InvoiceLine>
  </ubl:Invoice>

Credit Note

The following is an example Taiwanese credit note (as indicated by the Invoice Type Code being 381):

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
  <ubl:Invoice xmlns:ubl="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2" xmlns:cec="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2" xmlns:vrbl="urn:vertexinc:vrbl:ExtensionComponent:1">
      <!-- Required UBL extensions -->
      <cec:UBLExtensions>
          <cec:UBLExtension>
              <cec:ExtensionContent>
                  <vrbl:InvoiceExtension>
                      <vrbl:RoutingDetails>
                          <!-- Unique sender ID. In case of Taiwan B2C via Taxamo always the sender's VAT ID -->
                          <vrbl:Sender>73251209</vrbl:Sender>
                          <!-- Unique receiver ID. In case of Taiwan B2C via Taxamo always a static value -->
                          <vrbl:Receiver>GENERIC_TAXAMO_JSON_TW_1p0</vrbl:Receiver>
                      </vrbl:RoutingDetails>
                  </vrbl:InvoiceExtension>
              </cec:ExtensionContent>
          </cec:UBLExtension>
      </cec:UBLExtensions>
      <cbc:CustomizationID>urn:vertexinc:vrbl:billing:1</cbc:CustomizationID>
      <cbc:ProfileID>urn:vertexinc:vrbl:billing:1</cbc:ProfileID>
      <cbc:ID>CN-12345-001</cbc:ID>
      <cbc:IssueDate>2025-02-11</cbc:IssueDate>
      <cbc:IssueTime>15:30:00Z</cbc:IssueTime>
      <cbc:InvoiceTypeCode>381</cbc:InvoiceTypeCode>
      <cbc:Note>This is an invoice free-text</cbc:Note>
      <cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
      <cbc:BuyerReference>buyer_ref_number234</cbc:BuyerReference>
      <cac:InvoicePeriod>
          <cbc:StartDate>2024-11-26</cbc:StartDate>
          <cbc:EndDate>2024-11-30</cbc:EndDate>
          <cbc:Description>Monthly</cbc:Description>
      </cac:InvoicePeriod>
      <cac:OrderReference>
          <cbc:ID>PO987654</cbc:ID>
          <cbc:SalesOrderID>SalesOrderID123456</cbc:SalesOrderID>
      </cac:OrderReference>
      <cac:BillingReference>
          <cac:InvoiceDocumentReference>
              <cec:UBLExtensions>
                  <cec:UBLExtension>
                      <cec:ExtensionContent>
                          <vrbl:InvoiceDocumentReferenceExtension>
                              <vrbl:CorrectionData>
                                  <vrbl:CorrectionReason>Customers refund request approved</vrbl:CorrectionReason>
                              </vrbl:CorrectionData>
                          </vrbl:InvoiceDocumentReferenceExtension>
                      </cec:ExtensionContent>
                  </cec:UBLExtension>
              </cec:UBLExtensions>
              <!-- Original invoice number -->
              <cbc:ID>INV-12345-001</cbc:ID>
              <!-- "key" from get transaction response JSON -->
              <cbc:UUID>TnFkAAEj2T6gKD6VUD4Fnqczex1w</cbc:UUID>
          </cac:InvoiceDocumentReference>
      </cac:BillingReference>
      <cac:AccountingSupplierParty>
          <cac:Party>
              <!-- The GLN of the sender -->
              <cac:PartyIdentification>
                  <cbc:ID>0123456789012</cbc:ID>
              </cac:PartyIdentification>
              <cac:PartyName>
                  <cbc:Name>SenderCompanyName</cbc:Name>
              </cac:PartyName>
              <cac:PostalAddress>
                  <cbc:StreetName>Streetname 3</cbc:StreetName>
                  <cbc:CityName>Taipei City</cbc:CityName>
                  <cbc:PostalZone>111</cbc:PostalZone>
                  <cac:Country>
                      <cbc:IdentificationCode>TW</cbc:IdentificationCode>
                  </cac:Country>
              </cac:PostalAddress>
              <cac:PartyTaxScheme>
                  <cbc:CompanyID>73251209</cbc:CompanyID>
                  <cac:TaxScheme>
                      <cbc:ID>VAT</cbc:ID>
                  </cac:TaxScheme>
              </cac:PartyTaxScheme>
              <cac:PartyLegalEntity>
                  <cbc:RegistrationName>SenderRegisteredName</cbc:RegistrationName>
              </cac:PartyLegalEntity>
              <cac:Contact>
                  <cbc:Name>Customer service</cbc:Name>
                  <cbc:ElectronicMail>[email protected]</cbc:ElectronicMail>
              </cac:Contact>
          </cac:Party>
      </cac:AccountingSupplierParty>
      <cac:AccountingCustomerParty>
          <cac:Party>
              <cac:PartyName>
                  <cbc:Name>Mr. John Doe</cbc:Name>
              </cac:PartyName>
              <cac:PostalAddress>
                  <cbc:StreetName>Streetname 4</cbc:StreetName>
                  <cbc:CityName>Taipei City</cbc:CityName>
                  <cbc:PostalZone>111</cbc:PostalZone>
                  <cac:Country>
                      <cbc:IdentificationCode>TW</cbc:IdentificationCode>
                  </cac:Country>
              </cac:PostalAddress>
              <cac:PartyLegalEntity>
                  <cbc:RegistrationName>BuyerRegisteredName</cbc:RegistrationName>
              </cac:PartyLegalEntity>
              <cac:Contact>
                  <cbc:Telephone>09/000 88 00</cbc:Telephone>
                  <cbc:ElectronicMail>[email protected]</cbc:ElectronicMail>
              </cac:Contact>
          </cac:Party>
      </cac:AccountingCustomerParty>
      <cac:PaymentMeans>
          <cbc:PaymentMeansCode>31</cbc:PaymentMeansCode>
          <cac:PayeeFinancialAccount>
              <cbc:ID>TW123456788901234</cbc:ID>
              <cbc:Name>BankAccountOwner</cbc:Name>
              <cac:FinancialInstitutionBranch>
                  <cbc:ID>GEBABEBB</cbc:ID>
              </cac:FinancialInstitutionBranch>
          </cac:PayeeFinancialAccount>
      </cac:PaymentMeans>
      <cac:PaymentTerms>
          <cbc:Note>Up to 10.10.2024 without deduction</cbc:Note>
      </cac:PaymentTerms>
      <cac:TaxTotal>
          <cbc:TaxAmount currencyID="EUR">20</cbc:TaxAmount>
          <cac:TaxSubtotal>
              <cbc:TaxableAmount currencyID="EUR">400</cbc:TaxableAmount>
              <cbc:TaxAmount currencyID="EUR">20</cbc:TaxAmount>
              <cac:TaxCategory>
                  <cbc:ID>S</cbc:ID>
                  <cbc:Percent>5</cbc:Percent>
                  <cac:TaxScheme>
                      <cbc:ID>VAT</cbc:ID>
                  </cac:TaxScheme>
              </cac:TaxCategory>
          </cac:TaxSubtotal>
      </cac:TaxTotal>
      <cac:LegalMonetaryTotal>
          <cbc:LineExtensionAmount currencyID="EUR">400</cbc:LineExtensionAmount>
          <cbc:TaxExclusiveAmount currencyID="EUR">400</cbc:TaxExclusiveAmount>
          <cbc:TaxInclusiveAmount currencyID="EUR">420</cbc:TaxInclusiveAmount>
          <cbc:PayableAmount currencyID="EUR">420</cbc:PayableAmount>
      </cac:LegalMonetaryTotal>
      <cac:InvoiceLine>
          <cbc:ID>000010</cbc:ID>
          <cbc:Note>ItemDecription</cbc:Note>
          <cbc:InvoicedQuantity unitCode="H87">3</cbc:InvoicedQuantity>
          <cbc:LineExtensionAmount currencyID="EUR">300</cbc:LineExtensionAmount>
          <cac:OrderLineReference>
              <cbc:LineID>000001</cbc:LineID>
          </cac:OrderLineReference>
          <cac:Item>
              <cbc:Name>ItemName</cbc:Name>
              <cac:SellersItemIdentification>
                  <cbc:ID>730430</cbc:ID>
              </cac:SellersItemIdentification>
              <!-- GTIN13 of the item -->
              <cac:StandardItemIdentification>
                  <cbc:ID schemeID="0160">1234567890128</cbc:ID>
              </cac:StandardItemIdentification>
              <cac:ClassifiedTaxCategory>
                  <cbc:ID>S</cbc:ID>
                  <cbc:Percent>5</cbc:Percent>
                  <cac:TaxScheme>
                      <cbc:ID>VAT</cbc:ID>
                  </cac:TaxScheme>
              </cac:ClassifiedTaxCategory>
              <cac:AdditionalItemProperty>
                  <cbc:Name>Purchase Order Number</cbc:Name>
                  <cbc:Value>PO987654</cbc:Value>
              </cac:AdditionalItemProperty>
          </cac:Item>
          <cac:Price>
              <cbc:PriceAmount currencyID="EUR">100</cbc:PriceAmount>
              <cbc:BaseQuantity unitCode="H87">1</cbc:BaseQuantity>
          </cac:Price>
      </cac:InvoiceLine>
      <cac:InvoiceLine>
          <cbc:ID>000020</cbc:ID>
          <cbc:Note>Item Description</cbc:Note>
          <cbc:InvoicedQuantity unitCode="H87">2</cbc:InvoicedQuantity>
          <cbc:LineExtensionAmount currencyID="EUR">100</cbc:LineExtensionAmount>
          <cac:OrderLineReference>
              <cbc:LineID>000002</cbc:LineID>
          </cac:OrderLineReference>
          <cac:Item>
              <cbc:Name>ItemName</cbc:Name>
              <cac:SellersItemIdentification>
                  <cbc:ID>730430</cbc:ID>
              </cac:SellersItemIdentification>
              <!-- GTIN13 of the item -->
              <cac:StandardItemIdentification>
                  <cbc:ID schemeID="0160">1234567890128</cbc:ID>
              </cac:StandardItemIdentification>
              <cac:ClassifiedTaxCategory>
                  <cbc:ID>S</cbc:ID>
                  <cbc:Percent>5</cbc:Percent>
                  <cac:TaxScheme>
                      <cbc:ID>VAT</cbc:ID>
                  </cac:TaxScheme>
              </cac:ClassifiedTaxCategory>
              <cac:AdditionalItemProperty>
                  <cbc:Name>Purchase Order Number</cbc:Name>
                  <cbc:Value>PO987654</cbc:Value>
              </cac:AdditionalItemProperty>
          </cac:Item>
          <cac:Price>
              <cbc:PriceAmount currencyID="EUR">50</cbc:PriceAmount>
              <cbc:BaseQuantity unitCode="H87">1</cbc:BaseQuantity>
          </cac:Price>
      </cac:InvoiceLine>
  </ubl:Invoice>

Updated 8 days ago