WooCommerce · Página técnica

Cómo se conecta WooCommerce con el flujo documental de Tribuno

Esta página explica la arquitectura: WooCommerce origina la venta, el módulo prepara los datos, Tribuno procesa la operación documental y el resultado vuelve a quedar relacionado con el pedido.

En concreto

Tres sistemas, responsabilidades distintas

La tienda no debería asumir lógica tributaria que pertenece a la plataforma documental, y Tribuno no debería perder la referencia del pedido que originó la operación. Separar responsabilidades facilita diagnóstico, seguridad y mantenimiento.

01

WooCommerce

Gestiona el pedido, productos, cliente y estado comercial de la compra.

02

Módulo de integración

Detecta la condición configurada y prepara la información necesaria.

03

Tribuno

Recibe la operación, ejecuta el flujo documental y conserva trazabilidad.

04

Respuesta operativa

El pedido puede mantener referencia del resultado para revisión y continuidad.

Arquitectura

El flujo debe ser idempotente y trazable

Una misma orden no debería generar documentos duplicados por recargas, reintentos o cambios de estado repetidos. La integración necesita referencias consistentes para reconocer la operación.

  1. 01

    Identificador único de la orden.

  2. 02

    Condición de disparo configurable.

  3. 03

    Registro de la solicitud enviada.

  4. 04

    Resultado asociado a la misma operación.

Datos

La calidad del documento depende de los datos recibidos

El plugin debe distinguir datos del comprador, datos tributarios y datos de facturación a un receptor distinto. También debe evitar enviar campos empresariales vacíos o heredados cuando no corresponden.

  1. 01

    Tipo de documento solicitado.

  2. 02

    RUT y nombre del receptor cuando aplican.

  3. 03

    Dirección, comuna y ciudad para facturación cuando corresponden.

  4. 04

    Productos, cantidades, montos e impuestos de la orden.

Incidencias

Los errores deben volver con suficiente contexto para corregirlos

Un HTTP 500 genérico no basta. El flujo necesita distinguir validación local, comunicación con Tribuno y respuesta del proceso documental.

  1. 01

    Validación del checkout.

  2. 02

    Preparación del payload.

  3. 03

    Autenticación y comunicación.

  4. 04

    Estado final o error de la operación.

Cuándo tiene sentido

Casos donde esta capacidad puede aportar valor.

  • Desarrolladores que implementan WooCommerce.
  • Agencias que necesitan entender la separación de responsabilidades.
  • Tiendas que requieren diagnóstico de pedidos no emitidos.
  • Equipos que quieren evitar duplicación de documentos.

Preguntas frecuentes

Respuestas directas sobre este tema.

¿Esta página es distinta de la landing comercial de WooCommerce?

Sí. Aquí se explica la arquitectura y las responsabilidades técnicas; la otra página está orientada a evaluar el beneficio comercial para una tienda.

¿WooCommerce se comunica directamente con el SII?

El diseño de Tribuno usa la plataforma como capa documental y de gestión. La tienda origina la venta y se conecta con Tribuno mediante el módulo correspondiente.

¿Cómo se evitan documentos duplicados?

La integración debe reconocer la misma operación mediante identificadores y estados persistentes, además de controlar reintentos y disparadores repetidos.

¿Dónde se revisa la disponibilidad del módulo?

La ficha pública de WooCommerce y el catálogo de módulos muestran el producto comercial vigente.

Evaluación comercial

Conversemos sobre el flujo real de tu empresa.

Revisamos documentos, volumen, canales de venta e integraciones necesarias para orientar una configuración adecuada.

PLATAFORMA TRIBUNO Entrar a mi cuenta