FAIR

Federated and Independent Repositories

Dynamica Facturacion Electronica

Plugin Banner

Dynamica Facturacion Electronica

by Dynamica

Download
Description

Dynamica Facturacion Electronica agrega una base orientada a WooCommerce para facturacion electronica en Uruguay.

Funciones actuales:

  • Hooks de pedidos de WooCommerce para generacion de borradores
  • procesamiento manual y automatico de documentos
  • sincronizacion remota de configuracion de empresa mediante bearer token
  • seleccion de CAE y control local de numeracion
  • soporte de envio SOAP/XML para integracion con el proveedor
  • historial de documentos, seguimiento de respuestas y registro de enlaces PDF
  • modos sandbox y produccion
  • envio SOAP real desactivado por defecto hasta que el comercio lo habilite

Esta version esta enfocada en flujos CFE de Uruguay, incluyendo e-Ticket, e-Factura y otros tipos de documentos soportados segun el CAE del comercio y la configuracion del proveedor. Esta pensada para comercios que ya tienen acceso a un servicio externo compatible de facturacion electronica.

Quick Start

  1. Active WooCommerce y este plugin.
  2. Abra WooCommerce > Factura Electronica.
  3. Revise el endpoint sugerido para sincronizacion remota e ingrese el bearer token si su cuenta usa configuracion remota.
  4. Sincronice los datos de la empresa y revise el catalogo de CAE.
  5. Confirme el ambiente, la numeracion y los datos del emisor.
  6. Mantenga desactivado el envio real hasta completar las pruebas de sandbox. Las instalaciones nuevas inician con el envio real desactivado por defecto.
  7. Cree un pedido en WooCommerce y verifique la generacion del documento antes de habilitar el envio a produccion.

External Services

Este plugin se conecta a servicios externos para obtener configuracion de empresa y para enviar documentos fiscales.

1. Sincronizacion de configuracion con Dynamica

El plugin puede conectarse a un endpoint externo operado por Dynamica para sincronizar configuraciones de empresa de comercios que ya usan ese servicio. Este plugin no se presenta como un plugin oficial de Dynamica.

URL del servicio:

  • https://www.datosdynamica.net/woocommerce

Cuando se utiliza:

  • solo cuando un administrador hace clic manualmente en el boton de sincronizacion dentro de la configuracion del plugin

Que se envia:

  • la URL sugerida del endpoint incluida en el plugin
  • el bearer token ingresado por el comercio en la configuracion del plugin

Que se recibe y almacena:

  • identificadores de empresa
  • datos comerciales del emisor
  • datos del catalogo de CAE
  • configuracion de ambiente y proveedor requerida para el flujo de facturacion

Terminos del servicio y privacidad:

  • Dynamica company site: https://dynamica.com.uy/
  • Service URL: https://www.datosdynamica.net/woocommerce
  • Privacy Policy: https://www.datosdynamica.net/plugin/woocommerce/politica-de-privacidad.html
  • Terms of Service: https://www.datosdynamica.net/plugin/woocommerce/terminos-de-servicio.html

2. Envio SOAP a Migrate / InvoiCy

El plugin puede enviar cargas XML/SOAP de factura electronica a los endpoints configurados del proveedor.

Endpoints por defecto incluidos en el plugin:

  • Sandbox WSDL: https://appuypruebas.migrate.info/InvoiCy/aws_emissionfactura.aspx?WSDL
  • Production WSDL: https://appuy.migrate.info/InvoiCy/aws_emissionfactura.aspx?WSDL

Cuando se utiliza:

  • solo cuando el comercio habilita el envio real en la configuracion del plugin
  • durante acciones de reenvio de documentos iniciadas por un administrador
  • durante el procesamiento automatico de pedidos elegibles de WooCommerce

