Taiwan (GUI): Preceding Invoice Reference

You must reference the preceding Document for Taiwanese credit notes.

For Taiwanese Credit Notes (cbc:InvoiceTypeCode = 381) it is required to provide a reference to the original invoice and the Taxamo transaction key that was received back when the original invvoice was delivered.
Additionally when sending B2C credit notes to the Taiwanese Authorities via Taxamo, it is mandatory to provide the reason of the cancellation or refund.

Elements

Use the BillingReference element to model this information:

Name (Technical Name)	Cardinality	Description
Preceding Invoice Reference (`Invoice/BillingReference`)	0..n	A group of elements providing information regarding preceding invoices.

This group contains the following elements:

Name (Technical Name)	Cardinality	Description
Invoice Document Reference (`InvoiceDocumentReference`)	1..1	A group of elements providing information regarding invoice references.
Correction Method (`InvoiceDocumentReference/UBLExtensions/UBLExtension/ExtensionContent/InvoiceDocumentReferenceExtension/CorrectionData/CorrectionMethod`)	1..1	An extension element used to provide the cancellation method (full/partial).
Correction Reason (`/InvoiceDocumentReference/UBLExtensions/UBLExtension/ExtensionContent/InvoiceDocumentReferenceExtension/CorrectionData/CorrectionReason`)	1..1	An extension element used to provide the reason for the cancellation.
Preceding Invoice Reference (`InvoiceDocumentReference/ID`)	1..1	The identification of an invoice that was previously sent by the Seller.
Preceding Invoice Reference UUID (`InvoiceDocumentReference/UUID`)	1..1	The Taxamo transaction key that was received back when the original invoice was delivered.

Restrictions

You must reference the preceding Document in the Preceding Invoice Reference (InvoiceDocumentReference/ID) element.
You must reference the Transaction Key (that is generated when the Document is submitted) in the Preceding Invoice Reference UUID (InvoiceDocumentReference/UUID) element.

To indicate the cancellation method following codes are allowed:

Code	Description
`VRBL:TW:Partial`	Partial cancellation. Only the provided lines will be cancelled.
`VRBL:TW:Full`	Full cancellation. The full invoices will be cancelled and refunded.

Example: Partial Cancellation

<Invoice>
    <!-- Code omitted for clarity -->
    <cac:BillingReference>
        <cac:InvoiceDocumentReference>
            <cec:UBLExtensions>
                <cec:UBLExtension>
                    <cec:ExtensionContent>
                        <vrbl:InvoiceDocumentReferenceExtension>
                            <vrbl:CorrectionData>
                                 <vrbl:CorrectionMethod>VRBL:TW:Partial</vrbl:CorrectionMethod>
                                <vrbl:CorrectionReason>Customers refund request approved</vrbl:CorrectionReason>
                            </vrbl:CorrectionData>
                        </vrbl:InvoiceDocumentReferenceExtension>
                    </cec:ExtensionContent>
                </cec:UBLExtension>
            </cec:UBLExtensions>
            <!-- Original invoice number -->
            <cbc:ID>INV12345</cbc:ID>
            <!-- "key" from get transaction response JSON -->
            <cbc:UUID>ToiEAAEj2LSIKD50WgrJnnLr_VBY</cbc:UUID>
        </cac:InvoiceDocumentReference>
    </cac:BillingReference>
    <!-- Code omitted for clarity -->
</Invoice>

Example: Full Cancellation

<Invoice>
    <!-- Code omitted for clarity -->
    <cac:BillingReference>
        <cac:InvoiceDocumentReference>
            <cec:UBLExtensions>
                <cec:UBLExtension>
                    <cec:ExtensionContent>
                        <vrbl:InvoiceDocumentReferenceExtension>
                            <vrbl:CorrectionData>
                                 <vrbl:CorrectionMethod>VRBL:TW:Full</vrbl:CorrectionMethod>
                                <vrbl:CorrectionReason>Customers refund request approved</vrbl:CorrectionReason>
                            </vrbl:CorrectionData>
                        </vrbl:InvoiceDocumentReferenceExtension>
                    </cec:ExtensionContent>
                </cec:UBLExtension>
            </cec:UBLExtensions>
            <!-- Original invoice number -->
            <cbc:ID>INV12345</cbc:ID>
            <!-- "key" from get transaction response JSON -->
            <cbc:UUID>ToiEAAEj2LSIKD50WgrJnnLr_VBY</cbc:UUID>
        </cac:InvoiceDocumentReference>
    </cac:BillingReference>
    <!-- Code omitted for clarity -->
</Invoice>