documentation/content/applications/finance/fiscal_localizations/peru.rst

====
Peru
====

.. |SUNAT| replace:: :abbr:`SUNAT (Superintendencia Nacional de Aduanas y de Administración
   Tributaria)`
.. |GRE| replace:: :abbr:`GRE (Guía de Remisión Electrónica)`
.. |RUS| replace:: :abbr:`RUS (Régimen Único Simplificado)`
.. |EDI| replace:: :abbr:`EDI (Electronic Data Interchange)`
.. |PLE| replace:: :abbr:`PLE (Programa de Libros Electrónico)`

Modules
=======

:ref:`Install <general/install>` the following modules to utilize all the current features of the
Peruvian localization.

.. list-table::
   :header-rows: 1

   * - Name
     - Technical name
     - Description
   * - :guilabel:`Peru - Accounting`
     - `l10n_pe`
     - Adds accounting features for the Peruvian localization, which represent the minimal
       configuration required for a company to operate in Peru and under the SUNAT regulations and
       guidelines. The main elements included in this module are the chart of accounts, taxes,
       document types.
   * - :guilabel:`Peru - E-invoicing`
     - `l10n_pe_edi`
     - Includes all technical and functional requirements to generate and receive electronic
       invoices online based on the SUNAT regulations.
   * - :guilabel:`Peru - Accounting Reports`
     - `l10n_pe_reports`
     - Includes the following financial reports:

       - 1st set of main financial reports:

         - Registro de Ventas e Ingresos (RVIE) - 14.4
         - Registro de Compras Electrónico (RCE) - 8.4
         - Registro de Compras Electrónico - Información de Operaciones con Sujetos no Domiciliados
           (RCE) - 8.5

       - 2nd set of financial reports:

         - PLE 5.1 General Journal
         - PLE 5.3 Chart of Accounts
         - PLE 6.1 General Ledger

       - 3rd set of financial reports:

         - PLE 1.1 Libro de Caja
         - PLE 1.2 Libro de Bancos

   * - :guilabel:`Peruvian - Electronic Delivery Note`
     - `l10n_pe_edi_stock`
     - Adds the delivery guide (Guía de Remisión), which is needed as proof that you are sending
       goods between A and B. It is only when a delivery order is validated that the delivery guide
       can be created.
   * - :guilabel:`Peru - Stock Reports`
     - `l10n_pe_reports_stock`
     - Enables the :ref:`PLE reports <peru/reports-ple>` for permanent inventory record in physical
       units and permanent valued inventory records.
   * - :guilabel:`Peruvian eCommerce`
     - `l10n_pe_website_sale`
     - Enables the identification type in eCommerce checkout forms and the ability to generate
       electronic invoices.
   * - :guilabel:`Peruvian - Point of Sale with PE Doc`
     - `l10n_pe_pos`
     - Enables contact fiscal information to be editable from a PoS Session to generate electronic
       invoices and refunds.

.. note::
   - Odoo automatically installs the appropriate package for the company according to the country
     selected at the creation of the database.
   - The *Peruvian - Electronic Delivery Guide* module depends on the *Inventory* application to be
     installed.

.. seealso::
   - `App Tour - Localización de Peru <https://youtu.be/Ic3mGovkf8Y>`_
   - `Smart Tutorial - Localización de Peru (videos for workflows and configurations)
     <https://www.odoo.com/slides/smart-tutorial-localizacion-de-peru-133>`_
   - :doc:`Documentation on e-invoicing's legality and compliance in Peru
     <../accounting/customer_invoices/electronic_invoicing/peru>`

Configuration
=============

Install the Peruvian localization modules
-----------------------------------------

Go to *Apps* and search for Peru, then click Install in the module Peru EDI. This module has a
dependency with *Peru - Accounting*. In case this last one is not installed, Odoo installs it
automatically within EDI.

.. image:: peru/peru-modules.png
   :alt: The "Module" filter is set on "Peru"

.. note::
   When you install a database from scratch selecting Peru as country, Odoo automatically
   installs the base module: Peru - Accounting.

Configure your company
~~~~~~~~~~~~~~~~~~~~~~

In addition to the basic information in the Company, we need to set Peru as the Country, this is
essential for the Electronic Invoice to work properly. The field **Address Type Code** represents
the establishment code assigned by the SUNAT when companies register their RUC (Unique Contributor
Registration):

.. image:: peru/peru-company.png
   :alt: Company data for Peru including RUC and Address type code.

.. tip::
   In case the Address type code is unknown,  you can set it as the default value: 0000. Be aware
   that if an incorrect value is entered, the Electronic invoice validation might have errors.

.. note::
   The NIF should be set following the RUC format.

Chart of Account
~~~~~~~~~~~~~~~~

The chart of accounts is installed by default as part of the set of data included in the
localization module, the accounts are mapped automatically in:

