Portal del socio
El espacio de trabajo del SOCIO del canal (Referidor, Implementador Certificado u OEM). En una sola pantalla y SOLO LECTURA: la CARTERA (los tenants que implementó, con la situación de cada uno), el PIPELINE (las referencias en curso que propuso, reutilizando la Red), la COMISIÓN POR COBRAR (el sal…
Qué encuentras en esta pantalla
Un retrato de la pantalla, leído de ella misma — cambia cuando la pantalla cambia.
Acciones disponibles
InscribirVer entregasProbarIntentar entregar ahoraFiltrarReenviar
La lista muestra
EventoEndpointSecretoSituaciónEstadoIntentosHTTPPróximo intentoErrorFechaVersiónURL
Campos del registro
EventoQual acontecimento da plataforma dispara o aviso para fora.
Endereço de destinoPara onde o aviso é enviado. Endereço errado faz o evento sumir sem erro visível.
AtivaInscrição inativa para de disparar, sem perder a configuração de destino.
Empieza aquí
O que esta tela responde
Cómo avisar a un sistema externo en el instante en que algo ocurre aquí. Suscribes una dirección a un evento y la plataforma empieza a llamarla, con rastro de cada entrega.
Qué es esta pantalla
El tenant registra un ENDPOINT (una URL tuya) para ser AVISADO por HTTP cada vez que ocurre un evento de negocio en Tenka: contrato firmado, título pagado, FCA abierto. Cada aviso es un POST firmado con HMAC-SHA256 del cuerpo usando un SECRETO que solo tú y Tenka conocen (header X-Tenka-Signature): tu sistema verifica la firma y sabe que la llamada vino de Tenka y no fue adulterada. Aquí creas la suscripción (url + evento + secreto), la activas/desactivas, sigues el RASTRO de entregas (PENDIENTE → ENTREGADO | FALLA, con el n.º de intentos y el backoff) y puedes disparar un evento de PRUEBA o volver a encolar una entrega que falló. El evento "*" suscribe todos. Distinta de los webhooks internos de cobro (Asaas).
Cómo hacer
Qué responde esta pantalla
Cada entrega se firma con el secreto de la suscripción. Quien la recibe DEBE verificar esa firma antes de confiar en el contenido; sin eso, cualquiera que descubra tu URL puede enviarle un evento falso.
Dispara un evento de prueba antes de depender de él
El botón de prueba envía un evento real a tu endpoint ahora, sin esperar a que ocurra el hecho. Es la forma más rápida de descubrir un error de URL, de firewall o de firma, antes de que el primer evento de verdad se pierda en la cola.
API congelada y SDK
A API pública /api/v1 é congelada: nada some nem muda de tipo; mudança que quebra vai para /v2. O SDK sai do próprio contrato: /api/v1/sdk/tenka.js e /api/v1/sdk/tenka.py. O histórico de versões está no documento API-CHANGELOG da Biblioteca.
Reglas
Qué responde esta pantalla
Un endpoint caído no pierde el evento: la plataforma vuelve a intentar, espaciando los intentos. El rastro muestra el estado y cuántos intentos hubo; es por ahí que se descubre que la integración "se detuvo" porque venció el certificado del otro lado.
Registro de eventos y reenvío
O log de eventos mostra tudo que a conta enviou, em todas as inscrições, com filtro por evento e situação. Reenviar cria uma entrega nova com o mesmo conteúdo e o cabeçalho X-Tenka-Replay-Of com o id da original, para o sistema que recebe não duplicar. Toda entrega leva X-Tenka-Event-Version com a versão do contrato.
Preguntas frecuentes
Qué pregunta responde esta pantalla
¿A qué sistemas míos avisa Tenka cuando algo ocurre, y las entregas están llegando? Registra un endpoint (una URL tuya) por evento de negocio y Tenka envía un POST firmado con HMAC-SHA256 del cuerpo (header X-Tenka-Signature), que tu sistema verifica para saber que la llamada vino de aquí y no fue adulterada. El rastro de entregas muestra PENDIENTE, ENTREGADO o FALLA, con el número de intentos y el backoff; se puede disparar un evento de prueba y volver a encolar una entrega que falló. El evento * suscribe el endpoint a todos los eventos.
¿Te resultó útil este artículo?
En el mismo módulo: Integrações e extensões2
Academia Tenka
Conocer la AcademiaRutas de aprendizaje de tu sector, paso a paso, dentro de la plataforma.