Compartir a través de

Introducción a la facturación electrónica para Panamá

  • Artículo

Este artículo proporciona información para ayudarle a comenzar con la facturación electrónica para Panamá. Le guía a través de los pasos de configuración que dependen del país o región en Microsoft Dynamics 365 Finance or Dynamics 365 Supply Chain Management. Estos pasos complementan los pasos descritos en Configuración de la facturación electrónica. Para la integración de última milla con las autoridades fiscales panameñas, Microsoft se está asociando Edicom.

Después de configurar la facturación electrónica, puede generar, firmar digitalmente y enviar los archivos XML de las Edicom facturas electrónicas al proveedor de certificación autorizado (PAC) de acuerdo con los requisitos reglamentarios en Panamá.

Diagrama del flujo de trabajo de facturación electrónica en Panamá.

Nota

El enfoque de facturación electrónica que se describe en este artículo se implementa mediante un servicio de facturación que solo es aplicable a implementaciones en la nube de Finance o cadena de suministro.

Importante

La nueva característica de globalización de facturación electrónica para Panamá (flujo de salida) requiere que ejecute la versión 10.0.40 de Finance. Específicamente, debe ejecutar la compilación número 10.0.1935.60 o posterior. Solo se puede importar al nuevo Globalization Studio. No es compatible con Regulatory Configuration Service (RCS).

Requisitos previos

Antes de comenzar los procedimientos de este artículo, se deben cumplir los siguientes requisitos previos.

  1. Asegúrese de que la configuración de la entidad jurídica panameña esté actualizada. Para obtener más información, consulte Configurar una entidad jurídica e información fiscal para Panamá.

  2. Familiarizarse y comprender la facturación electrónica tal como se describe en Información general sobre facturación electrónica.

  3. Realice la parte común de la configuración del servicio de facturación electrónica como se describe en Configuración de facturación electrónica.

  4. Debe habilitar las siguientes funciones en Administración de características:

    • Integración de facturación electrónica
    • Diseñador del espacio de trabajo del servicio de facturación electrónica
    • Ejecutar acciones de actualización de documentos enviados

  5. Asegúrese de que se importen las siguientes configuraciones de formato de Informes electrónicos (ER). Para obtener más información, consulte Importar configuraciones de informes electrónicos (ER).

    • Modelo de contexto de factura de cliente
    • Factura electrónica de inventario (PA)
    • Factura electrónica (PA) del proyecto
    • Edicom Formato de importación de respuestas de archivos de origen
    • Edicom procesamiento de respuestas LATAM
    • Edicom Importación del registro de errores de respuesta

    Nota

    Estos formatos se basan en las correspondientes configuraciones de formato de LATAM que utilizan las configuraciones de Modelo de Factura LATAM y Asignación de Modelo de Factura LATAM . Todas las demás configuraciones requeridas se importan automáticamente.

Configurar la característica de facturación electrónica

La factura electrónica (PA) de Panamá "Factura electrónica para Panamá: conector de última milla ISV con Edicom" representa un flujo de salida para emitir los siguientes documentos de venta.

Name Código Nombre original
Factura de operación interna 01 Factura de operación interna
Exportar factura 03 Factura de exportación
Nota de abono referida a una o más facturas de venta 04 Nota de Crédito referente a una o varias FE
Nota de Débito referida a una o más Facturas de Venta 05 Nota de Débito referente a una o varias FE
Nota de abono genérica 06 Nota de Crédito genérica
Nota de débito genérica 07 Nota de Débito genérica
Factura de Zona Franca 08 Factura de Zona Franca
Factura de Operación en el Extranjero 10 Factura de Operación Extranjera

Algunos parámetros de la característica se publican con valores predeterminados. Antes de implementar la característica de facturación electrónica en el ambiente de servicio, agregue una característica basada en la característica proporcionada por Microsoft y complete los parámetros comunes en la pestaña Parámetros de características . Revise los valores predeterminados y actualícelos según sea necesario, para que reflejen mejor sus operaciones comerciales.

Para Panamá, hay al menos tres interacciones en Edicom el proceso: primero para enviar la factura, luego para obtener el XML firmado y finalmente para obtener el estado de la factura enviada. Cada interacción requiere parámetros comunes, como Edicom los detalles de conexión y el token de autenticación que Edicom proporciona. Estos parámetros comunes se reutilizan en la configuración de características para todos los tipos de documentos. Edicom proporciona los valores cuando se incorpora una empresa.

Nota

Ahora se simplifica la configuración de parámetros comunes. Ya no es necesario ir a cada configuración de acción y característica y especificar repetidamente los parámetros de conexión comunes. El uso de la pestaña Parámetros de característica solo está disponible a partir de la versión 10.0.41.

Importante