- Taxes
- Default Account Payable.
- Default Account Receivable

The chart of accounts for Peru is based on the most updated version of the :abbr:`PCGE (Plan
Contable General Empresarial)`, which is grouped in several categories and is compatible with NIIF
accounting.

.. _peru-accounting-settings:

Accounting Settings
-------------------

Once the modules are installed and the basic information of your company is set, you need to
configure the elements required for Electronic Invoice. For this, go to :menuselection:`Accounting
--> Settings --> Peruvian Localization`.

Basic Concepts
~~~~~~~~~~~~~~

Here are some terms that are essential on the Peruvian localization:

- **EDI**: Electronic Data Interchange, which in this refers to the Electronic Invoice.
- **SUNAT**: is the organization that enforces customs and taxation in Peru.
- **OSE**: Electronic Service Operator, `OSE SUNAT's definition
  <https://cpe.sunat.gob.pe/aliados/ose#:~:text=El%20Operador%20de%20Servicios%20Electr%C3%B3nicos%20(OSE)%20es%20qui%C3%A9n%20se%20encarga,otro%20documento%20que%20se%20emita>`_.
- **CDR**: Receipt certificate (Constancia de Recepción).
- **SOL Credentials**: Sunat Operaciones en Línea. User and password are provided by the SUNAT and
  grant access to Online Operations systems.

Signature Provider
~~~~~~~~~~~~~~~~~~

As part of  the requirements for Electronic Invoice in Peru, your company needs to select a
Signature Provider that will take care of the document signing process and manage the SUNAT
validation response. Odoo offers three options:

#. IAP (Odoo In-App Purchase)
#. Digiflow
#. SUNAT

Please refer to the sections below to check the details and considerations for each option.

IAP (Odoo In-App Purchase)
**************************

This is the default and the suggested option, considering the digital ceritificate is included as
part of the service.

.. image:: peru/peru-IAP.png
   :alt: IAP option as signature providers.

What is the IAP?
^^^^^^^^^^^^^^^^

This is a signature service offered directly by Odoo, the service takes care of the next process:

#. Provides the Electronic invoice Certificate, so you do not need to acquire one by yourself.
#. Send the document to the OSE, in this case, Digiflow.
#. Receive the OSE validation and CDR.

How does it work?
^^^^^^^^^^^^^^^^^

The service requires Credits in order to process your electronic documents. Odoo provides 1000
credits for free in new databases. After these credits are consumed, you need to buy a Credit
Package.

+---------+-----+
| Credits | EUR |
+=========+=====+
| 1000    | 22  |
+---------+-----+
| 5000    | 110 |
+---------+-----+
| 10,000  | 220 |
+---------+-----+
| 20,000  | 440 |
+---------+-----+

The credits are consumed per each document that is sent to the OSE.

.. important::
   If you have a validation error and the document needs to be sent one more time, one additional
   credit will be charged. Therefore, it is paramount that you verify all information is correct
   before sending your document to the OSE.

What do you need to do?
^^^^^^^^^^^^^^^^^^^^^^^

- In Odoo, once your enterprise contract is activated and you start working in Production, you
  need to buy credits once the first 1000 are consumed.
- As Digiflow is the OSE used in the IAP, you need to affiliate it as the official OSE for your
  company on the SUNAT website. This is a simple process. For more information, please check
  `OSE Affiliation guide
  <https://drive.google.com/file/d/1BkrMTZIiJyi5XI0lGMi3rbMzHddOL1pa/view?usp=sharing>`_.
- Register Digiflow as the authorized PSE, please check
  `PSE Affiliation guide
  <https://drive.google.com/file/d/1QZoqWvtQERpS0pqp6LcKmw7EBlm9EroU/view?usp=sharing>`_.

Digiflow
********

This option can be used as an alternative, instead of using the IAP services you can send your
document validation directly to Digiflow. In this case you need to consider:

- Buy your own digital Certificate: For more detail regarding the official vendor list, and the
  process to acquire it, please refer to `SUNAT Digital Ceritifcates
  <https://cpe.sunat.gob.pe/informacion_general/certificados_digitales/>`_.
- Sign a service agreement directly with `Digiflow <https://www.digiflow.pe/>`_.
- Provide your SOL credentials.

.. image:: peru/peru-Digiflow.png
   :alt: Digiflow.

SUNAT
*****

In case your company wants to sign directly with the SUNAT, it is possible to select this option
in your configuration. In this case you need to consider:
- Get the SUNAT Certification process accepted.

- Buy your own digital Certificate: For more detail regarding the official vendor list, and the
  process to acquire it, please refer to `SUNAT Digital Ceritifcates
  <https://cpe.sunat.gob.pe/informacion_general/certificados_digitales/>`_.

- Provide you SOL credentials.

