Integración WooCommerce a DTE: flujo real de pedidos a factura

Respuesta directa

En términos prácticos, la integración WooCommerce a DTE (paso a paso) incluye: verificar que tu cuenta de Tribuno tenga habilitados los módulos/API de facturación electrónica según el plan contratado, configurar el disparador en WooCommerce (webhook o tarea programada), mapear y validar los campos fiscales (RUT, desglose de IVA, códigos de ítem), implementar un adaptador que llame a la API de Tribuno en modo sandbox para pruebas, y finalmente activar en producción con monitoreo y manejo de errores. Más abajo se describen cada paso, los riesgos comunes y una lista de pruebas recomendadas.

Objetivo y público

Esta guía está pensada para comercios que usan WooCommerce en Chile y requieren emitir Documentos Tributarios Electrónicos (DTE) automáticamente cuando una venta se confirma. Es útil para emprendedores, pymes y desarrolladores internos o externos que implementan la integración. No reemplaza la asesoría contable ni la normativa del SII: cuando haya dudas normativas, conviene consultar al contador o directamente con el Servicio de Impuestos Internos.

Intención de búsqueda

El propósito es informativo y operativo: ofrecer un paso a paso técnico y recomendaciones prácticas para que una tienda WooCommerce transforme pedidos en DTE válidos dentro del ciclo chileno de facturación electrónica.

Prerequisitos

• Cuenta activa en Tribuno con los módulos de facturación electrónica e integraciones habilitados según el plan contratado. Verifica qué capacidades tienes antes de comenzar.
• Acceso de administrador a WooCommerce y la capacidad de instalar plugins o configurar webhooks/API.
• Folios y configuración del emisor según SII; coordina con tu contador si corresponde.
• Ambiente de pruebas (sandbox) en Tribuno o equivalente; si tu proyecto requiere interacción formal con el SII, coordina el procedimiento específico con Tribuno y con tu contador, ya que la necesidad y el alcance de certificaciones o validaciones puede variar.
• Conocimientos básicos de HTTP/JSON y gestión de errores (o un desarrollador que los tenga).

Arquitectura y flujo general

El flujo típico incluye estas etapas:

• Evento disparador: pedido confirmado, pago registrado o cambio de estado en WooCommerce.
• Captura y normalización: extraer datos del pedido: cliente (nombre, RUT si existe), dirección, ítems, cantidades, precios, impuestos, descuentos, cargos por envíos y forma de pago.
• Mapeo y validación: transformar los datos al esquema requerido por Tribuno y por la normativa (por ejemplo, muchos endpoints esperan el RUT sin puntos ni guión y con dígito verificador). Validar que montos y totales cuadren.
• Emisión: llamada a la API de Tribuno para crear y enviar el DTE. Según los módulos y la configuración, Tribuno suele devolver información relacionada con el folio o identificador del documento y el resultado del proceso de envío hacia el SII.
• Notificación: actualizar el pedido en WooCommerce con el estado del DTE y, cuando la plataforma lo soporte y esté configurado, adjuntar PDF/XML o enlaces; notificar al cliente según la política de comunicación de tu tienda.
• Post-venta: manejo de devoluciones, notas de crédito y conciliación de inventarios y contabilidad.

Paso a paso recomendado (alto nivel)

1) Revisar disponibilidad en Tribuno

Confirma que tu plan y los módulos activos en Tribuno cubren facturación electrónica y webhooks/API. No todos los planes incluyen las mismas capacidades; verifica antes de avanzar. Para más detalles, revisa la página de Módulos y consulta los Planes.

2) Inventario de campos en WooCommerce

Haz un listado de los datos que tu tienda registra: RUT del cliente (si se solicita), razón social, dirección de despacho y facturación, ítems (SKU, descripción, cantidad, precio unitario), impuestos por ítem, descuentos y cobros por envío. Decide qué campos son obligatorios para emitir el tipo de documento que necesitas (factura, boleta o exenta).

3) Elegir el método de envío de eventos

Recomendado: webhooks de WooCommerce para obtener eventos en tiempo real. Alternativa: tareas programadas (cron) que procesen pedidos en estado "pagado" o "completado" en lotes. Webhooks reducen latencia; cron puede ser más tolerante a fallos puntuales y más sencillo si procesas en lotes.

4) Implementar el adaptador/middleware

El adaptador toma el payload de WooCommerce, aplica las validaciones y mapeos necesarios y arma la petición a la API de Tribuno. Funcionalidades deseables:

• Validación de RUT (formato y dígito verificador).
• Cálculo/desglose de IVA por ítem y totales.
• Normalización de códigos de producto (si usas un catálogo tributario).
• Registro en una cola (por ejemplo, para procesar reintentos si la API responde con fallo temporal).
• Logging estructurado para auditoría y trazabilidad.

