From bac24f4b52e8ed5dc549c91cd13e3906758d4b8d Mon Sep 17 00:00:00 2001 From: "Sam Lieber (sali)" Date: Tue, 26 Sep 2023 17:28:07 +0000 Subject: [PATCH] [IMP] accounting/l10n_co: additional context closes odoo/documentation#6684 X-original-commit: 6045a60dd5d5c2e358c0319e12ed7ee9fec42414 Signed-off-by: Zachary Straub (zst) Signed-off-by: Samuel Lieber (sali) Co-authored-by: dade-odoo <87431108+dade-odoo@users.noreply.github.com> Co-authored-by: larm-odoo <121518652+larm-odoo@users.noreply.github.com> --- .../finance/fiscal_localizations/colombia.rst | 226 +++++++++++------- .../colombia/workflow-electronic-invoice.png | Bin 0 -> 24860 bytes 2 files changed, 141 insertions(+), 85 deletions(-) create mode 100644 content/applications/finance/fiscal_localizations/colombia/workflow-electronic-invoice.png diff --git a/content/applications/finance/fiscal_localizations/colombia.rst b/content/applications/finance/fiscal_localizations/colombia.rst index bebb79fe7..61f8ed9cc 100644 --- a/content/applications/finance/fiscal_localizations/colombia.rst +++ b/content/applications/finance/fiscal_localizations/colombia.rst @@ -4,15 +4,16 @@ Colombia .. |DIAN| replace:: :abbr:`DIAN (Dirección de Impuestos y Aduanas Nacionales)` -Odoo's Colombian localization package provides accounting, fiscal and legal features in Colombia -such as chart of accounts, taxes and electronic invoicing. +Odoo's Colombian localization package provides accounting, fiscal, and legal features for databases +in Colombia – such as chart of accounts, taxes, and electronic invoicing. -In addition, we have a series of videos covering how to start from scratch, configuration, main -workflows, and specific use cases. +In addition, a series of videos on the subject is also available. These videos cover how to start +from scratch, set up configurations, complete common workflows, and provide in-depth looks at some +specific use cases as well. .. seealso:: - `Odoo Colombian localization videos - `_. + `Smart Tutorial - Colombian Localization + `_. .. _colombia/configuration: @@ -36,74 +37,78 @@ localization: - `l10n_co` - Default :ref:`fiscal localization package `. This module adds the base accounting features for the Colombian localization: chart of accounts, taxes, - withholdings, identification document type. + withholdings, and identification document type. * - :guilabel:`Colombian - Accounting Reports` - `l10n_co_reports` - Includes accounting reports for sending certifications to suppliers for withholdings applied. * - :guilabel:`Electronic invoicing for Colombia with Carvajal` - `l10n_co_edi` - - This module includes the features that are required for the integration with Carvajal and - generates the electronic invoices and support document related to the vendor bills based on + - This module includes the features required for integration with Carvajal, and + generates the electronic invoices and support documents related to the vendor bills, based on |DIAN| regulations. * - :guilabel:`Colombian - Point of Sale` - `l10n_co_pos` - - Includes Point of Sale Receipt for Colombian Localization. + - Includes Point of Sale receipts for Colombian localization. .. note:: - When a database is created from scratch selecting :guilabel:`Colombia` as the country, Odoo - automatically installs the base modules *Colombia - Accounting* and *Colombia - Accounting - Reports*. + When `Colombia` is selected for a company's :guilabel:`Fiscal Localization`, Odoo automatically + installs certain modules. Company configuration --------------------- -To configure your company information, go to the :menuselection:`Contacts` app and search for your -company. Alternatively, activate :ref:`developer mode ` and navigate to +To configure your company information, go to the :menuselection:`Contacts` app, and search for your +company. + +Alternatively, activate :ref:`developer mode ` and navigate to :menuselection:`General Setting --> Company --> Update Info --> Contact`. Then, edit the contact -form to configure the following information: +form and configure the following information: - :guilabel:`Company Name`. -- :guilabel:`Address`: Including :guilabel:`City`, :guilabel:`Department` and :guilabel:`Zip Code`. -- :guilabel:`Tax ID`: When it is a `NIT`, it must have the *verification digit* at the end of the ID - followed by a hyphen (`-`). +- :guilabel:`Address`: Including :guilabel:`City`, :guilabel:`Department` and :guilabel:`ZIP` code. +- :guilabel:`Identification Number`: Select the :guilabel:`Identification Type` (`NIT`, `Cédula de + Ciudadanía`, `Registro Civil`, etc.). When the :guilabel:`Identification Type` is `NIT`, the + :guilabel:`Identification Number` **must** have the *verification digit* at the end of the ID + prefixed by a hyphen (`-`). Next, configure the :guilabel:`Fiscal Information` in the :guilabel:`Sales & Purchase` tab: - :guilabel:`Obligaciones y Responsabilidades`: Select the fiscal responsibility for the company - (:guilabel:`O-13` Gran Contribuyente, :guilabel:`O-15` Autorretenedor, :guilabel:`O-23` Agente de - retención IVA, :guilabel:`O-47` Regimen de tributación simple, :guilabel:`R-99-PN` No Aplica). + (`O-13` Gran Contribuyente, `O-15` Autorretenedor, `O-23` Agente de retención IVA, `O-47` Regimen + de tributación simple, `R-99-PN` No Aplica). - :guilabel:`Gran Contribuyente`: If the company is *Gran Contribuyente* this option should be selected. -- :guilabel:`Fiscal Regimen`: Select the Tribute Name for the company (:guilabel:`IVA`, - :guilabel:`INC`, :guilabel:`IVA e INC`, :guilabel:`No Aplica`) +- :guilabel:`Fiscal Regimen`: Select the Tribute Name for the company (`IVA`, `INC`, `IVA e INC`, + or `No Aplica`) - :guilabel:`Commercial Name`: If the company uses a specific commercial name, and it needs to be displayed in the invoice. Carjaval credentials configuration ---------------------------------- -Once the modules installed, the user credentials must be configured in order to connect with -Carvajal Web Service. Navigate to :menuselection:`Accounting --> Configuration --> Settings` and -scroll to the :guilabel:`Colombian Electronic Invoicing` section. Then, fill in the required -configuration information provided by Carvajal: +Once the modules are installed, the user credentials **must** be configured, in order to connect +with Carvajal Web Service. To do so, navigate to :menuselection:`Accounting --> Configuration --> +Settings` and scroll to the :guilabel:`Colombian Electronic Invoicing` section. Then, fill in the +required configuration information provided by Carvajal: -- :guilabel:`Username` and :guilabel:`Password`: Correspond to the username and password provided - by Carvajal to the company. +- :guilabel:`Username` and :guilabel:`Password`: Username and password (provided by Carvajal) to the + company. - :guilabel:`Company Registry`: Company's NIT number *without* the verification code. -- :guilabel:`Account ID`: Company ID followed by `_01`. -- :guilabel:`Colombia Template Code`: Select one of the two available templates (:guilabel:`CGEN03` - or :guilabel:`CGNE04`) to be used in the PDF format of the electronic invoice. +- :guilabel:`Account ID`: Company's NIT number followed by `_01`. +- :guilabel:`Colombia Template Code`: Select one of the two available templates (`CGEN03` or + `CGNE04`) to be used in the PDF format of the electronic invoice. + +Enable the :guilabel:`Test mode` checkbox to connect with the Carvajal testing environment. + +Once Odoo and Carvajal are fully configured and ready for production, deactivate the :guilabel:`Test +mode` checkbox to use the production database. .. image:: colombia/carvajal-configuration.png + :align: center :alt: Configure credentials for Carvajal web service in Odoo. -.. note:: - Check the :guilabel:`Test mode` checkbox to connect with the Carvajal testing environment. Once - Odoo and Carvajal are fully configured and ready for production, uncheck the :guilabel:`Test - mode` checkbox to use the production database. - .. important:: - :guilabel:`Test mode` must be used **only** on replicated databases, **not** the production + :guilabel:`Test mode` must **only** be used on duplicated databases, **not** the production environment. Report data configuration @@ -112,8 +117,17 @@ Report data configuration Report data can be defined for the fiscal section and bank information of the PDF as part of the configurable information sent in the XML. -Navigate to :menuselection:`Accounting --> Configuration --> Settings` and scroll to the -:guilabel:`Colombian Electronic Invoicing` section. +Navigate to :menuselection:`Accounting --> Configuration --> Settings`, and scroll to the +:guilabel:`Colombian Electronic Invoicing` section, in order to find the :guilabel:`Report +Configuration` fields. Here the header information for each report type can be configured. + +- :guilabel:`Gran Contribuyente` +- :guilabel:`Tipo de Régimen` +- :guilabel:`Retenedores de IVA` +- :guilabel:`Autorretenedores` +- :guilabel:`Resolución Aplicable` +- :guilabel:`Actividad Económica` +- :guilabel:`Bank Information` .. _colombia/master-data: @@ -123,67 +137,85 @@ Master data configuration Partner ~~~~~~~ +Partner contacts can be created in the *Contacts* app. To do so, navigate to +:menuselection:`Contacts`, and click the :guilabel:`Create` button. + +Then, name the contact, and using the radio buttons, select the contact type, either +:guilabel:`Individual` or :guilabel:`Company`. + +Complete the full :guilabel:`Address`, including the :guilabel:`City`, :guilabel:`State`, and +:guilabel:`ZIP` code. Then, complete the identification and fiscal information. + Identification information ************************** -Document types defined by the |DIAN| are available on the partner form as part of the Colombian -localization. Colombian partners must have their :guilabel:`Identification Number` (VAT) and -:guilabel:`Document Type` set. +Identification types, defined by the |DIAN|, are available on the partner form, as part of the +Colombian localization. Colombian partners **must** have their :guilabel:`Identification Number` +(VAT) and :guilabel:`Document Type` set. .. tip:: When the :guilabel:`Document Type` is `NIT`, the :guilabel:`Identification Number` needs to be - configured in Odoo, including the *verification digit*; Odoo splits this number when the data to - is sent to the third party. + configured in Odoo, including the *verification digit at the end of the ID, prefixed by a hyphen + (`-`)*. Fiscal information ****************** -The partner's responsibility codes (section 53 in the RUT document) are included as part of the -electronic invoicing module, as it is required by the |DIAN|. +The partner's responsibility codes (section 53 in the :abbr:`RUT (Registro único tributario)` +document) are included as part of the electronic invoicing module, as it is required by the |DIAN|. The required fields can be found under :menuselection:`Partner --> Sales & Purchase Tab --> Fiscal -Information`: +Information section`: - :guilabel:`Obligaciones y Responsabilidades`: Select the fiscal responsibility for the company - (:guilabel:`O-13` Gran Contribuyente, :guilabel:`O-15` Autorretenedor, :guilabel:`O-23` Agente de - retención IVA, :guilabel:`O-47` Regimen de tributación simple, :guilabel:`R-99-PN` No Aplica). + (`O-13` Gran Contribuyente, `O-15` Autorretenedor, `O-23` Agente de retención IVA, `O-47` Regimen + de tributación simple, or `R-99-PN` No Aplica). - :guilabel:`Gran Contribuyente`: If the company is *Gran Contribuyente* this option should be selected. -- :guilabel:`Fiscal Regimen`: Select the Tribute Name for the company (:guilabel:`IVA`, - :guilabel:`INC`, :guilabel:`IVA e INC`, :guilabel:`No Aplica`) +- :guilabel:`Fiscal Regimen`: Select the tribute name for the company (`IVA`, `INC`, `IVA e INC`, or + `No Aplica`) - :guilabel:`Commercial Name`: If the company uses a specific commercial name, and it needs to be displayed in the invoice. Products ~~~~~~~~ -In addition to adding general information (in the :guilabel:`General Information` tab) on the -product form, either the :guilabel:`UNSPSC Category`, :guilabel:`Barcode`, or :guilabel:`Internal -Reference` field must also be configured. +To manage products, navigate to :menuselection:`Accounting --> Customers --> Products`, then click +on a product. + +When adding general information on the product form, it is required that either the +:guilabel:`UNSPSC Category` (:guilabel:`Accounting` tab), or :guilabel:`Internal Reference` +(:guilabel:`General Information` tab) field is configured. Be sure to :guilabel:`Save` the product +once configured. Taxes ~~~~~ -If sales transactions include products with taxes, the :guilabel:`Value Type` field in the -:guilabel:`Advanced Options` tab needs to be configured per tax. To do so, go to -:menuselection:`Accounting --> Configuration --> Taxes`, and select the related tax. +To create or modify taxes, go to :menuselection:`Accounting --> Configuration --> Taxes`, and select +the related tax. -Retention tax types (:guilabel:`ICA`, :guilabel:`IVA`, :guilabel:`Fuente`) are also included. This -configuration is used to display taxes in the invoice PDF correctly. +If sales transactions include products with taxes, the :guilabel:`Value Type` field in the +:guilabel:`Advanced Options` tab needs to be configured per tax. Retention tax types +(:guilabel:`ICA`, :guilabel:`IVA`, :guilabel:`Fuente`) are also included. This configuration is used +to display taxes correctly in the invoice PDF. .. image:: colombia/retention-tax-types.png + :align: center :alt: The ICA, IVA and Fuente fields in the Advanced Options tab in Odoo. +.. _co-journals: + Sales journals ~~~~~~~~~~~~~~ -.. _co-journals: - Once the |DIAN| has assigned the official sequence and prefix for the electronic invoice resolution, -the sales journals related to the invoice documents must be updated in Odoo. To do so, navigate to -:menuselection:`Accounting --> Configuration --> Journals`. +the sales journals related to the invoice documents **must** be updated in Odoo. To do so, navigate +to :menuselection:`Accounting --> Configuration --> Journals`, and select an existing sales journal, +or create a new one with the :guilabel:`Create` button. -Configure the following data in the :guilabel:`Advanced Settings` tab: +On the sales journal form, input the :guilabel:`Journal Name`, :guilabel:`Type`, and set a unique +:guilabel:`Short Code` in the :guilabel:`Journals Entries` tab. Then, configure the following data +in the :guilabel:`Advanced Settings` tab: - :guilabel:`Electronic invoicing`: Enable :guilabel:`UBL 2.1 (Colombia)`. - :guilabel:`Invoicing Resolution`: Resolution number issued by |DIAN| to the company. @@ -193,32 +225,31 @@ Configure the following data in the :guilabel:`Advanced Settings` tab: - :guilabel:`Range of Numbering (maximum)`: Last authorized invoice number. .. note:: - The sequence and resolution of the journal must match the one configured in Carvajal and the + The sequence and resolution of the journal **must** match the one configured in Carvajal and the |DIAN|. Invoice sequence **************** -The invoice sequence and prefix must be correctly configured when the first document is created. +The invoice sequence and prefix **must** be correctly configured when the first document is created. .. note:: - Odoo automatically assigns a prefix and sequence to the following documents. + Odoo automatically assigns a prefix and sequence to the following invoices. Purchase journals ***************** -Once the |DIAN| has assigned the official sequence and prefix for the support document related to +Once the |DIAN| has assigned the official sequence and prefix for the *support document* related to vendor bills, the purchase journals related to their supporting documents need to be updated in Odoo. The process is similar to the configuration of the :ref:`sales journals `. Chart of accounts ***************** -The :doc:`chart of accounts -` is installed by default as part of -the localization module, the accounts are mapped automatically in taxes, default account payable, -and default account receivable. The chart of accounts for Colombia is based on the PUC (Plan Unico -de Cuentas). +The :doc:`chart of accounts ` is +installed by default as part of the localization module, the accounts are mapped automatically in +taxes, default account payable, and default account receivable. The chart of accounts for Colombia +is based on the PUC (Plan Unico de Cuentas). .. _colombia/workflows: @@ -228,18 +259,38 @@ Main workflows Electronic invoices ------------------- +The following is a breakdown of the main workflow for electronic invoices with the Colombian +localization: + +#. Sender creates an invoice. +#. Electronic invoice provider generates the legal XML file. +#. Electronic invoice provider creates the CUFE (Invoice Electronic Code) with the electronic + signature. +#. Electronic invoice provider sends a notification to |DIAN|. +#. |DIAN| validates the invoice. +#. |DIAN| accepts or rejects the invoice. +#. Electronic invoice provider generates the PDF invoice with a QR code. +#. Electronic invoice provider sends invoice to the acquirer. +#. Acquirer sends a receipt of acknowledgement, and accepts or rejects the invoice. +#. Sender downloads a :file:`.zip` file with the PDF and XML. + +.. image:: colombia/workflow-electronic-invoice.png + :align: center + :alt: Electronic invoice workflow for Colombian localization. + .. _colombia/invoice-creation: Invoice creation ~~~~~~~~~~~~~~~~ .. note:: - The functional workflow taking place before an invoice validation does not alter the main changes - introduced with the electronic invoice. + The functional workflow taking place before an invoice validation does **not** alter the main + changes introduced with the electronic invoice. Electronic invoices are generated and sent to both the |DIAN| and customer through Carvajal's web -service integration. These documents can be created from your sales order or manually. Go to -:menuselection:`Accounting --> Customers --> Invoices` and configure: +service integration. These documents can be created from your sales order or manually generated. To +create a new invoice, go to :menuselection:`Accounting --> Customers --> Invoices`, and select +:guilabel:`Create`. On the invoice form configure the following fields: - :guilabel:`Customer`: Customer's information. - :guilabel:`Journal`: Journal used for electronic invoices. @@ -259,9 +310,10 @@ invoice is then processed asynchronously by the E-invoicing service UBL 2.1 (Col also displayed in the chatter. .. image:: colombia/invoice-sent.png + :align: center :alt: Carvajal XML invoice file in Odoo chatter. -The :guilabel:`Electronic Invoice Name` field is now displayed in the :guilabel:`EDI Documents` tab +The :guilabel:`Electronic Invoice Name` field is now displayed in the :guilabel:`EDI Documents` tab, with the name of the XML file. Additionally, the :guilabel:`Electronic Invoice Status` field is displayed with the initial value :guilabel:`To Send`. To process the invoice manually, click on the :guilabel:`Process Now` button. @@ -271,7 +323,7 @@ displayed with the initial value :guilabel:`To Send`. To process the invoice man Reception of legal XML and PDF ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The electronic invoice vendor (Carvajal) receives the XML file and proceeds to validate its +The electronic invoice vendor (Carvajal) receives the XML file, and proceeds to validate its structure and information. After validating the electronic invoice, proceed to generate a legal XML which includes a digital @@ -279,10 +331,11 @@ signature and a unique code (CUFE), a PDF invoice that includes a QR code and th generated. If everything is correct the :guilabel:`Electronic Invoicing` field value changes to :guilabel:`Sent`. -A ZIP containing the legal electronic invoice in XML format and the invoice in PDF format is -downloaded and displayed in the invoice chatter: +A :file:`.zip` containing the legal electronic invoice (in XML format) and the invoice in (PDF +format) is downloaded and displayed in the invoice chatter: .. image:: colombia/invoice-zip.png + :align: center :alt: ZIP file displayed in the invoice chatter in Odoo. The electronic invoice status changes to :guilabel:`Accepted`. @@ -292,7 +345,7 @@ Credit notes The process for credit notes is the same as for invoices. To create a credit note with reference to an invoice, go to :menuselection:`Accounting --> Customers --> Invoices`. On the invoice, click -:guilabel:`Add Credit Note` and complete the following information: +:guilabel:`Add Credit Note`, and complete the following information: - :guilabel:`Credit Method`: Select the type of credit method. @@ -316,7 +369,7 @@ Debit notes The process for debit notes is similar to credit notes. To create a debit note with reference to an invoice, go to :menuselection:`Accounting --> Customers --> Invoices`. On the invoice, click the -:guilabel:`Add Debit Note` button and complete the following information: +:guilabel:`Add Debit Note` button, and enter the following information: - :guilabel:`Reason`: Type the reason for the debit note. - :guilabel:`Debit note date`: Select the specific options. @@ -331,7 +384,7 @@ Support document for vendor bills --------------------------------- With master data, credentials, and the purchase journal configured for support documents related to -vendor bills, you can start using support documents. +vendor bills, you can start using *support documents*. Support documents for vendor bills can be created from your purchase order or manually. Go to :menuselection:`Accounting --> Vendors --> Bills` and fill in the following data: @@ -372,6 +425,7 @@ Commerce (ICA) tax. The report can be found under :menuselection:`Accounting --> Colombian Statements --> Certificado de Retención en ICA`. .. image:: colombia/ica-report.png + :align: center :alt: Certificado de Retención en ICA report in Odoo Accounting. Certificado de Retención en IVA @@ -382,6 +436,7 @@ can be found under :menuselection:`Accounting --> Reporting --> Colombian Statem de Retención en IVA`. .. image:: colombia/iva-report.png + :align: center :alt: Certificado de Retención en IVA report in Odoo Accounting. Certificado de Retención en la Fuente @@ -392,4 +447,5 @@ be found under :menuselection:`Accounting --> Reporting --> Colombian Statements Retención en Fuente`. .. image:: colombia/fuente-report.png + :align: center :alt: Certificado de Retención en Fuente report in Odoo Accounting. diff --git a/content/applications/finance/fiscal_localizations/colombia/workflow-electronic-invoice.png b/content/applications/finance/fiscal_localizations/colombia/workflow-electronic-invoice.png new file mode 100644 index 0000000000000000000000000000000000000000..dd0a994ba652e5f1a0c6af4d282c2109332ab454 GIT binary patch literal 24860 zcmZ6x1x#Gu6DWL_WfylT?ocQc*J6tmcP&z&xD{Ho=;D;(P~6?2xD;5VxJz-@{%|P{ z`}LoEFE4pFH#v9aj-8n~CzHv1)liei!KAsObtbF%>xjfYKlU#D)Y;JA$r3NeIhLa;yy>DM|^K`!bG~P4v_V)HWJodl;{)=)6?e0L7 zW)`LfCp1>qBcGlZ=NA%uqpq&5mY0|N`ue`w2U=NKsj8~Bw6s)KR(|^QDJdyQT3XuA z&o4JO_uad95fKqPmsj$2wV(QWsPnRgE6d?SgPFf)Ejl}5CdbQHmizbjUzHTj9i8a5 zG$E1CIm=IvNMz9LQ|U4C@*X*M^4vYQG5&jX^UvYj&cgiWE_UtW+m6-7{)ybCZtWGH zuGOgz{aYag^hDzJwG4b{)^oGIr4t{9|Q6qaC>`wfkd7o zpYFylk;sRu6Xf$>QSw_Al4=Ly20At`|+I`U+Q|iw9MuS>63LUk+2TNavURo$I=ZgzShkNiL?RC_PsWLn{p6<;fyn#X=U$Aa)hFYeyys!G?WxGC z!(ES#n!=}XzP3-OMJkvzCeUb*+^4b^Whnpq{67zTQMBN=Uy}@u2^$2UNaXwpexO|4kjR+Z%=Y4xpDm13kEVs~ zqebPTVE>!gTw^NcM-+)b=6oE^u>6Hu0J!=#Q7R{k`wv1jyiEsHs)pPs$Rx!^#=H|5DUar&alxG+iB2TW=f$=axDoy}1Ml$kds9h~Yy2C?F6s1SBoGkp=YZDhGIj~S z9r?>>C%6@7UG1teZ-rL6r4=SYN5?uWhjS)NY(MbV|JVfo1ZQDCv^qRy*K&*MWZoPe zLbCe?dNddT3e@wu?&JsLEefeVz|DndaQ@kJ^_^SZD0L9+(E)s9yb2=$Z?u9S#Jfw- zN^O76i#ss2DOqi77sYwodM7_(%u2fwO1!I8LC4{`)qmbhhj0P|+Yz=htZA%tc*7dQ zA7J!qU(&GdSI$8+*5y^$(`8f_K<0>gQ*}K(gH=?4K(E%XCL8 zH@S$d((Nd++G5npB_JXO%K0x~bAZBelsoRpo0AXQY#h+Rh<>&jY#=fGb`OuS)|O`MpsI-GCQ)okOt(&J6>DVv|NBbDv^qvl6tI3O@IZtQ z?QpOTlMG3oeIK*v(AMe{xiZaX?fN2_AJ7Y=H$&5;9e_9aPa_ai=Z!;0S2U1Oy~^$IqC;b`~|!h<59D#%uUyDv^#Vyx@t$!CaB$H4yL_NKpj=`W*fcXV8B zQRDWWd?G%;cRX6yPNg*0J}e^fk6UwW+Est6?WljWpmz6deGnE*>uq&WKZzB|YxfBe zNBeLn)oQ{L-TPMJc(<7-1=oZ0_1z{-hD(d4jAo}fg2hw#WIvL5-8dqe1>^nd2y4ff z7!OeA7`G*yYL{ST^!j>2td;2Uhb?#A&50+D#w=itw%s2l-m!_`C*1n>u-H2PQSylo zTuFwIQVt58m7nMewjLLS;Dd*?`g^?J$lVo#J`NmtrSI`{c`%gw@((2RPr0inQjGW; z-7TC~06tp2AK*sVwxa2+?wB!7Zp(w%hi_jAC&W0B#SJ*!*{%8rG4bcJuJhBOAn1)i ztv~44>f(=6Jz^gWiyT|R`O2P0;0Ir4zRGQ+*ZKX%{a)e5({!2jPB9_hmxrNb9hx=Z3>9=#~tfKdQF^> zk)YbdxZG`p>D?e%FV^&bIp_+_Lhy10cq46Qkv>yIVKt|8{Jfh#dHmZUXhi zR8z*E;Acr1410VmvB2KxZ)cT1!Mea~(<2O<2?<&Y<)RnRiwte;+@5lhBn0C{{de zZ@U=^Z>N6Xp#>gUw_J^@8n=TdJpFVp8$43cdK3-^Cs0dGf?vF*OM8-bXkbzDmD1RRsIl&a!Kup1m zmwV2#$2Sm{m*FAzy3wxprsZbaX4{sWf8gbuOP2vCxk?=pviML6rG_c@*6Pz3O2 zwNXEIR1E(bb|4Z3cOUXkQp#RX|30|c-XeLd7O6|2xYf%2aMsy^*S(Rfb$(v0RvJGKq=qhib@GY4v7apIOSoIOz?5a%hO64hPd@G9&^ZnDmYcJSRIKYRs7rRyJE%Hz3&% z#NxaBv(8dfxrbUBsS09%p*|jsZpqW7Nlxe|InHw(j}Qp*&uRV>Z z!Rp}Xw@{R@hQOUv6c@fDf~j3ph7D14uPm9*#vsJ6549j!#QY1oA4b%#Q98@vca9)q zlj|R9ZHU8N{AJ4+*RTJyI?v4Uh0V%mcr#x8A*J^2YnA<{py3blC?nisxrHzcsqZq* zsm)2s#_r@@#|$w;H#@T!ya_0Dh>K$_5>|6`o=aiCmIqvM|KiBYK5nYsbZ2#WaD8-t z308wXnz+bBv_ud?J#nBLvDM3+G974{cr?ay@I;WOsp()q55ToATbas{baXD4*@!z} zP`AMlay4&`cse$2`sgkxcC_ZG4*f@8^Z6KxPLk4JN)e@E5J7QHP;FHMXIA``O(tCM zVyyNy!dQ&6CppTY18v3ok@5NSKjmI&=L_+2E(Bpz=kIj-P~b#Uy|L*pt(;@cei?!r zj&!--#79zR?-Wu9)0YeU$Yx@Z?BXl;MlkWd6B;1J(KW&`!Ie`5GJpS=v(+#qUXbVJ zSv-B9IXhCl8Px^D1EN8Cf4TTJ#tY;<+fPd5ugyK3X*$1L+0Lx`Umc7WVb^BG#r5Xbhqwm|?wTyvRfW0w-v9TD5d!SXH3Pp6acWm<`qfw=?aTqddw9Ta9!V}w^ev0;IY{BUi4BIn@l8^o+)_3 zG7SZyl!ijS4a40cViVz}qJUuzt;La(y;GsHs*F!qkn?+AjQh`Iu4N&(&ozyD)8FBh zJFuk0LEDK)bzfgvl(;`r#`+7Fv=a^16d?pEG+g#oVbw0mSBlkC5FYh&bNAu0$qmKC zM4P@>bPks@Ji(TV3+@`&WG(V}W?{vgo}9D;vf|TKVVFHDy}K z;njPHUy@+cz2vui&sJ-Yp@;^~QE<{X6gJFI@UexNCX)APp!qR~uOJAN7{(6Es*>MT z6yE89&zhbZamU|x`hKm*qxxWI{1LmbQ23Jz{4gb*P~g5${FVC#Q1G8msABnfi|EnV zOK7V9I>_EQvOs_C`OJb?@jMVrS7oBN)&N>PJySm)xZA+)%4-kzxjoOorYl1B0WsjA z^y^y7njHfaJ1I;(B9>i{={>dq|=%F`eA=~lqNv_CRsF`}kL|wmW!VU8puiDA%PJ zxd5M{Ph8_rJ&(wvIk$wey&fJ8tb|56byl|C2^)H(*0)L4KjDHO zZ937=HwLBHSzL5XaL7dLfBD-ZjtJ7?6wxdR+a5n%evvkse%}or3odDS>$?#_oyKpA z3e6fsr4Nof%CnrRUD;Fk!SRJj`w*9r?G1M-BUntNH10Q~jyNH*MI{Oi+7fTM;+_lr zJOkD72m6;E2MRU|j?EbvrhhfrK~dZ1ozfd~QmFm#fNDs9+3D4j)Vril&Uq)BLc; zN#Rtc?S2)IlY@7*{n8!#jKN>O2vz#NXdIhr@41Er4UNp^;b~WT)7F717F(mP*~9W= z2$e}||LY}e2z+<2_eI96Y-Ftk#IDU`@OuRMhkQ{sNl%o4@Cd5!~R1`&uLp z*P^1BNZ}m?j?Gk}9J@j4AOeLLI(I$^pWIU(ImWSFv>V@}@GAkuU=KWi%1p$&`pCgH z#Fq-Igm^guh(`ZBcXX%{N}Fu8>gxbXu&=QF(2_o}vZ0m59}KBi3ku09BbL=rRL&hn za0pg@AsTks0eHv)ET%Zj%asr)=ez=ZTYv3e$s%_Av4ek=)+I&Aj7s-q9T~6RI1u$v z62OdOiOSZlKt--)ii)G$q!?VkISHTM8%eJyXqnhcKkk|VxCrB!s(pH->eeNPTn%Lj zH(276m{Hyyf>Qqb6iyz$ki9r0ro7ClDEYM%oIgm>SazF1R*Sho{YsqeSaZd&C}bLY z;U)m>*o@skoDN(0dJwL%=gq&giYA?6eKrUP@eu?P1{`T35e-{&6fWeq-vuU+VuS0Bb* zRAt{qG+FX*F=>6ECV%aqzVK@NOH-j=m15PKF*!DnUvk|cZaoK}CpQa>3p)^!Z|V%M z=)EP-iHvYC>a7CHja5}VQa;hV*o?OWNe&K5g56%wVb5w_pLj&GlM|_A(JS;2g8g_+bE8DPi^y?QVg3<= zMDsb{Mq45BkkAvg(KOESs+z7l(bf1MZZfT~H*KDnGMN7SvL09Tt$K(>{AjV+x*7^B zgi3TE_*6Ys%=*OcwjUHa7)3Shl8Rp4sWboRx1o|yuKZHI%jMzks&ccW-(OlGHBebf zlr5?|1w;(C^TYlx1^foiIPK;sTb+`EXkPb2k~n<`oO-LO{3__6Q^~%NiKt%&#IsXM zJ^JGMr&2CEoE2o9W}ozDa>rO~SwL;{#p$v2$1WuybZva>u>x{Ux19ClTOm95 z5~i)H&yE|@FpR97!0Mjg4mH0Vo;55M+1N>Ko^xki`Pv++itv-ZfN;%^TCI!M!SjwN{PHh3zR>#OoW++1^Sx6&S{Ec`RmDh1MXh2P^#uKn18enIxZvCc4DX zn`z#n5Ow(@m+zy)Qv6l9LDAk345SgO7HnI4*R5`l!9R?(tcRZhQ6|SONP}=U1_TNH z-JAD9GYWyiP!uJ}kayAG3;P3O5Ff*&5{NQhe(bazs^z-W&~>TvragP>N=Z{j_uU%2 zdv>V|UipsO#P-8D#w5c$BLrL4j_@NwfoNUAy7T!-{TkEO_eO@6Fe3UJRqpYEEH@0D z1)QuhO}v5g%YKUqQWZhgoq(gj4@9yo{ee6ifHK*+37LuIc5nrMSPt6e^EW0nEC{F# zg;Rc>bZ>@FxvQY+ZHxU?e> z&z{Z@mox-hqC&fBsSzZGfgA^0+;<45h0W-;iyTfdZ4*;11QYoy7#L!?bz^z&jb72A z#AI^37gT5KlVBht;E3m&4S+n|J_Mf~GoG(rq-dBb1QS>ai;l)BS|t(fGCB8MXJhm1 zy;8b#&GElC1hM3jk*ivd(_AhKKVOpyK(c{nLuhcQAK$kMmd{hqk{Yh1Dwy3YR=Jdxs3^W zMvedVVu}w|xg}*Ne0#Z-xJr6Dg#*iGH&Q~M9h8c+B$bqHt4ApXytP3|c=0be7}d4m zzB%kwB-|;dpCIAFgERc)d&a7p#U7{AW`G9iGQ` zHudpa3ic|HL{l7Rk;%|~VD6vi>S3LRaL*($pZ!eE<5QYoPu)1Hpu?w0$tN#C@|@b!RBIkztm%Uo<59_^nE z%R4yUOJzXrA2C~gUh%vLpfmX;tVC)S>0+R4vw6HKm@_qln{$a(wgf*>Bt=xwS{*$E z^s~1+J*%pVE9KmIBxhUt--VJIlbm6gU>D$Ig|q8Fx6IV!225j2z9U+^)-S{uh({%I z^;oXpoJ?!^yi3a^-v8Hy@j7vovF%2@=4!@{2NJq&NKci zxi=sRmAc2zdGtkr5%HEU3L+i916P`S&3{7 z6=5&R4l6EwHSET3(!dp0#;XbQ5s;jZC*3)!hU+bpXt=&kM0Kms2k_;neZN4A@62R? ziOfNI4UJqvlq-18sDTowtuH<{#>q)iYIBR!Bqo4oXJh0G5tWL zd{34b?8!3|LAd;^6<)~+h`); zM#%%_P+dU7TA){hMSZp{p(x(R(x5)Ly{S7mieT~*a=wMxalS9(UK5Pj#Fy>y<2jSg%$@pl-tu#6L8*3yDf{j-S%+NGZH)0Wnr zX4badpsl22t}U6N!sv_Wufe?E*KuE#@7^W+K1JIOOd=oj7SUinGcA zg346oUBzlP`2$L))a&GBiXTP#OAOq{Ec-o7XEMAea8FW*y+Eh&{dWEYI;|R{j17x`%ctkdd8; z64LlfP@S6s3x8F3O^f@OEt{X2A;YqkchAL4z_n54C9az1(~7=!0K5dcCt zz~rgSqbw_=-)AHK0!ecr4Vok>=&OzRxWgbGryzy@K8)rguCtSqc53p%L+hgA!f|SN z4BlEDTxDE)!QwUR{T9|es#JQ$OV!I>MzjYqgSAvq232jNZ`@;JfLp{ta!w2BY|eGa zzGBDPeJtJRI8g=LL;D!@rHhmqL8>u5&LQ|rQ}EK>K{AM2ekpyaVDBA~yaQrMb31g$ z8TfF#KZm|um^eobP-=&~TSp@WGu0mb|9Hy6f)0?Gc_hEz$a{5_(|Zb-FeErGX0ziz zF5*Zp*9Xw_&>INuUbLqXz}iA*X)&cjdODXAQ1pBqK&@c9Yue<-i}pTZllJS+Z6NXq zd1Xcp0~ZD(ccC2dCYuFoY;@y=BxMBWuIsCoBDL$gIK4Fd;T|$XD+wY^I zuwA0}+U4~twToW^BZ=wd{t3}2I&-?P@6kxU*dmyT?qcOjl30}4HDYe{r6rG#?0A~! z{+Ru|@$b=h-Pqi;IPxRRvY02^fMJx|l~Q;c7HdUiP^2>?uBjh{P5AA*BD(*fdTK9! zX8qT5yWZ(L4}(r1C$%z@T25JlwdO_Vwi)VOwWoM&4T~ zI=G3~No!y##FpV%`tahKPffo=Rl)J@#2UMD4@L61T8-~asJnn1?F;n>oSJsY7p1c# z@m5T-Rl_FU7H)59#bJ&yAlh-h4LrDMN?OV66#WwRLP>R?S%0U6uI?DIupRc~PsY+P zJMgwD@5am*sPEAuWvjaRKEZu@Ef2cG%Ubv2S5kasUTF)jnl{FFTkyA2aOgl3>!1z; zT_Nvi8nZhGhQ6J%Vv4igpDbr{qj9GG!C7cBIACRjQ_q8v!ktz;8Aql5*C%VkrwR;S zzeB|9mND|^&OpKICugBf3)mMwh1X{NP83U?S;V#!W_Kt2(NQOc;5WaQ;ba2mN{6Eu zq2{&<`t~r5E>Sh9fMwG|s!+igOnTCEC>15eI9c(vacTMTF%*A&Dz2rK6Y9pD7#ROX zQE?QFOIdmj*MK*|&0jyB4_CJEJ%%mr$bHlUIE<$wZ7(9z{#K64#@q=gk^UQigENE5 zgVMS1{TVio#h3gdK8BP1V&PtDCJl{-WN;;DnUZZ8`*!b2Hj*(HCr*n};~91nRI^Gy zzBV;6@eK5N3YGf|M1i!VwF4idhtK1G9AO*qkt@?HaC_D}qTD<>G-ZFm(Rz@SB_|AZ zqEqQoI9BWu1Yjg3z1EhK+_~I;dr(Orfc+?^{HW7#qP7bfh09fOoR$PU40Prq?2Df6 zcXdWdMp|C}rYQ+zbw?4cG(}#^Dcnu^rukPtxn;yt?Id!XmM_~3h2{gnTMTP^?U!je zR{pZtUd3okWa0i%qdau7RJP#JyH`2avC$PgvnAd&q{{xdrb=N_Fh z1bM%`b~qr_=VT42-8gjLnUQ{tuP3wfcY?o3biIj@=P`N1zXf@dXbrqk84!Rw5IA)o zNBffVkgrOTz*-mJYtfr$Z}FB|6)>-suxr!a3(c3HxyfE9^kx@VfiUd7sO@)L`2p?b z%MUsRU@iXJB>)G_Z&tRcO&q45cI-xN(tjw7BhXV>q}F|`de?%Hq@8QMIh5!OZ2YO; zpYT!EUA(!bbe`;9U(3C#8W^Fap$)Ctg!tIxX1s|B-9(b4+E2|5J6M-uayy2^u?)r# zih>e_4%nlK;Z1(q(Xpxt{44gJ4Ov4jmx@jnISX`bU4BQI+E_&-?Ip)_(9$Rq`Ca1$ zkmRp5>Mg8U%ng2k&(5gmYLLBx4wvGV+)hz;PDxmRD&Xj2Ox9#&(NDH2=S#^iQr&{)zK3ayf z!gEe%R^XGJLZYl5=Ai0_!zvl|YRycR_C2Lk1t<2dZ$T8^b-Y$H*Uf|)BvyIQOrUMWYtuiS>X!A z{~8fg!kG^yg-s~sHHmc&;Zvqvgfzm2Oef#~{GYQZH00#JIyB`kyghzOE+w#yRaopn zgjVL2iQYLBmZ7efllXj!j)W1FG1}8Hyk5OApVgZcN}A^W!r&L4@TMi8FBh1AEB!?K zD?{*A3X}~hzVQj|!YRQC$~VYkB?T~L4;x9b%!mLol2~n9-QS#n(sn9p8?bZRQ{yxO zCBYGN4LAoA+={r0r+~5vi`YIU$iinU)e#E0iVt)JHJVZEH~wHIjw;GP859Jpu_|m? zH5DS{GZzHE%WvpRX5C=}?WI_8T-=O{Bl%{m8o)zz&pQ+wDHOKRT(|^pZ4SLw9U@J- za8##eQO?eh4{T->@pl*zhoa(Q=#)Q#A)Hl-5+w+tqEUPsuPiex1hDbir?=AoF4eA1e!HF+CQ5I%;iJf}N#$!U# zq9s^i|6%E73RS38Xs;gNmU%e3*-LbNLZSuTlkea1k>g8>&kclhj8B<4#0cy=X@f?z zom#~(`QwVGN^dCeS=9MLp_P?GjR?;&k7KsDW1?BwueO4-e{%W}_scCqGnB7rVoiRc zc(q^r?EmgEBbbGHk1cw{@$j3bkolR5*en4%r+X{-kv97>>Az=V2zI4Eb-)HBd+eNa z8Y_3~3q;<)mp=^=W}yIu;+mNm8|Ogetyf0|zK z)KU?x7iQpR()jzshSZ<$OnZ6RC@|0FH8<|Lt6LgOS`M*jyX(ZYd58{P_f&!Fidi^* zxM@yL|9U$R^ovtRGCaZvldiz;z7dN-)!ZSjJ*+?FvtD}9lkm)0(7`z;j^;Af@G9Ew zGnVYFVHh}=7FDeNWdefGz@Mt~#dnlcpW)`SC}Q1I{Do=VrVtyeOg-;o$g%2C2OV1d zt_j0On_+G`dv-*)SH5FhO3~mmFe+4-fMjB*BB9IL-hmjf!$IK}oxS=c{n#p*z}ptW zPR+50xg7mc&G(?^4`GpKvI4HTZD(Gludt@{E9^mrl~)1I zOyo(IP$oO+Hh$%8C20c(`=M8mI3?c%OJz{!;q5(y`%G@MKbhHH+K?QHnYumTmP&Vt zDf~dtWv!ZwBWoeIv8nTGQh$)A#P31)tC>h4frX%E=i^k+DYHFfP>Wkksj~o31PlHp zA6l@wr7(RXdo7bXs=MnTM-@KZU$yjK!>u8xsWNRv8Qb^In_CiD2SNk1W42r#j6q!= zOgh^mNvWn{;DfC9rr#P4v+&LH*9#IJ%Ofs(2;I%^49wid%F?zoMeEMOkVdWP6gdqp z&8<@=1*u9sc!UWSwl7JI|7Cr*y<-|@`vmWv8tB3{Eq5qN54zdYE=Ij7mfvjK-cg@Y zx(9q;8jxT#Wo6Np0dey<;jikz{^ANRy=>PBCe}zX8xCU&m-+6;uHe8IeVTA)2%39A zcKgcqL3^##$5q)dkR|B9rk(lBshvfPx072^1(4PEW@fqJk7AtWwo+JuDSxI2^A#1` z6QJI~r0l#^I`i&9SLI}62ej(Pq1@+HJZMpqmOI4U?Rmi4;;;Y3+)OM>fxsQ1+1KRh zQ3@o^<5lkphL+~0u3YTC^f595(Mw9143SF zEsdbAAKsH4e$0a0XVMu+DVyLcHhA9C*hzAUl*^x}|GF1jB@fle;%X9Z&+!St;`?9z z^yabmFu#tWttuUEV=DB#1AMkMtN{w}X$QWl66vqCOY)|?Dvb;|3n~dC6SW*$Q})f+608crbvV$Ddnsg z&8xIdc_wLl?pj7<6j=O^dPLLWNG|)+TU49cMDZjUU#_E_FiqP9UF=oB?Av&orsLA6 zUIxs-VsCBafv##;9PMl|oROP)rnr&CmgkqBxiJM9SnI}g)-^-b`nsJGllAaJk!L%{ z(lV*uOE##tEZMW*$IG@L8y%|UQUbB9D@}l2>}aLQ`1UEQv!O&g<&j(=fw7<=@TwRk zN`Oi@c7=x=4f_gb7^}hyPvbJyA`xQ$w%l&0_{?qgQ}+5M$TxhJXqaSV+;6)XjzS|;s>y(N&#!Y_+m;;Ob>VT>Dr9N%8HFQjUD1gDje29FJ~Y!9 zeD$0+#};c)SPOz6xbXhZ1o;15qp~jl`$#!N$Zh+sN>+0#Z2o%L`eVPyn+LQv`^9G3 z>6w>NENI7*1pbkH%hHuQ=N+&;nIDA<}$2T@2`$L;4M;-8mvGLWl0;jg;eyBr`W%VjgQm8#?CE zGTKy@HvNi~q9$>=G*}h`TVt;5180tqn@K{#P+_^&Fxh^YpSHFcEE7FH6ngcVUQvWb zT}4qV^TS3m`*-_BW5E#?t+)1NNqWZ9vembEpY&{4_z3zv+El~Rf;jl}x((r`@arAP z!cu$&{@efzP2F{XS&d{J(8!ItqJT{TuesqJLqHhRvJHBBlGF}$5#Y~V$Iv9Ig|Bz& zywa_hsH_|<+K=b*|MdLLfAfsJ=756DK0R*h?=CI!w%+uK;cTv^c;?cM?7JFr0x4#A z55j)Dn=n5!zoqHleIfbq-Il-lcMFs+l$db3WO6`@jrse=PpveGI{U>YClR%RDVI#^ zneK%4CcWY0PdB#6^!Y2XlCKN!^<&|~6XU;jBSCg&^(cy{SkfVEh$xcG?Zwpp!eQ1btXFcXSbH>v7{#+#=dL!3leZlXYym3lEEr)2`KyCM8 z9!7!zcb~g{>}(oS=sz($v6^B)X^F{7q>xyY6RW`ME?`}E5LD@JhC{KOZFRQ@8lF4} zLN{<-eVP-&YB!@{!R@p6c5-77m$6eS)yg3x%rDepYx7+=_R5~I<$pc$v8viz0Sgm` zhV5lHhvEX*PrsLY??=+#uzWnH=MdoDWqJ)i!Gylyc6*{Di#s#|OG_unjo%rfdHz|B znNut=O{4bROw4)Q8Ib&PP?Ylie#i9rZ=QEY-Jb^P0ekn~vHsWfk`fI^mni{H%>fV1 zBO|eXkK44dNrOKu24ZL>KcTQdJHkn0+NzRm+yxy3-XHx>#q16D23I$nm%^;09<+#n zTLgmmM$T|>(7(VmbjNLkOa|;^;%G%Q$~Myc#~G7&-&f4>YS*SZ-1#6svYV96J7n_N zS|m7LSF++I&zBKyrc~>_tgM2JL-H|oHKQKW_`baR4bl?!xIS8R-5)n)CB}TK zHcs;Gm5nQ>m(_ATdofF)1T&K?(f46Ze#B=%TphN36NM0q~?o`B8F9Z=g>&UWUcZS2>3`! zjWJyaf}@-@a_D;bWBaOOb!F<4kF%{pMBV8|w>y9C%;Ln|T!p^-=YApBUM|8SGlQLd zW(KX?9}#eOxqdh9+4+c*^Rn8c{rc+iyQ3gsUT9DbcoLxI;u+Y+ zw%phNlMe9z{Y;Onz_fVq1E;gs`#HiC&}+uV@<3x%RWfob7$2hI?El{XJ(L7@{w>OR zzVcarIPrA$J?)Rq5OQ9{Zdu(OU$s#x@_qk1#p5%)`tY-opj%xMn`%vs5Y-CStDDnL z{{-5&x_T6BzB4j%Hz7)gLNi-DPfxN$yI^LaMazKfv+ARJtKa_kvFRH7_o$yg-5%Y+ zOx$pM6LkLE9~LmJ|J0?WZSBp?I~K1h^(qW)9&~isV`QCIT3kogx3;%_S1ps>IPa0V ztvv3EcQB1iPfxeH?sJ+-1W2LxwC3-87Lnc%2C!?bZORxrDCwu9{>U)O=KZoxLgW`2rEslUW27DMhv&?G*UDg8cjh z-zAu&$-=jR347tJasCPn`sBg1l{7wmBcXvNTZ5`m(%47b)12+hfon_EI zW;i4GDbB>u&&HYs;4d&=aOL=jf+@zr``{Q6TjqZ{Bd|dQ)8Vq{7Be%{1Lp|1$aqL` zAjstnzq10l^p)0ES;>dRySta!{uJX+Dawl+zV%kVmX3v5)Me=`^r>J>=V4I3141SN z{5CvJ>Q5(G4%rfA{J+f^R2d#`R3V!>tdo&~X|ry8>?8g8@te%}aGhzpcDqKC`87_- zx1p1=oHVf|XHINGg^t9!GnSz}&cRfge9fG=QX-OrKX_=$iRhGmA~=t*(>w%2a4YkkiQ9xrq8 zMd?pI{ZJ=pf6Wqp-Uh0t{Q^F79G68679>RH7Mr!IED=0ggJPrlS#(^Qqj(%8faop1 zYT0>@ym!YRxfG1aeDhc4UvciaqjSH}eQ$GIJm0s!Q57A1nv)JDCEa_RYidv^`*-7= zY{~tkfw^VjzvIO|L#c@nNp?NJ*Vg?5=D9PL^^QZpsc%w#WETX10z?*!eAL0f0p-A4 z-`Zw2hQu@{em>V!%Zfnm9VgUlY#zq|0Q(E06|S!Wr_b14{|&vMWkU04dS)csugM~# z_@*#rz7YNOYIZFg)LY;Z#SQ24c(w&zZoGjGV7J2}nux!$eh;Rso^hj^s5{GgSFK)R zvHW`Zy=kzkY>61<41D#5=4CV|5^$Ed}t&k_S1HG<2%6C`K)_+9%ACOl19K<%`G;~_d{O?TyqeO5q?v%wu0E)k(yV zF%(C{ti`}kP|nXd5_SH_FeODje!j`wD$BZ?L{XQS=q|1ct{5hfzS>G~%lSEZgDdNE z8kTy+-XRYK$FCXUZ~3%+_v8iCYdq3ctiaM_AzUQsF;H}Yvhq*gFU1%}@UJEfIqZW# zi(1L3mOy&&#~3_W=~TXdx8XPDo-a5!lMTjFC0>r2AaJq^*8%bXp*?YPK3Ch}EX)$& zju+$O84zcFbTr<5e%86E$ALrmB zG-^RE^b23VF93vBu}3D-+aXD5qaT;B{eCcX%w(aTb<*vwv2CKOlTHO{eckt>fxked z@!If0M2`|klcImE#ltPd*Wy2qiR5_fs9{}=#xed7fP4_q3*q~pcZGIeasT3~zsMO`VLpl`SXQNu$&zTp$L*FlrM-o}9Cw98 zJ4+YIE^u(7iAgG>8}Xi@#SR3~0kpAv1l${YgFQV|X;rmHIdYW0Us=^htPU~SO&+@Y zh^hrlp5kS?-PiC^aO0lmfnTKMft&>;mvbm9>*t6+*{}^j10l;HdQf~pj&UpaHQV>qN){tWB@)Kwq<+e z9|~qS{T*nkTE?T@%847UI$GPa9x$(2UOHr5brkG-waxMeP$M>#4HEA4A;4Vm?LmR( zQZ~>>&JqeJRa~4l^IRU@Qg57G*i+N_bA9I-lkHY3Oi(mZXTb`6`FDR}3a;niXOd8; z*45SgV#PDlv1#zPuG(;*{(Fwi?RrwshMUZdvA#ov$jE2$IbGezfzn>R_pA1T891uN zvsIDVM{S>7*%>3*^!<{D7K&+B`u2gcnPa!4!0o~rH#d{XUu&+VEDO# zvu!#{`TrM)Aa~y`OLUskG)vXIJO*v*wcGhTo9}gH&6889n&_I8dQD4hG<1Ec(|4Sn zBLx-3ahL%if-_>1ci{UmCW=41_R+^9x-11ou@a3AgHc^qPF+75T?$N+FIS_>XB@&- z@L!&u@*ihT{bQxY#WmpVXd zaGVl}MAkULt`!OA&?R@Htc5nKP^lpCf8?Bhsq-B>YqL#I_mCcg4E?fh%m+|abuJ(D#~yo&SYcc@P)FzluIVgfFgT_S!xuynbsMyz~X3Q zTk(~?dIkR_`k#Qd_W4DKdFkb@WfjHn*=+X5+v3;Zuz2>{vthxXh4TOLc=-M~e`D}= z_T>HZ_kYcv?D3yjefs?A^!4HNaQF8Y5VntAJl@^in~Z36oxw|UKYT_s>WxO^UD@9L z#>1E=x4t~-CL2m!;kK)cAko@EC~7DZ0^C3c4@p-_I3STa*z{0q4qu)q;-Mo1WH^Ki zhqb@E7#VW>>O?YHmhAM}~{pcw7t_jq&U)ALE1d?%g}~8c$i} zZY^sU{Y82CfLfh^vv^@>1Oiz0cRN?P3c9-8!|WsiNOQO+5}C(Rfld_S9zo}uR1Y|; zbtpj#0^*FrU1B~lOa%?tHIx|6IQl_Aq;=}1T7!jANg-#74xd5QyW>wbTHsdV)m&|1xGS?xAomo6_3uhl(^+Fg*=FMxpdbHoMfytVZz zN1o?R6l#~Qm*=ZVGfL1f+;|!wwN2uG~Xp3b-4FD>jBtPzE-{y(A440x9EzqB^0N)^k9_ zK*^=VwsN1l^@{|x1032A0vc^r$4_16ux?cZ2oZD+G#S~Ga%6iWA}<#L3M};Euy)hPs^yiSd22i1T>H0F(Io@zmWgfPJ@F(|=}k>MCd@XA)<99%(^vay29 z6|5wxT`gMJB-tsasp33ktps|(>4;;a^tVdk}o#J z?*a&b&JO`|d$L48c{%~!5&?E$zs#rQ*%NTe3qwzSJ{f`DH4yN{&e!DJ-Px{&AmDnB zP7*3}>Rgd>@-V$B(gU<7Ahgkx0V}!U8<8q z2M!l;KJ47@>l~$ljPrtjuw^Lbb389p*R=JgMb?ky0j#Bki;nBQJ!PY`+>_c zY;#el`|@}zMT)N)0`MG=rtDBLlK>ap7Xn}yB$>{nc+Y$dcWfa8AYv0UPD=!+fSr?p zuUZ74M#@lqEiRR=P5>JEw#uAEbx&)ILPfwjrW;KIjH>b1ns{CWF^kWJHb4M&=R;Tl zQ+T=U*)~(a1{={|baRXU<=BCM`99*mmQ0T3FPVVDGA~#?5U_VZf3tTU;fW*L0zU3Z zFLggdn$q0lIxZ52Zy8F9nd%v6Zi@See_riqb%Q@_~H_q;b-AfZT zlRHe#vwC%oC|gu}%y?QDJn(<_La7k4zv=p|I!6^~5$b*$psccWeP?G6RP=OZ3Jr*b zVKur009pv9Dri8sklui99GSN9GNRP4>BPgW&i$Z)Cjnpt>N9{-o35GwT)b<5x`1au z=X%T+T^D};((P|2*vGU)Zr!9Z0Mx}tuB*!@wcK)Di+iWm0YDs4xdwpWqa!fu zZjCN!>RxsgYjwO5{V4jHjzxLJ8mDW>55V%?=$crRKmF89Og>Jr?6C$+Dh50O$OYAa zbG@wB#BCTf6IU>obNl-4{&rA<=5Ae46@YNm0w4nlQ=l6fKrWS_3W|hhjX4+q7~Nuc zZSz5|c?T%Mlb0m2#rq8KuZ%4XxFmVvyc#fhumi)OfaJ=}-M#$)91yRH0+)^Tjsc|t zKyhzxc$Z-^D=sTpB=qg##Ei z1#aHh4q~u`qQK?F+{#K0kf~?}ki}xOI0FK6Gp6OxfDr;)ypJa+zb|?0cOEuCS@^5_ z3E9PSX}}HYc5K5iuqXfe-<%8}B3ADLo&m5Fk46BQHnQk~WY$QAVDt>Q;A`>JkC~KC z&@ds@0CnLne>U~W^SG?n1T~XgK!!$v0H%KJ-Q4lB=QDuvL4eH1m=QjjE3ghQ2m^Sd z!3R3m>*AA-c>{fZ2Z)J_Pts#vJe13L`PS=_3xCO#y|4lwi_w8Rtv53<_AsgN07769 zFYd$8aD7LzI}u0_peR5Fz1324ba>09estF**mZJO>_kf;PYb z;4K^#%A59d9^ok?8K-Xe620x4gYPjG;lV(lw5jTJpLL(Fc z_ofpP?+0hV0*wvwvym?>_bC!~X*!oJBjM^6VVRv8X@G|XoZd#$0Fy}~BNqbqnE165 zR9c7(h(zN{pfH1J(Y_b}4oxU-VycH$yb?{nC<%HDQ^ph-&^Js?E$H08oT8?FJ~{@>WsAw#GDsq9cGN=P-rNczErbSm zNl+CzS_lmo1Zco0Aq|jGS$3MGD$A+?BM}1kCeXCd<@vNsf~rtjG;;O^j17n%b;FHrrH@9KTxi?@Yo6jx-q}StV#)`2*DXu|iwosTu z1I8h6ue8tveDiU(+;6f08KX1<0O_?-A;og$l$Or{z zeAeqAP1o$+z@ydsLg&{2SWZT#XJDlSFwK?$pu!;%TUiCwfN=<{vQHuL;O}YfX&&G9 zSkG|F!}gz3Z|c1-bgm=eh2%O+7Z#V&ES^l{DgcGmGLQk|5IFd>Q1H+O7l3e`7ElB* zYu;js-0~`FZq2N_qJ&FD*L4nv{FK&1tkn+35Y?LAUwutnL_1s>QG8$Lop04Nd7*Dk zHgq`}UuS}FalShn`t;NA^_kf3PYC?nU;6oT7#I_SPYdB7Hd;bmE?nCNXnXTqjw+n3 zPRYN&k^B@Z?T$m}5`ACmtf*VVI=6GlmMK@wVi)NmH0gSyb^PE~4QH@Xclb#bCw6$NZWcuJG@W70cUa^-~{1=2{qI~>%` zSk*j310YjL2?1t<92K#@vn@m5Kqnf${+i^CH{X2ojn_vyEkyh5(I0JZFAP_Q7Eb&! zU2b7VMepo+WC9oU-TPhWhm!%?+&7Y%whU|F78{nmRi{SO67{s;C-(_p!4w09ni|00d~j#I>D(Ltxc_H-GVqUt}_ww~$xMFevs1nHFl|)?RJ# zf+aw>{8v}@Ji_DS_B=B2|4Jlmp)^F38j-wGT{gEs4Dfy>yj5{%%5YxZiYU~uH30E5 zTTN3~-lCwVP3b8UHwUrpChr))8{%Hr;AoY&90_fS?=?puZXbrgw;*r> zPyoT*%-y?h-4on}!LctV(40BiRtKAV6Tfs0HZ=*IA_Nx!hdy%T{zkI#X*7WzOUlYB zE(ziyH8Mc-spv@ecJ8yt04o>+XhRTs?KXgZxjM8vPFm=xE=pM6l1^4V19;Ut;@pKL z4!d4+FcQX(uo{hN*X7=)Rowg3={A5`lTCqevsQ0)B4NDASdEqmHSbC-jf+!jWIkOJJloVkk(+yG1q^`1b(;|5cRmH=Qi&lFOH9Q4L=937Cl zRN~!21#zV0Y%hwRo#zz2}wI(|}mv%ZMEr z@HF@ct>jHW=GihFv1u5YW7l8a1?YnTQh?X)KY02sfd&kkZJ|AiKLKAtIn1J)3I+=U zq*7{inx&V9Vc>te-OmZbXaFu)LA$|PTD##h03&pp5?a(T^B(=RIo;mKOP>Ml&f|}E z4L`Jm0i2eJZ1*(aBxd0_5~&Suns=0K#+Hr@NEV_ST}!SZ7y|dj04ablz*FE)@6G<| zuR$`jX`#!;3@FU87yv7QN`cJ{fdLlwgrKhm$j(|D+iOkDhGPG#V)G5ZGcg=5rgGb!KV&ia(UJYGQ4FKIHVZ899dbpKrtG5Ah&{+~z zSsoyVN1`qZr4tOORDe)>L0MRgrOm@(pnk613_2Gi1@H`bfJg%d&)$Jd3k}+U;YZVT zK=c~-&(7Bgel!eKR-5#y$ybiACe?yQ)j)^dcR7``9tNax5ZfrnSPT{+&sLWqaf|^^ zKWu=R!XR!5B*hA#0=cd}5OI6=7C;{i_|N+t1K#&g3>coY(CG~*YyCH1jEn<{umK6i zDiDFV!4t6h)$ReIM3zmh!Xc|n94zMZnp}OKxOR1N0)hq&_`wf;@RJu_c;Wy4?_FWR zd+)vXfnZn+KnIj{RTKlXX^kR)Qs`I%cqL_y4LCCcm<~&6#?~NPUN68J%zrfl?wDaV zpMxWc#`Ih!V&oSAcGZ0t12^F3KkyXzzZb}W4?p@qSfCg%glQpZK$zth03rs<9cRE| zj5csc#FpVK7#om*P#z-*3zFcSU& zDe&K(0U!VBS1*607%((xp~+(m2(7VnE|Owlr5BV*c$>TB7vanp8?XjCSd3+%GF9G~ zH6ZuZ?g3@>9sm$BGnve09ByCT+lKz~y>CB{?1{U;dmq01E99dgGeD+=wvREOj0)g$ z0L6d`!+ZjZkpNtWGhl3hu~1H%P+%n}Q~=^Ew2THAhH=U`K(Z2tGvIrlkOIH|lNbK) z15bdLKOH^;FfFuud?XwyFjfN9fJ~IdW30ddNwTp5XJG(lLgO&U!VrswAk8=z1_(ku z43N2?K^Z^_Jn@5{{7*-K52+V4bW9u@2f&>K{@2@34SXu4y_otT9hxKx#b_W5#SGmW||DcABw7Bvp(ERuu!DKK^;Y zzzh%ypaDPlsk{S_0mF_oU_F&uPqOreY5-)?6%L~a&1I0|9XwpLp;OjD#ldrF7%Ogu zaJVOOk9i9LjEay3$Y;U>GXNEk2A}}v$$(X6tU@`-l6UIQ#_!(;&2;C30nZEv(^3kYiQElviYIOdkmfIv_MVBPnC*d|-44C)>L z-}=_Kp8eLhKK|(Amp}gEJ>>iwu$(dyk!Wh64+i8uf6C9l&kUsjx?Zb_S80Ih89=yl zKAgtsfY3T0=y)@*xsXLQpg+hsU@gWf$pOUyl9#{m^Ks~08!*QT)a-*dK$kZF$>+;M z8woog4X{)LXu3E%>ElN$X-xy{xEds92igrg&bP}VBup7upkg} zD1f5C(oh;;J1$5AaB#DwOl+Wi&e}lGjAijZGC;4>{DOWP@N~BUF&00i0b|M~R!j;K z0O1HMO=CI6vH&cdERq5AITAOFWe9*fA?yOF{OfSW0Y@u0Hd-ixVt|F3m;iFYFWxw8 z^Hp&q4XEn^t?vdbuvoM_HsF-xq6~?`OezL*jKGXg91CQ?A*sawvv>EpiDQi)$A8t| zwX^t`gm(xp!I+m2gR_xF``7NXMS5#0BP6?sWUgcTT!u|gL2<4i#d86X@MVC4r3d1W zOu)%93XphwKGG=SK>HOwZwz)~zy-0sasj@-v0ecDEFSr{V4m*8r;+~S8=eaA{k8X} zpo?sYtX;nJsxF_uUw)X-Oaiw^4zyf-6Z{*T3wlVhl z2%EKez|IV~V0na%`sZS;=s);8x33F0A@PHL2T<<@OO{Kiok8EFc8}VC?CSb*NQFcB z-h|RgKhy=Z@)B^?;jtqRT(Ds{4^I64bqc^yy?_H2;CV8Z9Mih-CK$~fLm7EG%sFqE zmg%_|d%Qj{ocUY{a{+{86J0`b73_q{yJ_58G z&&JpVdZz7-mj$5V*mF+~a{I2~`0jPsf5fn!7ho1t2pY z>7K=p=aYe7fbG$nQMe1ZK#3Gpw8?^)$48mmTgqU5#_eYpFz`mYB474Bir%UKOuX?3 z8PA36(PaUPR~Rk+czTFu!e`_PI3?AKV^YHh{WIX+l14C|2lJk8t?{0{6@ZDiFjA;D zo_h}FV=VMM&-6R+tYrbFHyU{pnBIKe2zvoXkVzIF_0t6;udmBs-q9uR+gAY^B+Jry zpl4YbKv%KU=mXFeLlTw+EI-o&An84XjCQe600_Yc{qwU=LDKABjtw#0rtqGtW9*Xx zD1oD(V~^t5cLgDn6!%d8Ebc8l0;sdqv7zW_#C}W3zr8qb$=GlkFca1F2pN=w z@~5AQ&`pO&c=2&UYX0?jsTc=hq_B$uw4YlIl^?iA|3!50)s%{7e7;+(iIuI^f~tgM z4aAk1QbS0BxdYSbTYYzuF#+2(c-z%);Ft)fIEm#+eY1f5pNw>M1?1(kHSQU_sUmmCc$S$bWqdad@$E0%4wP6}?2ZpXw*e;Jy zB25LQ#y$$r2JfwfY7WQEq_qzY0YtfgY6ob&y&KuB!}mKWJr~fyO8g)NG$>&AsYw-S zS%3w1VCgoMMq>k^L{jkWya2p=L&oA39@JO6$9D=?0XPva5iAjhua@l|^Q|VSm3}NB zm%@I@HmGZw?qJXuIF?I$wrjZVKy_Vn;^-M0p+wHHNhZZT-I9FZvGhGZeSYb@dXE)= zqug20EC6Vc^eTmToiD`W@k*whS$}u$l!dj0AVt#c7o4I z?8MpHucfFPbA-F;dK?ih;H28YQagb_jT)(51A;k2DpSX@ zE!T7n+dw!Sk$TYJF?NF=Ou3brffqyWwd*9JC3)U$V_mGcAl3!30pRu)8!D+puv7{A z=THT@?M!Yg+onBgTGVg=+s%OXYzN^ai==~f$K(RLp=q*nH=A^J2&qz9S^c<;=zQM~*4rE;c%G5+Lu6{#PLzd z;WhVYI&>OXDx0f?&)GnQuk$!EfEK|5N|i$4q~QNs{fS*2vjRTBnV4EzrZ~dKX#N`L z%5*lHy&AZ7@JO>3!$U+-GmQY5YT>DXTQK33dEoxdz2Ya}OovKz3&@`o%8&)2!~-2c z=l~~ORzUcvGw$CFUsg(^TR<(|65T#~Oi~;2uDWW=U1xV+DknI_0+YzzPrmv}!=C>kr_p&I$-O&E&S1WCZ{a#6(@} ztY*T|SPNngK|V9;1r!ZS?+ literal 0 HcmV?d00001