.. important::
   When using direct connection with the SUNAT, the SOL User must be set with the Company RUT + User
   Id. Example: ``20121888549JOHNSMITH``

Testing environment
~~~~~~~~~~~~~~~~~~~

Odoo provides a testing environment that can be activated before your company goes into production.

When using the testing environment and the IAP signature, you don’t need to buy testing credits
for your transactions as all of them are validated by default.

.. tip::
   By default the databases are set to work on production, make sure to enable the testing mode
   if needed.

Certificate
~~~~~~~~~~~

In case you don’t use Odoo IAP, in order to generate the electronic invoice signature, a digital
certificate with the extension ``.pfx`` is required. Proceed to this section and load your file and
password.

.. image:: peru/peru-Certificate.png
   :alt: EDI Certificate wizard.

Multicurrency
~~~~~~~~~~~~~

The official currency exchange rate in Peru is provided by the SUNAT. Odoo can connect directly to
its services and get the currency rate either automatically or manually.

.. image:: peru/l10n-pe-banksync-sunat.png
   :alt: SUNAT displayed in Multicurrency Service option.

Please refer to the next section in our documentation for more information about
:doc:`multicurrencies <../accounting/get_started/multi_currency>`.

.. _peru-master_data:

Configure Master data
---------------------

Taxes
~~~~~

As part of the localization module the taxes are created automatically with their related
financial account and electronic invoice configuration.

.. image:: peru/peru-taxes.png
   :alt: List of default taxes.

EDI Configuration
*****************

As part of the taxes configuration, there are three new fields required for electronic invoice,
the taxes created by default have this data included, but in case you create new taxes make
sure you fill in the fields:

.. image:: peru/peru-taxes-edi.png
   :alt: Taxes EDI data for Peru.

Fiscal Positions
~~~~~~~~~~~~~~~~

There are two main fiscal positions included by default when you install the Peruvian localization.

**Extranjero - Exportación**: Set this fiscal position on customers for Exportation transactions.

**Local Peru**: Set this fiscal position on local customers.

Document Types
~~~~~~~~~~~~~~

In some Latin American countries, including Peru, some accounting transactions like invoices and
vendor bills are classified by document types, defined by the government fiscal authorities, in
this case by the SUNAT.

Each document type can have a unique sequence per journal where it is assigned. As part of the
localization, the Document Type includes the country on which the document is applicable;the data
is created automatically when the localization module is installed.

The information required for the document types is included by default so the user does not need
to fill anything on this view:

.. image:: peru/peru-document-type.png
   :alt: Document Type list.

.. warning::
   Currently the documents supported on customer invoices are: Invoice, Boleta, Debit Note and
   Credit Note.

Journals
~~~~~~~~

When creating Sales Journals, the following information must be filled, in addition to the standard
fields on the Journals:

Use Documents
*************

This field is used to define if the journal uses Document Types. It is only applicable to
Purchase and Sales journals, which are the ones that can be related to the different set of
document types available in Peru. By default, all the sales journals created use documents.

Electronic Data Interchange
***************************

This section indicates which EDI workflow is used in the invoice, for Peru we must select
“Peru UBL 2.1”.

.. image:: peru/peru-journal-edi.png
   :alt: Journal EDI field.

.. warning::
   By default, the value Factur-X (FR) is always displayed, make sure you can uncheck it manually.

Partner
~~~~~~~

Identification Type and VAT
***************************

As part of the Peruvian localization, the identification types defined by the SUNAT are now
available on the Partner form, this information is essential for most transactions either on
the sender company and in the customer, make sure you fill in this information in your records.

.. image:: peru/peru-id-type.png
   :alt: Partner identification type.

Product
~~~~~~~

Additional to the basic information in your products, for the Peruvian localization, the UNSPC
Code on the product is a required value to be configured.

.. image:: peru/peru-unspc-code.png
   :alt: UNSPC Code on products.

Usage and testing
=================

Customer invoice
----------------

EDI Elements
~~~~~~~~~~~~

Once you have configured your master data, the invoices can be created from your sales order or
manually. Additional to the basic invoice information described on :doc:`our page about the
invoicing process <../accounting/customer_invoices/overview>`, there are a couple of
fields required as part of the Peru EDI:

- **Document type**: The default value is “Factura Electronica” but  you can manually change the
  document type if needed and select Boleta for example.

  .. image:: peru/peru-invoice-document-type.png
     :alt: Invoice document type field on invoices.

- **Operation type**: This value is required for Electronic Invoice and indicates the transaction
  type, the default value is “Internal Sale” but another value can be selected manually when needed,
  for example Export of Goods.

  .. image:: peru/peru-operation-type.png
     :alt: Invoice operation type field on invoices.

