Skip to content

Commit

Permalink
[IMP]l10n_es_facturae: readme_improve_usage
Browse files Browse the repository at this point in the history
  • Loading branch information
Yoana-RB authored and Christian-RB committed Dec 11, 2024
1 parent 5a90348 commit c04c19a
Show file tree
Hide file tree
Showing 15 changed files with 243 additions and 114 deletions.
156 changes: 110 additions & 46 deletions l10n_es_facturae/README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ Creación de Facturae
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:d0084e0bfb019a08485261d86b1a88a3902d2f47543cc1bc840d6dbac2fe3cf9
!! source digest: sha256:f5488213f3dab920ac99a6d95fe2078f34f3d019e1d33acee8f53dae769658dd
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
Expand Down Expand Up @@ -47,13 +47,21 @@ administración le proporcionará estos datos.

Informacion sobre el formato:

- https://www.facturae.gob.es/formato/Versiones/Esquema_castellano_v3_2_x_06_06_2017_unificado.pdf
- https://www.facturae.gob.es/formato/Versiones/Esquema_castellano_v3_2_x_06_06_2017_unificado.pdf

**Table of contents**

.. contents::
:local:

Use Cases / Context
===================

La facturación electrónica consiste en la emisión, envío y recepción de
facturas en formato digital, garantizando su validez legal y fiscal.
Este método permite cumplir con las normativas vigentes, especialmente
en transacciones con administraciones públicas y grandes empresas.

Installation
============

Expand All @@ -74,44 +82,100 @@ bancaria de los mandatos o los apellidos respectivamente.
Configuration
=============

- Es necesario ir a los modos de pago e indicar su correspondencia con
los códigos de Facturae.
- La dirección del contacto establecido en la factura, a la cual se va
a remitir la factura de venta que queremos exportar, debe estar
marcada como facturae y debe tener cubiertos los datos de Oficina
contable, Órgano gestor y Unidad tramitadora.
- Si deseamos permitir la firma del xml generado desde Odoo mediante la
opción que ofrece el wizard de exportación, tenemos que irnos a
Invoicing -> Configuration -> Certificates AEAT. Crearemos un nuevo
certificado donde cargaremos el fichero .pfx que hayamos obtenido,
estableceremos un nombre para el certificado y la carpeta donde se
ubicará. Una vez creado pulsaremos el botón **Obtain Keys** y nos
pedirá que introduzcamos la contraseña del certificado. Una vez
obtenidas las claves activaremos el certificado pulsando sobre el
botón "To Active".
Pasos para comenzar a utilizar la facturación electrónica:

1. **Configurar los contactos a los que se emitirá facturación
electrónica**

El primer paso es configurar los contactos de los clientes a los que se
enviará la facturación electrónica. Para ello, dirígete al menú de
**Contactos**, selecciona la **ficha del cliente** correspondiente y
accede a la sección de **Facturación/Contabilidad**, específicamente al
apartado de **Facturae**.

|usage_01| |usage_02|

Aquí debes **activar la casilla** correspondiente, seleccionar la
**versión de Facturae** que utilizarás y añadir los **códigos**
necesarios para completar esta configuración.

|usage_03|

2. **Completar la información de la compañía propia:**

Una vez configurados los contactos, es importante asegurarse de que la
información de tu propia compañía esté completa. Para ello, accede a la
ficha de tu empresa en **ajustes** y añade todos los datos requeridos,
incluyendo la **versión de Facturae** que utilizarás.

|usage_04| |usage_05|

Este paso es fundamental para que las facturas electrónicas se generen
correctamente y cumplan con los estándares exigidos.

3. **Añadir el certificado digital:**

El siguiente paso es cargar el certificado digital, que es indispensable
para firmar las facturas electrónicas. Ve a la sección de
**Facturación/Contabilidad**, accede al apartado de **Configuración** y
selecciona Certificados AEAT.

En esta pantalla, haz clic en **Nuevo** para crear un registro para tu
certificado. |usage_06|

Asígnale un nombre y sube el archivo correspondiente. Una vez cargado el
certificado, haz clic en la opción de **Obtener claves** y guarda los
cambios.

|usage_07|