La función de factura electrónica (PA) de Panamá es proporcionada por Microsoft. Para poder usarlo, requiere una configuración adicional, tal y como se describe en este artículo. Para obtener información sobre cómo configurar las características de facturación y aplicar cambios, consulte Trabajar con configuraciones de características. Por ejemplo, además de los parámetros de conexión, puede filtrar entidades jurídicas específicas para que se procesen en reglas de aplicabilidad. De forma predeterminada, la característica es aplicable a todas las entidades legales que tengan una dirección principal en Panamá.

  1. Importe la última versión de la característica de globalización de facturas electrónicas panameñas como se describe en Importar características del repositorio. Las siguientes ilustraciones muestran el aspecto de la característica después de Dataverse importarla.

    Captura de pantalla de la característica Globalización importada para Panamá en la página Características de facturación electrónica, incluida la información en la pestaña Versiones.

    Captura de pantalla que muestra la información en la pestaña Configuraciones para la característica Globalización para Panamá

  2. Cree una copia de la función de globalización importada y seleccione su proveedor de configuración. Para obtener más información, consulte Crear una característica de globalización.

  3. En la pestaña Versiones , confirme que la versión Borrador esté seleccionada.

  4. En la pestaña Parámetros de característica, especifique valores para los siguientes parámetros de conexión e integración que son necesarios para la interoperación con Edicom la API:

    • SeleccioneAplicación y, a continuación, introduzca el número de id. de servicio que obtuvo.
    • SeleccioneDominio y, a continuación, introduzca el mismo número de id. de servicio.
    • SeleccioneObtener el nombre del esquema de estado y luego introduzca el nombre del esquema.
    • SeleccioneGrupo y luego introduzca el código de grupo que obtuvo.
    • SeleccioneNombre de esquema XML firmado y, a continuación, introduzca el nombre del esquema.
    • Seleccionar Nombre de destino y, a continuación, introduzca el número de id. de servicio concatenado con la cadena "_EDIWIN". Por ejemplo, si el número de id. de servicio es 123456, introduzca 123456_EDIWIN.
    • SeleccioneEnviar nombre de esquema de factura y luego introduzca el nombre del esquema.
    • Seleccionar Token de autenticación y luego Seleccionar el nombre del secreto que creó para el token.
    • Seleccione la dirección URL del servicio web y compruebe la dirección web.

    La siguiente ilustración muestra estos parámetros de características establecidos en los valores que Edicom se proporcionan a Microsoft con fines de prueba. Los valores que introduzca serán diferentes. Edicom le proporciona estos valores cuando se incorpore.

    Captura de pantalla que muestra la pestaña Parámetros de características configurada para la característica Globalización para Panamá

  5. La copia de la característica siempre se crea como una versión de Borrador. Independientemente de si realizó cambios, debe completar, publicar e implementar la característica como se describe en Completar, publicar e implementar una característica de globalización (RCS).

Canalización de flujo de salida

Para revisar la canalización de procesamiento, en la pestaña Configuraciones , vaya a Configuración de características, Seleccione el tipo de documento derivado que desee y luego Seleccionar Editar. El flujo de salida consta de las siguientes acciones:

  1. Transformar documento : genere un formato al que se pueda enviar a Edicom.

  2. Integrar con Edicom : envíe la factura generada a Edicom.

  3. Obtener el estado de Edicom para una factura : obtenga el XML firmado de Edicom. Es posible que este documento no esté disponible de inmediato, porque el PAC necesita tiempo para generarlo.

    Nota

    En este apunte del flujo, entra en juego el concepto de acciones de actualización. Tenga en cuenta que la casilla de verificación Actualizar acción está seleccionada para este paso. Por lo tanto, este paso y todos los pasos posteriores se ejecutan en bucle hasta que el sistema determina que se ha alcanzado un estado terminal.

  4. Obtener el estado de Edicom una factura : obtenga el estado de la factura Edicom enviada.

  5. Procesar respuesta : procese la respuesta recibida para determinar si se ha alcanzado un estado terminal.

    • Si la respuesta de estado indica un error, la canalización finaliza y el envío se marca como fallido.
    • Si la respuesta indica que se ha presentado correctamente a la DGI Panameña de Autoridades Fiscales, la canalización se marca como completada.

Captura de pantalla de la canalización de salida

Nota

Existe una configuración similar para cada formato que se incluye en la función de factura electrónica (PA) de Panamá. Para Panamá, hay dos configuraciones: una para facturas de proyectos (PA de factura electrónica de proyecto) y otra para facturas de inventario y servicios (PA de factura electrónica de inventario).

Captura de pantalla que muestra las dos configuraciones para Panamá

Reglas de aplicabilidad

Las reglas de aplicabilidad deben configurarse correctamente para proporcionar contexto, de modo que se pueda encontrar la característica exacta de globalización de la facturación electrónica que debe ejecutarse en el servicio de facturación electrónica. Las reglas de aplicabilidad se proporcionan de forma inmediata al cuenta corriente la entidad jurídica en el código de país o región de la Organización Internacional de Normalización (ISO). Esta configuración de característica en particular admite los tres tipos de facturas: facturas de clientes, notas de débito y notas de crédito.

Captura de pantalla de la configuración en la pestaña Reglas de aplicabilidad de la página Configuración de la versión de características

Variables