- **EDI Affectation Reason**: In the invoice lines, additional to the Tax there is a field “EDI
  Affectation Reason” that determines the tax scope based on the SUNAT list that is displayed.
  All the taxes loaded by default are associated with a default EDI affection reason, if needed
  you can manually select another one when creating the invoice.

  .. image:: peru/peru-tax-affectation-reason.png
     :alt: Tax affectation reason in invoice line.

Invoice validation
~~~~~~~~~~~~~~~~~~

Once you check all the information in your invoice is correct, you can proceed to validate it. This
action registers the account move and triggers the Electronic invoice workflow to send it to the
OSE and the SUNAT. The following message is displayed at the top of the invoice:

.. image:: peru/peru-posted-invoice.png
   :alt: Sending of EDI Invoice in blue.

Asynchronous means that the document is not sent automatically after the invoice has been posted.

.. _peru-electronic-invoice-status:

Electronic Invoice Status
*************************

**To be Sent**: Indicates the document is ready to be sent to the OSE, this can be
done either automatically by Odoo with a *cron* that runs every hour, or the user can send it
immediately by clicking on the button “Sent now”.

.. image:: peru/peru-sent-manual.png
   :alt: Send EDI manually.

**Sent**: Indicates the document was sent to the OSE and was successfully validated. As part of
the validation a ZIP file is downloaded and a message is logged in the chatter indicating the
correct Government validation.

.. image:: peru/peru-invoice-sent.png
   :alt: Message on chatter when the invoice is valid.

In case there is a validation error the Electronic Invoice status remains in “To be sent” so the
corrections can be made and the invoice can be sent again.

.. warning::
   One credit is consumed each time that you send a document for validation, in this sense if an
   error is detected on an invoice and you send it one more time, two credits are consumed in
   total.

Common Errors
~~~~~~~~~~~~~

There are multiple reasons behind a rejection from the OSE or the SUNAT, when this happens Odoo
sends a message at the top of the invoice indicating the error details and in the most common
cases a hint to fix the issue.

If a validation error is received, you have two options:

- In case the error is related to master data on the partner, customer or taxes, you can simply
  apply the change on the record (example customer identification type) and once it is done click
  on the Retry button.
- If the error is related to some data recorded on the invoice directly (Operation type, missing
  data on the invoice lines), the correct solution is to reset the invoice to Draft, apply the
  changes, and then send the invoice again to the SUNAT for another validation.

  .. image:: peru/peru-errors.png
     :alt: List of common errors on invoices.

For more detail please refert to `Common errors in SUNAT
<https://www.nubefact.com/codigos-error-sunat/>`_.

Invoice PDF Report
~~~~~~~~~~~~~~~~~~

After the invoice is accepted and validated by the SUNAT, the invoice PDF report can be printed.
The report includes a QR code, indicating the invoice is a valid fiscal document.

.. image:: peru/peru-PDF.png
   :alt: Invoice PDF report.

IAP Credits
~~~~~~~~~~~

Odoo’s Electronic IAP offers 1000 credits for free, after these credits are consumed in your
production database, your company must buy new credits in order to process your transactions.

Once you run out of credits a red label is displayed at the top of the invoice indicating that
additional credits are required, you can easily buy them by accessing the link provided in
the message.

.. image:: peru/peru-credits-IAP.png
   :alt: Buying credits in the IAP.

In the IAP service includes packages with different pricing based on the number of credits.
The price list in the IAP is always displayed in EUR.

Special Use cases
~~~~~~~~~~~~~~~~~

Cancellation process
********************

Some scenarios require an invoice cancellation, for example, when an invoice was created by mistake.
If the invoice was already sent and validated by the SUNAT, the correct way to proceed is by
clicking on the button Request Cancellation:

.. image:: peru/peru-cancellation.png
   :alt: Request invoice cancellation button.

In order to cancel an invoice, please provide a cancellation Reason.

Electronic Invoice Status
^^^^^^^^^^^^^^^^^^^^^^^^^

**To Cancel**:  Indicates the cancellation request is ready to be sent to the OSE, this can be done
either automatically by Odoo with a *cron* that runs every hour, or the user can send it
immediately by clicking on the button “Send now”. Once it is sent, a cancellation ticket is
created, as a result the next message and CDR File are logged in the chatter:

.. image:: peru/peru-cancellation-cdr.png
   :alt: Cancellation CDR sent by the SUNAT.

**Cancelled**: Indicates the cancellation request was sent to the OSE and was successfully
validated. As part of the validation a ZIP file is downloaded and a message is logged in the
chatter indicating the correct Government validation.

.. image:: peru/peru-cancelled.png
   :alt: Invoice after cancellation.

.. warning::
   One credit is consumed on each cancellation request.

Export invoices
***************

When creating exportation invoices, take into account the next considerations:

- The Identification type on your customer must be Foreign ID.
- Operation type in your invoice must be an Exportation one.
- The taxes included in the invoice lines should be EXP taxes.

