Generar y enviar facturas electrónicas simplificadas para Arabia Saudí
Nota
La funcionalidad descrita en este artículo está destinada a respaldar los requisitos de la Fase 2 de la implementación de la facturación electrónica en el Reino de Arabia Saudita. Para obtener información sobre las funciones heredadas destinadas a respaldar los requisitos de la Fase 1 de la implementación de la facturación electrónica en el Reino de Arabia Saudí, consulte Generar códigos QR e imprimirlos en recibos para Arabia Saudí.
Este artículo proporciona una información general de la funcionalidad para facturas electrónicas simplificadas (facturas electrónicas) que están disponibles para Arabia Saudí en Microsoft Dynamics 365 Commerce. Este artículo también proporciona pautas para configurar la funcionalidad.
La funcionalidad de facturación electrónica que está disponible para Arabia Saudí en Commerce ofrece las siguientes capacidades:
- Genere un archivo XML de una factura electrónica simplificada cuando se concluya una transacción de venta en el punto de venta (PDV) de Commerce.
- Genere un sello criptográfico, o una firma digital, para la factura electrónica simplificada.
- Generar e imprimir un código QR para la factura electrónica simplificada que incluye el sello criptográfico.
- Envíe la factura electrónica simplificada de Commerce headquarters a las autoridades fiscales de Arabia Saudí (Zakat, Tax and Customs Authority [ZATCA]) para fines de presentación de informes.
Para obtener más información sobre los requisitos de facturación electrónica para Arabia Saudí, consulte el portal de facturación electrónica de ZATCA.
El flujo del proceso de extremo a extremo de alto nivel en Commerce para Arabia Saudita es el siguiente:
Cuando se completa el proceso de finalización de compra de una transacción de venta en el PDV, el PDV utiliza la Commerce Scale Unit (CSU) para enviar al Commerce Runtime (CRT) una solicitud para generar y firmar digitalmente una factura electrónica simplificada. El marco de trabajo de registro fiscal y un conector interno se utilizan para implementar la generación y firma digital de facturas electrónicas simplificadas.
Nota
Si el PDV está en modo sin conexión, la generación y la firma digital de una factura electrónica se producen en la copia local de CRT en la máquina del PDV.
CRT genera una factura electrónica simplificada en formato XML. Los Informes electrónicos (ER) se utilizan para implementar el formato XML de las facturas electrónicas para Arabia Saudí. Se utiliza un formato común para las facturas electrónicas simplificadas en Commerce y las facturas electrónicas de impuestos normales en Dynamics 365 Finance.
CRT envía a Commerce headquarters una solicitud para proporcionar un certificado digital.
Commerce headquarters extrae el certificado digital de Azure Key Vault y lo envía de vuelta a CRT. Para obtener más información sobre cómo Commerce gestiona los certificados digitales, consulte la sección Configurar los parámetros de la firma digital de este artículo.
Nota
Si el PDV está en modo sin conexión, la copia local de CRT utiliza un certificado digital instalado localmente en la máquina del PDV.
CRT calcula el hash de la factura, firma digitalmente los datos de la factura electrónica y genera un código QR que incluye el hash de la factura y los datos de la firma digital. CRT también actualiza la factura XML con el hash de la factura y los datos de la firma digital. La factura electrónica, el hash de la factura, el código QR y otra información se guardan en la base de datos del canal en una transacción fiscal vinculada a la transacción de ventas.
El PDV solicita un recibo de venta de CRT. CRT crea el recibo, incluido el código QR, y lo envía de nuevo al PDV. El PDV envía el recibo a la impresora de recibos.
Commerce headquarters utiliza Commerce Data Exchange (CDX) para descargar los datos de las transacciones de ventas junto con las transacciones fiscales de CSU. Los datos se almacenan en la base de datos de la sede central durante toda la vida útil de su entorno de producción.
Commerce headquarters extrae la factura electrónica simplificada en formato XML de la transacción fiscal vinculada a la transacción de venta. A continuación, envía la factura electrónica a ZATCA. El envío se realiza integrando con el servicio de facturación electrónica. Para obtener más información sobre las capacidades comunes de facturación electrónica que están disponibles para Arabia Saudí, consulte Facturas electrónicas de clientes en Arabia Saudí.
Configurar Commerce para Arabia Saudí
Esta sección describe la configuración de comercio que es específica y recomendada para Arabia Saudí. Para obtener más información sobre las funciones y configuraciones comunes de Commerce, consulte la Página principal de Commerce.
Como requisito previo, debe completar la configuración de la funcionalidad de facturación electrónica para Arabia Saudí, incluida la configuración del servicio de facturación electrónica. Para obtener más información, consulte Facturas electrónicas de cliente en Arabia Saudí.
Para utilizar la funcionalidad de Commerce específica de Arabia Saudí, debe completar las siguientes tareas:
- Configure el campo País o región en SAU (Arabia Saudí) en la dirección principal de la entidad jurídica.
- Establezca el campo Código ISO en SA (Arabia Saudí) en el perfil de funcionalidad ISO de cada tienda ubicada en Arabia Saudí.
También debe especificar la siguiente configuración para Arabia Saudí. Tenga en cuenta que debe ejecutar los trabajos de distribución adecuados después de completar la configuración.
- Habilite las características de Commerce para Arabia Saudí en el área de trabajo Administración de características.
- Configurar el impuesto sobre el valor añadido (IVA) según la normativa de IVA de Arabia Saudí.
- Configure campos personalizados y formatos de recibos para imprimir códigos QR en recibos y cumplir con los requisitos reglamentarios locales.
- Configure la funcionalidad de registro fiscal para Arabia Saudí para permitir la generación y firma digital de facturas electrónicas simplificadas.
- Configure certificados digitales y otros parámetros de firma digital para el lado del canal de Commerce.
- Especifique las configuraciones de RE que se deben usar para generar facturas electrónicas simplificadas en PDV y enviarlas desde Commerce headquarters.
- Configurar el envío de facturas electrónicas para las facturas electrónicas simplificadas que se generan en el PDV.
- Habilite la firma digital en modo fuera de línea.
Habilitar características para Arabia Saudí
Habilite las siguientes características en el área de trabajo Administración de características:
- Capacidad de facturación electrónica RAS para el marco de integración fiscal
- (Arabia Saudí) Integración de la facturación electrónica
Configurar el IVA según los requisitos de Arabia Saudí
Debe crear códigos de impuestos, grupos de impuestos y grupos de impuestos de artículo para los grupos de impuestos de artículos. También debe configurar la información de impuestos sobre las ventas para productos y servicios. Para obtener más información sobre cómo configurar y usar características de impuestos, consulte Visión general de impuestos y Configurar códigos de impuestos sobre las ventas.
También debe especificar grupos de impuestos sobre las ventas y habilitar la opción Los precios incluyen impuestos sobre las ventas para tiendas ubicadas en Arabia Saudí.
Configure campos personalizados para usarlos en formatos de recibo para recibos de ventas
Puede configurar el texto del idioma y los campos personalizados que se utilizan en los formatos de recibo de POS. La empresa predeterminada del usuario que crea la configuración del recibo debe ser la misma entidad legal donde se crea la configuración del texto del idioma. Alternativamente, los textos en el mismo idioma deben crearse tanto en la empresa predeterminada del usuario como en la entidad legal de la tienda para la que se creó la configuración.
En la página Texto de idioma, en la pestaña PDV agregue los siguientes registros para las etiquetas de los campos personalizados para diseños de recibos. Tenga en cuenta que los valores ID de idioma, ID de texto y Texto que se muestran en la tabla son solo ejemplos. Puede cambiarlos fácilmente para satisfacer sus necesidades. Sin embargo, los valores ID de texto que use deben ser únicos y deben ser iguales o mayores que 900001.
| Id. de idioma | Id. de texto | Texto |
|---|---|---|
| es-es | 900001 | Código QR |
Sobre la página Campos personalizados, agregue los siguientes registros para los campos personalizados para diseños de recibos. Tenga en cuenta que los valores ID de texto de subtítulo deben corresponder a los valores de ID de texto que especificó en la página Texto de idioma.
| Name | Tipo | Id. de texto de leyenda |
|---|---|---|
| INVOICEQRCODE_SA | Recepción | 900001 |
En la página Parámetros de Commerce, en la pestaña Parámetros de configuración, agregue los siguientes registros.
| Name | Valor |
|---|---|
| RetailEInvoiceFeature_SA.QrCodeHeight | 200 |
| RetailEInvoiceFeature_SA.QrCodeWidth | 200 |
Configurar formatos de recibo
Para cada formato de recibo requerido, cambie el valor del campo Comportamiento de impresión a Imprimir siempre. También debe configurar perfiles de hardware para admitir impresoras de recibos y habilitar la estación de hardware. Para obtener más información sobre cómo trabajar con periféricos de PDV, consulte Periféricos.
En el diseñador de formato de recibo, agregue los siguientes campos personalizados a las secciones de recibos correspondientes. Los nombres de los campos corresponden a los textos de idioma que definió en la sección anterior.
Pie de página: agregue el siguiente campo:
- Código QR – Este campo imprime el código QR para el recibo.
Para obtener más información sobre cómo trabajar con formatos de recibo, consulte Configurar y diseñar formatos de recibos.
Configurar el registro fiscal
Complete los pasos de configuración del registro fiscal que se describen en Configurar la integración fiscal para los canales comerciales:
- Configuración de un proceso de registro fiscal. Asegúrese de tomar nota de la configuración del proceso de registro fiscal que sea específico de Arabia Saudí.
- Establecimiento de la configuración de tratamiento de errores.
- Habilitar la ejecución manual del registro fiscal aplazado.
Configurar el proceso de registro fiscal
Para habilitar el proceso de registro fiscal para Arabia Saudí en Commerce headquarters, siga estos pasos.
Descargue los archivos de configuración para el proveedor de documentos fiscales y el conector fiscal del kit de desarrollo de software (SDK) de Commerce:
- Abra el respositorio Soluciones de Dynamics 365 Commerce.
- Abra la última rama de versión disponible.
- Abra src>FiscalIntegration>ElectronicInvoiceSaudiArabia.
- Descargue el archivo de configuración para el conector fiscal, ConnectorSample.xml.
- Descargue el archivo de configuración para el proveedor de documentos fiscales, DocumentProviderSample.xml.
Vaya a Venta minorista y comercio>Configuración de sede central>Parámetros>Parámetros compartidos. En la pestaña General, configure la opción Habilitar integración fiscal en Sí.
Vaya a Venta minorista y comercio>Configuración de canal>Integración fiscal>Integración fiscal y cargue el archivo de configuración del conector fiscal que descargó antes.
Vaya a Venta minorista y comercio>Configuración de canal>Integración fiscal>Proveedores de documentos fiscales y cargue el archivo de configuración del proveedor de documentos fiscales que descargó antes.
Vaya a Venta minorista y comercio>Configuración de canal>Integración fiscal>Perfiles funcionales del conector. Cree un nuevo perfil funcional del conector y seleccione el proveedor de documentos y conector que cargó anteriormente. A continuación, actualice la configuración de asignación de datos según sea necesario.
Vaya a Venta minorista y comercio>Configuración de canal>Integración fiscal>Perfiles técnicos del conector. Cree un nuevo perfil técnico de conector y seleccione el conector que cargó anteriormente. Establezca el tipo de conector en Interno y actualice las demás configuraciones de conexión según sea necesario.
Vaya a Venta minorista y comercio>Configuración de canal>Integración fiscal>Grupos del conector fiscal y cree un nuevo grupo fiscal de conectores para el perfil funcional del conector que creó antes.
Vaya a Venta minorista y comercio>Configuración de canal>Integración fiscal>Procesos de registro fiscal. Cree un nuevo proceso de registro fiscal, cree un paso de proceso de registro fiscal,y, a continuación, seleccione el grupo de conectores fiscales que creó anteriormente.
Vaya a Venta minorista y comercio>Configuración de canal>Configuración de PDV>Perfiles de PDV>Perfiles de funcionalidad y seleccione un perfil de funcionalidad que esté vinculado a la tienda en la que se debe activar el proceso de registro. Sobre la ficha desplegable Proceso de registro fiscal, seleccione el proceso de registro fiscal que creó anteriormente. Sobre la ficha desplegable Servicios fiscales, seleccione el perfil técnico del conector que creó anteriormente.
Vaya a Retail y Commerce>TI de Retail y Commerce>Programación de distribución. Abra la programación de distribución y seleccione los trabajos 1070 y 1090 para transferir datos a la base de datos del canal.
Configurar los parámetros de la firma digital
Para firmar digitalmente y enviar facturas electrónicas simplificadas, debe obtener los llamados Identificadores de Sello Criptográfico (CSID) de ZATCA. Los CSID tienen la forma de certificados digitales. Para obtener más información sobre cómo obtener CSID, consulte Incorporación de facturación electrónica en Arabia Saudí. Debe obtener un CSID para cada registro de PDV que vaya a utilizar, porque la numeración secuencial y la firma digital de facturas electrónicas simplificadas se realizan por cada registro de PDV.
Los certificados digitales que se utilizarán para firmar digitalmente facturas electrónicas simplificadas se almacenan en Key Vault. Para el modo fuera de línea de la aplicación Store Commerce, la firma también se puede realizar mediante un certificado digital que se almacena en el almacenamiento local de la máquina en la que está instalada la aplicación Store Commerce. La característica Perfiles de certificado definidos por el usuario para tiendas permite la configuración de certificados que se almacenan en Key Vault. También admite la conmutación por error al modo sin conexión cuando Key Vault o Commerce headquarters no están disponibles. Esta característica extiende la característica Gestionar secretos para canales minoristas.
Para configurar certificados y perfiles de certificado que se pueden usar para la firma digital, siga los pasos en Configurar perfiles de certificado. Debe configurar un perfil de certificado independiente para cada CSID que obtenga de ZATCA.
Tras configurar los perfiles de certificado, siga estos pasos.
- Vaya a Venta minorista y comercio>Configuración de canal>Integración fiscal>Perfiles técnicos del conector y seleccione el perfil técnico del conector que creó anteriormente.
- Para configurar perfiles de certificado por registro de PDV, seleccione Invalidar y crear registros para todos los registros para los que deba especificar CSID.
- En cada registro, en la ficha desplegable Dispositivo, en el campo Perfil de certificado, especifique un perfil de certificado correspondiente. Para obtener más información sobre cómo anular la configuración del perfil técnico del conector, consulte Crear perfiles técnicos de conector.
Especificar configuraciones de ER
Debe descargar las últimas versiones de las siguientes configuraciones del repositorio de Dataverse. Para obtener más información, consulte Importar configuraciones de informes electrónicos (ER) de Dataverse.
Configuraciones de generación de facturas electrónicas:
- Modelo de datos del modelo de factura
- Asignación del modelo de datos Asignación de modelo de factura para Commerce (SA)
- Formato de Factura electrónica de ventas (SA)
Configuraciones de envío de facturas electrónicas:
- Modelo de datos Modelo de contexto de factura de cliente
- Modelo de datos Datos del canal minorista
- Asignación del modelo de datos Asignación de documentos fiscales comerciales
- Formato Formato de documento fiscal minorista
También debe configurar los parámetros específicos de la entidad jurídica del formato de factura electrónica.
En el espacio de trabajo Informes electrónico, seleccione Configuraciones de informes.
En la página Configuraciones, seleccione el formato Factura electrónica de ventas (SA) que ha importado antes y, a continuación, seleccione Configuraciones>Parámetros específicos de la aplicación>Configuración.
En la página Parámetros específicos de la aplicación, seleccione la versión de la configuración de formato para la que desea configurar los parámetros.
En la ficha desplegable Búsquedas, seleccione el registro para la búsqueda PaymentMethodSubstitutionLookup.
En la ficha desplegable Condiciones, cree registros para vincular los métodos de pago configurados para los clientes en el módulo Proveedores a los medios de pago que ZATCA define para las facturas electrónicas.
En el campo Resultado de la búsqueda, seleccione un código de medio de pago.
En el campo Nombre, seleccione un método de pago de cliente que se deba corresponder con el código del medio de pago. Si desea que el código de medios de pago se seleccione cuando no se especifica el método de pago del cliente, puede seleccionar *En blanco*. Si desea que el código de medios de pago se seleccione cuando no se especifica el método de pago del cliente, puede seleccionar *Completado*.
El campo Línea se establece automáticamente. Define el orden en el que se buscan los códigos de medios de pago para un método de pago de cliente. Puede cambiar el orden mediante los botones Mover hacia arriba y Mover hacia abajo.
Complete la configuración estableciendo el campo Estado en Completado.
Configurar el envío de facturas electrónicas
Antes de configurar los parámetros de envío de facturas electrónicas para Commerce, configure el servicio de facturación electrónica para que se pueda usar en Arabia Saudí. Para obtener más información, vea Introducción a la facturación electrónica para Arabia Saudí. Para configurar los CSID por cada terminal punto de venta, siga estos pasos para cada terminal punto de venta en su entorno de facturación electrónica.
Agregue un certificado CSID correspondiente a los parámetros de Key Vault del ambiente.
Cree una configuración característica del tipo de Procesamiento de canalización para la característica de facturación electrónica. Para completar este paso, configure la primera configuración de característica y luego cree nuevas configuraciones de característica copiándolas de la primera y modificando los parámetros.
En la configuración de la función, siga estos pasos:
- En la acción de integración de la canalización de procesamiento, especifique el nombre del certificado CSID que agregó anteriormente.
- En la regla de aplicabilidad, especifique los correspondientes valores de Store y RegisterNumber.
En Commerce headquarters, siga estos pasos para configurar los parámetros de envío de facturas electrónicas específicos de Commerce para Arabia Saudí.
En la página Parámetros de documento electrónico, en la pestaña Documento electrónico, cree un nuevo registro y especifique los siguientes parámetros:
- En el campo Nombre de la tabla, seleccione Documento de transacción fiscal.
- En el campo Contexto del documento, seleccione Contexto de documento fiscal comercial.
- En el campo Asignación de modelos de documentos electrónicos, seleccione Asignación de documentos fiscales comerciales.
- Seleccionar secuencias numéricas para los nombres de archivo enviados y los id. de envío de lotes.
En la pestaña Características , marque la característica Factura electrónica de Arabia Saudí como Habilitada.
Habilitar la firma digital en modo fuera de línea
Para habilitar la firma digital en modo fuera de línea, debe seguir estos pasos después de activar PDV en un nuevo dispositivo.
- Inicie sesión en POS.
- Sobre la página Estado de conexión a la base de datos, asegúrese de que la base de datos fuera de línea esté completamente sincronizada. Cuando el valor del campo Descargas pendientes sea 0 (cero), la base de datos está completamente sincronizada.
- Salga de POS.
- Espere un momento a que la base de datos fuera de línea esté completamente sincronizada.
- Inicie sesión en POS.
- Sobre la página Estado de conexión a la base de datos, asegúrese de que la base de datos fuera de línea esté completamente sincronizada. Cuando el valor del campo Transacciones pendientes en la base de datos sin conexión sea 0 (cero), la base de datos está completamente sincronizada.
- Reiniciar PDV
Envío de facturas electrónicas
Para iniciar el envío de facturas electrónicas simplificadas a ZATCA, ejecute la operación periódica Enviar documentos electrónicos en Commerce headquarters.
Puede revisar el registro de envío en la página Registro de envío de documento electrónico.