Integration Alegra Woocommerce

1.Descargar e instalar plugin #

  1. Descargar plugin desde el repo de github
  2. Ingrese al menu plugins / añadir nuevo / Subir Plugin
  3. Suba el plugin en format .zip
  4. Instale y active el plugin
  5. Configura el plugin en Woocommerce -> ajustes -> Integracion -> Integration Siigo Woocommerce

2.Configuración #

  1. Active Alegra
  2. Modo de desarrollador:  Activa esta opción si estás en modo prueba y deseas ver mensajes de depuración
  3. Ingresar las credenciales de API
  4. Guarde los cambios

Una vez validadas, se mostrarán las siguientes opciones:

🧾 Facturas de ventas

  • Estado del pedido: Define el estado de WooCommerce que debe tener un pedido para generar factura automáticamente. (Ejemplo: Procesando)
  • Estado de la factura: Estado en el que se crea la factura
  • Vendedor: Asigna el vendedor predeterminado en la factura generada

3.Preguntas Frecuentes #

¿Qué campos personalizados agrega el plugin en el checkout?
El plugin agrega automáticamente dos campos obligatorios en el proceso de pago:

  1.  Tipo de documento: Campo de selección con las siguientes opciones:
    – CC: Cédula de ciudadanía
    – NIT: Número de identificación tributaria
    – CE: Cédula de extranjería
    – DIE: Documento de identificación extranjero
    – TE: Tarjeta de extranjería
    – PP: Pasaporte
    – TI: Tarjeta de identidad
    – RC: Registro civil
    – FOREIGN_NIT: NIT de otro país
  2. Número de documento: Campo numérico para ingresar el número de identificación. Puedes indicarle un diferente meta clave en las configuraciones del plugin.

Estos campos son obligatorios y se utilizan para crear el contacto en Alegra y generar la factura correctamente.

¿Puedo personalizar los campos de documento?
Sí, los campos pueden ser personalizados utilizando plugins compatibles con WooCommerce como:

  • Custom WooCommerce Checkout Fields Editor: Permite modificar etiquetas, placeholders, hacer campos opcionales, agregar validaciones personalizadas, etc.
  • Checkout Field Editor for WooCommerce: Para reordenar, editar o agregar campos adicionales
  • WooCommerce Checkout Manager: Para gestión avanzada de campos de checkout.

Los campos `billing_type_document` y `billing_dni` son fundamentales para la integración con Alegra. Si los modifica o hace opcionales, asegúrese de que el cliente los complete para evitar errores en la generación de facturas.

Help Guide Powered by Documentor
Suggest Edit