.. image:: peru/peru-exp-invoice.png
   :alt: Exportation invoices main data.

Advance Payments
****************

#. Create the advance payment Invoice and apply its related payment.
#. Create the final invoice without considering the advance payment.
#. Create a credit note for the Final invoice with the advance payment amount.
#. Reconcile the Credit note with the final invoice.
#. The remaining balance on the final invoice should be paid with a regular payment transaction.

Detraction Invoices
*******************

When creating invoices that is subject to Detractions, take into account the next considerations:

#. All the products included in the invoice must have these fields configured:

   .. image:: peru/peru-detraction.png
      :alt: Detraction fields on products.

#. Operation type in your invoice must be ``1001``

   .. image:: peru/peru-detraction-invoice.png
      :alt: Detraction code on invoices.

Credit Notes
------------

When a correction or refund is needed over a validated invoice, a credit note must be generated,
for this just click on the button “Add Credit Note”, a part of the Peruvian localization you need
to prove a Credit Reason selecting one of the options in the list.

.. image:: peru/peru-credit-note.png
   :alt: Add Credit Note from invoice.

.. tip::
   When creating your first credit Note, select the Credit Method: Partial Refund, this allows you
   to define the credit note sequence.

By default the Credit Note is set in the document type:

.. image:: peru/peru-credit-note-document.png
   :alt: Credit Note document type.

To finish the workflow please follow the instructions on :doc:`our page about Credit Notes
<../accounting/customer_invoices/credit_notes>`.

.. note::
   The EDI workflow for the Credit notes works in the same way as the invoices.

Debit Notes
-----------

As part of the Peruvian localization, besides creating credit notes from an existing document
you can also create debit Notes. For this just use the button “Add Debit Note”.

By default the Debit Note is set in the document type.

.. _peru-edg:

Electronic delivery guide 2.0
-----------------------------

The *Guía de Remisión Electrónica* (GRE) is an electronic document generated by the shipper to
support the transportation or transfer of goods from one place to another, such as a warehouse or
establishment. In Odoo, there are several configuration steps needed before you can successfully use
this feature.

The use of the *guía de remisión electrónica* electronic document is mandatory and required by
|SUNAT| for taxpayers who need to transfer their products, except those under the *Single Simplified
Regime* (régimen único simplificado or RUS).

Delivery guide types
~~~~~~~~~~~~~~~~~~~~

Sender
******

The *Sender* delivery guide type is issued when a sale is made, a service is rendered (including
processing), goods are assigned for use, or goods are transferred between premises of the same
company and others.

This delivery guide is issued by the owner of the goods (i.e., the sender) at the beginning of the
shipment. The sender delivery guide is supported in Odoo.

.. seealso::
   `SUNAT guía de remisión <https://www.gob.pe/7899-guia-de-remision>`_

Carrier
*******

The *Carrier* delivery guide type justifies the transportation service the driver (or carrier)
performs.

This delivery guide is issued by the carrier and must be issued to each shipper when the shipment
goes through public transport.

.. important::
   The carrier delivery guide is **not** supported in Odoo.

.. seealso::
   `SUNAT guía de remisión transportista
   <https://tefacturo.pe/blog/sunat/guia-de-remision-electronica/guia-de-remision-transportista/>`_

Transportation types
~~~~~~~~~~~~~~~~~~~~

Private
*******

The *Private* transportation type option is used when the owner transfers goods using their own
vehicles. In this case, a sender's delivery guide must be issued.

Public
******

The *Public* transportation type option is used when an external carrier moves the goods. In
this case, two delivery guides must be issued: the sender's delivery guide and the carrier's
delivery guide.

Direct submission to SUNAT
~~~~~~~~~~~~~~~~~~~~~~~~~~

The creation of the |GRE| delivery guide in Odoo **must** be sent directly to the |SUNAT|,
regardless of the electronic document provider: IAP, Digiflow, or |SUNAT|.

Required information
~~~~~~~~~~~~~~~~~~~~

Version 2.0 of the electronic delivery guide requires additional information on the general
configuration, vehicles, contacts, and products. In the general configuration, it is necessary to
add new credentials that you can retrieve from the |SUNAT| portal.

Cancellations
~~~~~~~~~~~~~

**Both** the sender and the carrier can cancel the electronic waybill as long as the following
conditions are met:

- The shipment has not been initiated.
- If the shipment has been initiated, the receiver **must** be changed before reaching the final
  destination.

.. important::
   The |SUNAT| no longer uses the term "Anula", but now uses the term "Dar de baja" for
   cancellations.

Testing
~~~~~~~

The |SUNAT| does not support a test environment. This means that any delivery guides that were
generated by mistake **will** be sent to the |SUNAT|.