Que se envia:

  • identificadores del emisor y credenciales del proveedor configuradas por el comercio
  • carga XML del documento fiscal generada a partir del pedido de WooCommerce
  • datos de facturacion e identificacion fiscal del cliente ingresados durante el checkout o la edicion del pedido
  • totales del pedido, items y datos de numeracion del documento requeridos por el proveedor

Que se recibe y almacena:

  • codigos y mensajes de respuesta del proveedor
  • XML de respuesta del proveedor
  • URL del PDF cuando el proveedor devuelve uno

Informacion del servicio:

  • Migrate / InvoiCy: https://migrate.info/en
  • Migrate legal center: https://migrate.info/es/politicas/regulamento-invoicy
  • Migrate privacy center: https://vencyone.cloud/painel-empresa/3510770211-central?language=pt-BR

Requirements

  • WordPress 6.6 o superior
  • WooCommerce activo
  • PHP 8.2 o superior
  • acceso a un proveedor externo compatible de facturacion electronica
  1. Suba el archivo ZIP en Plugins > Add New > Upload Plugin.
  2. Active WooCommerce si aun no esta activo.
  3. Active este plugin.
  4. Vaya a WooCommerce > Factura Electronica.
  5. Revise la URL sugerida del endpoint e ingrese el bearer token si usa sincronizacion remota.
  6. Revise el CAE, la numeracion y la configuracion del ambiente.
  7. Mantenga desactivado el envio real hasta validar el flujo de sandbox.
El plugin funciona sin WooCommerce?

No. WooCommerce es requerido porque el plugin se integra con pedidos, checkout y pantallas administrativas de WooCommerce.

Donde se almacenan los XML, respuestas y logs?

El plugin almacena XML generados, respuestas JSON, certificados y logs en wp-content/uploads/dynamica-facturacion-electronica/, fuera de la carpeta del plugin, para que las actualizaciones no eliminen archivos de ejecucion.

El plugin vuelve a exponer al navegador los tokens o claves guardadas?

No. Los secretos guardados intencionalmente no se muestran otra vez en la interfaz administrativa. Dejar el campo relacionado vacio conserva el valor almacenado.

El plugin contacta servicios externos automaticamente?

La sincronizacion remota de configuracion solo se ejecuta por accion de un administrador. El envio SOAP real comienza desactivado por defecto y solo ocurre cuando el comercio lo habilita en la configuracion y dispara un flujo de documento elegible.

Puedo usar este plugin sin una cuenta de proveedor?

Puede configurar y probar la generacion local de borradores, pero el envio real requiere credenciales validas del proveedor y acceso a un servicio compatible de facturacion electronica.

0.1.2

  • Se agregaron enlaces publicos de politica de privacidad y terminos de servicio para el servicio de configuracion remota.
  • Se deshabilito por defecto el envio SOAP real para nuevas instalaciones.
  • Se agrego contenido sugerido para politica de privacidad mediante las herramientas de privacidad de WordPress.
  • Se movieron los estilos de presentacion de la pagina administrativa a una hoja de estilos cargada correctamente.
  • Se alinearon las capacidades administrativas de WooCommerce entre configuracion, reenvio y descarga de documentos.
  • Se agrego la carga estandar del textdomain del plugin durante el arranque.
  • Se corrigieron las URLs de acciones administrativas para reenvio y descarga del paquete XML.

0.1.1

  • Se eliminaron claves tecnicas hardcodeadas del plugin distribuido.
  • Se dejo de exponer secretos guardados en respuestas AJAX y campos de interfaz administrativa.
  • Se ocultaron valores sensibles en los logs del plugin.
  • Se movio el registro de archivos del plugin al directorio de uploads de WordPress.
  • Se eliminaron rutas internas de archivos de registros almacenados, metadatos de pedidos y vistas administrativas.
  • Se mantuvo el ZIP distribuido libre de logs internos de ejecucion del plugin.
  • Se amplio la documentacion del readme para servicios externos y flujo de datos.

0.1.0

  • Base inicial de integracion de facturacion electronica para WooCommerce.
Back to top