Las siguientes variables se utilizan en las acciones de flujo de datos salientes de la característica Panameña. (Estas variables se proporcionan listas para usar).

  • BusinessDocumentDataModel : la variable del modelo de datos de documentos empresariales que se recibe de Finance o cadena de suministro Management y se transforma en el formato necesario para el envío.
  • SignedXML: la variable XML firmada que se devuelve a Finance o a cadena de suministro. Esta variable contiene el cuerpo de la respuesta codificada en base64 del paso Obtener XML firmado de Edicom . Se utiliza en los tipos de respuesta para guardar el XML firmado del que se obtiene como archivo adjunto al diario de Edicom facturas. También se utiliza para generar informes imprimibles a través de códigos QR.

Captura de pantalla de la configuración en la pestaña Variables de la página Configuración de la versión de característica

Después de importar la característica facturación electrónica para Panamá , que incluye la configuración de la característica predeterminada lista para usar, seguir los pasos de la siguiente sección para configurar documentos electrónicos.

Configurar parámetros de documentos electrónicos

  1. Asegúrese de importar las configuraciones de ER específicas del país/región para el contexto del documento y el mapeo del modelo de documento electrónico que se requieren para Panamá. Para obtener más información, consulte Configurar los parámetros de documentos electrónicos.

  2. Vaya a Administración de la organización>Configuración>Parámetros de documentos electrónicos.

  3. En la sección Documento electrónico, agregue registros para el Diario de facturas de cliente y nombres de tabla de Factura de proyecto.

  4. Para cada nombre de tabla, establezca los campos Contexto de documento y Asignación de modelos de documento electrónico según el paso 1.

    Captura de pantalla de la configuración en la pestaña Documento electrónico de la página Parámetros de documento electrónico.

  5. Guarde los cambios y cierre la página.

  6. Para cada nombre de tabla, seguir estos pasos:

    1. Seleccione los tipos de respuesta, Seleccionar Nuevo para crear un tipo de respuesta que obtendrá del back-end e introduzca los siguientes valores:

      • En el campo Tipo de respuesta, introduzca SignedXML (el valor predeterminado). (Véase la Variables de este artículo).
      • En el campo Descripción , introduzca cualquier nombre significativo. Alternativamente, deje el campo en blanco.
      • En el campo Estado de envío, seleccione Pendiente.
      • En el campo Asignación del modelo, Seleccionar Edicom el formato de respuesta del archivo de origen.

    2. Repita el paso anterior, pero establezca el campo Estado de envío en Ejecución deacciones de actualización pendientes. De esta manera, puede ejecutar un subconjunto de las acciones en la canalización de procesamiento en un bucle para extraer continuamente estados actualizados y otra información para los documentos enviados de la autoridad fiscal.

    Captura de pantalla de la configuración del tipo de respuesta para el nombre de tabla Diario de facturas del cliente en la página Actualizaciones de documentos para tipos de respuesta.

    Nota

    La respuesta incluye el XML firmado del Edicom que se obtiene. Este XML firmado se almacena en el sistema como archivo adjunto al diario de facturas correspondiente. Eventualmente se utilizará para generar facturas imprimibles a través de códigos QR.

Emitir facturas electrónicas

Después de completar todos los pasos de configuración necesarios, puede generar y enviar facturas electrónicas para facturas registradas en Administración de la organización>. Documentos>electrónicos periódicos>Enviar documentos electrónicos. Para obtener más información sobre cómo generar facturas electrónicas, consulte Enviar documentos electrónicos.

Para obtener información sobre los resultados de un envío, vaya a Administración>de la organización, Documentos>electrónicos periódicos>, Registro de envío de documentos electrónicos y Seleccione el tipo de documento requerido. Para obtener más información, consulte Trabajar con un registro de envío de documentos electrónicos.

Para Panamá, después de enviar la factura, el estado de envío se establece en Ejecución de acciones de actualización pendientes. Es probable que el cuerpo de la respuesta esté vacío para el XML firmado y la llamada para obtener el estado de la factura. Un cuerpo de la respuesta vacío indica que el XML no estaba disponible inmediatamente después del envío. Para abordar el estado pendiente, se usa una función que se denomina Ejecutar acciones de actualización. Esta función reanuda la canalización a partir de la acción marcada como acción de actualización. A continuación, ejecuta todas las acciones posteriores de la canalización en un bucle. El estado debería cambiar a Ejecutando de nuevo. Luego, después de unos segundos, vuelve a la ejecución de acciones de actualización pendientes.

Captura de pantalla que muestra la función Ejecutar acciones de actualización seleccionada en el menú desplegable Funciones.

Nota

Al establecer una programación de periodicidad, puede configurar la función Ejecutar acciones de actualización para que se ejecute en modo por lotes de forma periódica.

Cuando revise los detalles del envío, debería observar que los pasos se ejecutan nuevamente. Esta vez, se recibe el XML firmado.

Captura de pantalla que muestra el XML firmado recibido

Como resultado del flujo de salida completado, el XML firmado se adjunta al diario de facturas como EdicomSourceFile.

Captura de pantalla del archivo de origen adjunto

Para Panamá, la acción de respuesta del proceso completa la canalización después de unos minutos.

Captura de pantalla con la canalización completada

Más recursos