If, by mistake, the waybill was created in this environment, it is necessary to delete it from the
|SUNAT| portal.

Configuration
~~~~~~~~~~~~~

.. important::
   - Electronic sender's |GRE| is currently the only supported type of waybill in Odoo.
   - The delivery guide is dependent on the Odoo *Inventory* app, the :guilabel:`l10n_pe_edi` and
     :guilabel:`l10n_pe` modules.
   - A second user **must** be added for the creation of electronic documents.

After following the steps to configure the :ref:`electronic invoicing <peru-accounting-settings>`
and the :ref:`master data <peru-master_data>`, :ref:`install <general/install>` the
:guilabel:`Peruvian - Electronic Delivery Note 2.0` module (`l10n_pe_edi_stock_20`).

Next, you need to retrieve the *client ID* and *client secret* from |SUNAT|. To do so, follow the
`manual de servicios web plataforma nueva GRE
<https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf>`_.

.. note::
   In the |SUNAT| portal, it is important to have the correct access rights enabled, as they may
   differ from the user set for electronic invoicing.

These credentials should be used to configure the delivery guide general settings from
:menuselection:`Inventory --> Configuration --> Settings`, and scroll down to the :guilabel:`Peru
Delivery Guide` section.

Configure the following :guilabel:`Sunat Delivery Guide API` fields:

- :guilabel:`Guide Client ID`: the unique API *client ID* generated in the |SUNAT| portal
- :guilabel:`Guide Client Secret`: the unique API *client secret* generated in the |SUNAT| portal
- :guilabel:`Guide SOL User`: the RUC Number + SOL username
- :guilabel:`Guide SOL Password`: the SOL user password

.. image:: peru/gre-fields-example.png
   :alt: Example for the SUNAT Delivery Guide API section configuration.

.. note::
   It is required to follow the format `RUC + UsuarioSol` (e.g., `20557912879SOLUSER`) for the
   :guilabel:`Guide SOL User` field, depending on the user selected when generating the |GRE| API
   credentials in the |SUNAT| portal.

Operator
********

The *operator* is the vehicle's driver in cases where the delivery guide is through *private*
transport.

To create a new operator, navigate to :menuselection:`Contacts --> Create` and fill out the contact
information.

First, select :guilabel:`Individual` as the :guilabel:`Company Type`. Then, add the
:guilabel:`Operator License` in the :guilabel:`Accounting` tab of the contact form.

For the customer address, make sure the following fields are complete:

- :guilabel:`District`
- :guilabel:`Tax ID` (:guilabel:`DNI`/:guilabel:`RUC`)
- :guilabel:`Tax ID Number`

.. image:: peru/operator-configuration.png
   :alt: Individual type operator configurations in the Contact form.

Carrier
*******

The *carrier* is used when the delivery guide is through *public* transport.

To create a new carrier, navigate to :menuselection:`Contacts --> Create` and fill out the contact
information.

First, select :guilabel:`Company` as the :guilabel:`Company Type`. Then, add the :guilabel:`MTC
Registration Number`, :guilabel:`Authorization Issuing Entity`, and the :guilabel:`Authorization
Number`.

For the company address, make sure the following fields are complete:

- :guilabel:`District`
- :guilabel:`Tax ID` (:guilabel:`DNI`/:guilabel:`RUC`)
- :guilabel:`Tax ID Number`

.. image:: peru/company-operator-configuration.png
   :alt: Company type operator configurations in the Contact form.

Vehicles
********

To configure the available vehicles, navigate to :menuselection:`Inventory --> Configuration -->
Vehicles` and fill in the vehicle form with the information needed for the vehicle:

- :guilabel:`Vehicle Name`
- :guilabel:`License Plate`
- :guilabel:`Is M1 or L?`
- :guilabel:`Special Authorization Issuing Entity`
- :guilabel:`Authorization Number`
- :guilabel:`Default Operator`
- :guilabel:`Company`

.. important::
   It is important to check the :guilabel:`Is M1 or L?` checkbox if the vehicle has fewer than four
   wheels or fewer than eight seats.

.. image:: peru/vehicle-not-m1-or-l-pe.png
   :alt: Vehicle not selected as an M1 or L type with extra fields shown.

Products
********

To configure the available products, navigate to :menuselection:`Inventory --> Products` and open
the product to be configured.

Make sure that the applicable information in the product form is fully configured. The
:guilabel:`Partida Arancelaria` (Tariff Item) field needs to be completed.

Generating a GRE
~~~~~~~~~~~~~~~~

Once the delivery from inventory is created during the sales workflow, make sure you complete the
|GRE| fields on the top-right section of the transfer form for the fields:

- :guilabel:`Transport Type`
- :guilabel:`Reason for Transfer`
- :guilabel:`Departure start date`

It is also required to complete the :guilabel:`Vehicle` and :guilabel:`Operator` fields under the
:guilabel:`Guia de Remision PE` tab.

