Integração customizável com seu próprio sistema (Webhook)

Tipo de integração

Saída:  esta integração envia dados do TudoNet para uma ferramenta de destino especificada na configuração.
 

O que essa integração faz?

Esta configuração permite enviar dados do TudoNet para outras ferramentas que possuem um URL de entrada de dados.  Esta URL deve ser capaz de ler e consumir dados enviados por POST no formato JSON .
 

Observações e requisitos

  • Ter a URL do outro sistema que receberá via POST os dados no formato JSON;
  • Para URLs customizadas, é importante ter um desenvolvedor ou entrar em contato com o suporte do seu outro sistema para verificar a compatibilidade com a leitura dos pacotes de dados que o TudoNet envia.

Passo a passo para realizar a integração

  1. Em aplicativos na página inicial
  2. Clique em Webhook. Campo a ser preenchido:
  3. Ativar notificações: Ativar
  4. URL de notificação: Cole sua url (com https://)
  5. Ao clicar no  botão Salvar .
  6. Se a integração estiver funcionando corretamente, irá guardar com sucesso e irá receber notificações


Importante

A notificação de resposta negativa indica que a URL de destino não representa um servidor disponível (está incorreta)  ou  que o servidor de destino não possui certificado de segurança, que é necessário para ser validado pelo nosso webhook. Em ambos os casos, o ideal é validar esses pontos com seu desenvolvedor ou com o suporte da ferramenta que lhe forneceu a URL.

Exemplo de dados enviados pelo TudoNet

Os dados serão enviados de acordo com a seguinte estrutura, que é a de um JSON padrão:

Novo Pedido recebido:

{
  "evento": "nova_venda",
  "data": "05/02/2024 10:00",
  "venda": {
    "data": "2024-02-05 10:00:24",
    "total_produtos": "99,90",
    "total_desconto": "0,00",
    "total_taxas": "0,00",
    "total_venda": "99,90",
    "total_items": "1,00",
    "total_quantidade": "1,00",
    "pago": "0,00",
    "status_pagamento": "Não pago",
    "vendedor": "",
    "id_venda": "1234",
    "id_venda_completo": "a31eXXXXYYYYaaa222",
    "status_venda": "Aguardando Aprovação",
    "plataforma": "pedidos",
    "total_frete": "0,00",
    "url_pedido": "https://pedi.do/XXXXXX/p/a31eXXXXYYYYaaa222",
    "adicionais": "\n\nForma de pagamento escolhida: Pix, \n"
  },
  "produtos": [
    {
      "codigo": "7804300137366",
      "nome": "VINHO CHILENO TINTO SECO SAN PEDRO GATO NEGRO PINOT NOIR VALLE CENTRAL GARRAFA 750ML",
      "valor_unidade": "99,90",
      "valor_total": "99,90",
      "quantidade": "1",
      "adicional": ""
    }
  ],
  "cliente": {
    "cliente_id": "12345",
    "cliente_nome": "NOME DO CLIENTE",
    "cliente_whatsapp": "11988887777",
    "cliente_documento": "01234567890" 
  },
  "frete": {
    "endereco_completo": "RUA DE TESTE, 123 - BAIRRO,  (COMPLEMENTO)"
  }
}

Atualizações de pedidos:

{
  "evento": "atualizacao_venda",
  "data": "05/02/2024 10:10",
  "venda": {
    "id_venda": "1234",
    "id_venda_completo": "a31eXXXXYYYYaaa222",
    "status_venda": "Aguardando Pagamento"
  },
  "cliente": {
    "cliente_id": "12345",
    "cliente_nome": "NOME DO CLIENTE",
    "cliente_whatsapp": "11988887777",
    "cliente_documento": "01234567890" 
  },
}

Atualizações futura:

As atualizações e novos tipos de notificações serão publicados nessa página.

Rolar para cima