.. |usage_01| image:: https://raw.githubusercontent.com/OCA/l10n-spain/17.0/l10n_es_facturae/static/description/usage_01.png
.. |usage_02| image:: https://raw.githubusercontent.com/OCA/l10n-spain/17.0/l10n_es_facturae/static/description/usage_02.png
.. |usage_03| image:: https://raw.githubusercontent.com/OCA/l10n-spain/17.0/l10n_es_facturae/static/description/usage_03.png
.. |usage_04| image:: https://raw.githubusercontent.com/OCA/l10n-spain/17.0/l10n_es_facturae/static/description/usage_04.png
.. |usage_05| image:: https://raw.githubusercontent.com/OCA/l10n-spain/17.0/l10n_es_facturae/static/description/usage_05.png
.. |usage_06| image:: https://raw.githubusercontent.com/OCA/l10n-spain/17.0/l10n_es_facturae/static/description/usage_06.png
.. |usage_07| image:: https://raw.githubusercontent.com/OCA/l10n-spain/17.0/l10n_es_facturae/static/description/usage_07.png

Usage
=====

Desde el botón "Más" del formulario de factura, ejecutamos el asistente
denominado "Crear fichero Facturae" Podremos visualizar automáticamente
campos extra de facturación electrónica si el cliente es de facturación
electrónica. Estos campos se podrán editar a nivel de factura o de
línea. En el caso de línea, aparecera un botón con un pop-up con todo el
detalle que podemos editar.
**Descarga el archivo de facturae**

Con la configuración lista, ya puedes proceder a emitir tus facturas
electrónicas. Para ello, accede a **Facturación/Contabilidad**, entra en
el menú de **Clientes** y selecciona **Facturas**. |usage_08|

Haz clic en **Nuevo** para crear una nueva factura. Completa toda la
información necesaria, guarda los datos, y luego selecciona el icono de
**engranaje de Acción**.

|usage_09|

Aquí encontrarás la opción para descargar el archivo de la factura
electrónica. Si es necesario, firma el archivo antes de descargarlo.

|usage_10|

Finalmente, una vez que tengas el archivo listo, puedes subirlo al
portal **FACe** para completar el proceso.

.. |usage_08| image:: https://raw.githubusercontent.com/OCA/l10n-spain/17.0/l10n_es_facturae/static/description/usage_08.png
.. |usage_09| image:: https://raw.githubusercontent.com/OCA/l10n-spain/17.0/l10n_es_facturae/static/description/usage_09.png
.. |usage_10| image:: https://raw.githubusercontent.com/OCA/l10n-spain/17.0/l10n_es_facturae/static/description/usage_10.png

Known issues / Roadmap
======================

- No está soportada la exportación de facturas rectificativas. Fallan
las series.
- El certificado y la contraseña de acceso al certificado no se guardan
cifrados en la base de datos.
- Ver la posibilidad de exportar varias facturas juntas.
- Las facturas con recargo de equivalencia no generan un formato
correcto.
- Debido a un cambio de certificados, mal hechos desde Camerfirma, se
ha eliminado el cálculo automático del hash del método de firma.
- No está soportada la exportación de facturas rectificativas. Fallan
las series.
- El certificado y la contraseña de acceso al certificado no se guardan
cifrados en la base de datos.
- Ver la posibilidad de exportar varias facturas juntas.
- Las facturas con recargo de equivalencia no generan un formato
correcto.
- Debido a un cambio de certificados, mal hechos desde Camerfirma, se ha
eliminado el cálculo automático del hash del método de firma.

Changelog
=========
Expand Down Expand Up @@ -154,20 +218,20 @@ Authors
Contributors
------------