The delivery transfer has to be marked as *Done* for the :guilabel:`Generar Guia de Remision` button
to appear on the left menu of the transfer form.

.. image:: peru/generate-gre-transferview.png
   :alt: Generar Guia de Remision button on a transfer form in the Done stage.

Once the transfer form is correctly validated by |SUNAT|, the generated XML file becomes available
in the chatter. You can now print the delivery slip that shows the transfer details and the QR
code validated by |SUNAT|.

.. image:: peru/gre-delivery-slip.png
   :alt: Transfer details and QR code on generated delivery slip.

Common errors
~~~~~~~~~~~~~

- `Diferente prefijo para productos (T001 en algunos, T002 en otros)`

  At the moment, Odoo does not support the automation of prefixes for products. This can be done
  manually for each product output. This can also be done for non-storable products. However, keep
  in mind that there will be no traceability.
- `2325 - GrossWeightMeasure - El dato no cumple con el formato establecido "Hace falta el campo"
  "Peso"" en el producto`

  This error occurs when the weight on the product is set as `0.00`. To fix this, you need to cancel
  the waybill and recreate it. Make sure that you fix the weight on the product before creating the
  new waybill, or it will result in the same error.
- `JSONDecodeError: Expecting value: line 1 column 1 (char 0) when creating a Delivery Guide`

  This error is typically generated due to SOL user issues. Verify the user's connection with the
  |SUNAT|; the SOL user must be established with the company RUT + user ID. For example
  `2012188549JOHNSMITH`.
- `El número de documento relacionado al traslado de mercancía no cumple con el formato establecido:
  error: documento relacionado`

  The *Related Document Type* and *Related Document Number* fields only apply to invoices and
  receipts.
- `400 Client error: Bad Request for URL`

  This error is not solvable from Odoo; it is advised you reach out to the |SUNAT| and verify the
  user. It may be necessary to create a new user.

- `Invalid content was found starting with element 'cac:BuyerCustomerParty'`

  This error occurs when the transfer reason is set as *other*. Please select another option.
  Following to the official documentation of the |SUNAT|'s waybill guide, the transfer reasons *03
  (sale with shipment to third party)* or *12 (others)* does not work in Odoo, since you should not
  have an empty or blank customer.
- `Duda cliente: consumo de créditos IAP al usar GRE 2.0`

  For live clients using IAP, no credit is consumed (in theory) because it does not go through the
  OSE, i.e., these documents are directly sent to the |SUNAT|.
- `Errores con formato credenciales GRE 2.0 (traceback error)`

  Odoo currently throws an error with a traceback instead of a message that the credentials are not
  correctly configured in the database. If this occurs on your database, please verify your
  credentials.

eCommerce electronic invoicing
------------------------------

First, :ref:`install <general/install>` the **Peruvian eCommerce** (`l10n_pe_website_sale`) module.

The **Peruvian eCommerce** module enables the features and configurations to:

- allow clients to create online accounts for **eCommerce** purposes;
- support required fiscal fields in the **eCommerce** application;
- receive payments for sales orders online;
- generate electronic documents from the **eCommerce** application.

.. note::
   The **Peruvian eCommerce** module is dependent on the previous installation of the
   **Invoicing** or **Accounting** app, as well as the **Website** app.

.. _peru-ecommerce-configuration:

Configuration
~~~~~~~~~~~~~

After configuring the Peruvian :ref:`electronic invoicing <peru-accounting-settings>` flow, complete
the following configurations for the **eCommerce** flow:

- :ref:`Client account registration <ecommerce/checkout/policy>`;
- :ref:`Automatic invoice <handling/legal>`;
- :doc:`../../websites/ecommerce/products`: Set the :guilabel:`Invoicing Policy` to
  :guilabel:`Ordered quantities` and define the desired :guilabel:`Customer taxes`.
- :doc:`../payment_providers`;
- :doc:`../../websites/ecommerce/checkout_payment_shipping/shipping`: For each shipping method, set
  the :guilabel:`Provider` field to :guilabel:`Fixed Price`. Then, set a :guilabel:`Fixed Price`
  amount greater than `0.00` (not zero), as the shipping method price is added to the invoice line.

.. note::
   - `Mercado Pago <https://www.mercadopago.com/>`_ is an online payment provider supported in Odoo
     that covers several countries, currencies, and payment methods in Latin America.
   - Make sure to define a :guilabel:`Sales Price` on the :guilabel:`Delivery Product` of the
     shipping method to prevent errors when validating the invoice with |SUNAT|.
   - To offer free delivery, manually remove the :guilabel:`Delivery Product`, or at least use
     `$0.01` (one cent) for the invoice to be validated with SUNAT.

.. seealso::
   :doc:`Set up the Mercado Pago payment provider. <../payment_providers/mercado_pago>`

