Nesse endpoint, você aprenderá como realizar a integração com nossos Webhooks
O que são Webhooks?
Um webhook dentro da Hubiss, é um endereço endpoint que você deve apontar para receber nossas notificações quando recebe um novo pedido, quando o pedido recebe alteração e também o mesmo vale para os produtos, quando é cadastrado/atualizado.
Por quê eu devo cadastrar um webhook?
Se você faz cadastro de produtos na hubiss por API, provavelmente você já possui um sistema ERP para emissão de nota Fiscal, então você deve querer administrar os pedidos dentro do Sistema ERP, para não precisar ficar copiando as informações de forma manual.
Atenção
Atualmente possuímos 2 tópicos de notificações
Pedidos - Será notificado o endpoint determinado sempre que um novo pedido entre na plataforma ou receba alguma alteração vindo do Marketplace
Produtos - Será notificado sempre que um produto receba uma alteração de status ou estoque. (Ainda não implantado)
Veja abaixo os exemplos de notificação enviados via POST para os endpoints
{
"userId": "1",
"topic": "orders",
"resource": "orders/123",
"attempt": 1
}
Campos do Conteúdo postado
| Nome | Descrição | Exemplo | Opções Disponíveis |
|---|---|---|---|
| userId | Código identificador do usuário responsável pelo registro | 1 | varia |
| topic | Informa qual o tipo de notificação está sendo enviado | orders | orders | products |
| resource | Esse será o caminho mais completo que você terá para recuperar os registros posteriormente, eles podem variar de acordo com cada tópico, porém o formato nunca irá mudar. | orders/123 | varia |
| attempt | Informa qual o número da tentativa de notificação atual, caso tenha falhado anteriormente, irá tentar por até 10 vezes seguidas até falhar definitivamente. | 1 | varia |