- ASR-OSS (http://www.asr-oss.com)
- FactorLibre (http://www.factorlibre.com)
- Tecon (http://www.tecon.es)
- Pexego (http://www.pexego.es)
- Malagatic (http://www.malagatic.es)
- Comunitea (http://www.comunitea.com)
- Pedro M. Baeza (http://www.tecnativa.com)
- Javi Melendez <[email protected]>
- Enric Tobella <[email protected]>
- Adrián Gómez <[email protected]>
- Eduardo de Miguel ([email protected])
- Eric Antones ([email protected]>
- Alberto Martínez ([email protected])
- Carolina Fernandez (http://www.tecnativa.com)
- ASR-OSS (http://www.asr-oss.com)
- FactorLibre (http://www.factorlibre.com)
- Tecon (http://www.tecon.es)
- Pexego (http://www.pexego.es)
- Malagatic (http://www.malagatic.es)
- Comunitea (http://www.comunitea.com)
- Pedro M. Baeza (http://www.tecnativa.com)
- Javi Melendez <[email protected]>
- Enric Tobella <[email protected]>
- Adrián Gómez <[email protected]>
- Eduardo de Miguel ([email protected])
- Eric Antones ([email protected]>
- Alberto Martínez ([email protected])
- Carolina Fernandez (http://www.tecnativa.com)

Maintainers
-----------
Expand Down
47 changes: 33 additions & 14 deletions l10n_es_facturae/readme/CONFIGURE.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,33 @@
- Es necesario ir a los modos de pago e indicar su correspondencia con
los códigos de Facturae.
- La dirección del contacto establecido en la factura, a la cual se va
a remitir la factura de venta que queremos exportar, debe estar marcada
como facturae y debe tener cubiertos los datos de Oficina contable,
Órgano gestor y Unidad tramitadora.
- Si deseamos permitir la firma del xml generado desde Odoo mediante la
opción que ofrece el wizard de exportación, tenemos que irnos a
Invoicing -> Configuration -> Certificates AEAT. Crearemos un nuevo
certificado donde cargaremos el fichero .pfx que hayamos obtenido,
estableceremos un nombre para el certificado y la carpeta donde se ubicará.
Una vez creado pulsaremos el botón **Obtain Keys** y nos pedirá que
introduzcamos la contraseña del certificado. Una vez obtenidas las claves
activaremos el certificado pulsando sobre el botón "To Active".
Pasos para comenzar a utilizar la facturación electrónica:

1. **Configurar los contactos a los que se emitirá facturación electrónica**

El primer paso es configurar los contactos de los clientes a los que se enviará la facturación electrónica. Para ello, dirígete al menú de **Contactos**, selecciona la **ficha del cliente** correspondiente y accede a la sección de **Facturación/Contabilidad**, específicamente al apartado de **Facturae**.

![usage_01](../static/description/usage_01.png)
![usage_02](../static/description/usage_02.png)

Aquí debes **activar la casilla** correspondiente, seleccionar la **versión de Facturae** que utilizarás y añadir los **códigos** necesarios para completar esta configuración.

![usage_03](../static/description/usage_03.png)


2. **Completar la información de la compañía propia:**

Una vez configurados los contactos, es importante asegurarse de que la información de tu propia compañía esté completa. Para ello, accede a la ficha de tu empresa en **ajustes** y añade todos los datos requeridos, incluyendo la **versión de Facturae** que utilizarás.

![usage_04](../static/description/usage_04.png)
![usage_05](../static/description/usage_05.png)

Este paso es fundamental para que las facturas electrónicas se generen correctamente y cumplan con los estándares exigidos.

3. **Añadir el certificado digital:**

El siguiente paso es cargar el certificado digital, que es indispensable para firmar las facturas electrónicas. Ve a la sección de **Facturación/Contabilidad**, accede al apartado de **Configuración** y selecciona Certificados AEAT.

En esta pantalla, haz clic en **Nuevo** para crear un registro para tu certificado.
![usage_06](../static/description/usage_06.png)

Asígnale un nombre y sube el archivo correspondiente. Una vez cargado el certificado, haz clic en la opción de **Obtener claves** y guarda los cambios.

![usage_07](../static/description/usage_07.png)
1 change: 1 addition & 0 deletions l10n_es_facturae/readme/CONTEXT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
La facturación electrónica consiste en la emisión, envío y recepción de facturas en formato digital, garantizando su validez legal y fiscal. Este método permite cumplir con las normativas vigentes, especialmente en transacciones con administraciones públicas y grandes empresas.
21 changes: 15 additions & 6 deletions l10n_es_facturae/readme/USAGE.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,15 @@
Desde el botón "Más" del formulario de factura, ejecutamos el asistente
denominado "Crear fichero Facturae" Podremos visualizar automáticamente
campos extra de facturación electrónica si el cliente es de facturación
electrónica. Estos campos se podrán editar a nivel de factura o de
línea. En el caso de línea, aparecera un botón con un pop-up con todo el
detalle que podemos editar.
**Descarga el archivo de facturae**

Con la configuración lista, ya puedes proceder a emitir tus facturas electrónicas. Para ello, accede a **Facturación/Contabilidad**, entra en el menú de **Clientes** y selecciona **Facturas**.
![usage_08](../static/description/usage_08.png)

Haz clic en **Nuevo** para crear una nueva factura. Completa toda la información necesaria, guarda los datos, y luego selecciona el icono de **engranaje de Acción**.

![usage_09](../static/description/usage_09.png)

Aquí encontrarás la opción para descargar el archivo de la factura electrónica. Si es necesario, firma el archivo antes de descargarlo.

![usage_10](../static/description/usage_10.png)

Finalmente, una vez que tengas el archivo listo, puedes subirlo al portal **FACe** para completar el proceso.

Loading

0 comments on commit c04c19a

Please sign in to comment.