Invoicing flow for eCommerce
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Once the :ref:`configurations <peru-ecommerce-configuration>` are all set, fiscal input fields will
be available during the checkout process for signed-in customers.

When customers enter their fiscal data at checkout and complete a successful purchase, the invoice
is generated with the corresponding |EDI| elements. The document type (Boleta/Factura) is selected
based on their tax ID (RUC/DNI). The invoice must then :ref:`be sent to the OSE and the SUNAT
<peru-electronic-invoice-status>`. By default, all published invoices are sent once a day through
a scheduled action, but you can also send each invoice manually if needed.

Once the invoice is validated with |SUNAT|, customers can download the .zip file with the CDR, XML,
and PDF files directly from the customer portal by clicking the :guilabel:`Download` button.

Reports
=======

.. _peru/reports-ple:

Permanent inventory reports: |PLE| 12.1 and |PLE| 13.1
------------------------------------------------------

Odoo can produce two permanent inventory reports as `.txt` files for Peruvian accounting: |PLE| 12.1
and |PLE| 13.1. All inventory transactions made need to be reported.

- |PLE| 12.1 **only tracks inventory in physical units**, focusing on the inflow and outflow of
  goods for effective management and planning.

- |PLE| 13.1 tracks **both physical quantities and monetary values of inventory**, providing a
  comprehensive view for tax and management purposes.

Both reports must be maintained semi-annually (January-June and July-December), with monthly
transaction details reported within these periods. The submission deadlines are October 1st for the
first semester and April 1st for the second semester, in accordance with the *Resolución de
Superintendencia N° 169-2015*.

Configuration
~~~~~~~~~~~~~

Before generating the |PLE| 12.1 or |PLE| 13.1 reports, make sure the :guilabel:`Peru - Stock
Reports` (`l10n_pe_reports_stock`) module is installed, then update the fields for:

- :ref:`Products <peru/reports-ple-products>`
- :ref:`Warehouses <peru/reports-ple-warehouses>`
- :ref:`Inventory transfers <peru/reports-ple-transfers>`

.. _peru/reports-ple-products:

Products
********

Several configurations related to the product or product category are necessary for |PLE| reporting:

- **Type of existence**: For all products needing |PLE| reporting, go to the product record's
  :guilabel:`Accounting` tab and select the :guilabel:`Type of Existence` according to |SUNAT|'s
  table 5 for inventory reporting.

- **Automatic inventory valuation**: For storable goods (:dfn:`products with tracked inventory`),
  use :doc:`automatic inventory valuation
  <../../inventory_and_mrp/inventory/product_management/inventory_valuation/inventory_valuation_config>`.
  Once automatic inventory valuation is enabled, this valuation method can be enabled for
  a product's :ref:`product category <inventory/warehouses_storage/valuation-on-product-category>`.

- **Costing method:** Storable goods must use a :doc:`costing method
  <../../inventory_and_mrp/inventory/product_management/inventory_valuation/inventory_valuation_config>`
  **other** than :guilabel:`Standard Price`, as the journal entries generated from stock moves are
  used to populate the |PLE| reports.

.. _peru/reports-ple-warehouses:

Warehouses
**********

When :doc:`setting up a warehouse
<../../inventory_and_mrp/inventory/warehouses_storage/inventory_management/warehouses>`, the
:guilabel:`Annex Establishment Code` field must be filled. This code acts as a unique ID for each
warehouse and should only be a numeric combination, containing between 4 to 7 digits.

.. _peru/reports-ple-transfers:

Inventory transfers
*******************

Transferring inventory is a key process captured in the |PLE| 12.1 and |PLE| 13.1 reports.
:doc:`Inventory transfers <../../inventory_and_mrp/inventory/shipping_receiving/daily_operations>`
include both incoming and outgoing shipments.

When validating an inventory transfer (either on a warehouse receipt or delivery order), select the
:guilabel:`Type of Operation (PE)` performed according to |SUNAT|'s table 12 for permanent inventory
reporting.

Generate a .txt file for permanent inventory Kardex reports
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

|PLE| 12.1 and 13.1 come as two separate books. The books need to be downloaded in `.txt` file
format from Odoo, and then they should be submitted to the |SUNAT| |PLE| software.

On the :ref:`Inventory Valuation Report <inventory/management/reporting/valuation-report>`, click
the :guilabel:`PLE Reports` button. Then, select the :guilabel:`Period` and choose a report to
export: either the :guilabel:`PLE 12.1` or :guilabel:`PLE 13.1`. Odoo generates a `.txt` file
for the chosen report.

.. image:: peru/l10n-ple-export-button.png
   :alt: Export Buttons selection

.. note::
   Only a download of the report in `.txt` format is available. There is no preview or visualization
   available within Odoo.