TMB - Manual webhook

Página 1 de 2 Webhook para Pedidos É possível utilizar webhook para que seu sistema seja notificado sobre alterações que ocorram nos pedidos do sistema da TMB Educação. Os eventos que a TMB notifica são: • Efetivado – O Cliente pagou o boleto de entrada. • Cancelado- Após o pagamento do boleto de entrada o cliente cancelou o contrato. • Aguardado Assinatura- Aguardando assinatura do contrato. • Boleto Gerado- Boleto de entrada gerado pelo Asaas. • Desistência- O cliente desistiu por algum motivo. Exemplo de JSON a ser recebido em seu endpoint [POST] A notificação consiste em um POST contendo um JSON, conforme este exemplo: Pedido 255 string 255 string produtor 50 string lancamento 255 int provedor_negociado 255 string pedido 50 status_pedido 255 string cliente 1200 decimal documento int email 100 decimal endereco_completo decimal valor_principal decimal parcelas datetime valor_entrada datetime? valor_parcela string valor_total string criado_em int data_efetivado string telefones datetime? telefone_ativo lancamento_id id_externo risco_compartilhado_em

Página 2 de 2 Configuração do webhook no sistema A configuração do webhook é realizada pelo time da TMB, o produtor deverá passar a seguintes informações: ID Externo do produto O campo deve ser preenchido com o código de referência do lançamento na base do produtor. URL do webhook O campo deve ser preenchido com a URL de destisno fornecida pelo produtor. Webhook Chave O campo deve ser preenchido o nome da chave de cabeçalho do endpoint caso houver uma autenticação por token. Webhook Chave Valor O campo deve ser preenchido o token/segredo do endpoint caso houver uma autenticação por token. Tela de configuração Atenção: • Com a entrada de novos produtos e funções dentro do TMB, é possível que novos atributos sejam incluídos no Webhook. É muito importante que seu código esteja preparado para não gerar exceções caso a TMB devolva novos atributos não tratados pela sua aplicação, pois isso poderá causar interrupção na fila de sincronização. • Enviaremos um e-mail quando novos campos forem incluídos no Webhook. O disparo será feito para o e-mail do produtor.