Compartir a través de

Generar y enviar facturas electrónicas simplificadas para Arabia Saudí

  • Artículo

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 Saudita, consulte Generar códigos QR e imprimirlos en recibos para Arabia Saudita.

En este artículo se proporciona información general de la funcionalidad de las facturas electrónicas simplificadas (facturas electrónicas) que están disponibles para Arabia Saudí en Microsoft Dynamics 365 Commerce. En este artículo también se proporcionan directrices 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 apuntar 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 Saudita (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 Saudita, 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:

  1. Cuando se completa el proceso de finalización de compra de una transacción de venta en el PDV, el PDV usa el signo 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 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.

  2. CRT genera una factura electrónica simplificada en formato XML. Informes electrónicos (ER) se utiliza para implementar el formato XML de las facturas electrónicas para Arabia Saudita. 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.

  3. CRT envía Commerce headquarters una solicitud para proporcionar un certificado digital.

  4. 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 firma digital de este artículo.

    Nota

    Si el PDV está en modo sin conexión, la copia local utiliza CRT un certificado digital instalado localmente en la máquina del PDV.

  5. 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.

  6. El PDV solicita un albarán de CRT venta. 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.

  7. Commerce headquarters usa 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 ambiente de producción.

  8. 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 Listo integrando con el servicio 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 Commerce 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 clientes en Arabia Saudí.

Para utilizar la funcionalidad de Commerce específica de Arabia Saudí, debe completar las siguientes tareas:

  • Establezca el campo País/región en SAU (Arabia Saudí) en la dirección principal de la entidad jurídica.
  • Establezca el campo de código ISO en SA (Arabia Saudita) en el perfil de funcionalidad de PDV de cada tienda ubicada en Arabia Saudita.

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.

  1. Habilitar las características de Commerce para Arabia Saudita en el espacio de trabajo Administración de características.
  2. Configurar el impuesto sobre el valor añadido (IVA) según la normativa de IVA de Arabia Saudí.
  3. Configure campos personalizados y formatos de recibos para imprimir códigos QR en recibos y cumplir con los requisitos reglamentarios locales.
  4. Configure la funcionalidad de registro fiscal para Arabia Saudita para permitir la generación y firma digital de facturas electrónicas simplificadas.
  5. Configure certificados digitales y otros parámetros de firma digital para el lado del canal de Commerce.
  6. Especificar las configuraciones de ER que se deben usar para generar facturas electrónicas simplificadas en PDV y enviarlas desde Commerce headquarters.
  7. Configurar el envío de facturas electrónicas para las facturas electrónicas simplificadas que se generan en el PDV.
  8. Habilite la firma digital en modo sin conexión.

Habilitar características para Arabia Saudí

Habilite las siguientes características en el espacio de trabajo Administración de características:

  • Capacidad de facturación electrónica de Arabia Saudita 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 utilizar el impuesto sobre las ventas, consulte Resumen de impuestos sobre las ventas y Configurar códigos de impuestos sobre las ventas.

También debe especificar grupos de impuestos y habilitar la opción Los precios incluyen impuestos para las tiendas ubicadas en Arabia Saudí.

Configurar campos personalizados para usarlos en formatos de 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 de texto Idioma , en la pestaña PDV , agregue los siguientes registros para las etiquetas de los campos personalizados para los 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 de Text ID que use deben ser únicos y deben ser iguales o superiores a 900001.

Id. del idioma Id. de texto Text
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 Escriba 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 campo corresponden a los textos de idiomas definidos en la sección anterior.

  • Pie de página: Agregue el siguiente campo:

    • Código QR: este campo imprime el código QR del recibo.

Para obtener más información sobre cómo trabajar con formatos de recibos, 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 de Commerce:

  1. Configurar un proceso de registro fiscal. Asegúrese de tener en cuenta la configuración del proceso de registro fiscal específica para Arabia Saudí.
  2. Establecer la configuración de control de errores.
  3. Habilitar la ejecución manual del registro fiscal diferido.

Configurar el proceso de registro fiscal

Para habilitar el proceso de registro fiscal para Arabia Saudita en Commerce headquarters, seguir estos pasos.

  1. Descargue los archivos de configuración para el proveedor de documentos fiscales y el conector fiscal desde el kit de desarrollo de software (SDK) de Commerce:

    1. Abra el respositorio Soluciones de Dynamics 365 Commerce.
    2. Abra la última rama de versión disponible.
    3. Abra src>FiscalIntegration>ElectronicInvoiceSaudiArabia.
    4. Descargue el archivo de configuración del conector fiscal,ConnectorSample.xml .
    5. Descargue el archivo de configuración del proveedor de documentos fiscales,DocumentProviderSample.xml .

  2. Vaya a Parámetros compartidos >de>configuración de Retail and Commerce>Headquarters. En la pestaña General, configure la opción Habilitar integración fiscal en Sí.

  3. Vaya a Retail y Commerce>Configuración>de canal Integración>fiscal Conectores fiscales y cargue el archivo de configuración del conector fiscal que descargó anteriormente.

  4. Vaya a Configuración>de canal de venta minorista y comercio>Integración fiscal Proveedores> de documentos fiscales y cargue el archivo de configuración del proveedor de documentos fiscales que descargó anteriormente.

  5. Vaya a Configuración de canal>de Retail y Commerce>Perfiles> funcionales del conector de integraciónfiscal. Cree un nuevo perfil funcional del conector y seleccione el proveedor de documentos y conector que cargó anteriormente. Luego, actualice la configuración de la asignación de datos según sea necesario.

  6. Vaya a Retail y Commerce>Configuración>de canal Conector de integración>fiscal Perfiles técnicos. 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.

  7. Vaya a Venta minorista y comercio>Configuración>de canal Integración>fiscal Grupos de conectores fiscales y cree un nuevo grupo de conectores fiscales para el perfil funcional del conector que creó anteriormente.

  8. Ir a Retail y Commerce>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 luego Seleccione el grupo de conectores fiscales que creó anteriormente.

  9. Ir a Configuración>de canal de Retail y Commerce>Configuración>de PDV Perfiles de funcionalidad de Perfiles> de funcionalidad y Seleccione un perfil de funcionalidad que esté vinculado a la tienda donde 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.

  10. 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, consulteIncorporación electrónica de la facturación 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 Listo por 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 sin conexión de la aplicación Store Commerce;, la firma también se puede Listo 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 amplía la característica Administrar secretos para canales comerciales.

Para configurar certificados y perfiles de certificado que se pueden usar para la firma digital, seguir 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, seguir estos pasos.

  1. Vaya a Configuración del canal>de Retail y Commerce>Perfiles> técnicos del conector de integraciónfiscal y Seleccione el perfil técnico del conector que creó anteriormente.
  2. Para configurar perfiles de certificado por registro de PDV, Seleccionar Anular y cree registros para todos los registros para los que deba especificar CSID.
  3. 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 informes electrónicos

Debe descargar las últimas versiones de las siguientes configuraciones del Dataverse repositorio. Para obtener más información, consulte Importar configuraciones de Informes electrónicos (ER) desde Dataverse.

  • Configuraciones de generación de facturas electrónicas:

    • Modelo de datos de modelo de factura
    • Asignación de modelo de factura para la asignación del modelo de datos de Commerce (SA)
    • Formato de factura electrónica de ventas (SA)

  • Configuraciones de envío de facturas electrónicas:

    • Modelo de contexto de factura cliente Modelo de datos
    • Modelo de datos de canal comercial
    • Asignación de documentos fiscales comerciales Asignación del modelo de datos
    • Formato de documento fiscal comercial Formato de documento

También debe configurar los parámetros específicos de la entidad jurídica del formato de factura electrónica.

  1. En el espacio de trabajo Informes electrónico, seleccione Configuraciones de informes.

  2. En la página Configuraciones, Seleccione el formato de factura electrónica de ventas (SA) que importó anteriormente y, a continuación, Seleccionar Configuración de parámetros específicos de la aplicación Configurations >.>

  3. 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.

  4. En la ficha desplegable Búsquedas , Seleccione el registro para la búsqueda PaymentMethodSubstitutionLookup .

  5. En la ficha desplegable Condiciones , cree registros para vincular los métodos de pago configurados para los clientes en el módulo Clientes a los medios de pago que ZATCA define para las facturas electrónicas.

  6. En el campo Resultado de la búsqueda, Seleccione un código de medio de pago.

  7. 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 para cualquier método de pago de cliente, puede Seleccionar *No está en blanco*.

    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 con los botones Subir y Bajar .

  8. 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, consulte Introducción a la facturación electrónica para Arabia Saudí. Para admitir la configuración de CSID por registro de PDV, seguir estos pasos para cada registro de PDV en su facturación electrónica ambiente.

  1. Agregue un certificado CSID correspondiente a los parámetros de Key Vault del ambiente.

  2. Crear una configuración de característica del tipo de canalización de procesamiento para la característica de facturación electrónica. Para completar este paso, configure la primera configuración de características y, a continuación, cree nuevas configuraciones de características copiándolas de la primera y modificando los parámetros.

  3. En la configuración de la característica, seguir estos pasos:

    1. En la acción de integración de la canalización de procesamiento, especifique el nombre del certificado CSID que agregó anteriormente.
    2. En la regla de aplicabilidad, especifique los valores Store y RegisterNumber correspondientes .

En Commerce headquarters, seguir estos pasos para configurar los parámetros de envío de facturas electrónicas específicos de Commerce para Arabia Saudita.

  1. 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:

    1. En el campo Nombre de tabla, Seleccionar Documento de transacción fiscal.
    2. En el campo Contexto del documento, Seleccionar contexto dedocumento fiscal comercial.
    3. En el campo Asignación de modelo de documento electrónico, Seleccione Asignación de documentos fiscales comerciales.
    4. Seleccionar secuencias numéricas para los nombres de archivo enviados y los id. de envío de lotes.

  2. En la pestaña Características , marque la característica de factura electrónica de Arabia Saudita como Habilitada.

Habilitar la firma digital en modo sin conexión

Para habilitar la firma digital en modo sin conexión, debe seguir estos pasos después de activar PDV en un nuevo dispositivo.

  1. Inicie sesión en POS.
  2. En la página Estado de conexión de la base de datos, asegúrese de que la base de datos sin conexión esté completamente sincronizada. Cuando el valor del campo Descargas pendientes sea 0 (cero), la base de datos está completamente sincronizada.
  3. Salga de POS.
  4. Espere a que la base de datos sin conexión esté completamente sincronizada.
  5. Inicie sesión en POS.
  6. En la página Estado de conexión de la base de datos, asegúrese de que la base de datos sin conexión 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.
  7. Reinicie POS.

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 documentos electrónicos.