From d85a92abce205b2abdd72b9e5f67c6ccaa1cdfff Mon Sep 17 00:00:00 2001 From: mial-odoo <87338985+mial-odoo@users.noreply.github.com> Date: Tue, 27 Jan 2026 13:19:43 -0600 Subject: [PATCH] [IMP] Add 19.1 changes to the MX loc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit https://www.odoo.com/es/odoo-19-1-release-notes We changed some workflows in 19.1 that need to be added into the doc as we added: -External trade invoices with services -Cancellation acknowledgement -Periodicity on global invoices -Demo data is not current (Previous data still works, but this one works better for 19.1+ features). closes odoo/documentation#16142 Signed-off-by: Anne-Françoise Marcq (afma) --- .../finance/fiscal_localizations/mexico.rst | 96 ++++++++++++++---- .../mexico/certificate.cer | Bin 1460 -> 1466 bytes .../mexico/certificate.key | Bin 1298 -> 1298 bytes ...x-invoice-cancellation-acknowledgement.png | Bin 0 -> 28791 bytes 4 files changed, 78 insertions(+), 18 deletions(-) create mode 100644 content/applications/finance/fiscal_localizations/mexico/mx-invoice-cancellation-acknowledgement.png diff --git a/content/applications/finance/fiscal_localizations/mexico.rst b/content/applications/finance/fiscal_localizations/mexico.rst index 8c4a717a11..ce43475d1f 100644 --- a/content/applications/finance/fiscal_localizations/mexico.rst +++ b/content/applications/finance/fiscal_localizations/mexico.rst @@ -165,10 +165,18 @@ invoicing` section. Under :guilabel:`Service Tax Administration (SAT)`, select t Regime` that applies to the company from the drop-down list, and click :guilabel:`Save`. .. tip:: - In order to test the Mexican localization, configure the company with a real address within - Mexico (including all fields). Add `EKU9003173C9` as the :guilabel:`Tax ID` and `ESCUELA KEMPER - URGATE` as the :guilabel:`Company Name`. For the :guilabel:`Fiscal Regime`, use - :guilabel:`General de Ley Personas Morales`. + To test the Mexican localization, make sure the following fields are filled in: + + - :guilabel:`Company form`: + + - :guilabel:`Company Name`: enter `INNOVACION VALOR Y DESARROLLO SA SA` + - :guilabel:`Address`: fill in all fields with a real address in Mexico, and `58000` as + :guilabel:`Zip` + - :guilabel:`RFC`: enter `IVD920810GU2` + + - Go to :menuselection:`Accounting --> Configuration --> Settings` and scroll down to the + :guilabel:`MX Electronic invoicing` section. In the :guilabel:`Fiscal Regime` field, select + :guilabel:`General de Ley Personas Morales`. Branches -------- @@ -367,9 +375,9 @@ PAC credentials ~~~~~~~~~~~~~~~ After processing your `Private Key (CSD) -`_ with the |SAT|, you **must** register directly with the :ref:`PAC -` of your choice before you start creating invoices from Odoo. +`_ with the |SAT|, you +**must** register directly with the :ref:`PAC ` of your choice before you +start creating invoices from Odoo. Once you've created your account with any of these providers, go to :menuselection:`Accounting --> Configuration --> Settings` and navigate to the :guilabel:`MX Electronic invoicing` section. Under @@ -410,7 +418,8 @@ menu. records are optional. .. tip:: - In order to test the electronic invoicing, the following |SAT| test certificates are provided: + To test the electronic invoicing, the following |SAT| test certificates are provided and can be + tested with either :guilabel:`Quadrum` or :guilabel:`Solución Factible` as PAC: - :download:`Certificate ` - :download:`Certificate Key ` @@ -764,6 +773,24 @@ Like with invoices, go to the payment and click :guilabel:`Update SAT` in order This action cancels the invoice and marks the :guilabel:`Reason` as :guilabel:`01 - Invoice issued with errors (with related document)`. +.. _l10n/mx/cancellation-acknowledgement: + +Cancellation Acknowledgement +**************************** + +To print a cancellation |PAC| response after cancelling a |CFDI|, click :guilabel:`Print` on the +corresponding cancellation line in the :guilabel:`CFDI` tab of the invoice form. + +To include the current :guilabel:`SAT status` in the PDF, click :guilabel:`Update SAT` in the +invoice form. Note that when a payment is reviewed, the invoice status is updated accordingly. + +.. image:: mexico/mx-invoice-cancellation-acknowledgement.png + :alt: Cancellation acknowledgement example. + +.. important:: + A cancellation acknowledgement confirms that the cancellation was requested successfully, but it + is *not* definitive proof that the CFDI has been fully cancelled. + .. _l10n/mx/special-use-cases: Invoicing special use cases @@ -1068,24 +1095,40 @@ After this, go to :menuselection:`Sales --> To Invoice --> Orders to Invoice`, s sales orders and press :guilabel:`Create Invoices`. Make sure to disable the :guilabel:`Consolidated Billing` checkbox and click :guilabel:`Create Draft Invoice`. -Odoo will redirect to a list of invoices. Select all of them and in the :icon:`fa-gear` -:guilabel:`Actions` drop-down menu select :guilabel:`Post entries`. Select all posted invoices again -and go back to the :icon:`fa-gear` :guilabel:`Actions` drop-down menu to select :guilabel:`Create -Global Invoice`. +In the list of draft invoices displayed, select all, click :icon:`fa-gear` :guilabel:`Actions`, and +select :guilabel:`Confirm entries`. Then, select all posted invoices again and return to the +:icon:`fa-gear` :guilabel:`Actions` drop-down menu to select :guilabel:`Create Global Invoice`. -In the wizard, select the :guilabel:`Periodicity` indicated by a professional accountant and press -:guilabel:`Create`. All invoices should be signed under the same XML file, with the same +In the :guilabel:`Create Global Invoice` window, select the :guilabel:`Periodicity` recommended by +your accountant and use the :guilabel:`Date` field to specify the period to be invoiced. Then, click +:guilabel:`Create`. Verify all invoices are signed under the same XML file and share the same :guilabel:`Fiscal Folio`. +.. note:: + - The selected :guilabel:`Date` is used only to extract the *month* and *year* for the XML. For + bimonthly periodicity, the month determines the period declared as follows: + + - Months 1-12: Standard month number (January = 1, February = 2, etc.) + - January - February -> 13 + - March - April -> 14 + - May - June -> 15 + - July - August -> 16 + - September - October -> 17 + - November - December -> 18 + + - Global invoices created this way won't include a **PDF** attachment, as their information is + already in Odoo and isn't meant to be seen by customers. + +.. example:: + - Selecting the date 01/12/2026 with monthly periodicity declares month 12 and year 2026. + - Selecting the date 01/12/2026 with bimonthly periodicity declares month 18 and year 2026. + - Selecting the date 01/12/2026 with daily periodicity declares month 12 and year 2026. + .. tip:: - Click :guilabel:`Show` in the :guilabel:`CFDI` tab to display a list with all related invoices. - Click :guilabel:`Cancel` in the :guilabel:`CFDI` tab to cancel the global invoice in both the |SAT| and Odoo. -.. note:: - Global invoices created this way won't have a **PDF** in them as their information is already - within Odoo and is not to be seen by a customer. - .. _l10n/mx/reporting: Electronic accounting (reporting) @@ -1377,6 +1420,23 @@ the invoice's :guilabel:`Other Info` tab. Finally, confirm the invoice with the same process as a regular invoice, and click the :guilabel:`Send` button to sign it via CFDI. +.. _l10n/mx/external-trade-services: + +Invoicing services +~~~~~~~~~~~~~~~~~~ + +Services and merchandise can be invoiced together on the same invoice if the service is set up +correctly. To do so, follow these steps: + +#. Go to :menuselection:`Accounting --> Customers --> Products` and access the relevant service + form. +#. In the :guilabel:`Accounting` tab, under the :guilabel:`UNSPSC` section, find the :guilabel:`UMT + Aduana` field and click the :icon:`oi-arrow-right` :guilabel:`(right arrow)`. +#. Verify that either the :guilabel:`UNSPSC Category` is selected to :guilabel:`E48 service unit` or + the :guilabel:`Customs code` is set as `99`. + +Invoicing with either of these codes sets the service price to 0 for customs declarations. + .. _l10n/mx/pos: Point of sale diff --git a/content/applications/finance/fiscal_localizations/mexico/certificate.cer b/content/applications/finance/fiscal_localizations/mexico/certificate.cer index e0963d127e6e1adc67ca1e96d8f82e7a55ec643c..cf70ca51020e2e59f3bc2d482a77a56536ec25c8 100644 GIT binary patch delta 1006 zcmdnOy^CAfpow*xK@;=51_Xg{O7+E&q39 z-{8KaJKf!AKXaaWY5OD5`m{yTt#NvFNnU-szI@qhE7ZH3@7wct)j8YGb9QF^n0d&- zF0;mTxt5ZhiVmZx{;J1P`F|hp?fky~%PtS8C~3yK=VWBh9Nsjq%kCJbX6+}dl7<}T z;EmJg>RVo^4}7&xg~4ja*CiDb)tT&Giae{gdLow5oD||6u+!K6L=?9I*Lx<8%ad!E zE$Ss7ZfIG1!R!3nd7t*nR`Ji?fAOt`=p>2%x9;=clCgb{y1SvFP5>*&)-WteEC0->rS#ShQ_^-fXi3H_P3M zM+zF^LW*_@YnI+#?s9`q{pRMTOtl?h*0mS=3tY7))c@d^DEj^FdiO@Y{NJB=5~^<> z^0=klecZrT*3$L;)o1nU&o}K<@tPSbSaz%W z^~}$1Tt6G1O?sonmin+@*}lXb&1p^w#yhLNTGq8MzqhY2cDm^HQ{gSo%D)R!ap4B}mvE zJ}cJv2ADdxeo#3y^}>pKd;#k?<%>SI@4H+lus@t(+ND>j4AzS8W=gQNmz*_dR4qSn z#o*lXQ=u{Y9WHj~9h@`iVc!0gxupv)u8Rw9mCM>|?^~_^rKRfP=j`Nvk9YO=Z4j+q g?S1M9%f$x@((d`&{yw~OE=nZ9Lo=8~O(|qO0D&8~xBvhE delta 1000 zcmdnRy@gxZpow*ZK@;q1QNi2QH^4PWAvDO{F~n6N*ipg7Rlzw7 zrcjeug0VTUS`d)jQM@=vqT_V`t0BGE8ap+tTM)uly#dYpn0PvvK1w z$C%{SRLcT8WD+ip!m~{NS8Ez7I2x#m_$H!n(%k_+QRj z@0?au6e~40l?nLo5}h!oqta)G^5433W~(=(IW@Izj{Ca2wQH-r>Ym;=9!lA_xa2R* z3_2y-asFil>E;%`U1Dmuf`{vinCuF?j4Db9Q$T;80UpFmo zX60As94Ec~`Sbpn6D&`bJboi-f7P#AW4HJc-XBX;Y~$bXMlPB5if<<8ywgnPdnY$B zThxm#Rp_7ms_9cw!)1kS+r!h!&esM+?{biiZf=|F;k$bs(*y<_X^XFMzu zdfIB{`yN)3YWjHG=*;I66_ZjLY@WMc+q!G*sT-M0^%0%749lOK%QV%W;pgJ`)2{pP zxn-AqmYG-WoobuS?t9}jPqyCni5_8oUfVuI{xE;w6fOJhXxxNJq3xcoKc<#_d|u65 zvVQuNDZc~1oeq%KURBL=ce2{gUXu@(6TTI?pMJjksjaqS|CW~S>b|H?uQw??pQB{x za*Xq)gW04Dr{w(WH%C=7&s@H=Qs>3IzfH1vW+%(|xxOy?e2V3Yk#EB06ea6fZ_YT( zbB@ea=RNG}@Y?M3#<`z9;GasF;#t+-X>aE#x%wTqjHv$pGcZDa zL3!NQ&E@qo`ct;PJ>#x7^}}Hn0|j-%U2IENX(V$n%w|_rPQA%_=4^dr`NPcgEvb6` zv$dW7B)p8b6u;D{kbG(X&MwRFeP>Ij9b>ZG)P0=ghU|)_KeNnJ?<;h^PWi!7`>BFK z?uiKRvV*T>bsj9dAawYfb{g0B?aYC0?)_`FylpV`Qc|ul_xroaQNtq7ym`u8o2g~9 eM3k=Gn%)v~^s%F-bzN5Ulf!wIEH2kx2m%0=BeLxP diff --git a/content/applications/finance/fiscal_localizations/mexico/certificate.key b/content/applications/finance/fiscal_localizations/mexico/certificate.key index 4f2d75daf2cbc2831c39444dfc0e74e96921a1ca..7cda77e86e29812added02ea51f42963978382ce 100644 GIT binary patch delta 1208 zcmV;p1V{Ul3X%$tYJa=}!wTt5BM1w`F{D0OiP`l~gMd%mHf6s-3TpPjSgG5#6Z8|i zX~o2`sUxH>A#fdelYR)^hRK~qJmqc}`*&-vAM1vE{TY+2m~rz)LFqfLO~O)NdZ$^I zTq#)A=88A;5*$p8z-}-aO-#=Qa(~kfRs|cv5fIeulC2B=s()*+d9Y00CSc+&Cd|=K z3AY$cc^NZLxlb;sxYxe;5sCT2TU{~S5AbBu7wzH}Hw09$=E6`Gyu>|sLyZ)AGRRl$ zgN98-8!(--?8h1yBd%hrQu#Pk^%XeR(4@PnpT<)6k=gR0Fjhw3ANws?4Jwe%aGizO zN)!^t)$+M4hJVo;Nvi5eLi>y-D$ulv-p49A^#e8|ZoT%0CW^nb7DkkeM#bHd6vPYX9j8Q?k-&27O~?2?DIBE~BDs z*wM!MQxtoM0FTn*^Fa?mSKh%ed~>c*h9XXV%fwJlfPWu#;{~M!BeO@%@Z=!BX{I$t zUa1p3^M&l@ov$QIRdN*GE=Zm=;K|@>r1Y(TB#-?b&i1t!UK;YIAhkq>Rs}mgX2FhfDPU83!>c&4{>K2_cj+8zexO(mBpA|L&w8|MNg(VPqZ{L8? zG!MccM5Pc#>xYYU52pQvC79V03aaOZ8@H*LsUqBuH5p&n0R>o$qi{V2(xr-ftLY2h zG_ul%6OI}9w@<0pOSOE>%^34qleisvXBSm6Q-9IEeKbr6XRHJ>OM$eo8zR5UGTaA| zE(TP$`VmD*QCn**Vyvl(6f$h}Hck)xX<{8=QYuVdBD#@FvY*RLqXtrQTNm8tUrJ}n zmd43RhXX-0Raf<%Q)dSnZ+awFb+_j!<-EEWD>rAW|f z(|@FCB;0tl)~OaR74<`kx^z)QfQ;Fl(Too}vNzJKe_=sp`ND7u3Cc{r%i*jI#6p)r|PJAxEt zeuCkZ&R}IUo#y<{m30=ham5J%dB&YV%-HInx!6Au#`VJR6-O3ghrl3mF&1|UVCeOO za^Qm+S8SqCtCyxjZoI==%JXgM@A}GDR^-q2nVzEv=2S5B%xj%KzgQfi?PW%l?|)P4 zHN0C^_Ra?k1>0TCIpk&}>630_DDB~}z)7%>biQ(aVotMtY8eIFTCz#UnjpVQr4?Dz zK7EF8NLM%R{FPrOc!hzNL)$6#%@cxbnCpkW$vg|(0V0A| Wv`IYxQA?rUSmB2OFYzd~oCsAJ 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 TXZU}k