Guides

Mexico (Pymnt): Invoice Document Reference Extension

Read about the elements and examples for Invoice Document Reference Extension for Mexico (Pymnt).

Suggest Edits

An extension group to provide additional information for the related invoice.

Name (Path)CardinalityDescription
Invoice Document Reference Extension (UBLExtensions/UBLExtension/ExtensionContent/InvoiceDocumentReferenceExtension)1..1An extension group to provide additional information regarding the related invoice.

Elements

This extension group contains the following elements and groups.

Name (Path)CardinalityDescription
Invoice Currency Code (DocumentCurrencyCode)1..1The currency in which all invoice amounts are given, except for the Total tax amount in accounting currency (only if accounting currency is different from invoice currency).
Exchange Rate (ExchangeRate)0..1A group to provide information about the tax exchange rate applied to the invoice amounts.
Source Currency Code (ExchangeRate/SourceCurrencyCode)1..1To indicate the source currency (foreign currency).
Target Currency Code (ExchangeRate/TargetCurrencyCode)1..1To indicate the destination currency (MXN).
Calculation Rate (ExchangeRate/CalculationRate)1..1The calculation rate.
Invoice Series (InvoiceSeries)0..1To provide the series of the invoice.
Outstanding Amount (OutstandingAmount)1..1The outstanding amount to be paid.
Outstanding Amount Currency (OutstandingAmount/@currencyID)1..1The currency of the outstanding amount to be paid.
Paid Amount (PaidAmount)1..1The paid amount in the referenced document.
Paid Amount Currency (PaidAmount/@currencyID)1..1The currency of the paid.
Previous Balance Amount (PreviousBalanceAmount)1..1The previous balance amount.
Previous Balance Amount Currency (PreviousBalanceAmount/@currencyID)1..1The currency of the previous balance amount.
Sequence Number (SequenceNumeric)1..1The installment number in the sequence of payments.
Invoice Tax Totals (TaxTotal)0..1The tax totals and tax breakdown of the referenced invoice
Invoice Witholding Tax Totals (WithholdingTaxTotal)0..1The withholding tax totals and witholding tax breakdown of the referenced invoice

For all currencies use codes from the ISO4217 code list

Note: At least one Invoice Tax Totals or Invoice Withholding Tax Totals group must be provided.

For more details on the Invoice Tax Totals see Document Level Taxes.
This group uses the same structure and code lists.

For more details on the Invoice Withholding Tax Totals see Document Level Withholding Taxes.
This group uses the same structure and code lists.

Example

Below is an example of the Invoice Document Reference Extension:

<ubl:Statement>
    <!-- code omitted for clarity -->
    <cac:StatementLine>
        <!-- code omitted for clarity -->
        <cac:BillingReference>
            <cac:InvoiceDocumentReference>
                <cec:UBLExtensions>
                    <cec:UBLExtension>
                        <cec:ExtensionContent>
                            <vrbl:InvoiceDocumentReferenceExtension>
                                <cbc:DocumentCurrencyCode>USD</cbc:DocumentCurrencyCode>
                                <cac:ExchangeRate>
                                    <cbc:SourceCurrencyCode>USD</cbc:SourceCurrencyCode>
                                    <cbc:TargetCurrencyCode>MXN</cbc:TargetCurrencyCode>
                                    <cbc:CalculationRate>17.61</cbc:CalculationRate>
                                </cac:ExchangeRate>
                                <vrbl:InvoiceSeries>F</vrbl:InvoiceSeries>
                                <vrbl:OutstandingAmount currencyID="USD">928.00</vrbl:OutstandingAmount>
                                <cbc:PaidAmount currencyID="USD">1392.00</cbc:PaidAmount>
                                <vrbl:PreviousBalanceAmount currencyID="USD">2320.00</vrbl:PreviousBalanceAmount>
                                <cbc:SequenceNumeric>1</cbc:SequenceNumeric>
                                <cac:TaxTotal>
                                    <cbc:TaxAmount currencyID="USD">192.00</cbc:TaxAmount>
                                    <cac:TaxSubtotal>
                                        <cbc:TaxableAmount currencyID="USD">1200.00</cbc:TaxableAmount>
                                        <cbc:TaxAmount currencyID="USD">192.00</cbc:TaxAmount>
                                        <cac:TaxCategory>
                                            <cbc:ID>VRBL:MX:02</cbc:ID>
                                            <cbc:Percent>16.00</cbc:Percent>
                                            <cac:TaxScheme>
                                                <cbc:ID>VRBL:MX:002</cbc:ID>
                                                <cbc:TaxTypeCode>VRBL:MX:Rate</cbc:TaxTypeCode>
                                            </cac:TaxScheme>
                                        </cac:TaxCategory>
                                    </cac:TaxSubtotal>
                                </cac:TaxTotal>
                                <!-- <cac:WithholdingTaxTotal>
                                    <cbc:TaxAmount currencyID="USD">192.00</cbc:TaxAmount>
                                    <cac:TaxSubtotal>
                                        <cbc:TaxableAmount currencyID="USD">1200.00</cbc:TaxableAmount>
                                        <cbc:TaxAmount currencyID="USD">192.00</cbc:TaxAmount>
                                        <cac:TaxCategory>
                                            <cbc:ID>VRBL:MX:02</cbc:ID>
                                            <cbc:Percent>16.00</cbc:Percent>
                                            <cac:TaxScheme>
                                                <cbc:ID>VRBL:MX:002</cbc:ID>
                                                <cbc:TaxTypeCode>VRBL:MX:Rate</cbc:TaxTypeCode>
                                            </cac:TaxScheme>
                                        </cac:TaxCategory>
                                    </cac:TaxSubtotal>
                                </cac:WithholdingTaxTotal> -->
                            </vrbl:InvoiceDocumentReferenceExtension>
                        </cec:ExtensionContent>
                    </cec:UBLExtension>
                </cec:UBLExtensions>
            </cac:InvoiceDocumentReference>
        </cac:BillingReference>
        <!-- code omitted for clarity -->
    </cac:StatementLine>
</ubl:Statement>

Updated 9 days ago