📘 Visão geral
Este serviço permite que o seu sistema receba atualizações automáticas sempre que houver alterações no status do pedido ou quando um código de rastreio for gerado ou atualizado.
A comunicação é realizada por meio de webhooks, garantindo:
⚡ Sincronização em tempo real
🔄 Redução da necessidade de consultas manuais à API
🛡️ Maior confiabilidade operacional
🔗 O que são webhooks?
Webhooks são chamadas HTTP enviadas automaticamente para uma URL configurada por você sempre que um evento específico acontece no sistema.
📦 Eventos disponíveis
Atualmente, o serviço disponibiliza dois tipos de eventos:
1️⃣ Atualização de status do pedido
Após a geração da relação de volumes, os pedidos seguem para o status Despachado no Enviando.
Em seguida, os pedidos aguardam 30 minutos até que a tarefa recursiva sync_dispatched seja executada.
Essa tarefa:
🔄 Atualiza o status do pedido para Sincronizado no Enviando
🔁 Sincroniza o pedido com o Bling, alterando o status do pedido no Bling para Verificado
Sempre que o status de um pedido for alterado (exemplo: Despachado), você receberá uma notificação na URL de sincronização de status do pedido, com o seguinte payload:
📄 Exemplo :
{
"order": "102030",
"account_slug": "enviando",
"dispatch_number": 18689,
"status": "DISPATCHED"
}📝 Observação: Após cadastrar as URLs, é possível executar a tarefa recursiva manualmente para validar o recebimento das informações, sem a necessidade de aguardar os 30 minutos.
2️⃣ Atualização de código de rastreio
Após o pedido ser sincronizado (conforme descrito na etapa anterior), ele aguardará 60 minutos até que a tarefa recursiva sync_tracking_codes seja executada.
Quando essa tarefa for concluída, o código de rastreio será enviado para a URL de sincronização de rastreio do pedido, no formato abaixo:
📄 Exemplo
{
"order": "102030",
"account_slug": "enviando",
"tracking_code": "YD20002026BR",
"service_id": "14892711129"
}📝 Observação: Após cadastrar as URLs, você também pode executar a tarefa recursiva manualmente para validar o recebimento das informações, sem precisar aguardar os 60 minutos.
⚙️ Requisitos para utilização
Para utilizar o serviço de webhooks, é necessário cumprir os passos abaixo:
1️⃣ Configurar as URLs de sincronização
No painel de configuração da conta do Enviando, informe as duas URLs de sincronização ou apenas a URL correspondente ao tipo de evento que deseja receber.
🔔 URL de sincronização de status do pedido
Endpoint que receberá os eventos de mudança de status.
📍 Caminho no Enviando :
Configuração > Contas > Editar
📦 URL de sincronização de rastreio do pedido
Endpoint que receberá os eventos relacionados ao código de rastreio.
💬 Precisa de ajuda?
Nossa equipe está pronta para ajudar 💙