5) Testear en sandbox

Antes de pasar a producción, prueba con pedidos que cubran casos reales: ventas con y sin RUT, descuentos, múltiples ítems, envíos a otra dirección y devoluciones parciales. Documenta las respuestas y los errores para crear una guía de resolución de incidentes. Coordina estas pruebas con Tribuno y, si corresponde, con el procedimiento de pruebas que indique el SII o tu asesor tributario.

6) Manejo de errores y reintentos

Define políticas claras: reintentos exponenciales ante fallos temporales, alertas si un pedido supera N intentos (por ejemplo, 5 reintentos se usa a veces como referencia, pero es sólo un ejemplo orientativo), y procedimientos manuales cuando el SII devuelve rechazos formales que requieren corrección de datos.

7) Poner en producción y monitoreo

Activa la integración en producción con monitoreo de métricas clave (por ejemplo: tasa de éxito de emisión, número de reintentos, latencia promedio). Registra todos los DTE emitidos y conserva los PDFs/XML o los respaldos documentales según la capacidad y configuración de tu plataforma y del almacenamiento que utilices.

Puntos críticos y validaciones obligatorias

• Validación de RUT: formato y dígito verificador; si el cliente no tiene RUT, establece una política (por ejemplo, emitir boleta a consumidor final).
• Consistencia de montos: suma de ítems + impuestos + envío - descuentos debe coincidir con el total del pedido.
• Tipo de documento según estado/pago: define reglas claras (por ejemplo: pedido marcado como pagado genera factura/boleta; pedido pendiente no debe emitir DTE).
• Impuestos especiales y exenciones: documenta casos donde aplica exención o tasa 0%.
• Folios del emisor: deben estar habilitados por el SII y administrados según procedimiento; coordina con tu contador.

Pruebas y certificación

Planifica pruebas que cubran al menos los siguientes escenarios: venta con RUT, venta sin RUT, descuentos por línea, envío gratis, devolución parcial (emitir nota de crédito), rechazo por validación SII. Documenta los errores más frecuentes y la acción correctiva asociada. Si necesitas certificación formal con el SII, coordina los pasos con Tribuno y tu contador; esta guía no sustituye ese proceso ni la documentación oficial del SII.

Monitoreo y operación

• Registra logs de cada intento de emisión, respuesta de la API de Tribuno y, cuando corresponda, de las comunicaciones con el SII.
• Configura alertas por rechazo de DTE o por fallos repetidos (por ejemplo: notificación al equipo de operaciones tras 3 rechazos consecutivos, cifra a definir según tu operación).
• Procedimientos para reemisión y conciliación de inventario: asegúrate de que la emisión o anulación de un DTE se refleje en el stock cuando corresponda.

Preguntas frecuentes

¿Qué estado de pedido usar como disparador?

Lo común es usar el estado que indica pago confirmado (p. ej., processing o completed según tu flujo). Elegir un estado intermedio puede evitar emisiones para pedidos que luego se cancelan.

¿Cómo se manejan las ventas sin RUT o internacionales?

En ventas sin RUT normalmente se emite boleta a consumidor final; para ventas internacionales hay consideraciones arancelarias y tributarias que requieren revisión con un especialista. Estos casos suelen necesitar validación adicional antes de emitir el DTE.

¿Qué hago si el SII rechaza un DTE?

Registra el motivo de rechazo y aplica correcciones en los datos según corresponda (por ejemplo: RUT incorrecto, inconsistencia en montos). Si se trata de un rechazo por regla de negocio, corrige y reemite; si es un rechazo técnico, coordina con Tribuno y tu equipo técnico o con tu asesor tributario.

¿Se actualiza el stock automáticamente al emitir DTE?

Depende de cómo diseñes la integración: puedes decrementar stock al confirmar el pedido o al emitir el DTE. Define la regla operativa que mejor se ajuste a tu negocio y documenta el flujo para conciliación posterior.

Conclusión y siguientes pasos

Integrar WooCommerce con la emisión de DTE puede ahorrar tiempo operativo y reducir errores manuales, pero requiere diseño cuidadoso: mapeo de campos, validaciones fiscales, pruebas en sandbox y un plan de monitoreo robusto. Antes de implementar, verifica qué módulos están activos en tu cuenta de Tribuno y coordina con tu contador para asuntos de folios y cumplimiento. Si quieres revisar opciones o habilitar módulos, Revisa los módulos disponibles y consulta los planes vigentes. Para dudas puntuales o coordinación técnica, contáctanos y el equipo podrá orientarte sobre pasos siguientes.

Nota: Las cifras y ejemplos numéricos en este artículo son orientativos y se ofrecen como ejemplo. Para decisiones que dependan de normativa vigente o interpretación tributaria, consulta la documentación oficial del SII o a un contador.