tario.

Crear webhooks y verificar las entregas

Un webhook envía un POST firmado a tu URL cuando Hacienda acepta o rechaza una factura o entra una compra; lo creás en Configuración de la empresa → Integraciones, copiás el secreto una vez, lo probás y seguís cada entrega.

Abrir en Tario: IntegracionesTokens API

Si no tenés la sesión abierta, Tario te pide ingresar y abre tu empresa actual.

Pasos

  1. Abrí Configuración de la empresa → Integraciones → Webhooks y hacé clic en Nuevo webhook (necesitás el permiso Configuración → gestionar).

  2. Escribí la URL del endpoint (se recomienda HTTPS), elegí los Eventos que querés (Factura aceptada, Factura rechazada, Compra recibida) y una Descripción opcional. Confirmá con Crear.

  3. Copiá el secreto de firma ahora: se muestra una sola vez. Cada entrega lleva X-Tario-Event, X-Tario-Delivery y X-Tario-Signature = HMAC-SHA256 del cuerpo crudo con ese secreto, en hexadecimal; verificalo sobre el cuerpo crudo antes de parsearlo.

  4. Hacé clic en Enviar evento de prueba para encolar un ping firmado: la columna Última entrega muestra En cola, Entregado (con el código HTTP), Reintentando o Falló con el último error. Tario reintenta las entregas fallidas hasta 5 veces (1 min, 5 min, 30 min, 2 h).

  5. Usá el interruptor de Estado para pausar un webhook sin borrarlo; Eliminar lo quita y descarta las entregas encoladas.

  6. El historial de entregas se conserva 30 días. Las mismas suscripciones están disponibles por la API (GET/POST/PATCH/DELETE /api/v1/webhooks) con la habilidad update.

Consejos

  • Respondé 2xx rápido y procesá el evento después: un endpoint lento cuenta como fallo a los 10 segundos.
  • Usá X-Tario-Delivery como clave de idempotencia: un reintento repite el mismo id de entrega.
  • Los eventos de factura traen numero_hacienda (consecutivo), email_delivery (qué correo envía Tario, si alguno), hacienda_responded_at y las rutas xml_download_path / xml_response_download_path para bajar el XML firmado y la respuesta con tu token, por ejemplo para armar tu propio PDF.

Errores comunes

Código o mensajeQué significaCómo resolverlo
Activá el webhook antes de enviar un evento de prueba.El webhook está pausado, así que no se le entrega nada.Activá el interruptor de Estado y volvé a enviar la prueba.

Preguntar a Tario AI

Abre el asistente dentro de Tario con la pregunta escrita, lista para enviar.

Preguntar a Tario AI

Temas relacionados

← Volver a API e integraciones