Descrição
Webhook é uma tecnologia utilizada para permitir a comunicação entre duas aplicações e enviar notificações quase em tempo real. O envio ou o recebimento de dados é disparado quando determinado evento acontecer em uma das aplicações.
Atualmente na Moovin temos a opção de configuração para webhook de pedidos, disparando uma notificação assim que o pedido assumir algum status definido.
Configurando
Acesse o seu painel administrativo da Moovin e navegue até o menu Configurações>Webhook. Na tela seguinte, clique na opção cadastrar localizada no canto superior direito da tela.
Clique na imagem para ampliar.
Clique na imagem para ampliar.
Agora preencha os campos para configuração de seu webhook de acordo com a sua integração.
Nome: Defina um nome para a aplicação.
Status: Ativo/Inativo.
URL Destino: Insira a URL na qual a Moovin deverá enviar a notificação
Método: POST/GET/PUT ou DELETE
Escopo: Pedido
Status/Notificação: Selecione apenas os status de pedidos na qual deseja que seja enviado a notificação quando o pedido assumir este estado.
Notificação/Retorno
A notificação disparada pela Moovin no escopo de pedidos terá um corpo JSON idêntico ao retorno do método getPedidos, sendo eles os campos abaixo:
{
"pedidos": [
{
"codigo_pedido": "39077",
"data": "2019-12-23 13:53:30",
"data_ultima_atualizacao": "2019-12-23 13:53:31",
"codigo_forma_pagamento": "33",
"nome_forma_pagamento": "Pagamento Netshoes - Netshoes",
"loja_venda": "",
"nome_loja_pagamento": "E-commerce",
"codigo_status_pedido": "2",
"descricao_loja_status_pedido": "Pendente",
"descricao_cliente_status_pedido": "Pendente",
"status_transacao": "Pendente",
"pagamento_efetuado": "N",
"parcelas": "1",
"valor_acrescimo": "10.00",
"valor_parcial": "99.89",
"valor_total": "113.89",
"valor_frete": "14.00",
"valor_presente": "0.00",
"valor_taxa_gateway": "",
"forma_pagamento_sistema_pagamento": "",
"desconto_bonus": "0.00",
"desconto_pontos": "0.00",
"desconto_vlr_compra": "0.00",
"desconto_num_pedidos": "0.00",
"desconto_cupom": "0.00",
"clearsale_score": "",
"codigo_cupom_desconto": "",
"desconto_total": "0.00",
"cliente_ip": "",
"qtd_itens": "1",
"separado_por_usuario": "",
"data_separado": "0000-00-00 00:00:00",
"navegador": "",
"navegador_versao": "",
"sistema_operacional": "",
"mobile": "0",
"meio_ambiente": "0",
"pagamento_venc_boleto": "0000-00-00",
"importado": "0",
"campanha_id": "58",
"campanha_ident": "marketplace.netshoes",
"pagamento_identificador": "36488046",
"codigo_revendedor": "",
"pedido_troca" "N",
"numero_pedido_troca": "",
"taxa_marketplace": "0.00",
"taxa_frete_marketplace": "0.00",
"itens": {
"item": [
{
"codigo": "10.3318.37",
"produto_codigo": "6365667302",
"produto_codigo_cor": "6365667302427",
"produto_codigo_tamanho": "10.3318.37",
"qtd": "1",
"cor": "Napa Rosa",
"tamanho": "37",
"brinde": "0",
"nome_loja": "E-commerce",
"cod_loja": "1",
"valor": "99.89",
"valor_pago": "99.89",
"prazo_entrega_extra": "0",
"nfe_ncm": "",
"nfe_origem": "0",
"peso": "1000",
"presente": "N",
"pre_venda": "N",
"personalizacao": "",
"data_envio_pre_venda": "0000-00-00",
"descricao": "Ref: 5667302 | Tam.: 37 | TÊNIS MOLECA FEMININO | Cor: NAPA ROSA",
"id_marketplace_item": ""
}
]
},
"cliente": {
"codigo": "40897",
"nome": "Teste Moovin LTDA",
"telefone_residencial": "(77)777777777",
"telefone_celular": "(77)777777777",
"telefone_comercial": "",
"cpf_cnpj": "012345678910",
"email": "3089d11903282cda1ce06cfaa76ecb0c@netshoes.com.br",
"data_nasc": "2019-12-23"
},
"dados_entrega": {
"nome": "Teste de Destinatario",
"rg": "",
"endereco": "Avenida Inacio Berwian",
"numero": "700",
"complemento": "123456",
"instrucoes": "Morada do Sol",
"bairro": "Morada do Sol",
"cep": "95775000",
"cidade": "TUPANDI",
"estado": "RS",
"email": "3089d11903282cda1ce06cfaa76ecb0c@netshoes.com.br",
"telefone_residencial": "(77)777777777",
"telefone_celular": "(88)888888888",
"telefone_comercial": ""
},
"dados_transacao": {
"transacao": [
{
"data": "0000-00-00",
"cod_forma_pagamento": "33",
"forma_pagamento": "Pagamento Netshoes - Netshoes",
"parcelas": "1",
"gateway": "0",
"valor_total": "113.89",
"vencimento_boleto": "0000-00-00",
"mensagem_retorno": "",
"codigo_retorno": "",
"num_autorizacao": "",
"num_transacao": "",
"ident": "799995948",
"adquirente": "",
"num_comp_venda": "",
"data_pagamento": "2019-12-23 13:53:31",
"data_aprovacao": ""
}
]
},
"dados_transporte": {
"modalidade": "Sedex",
"codigo_rastreio": "",
"valor_transporte": "14.00",
"prazo_entrega": "5",
"codigo_transportadora": "4",
"tipo": "Expresso",
"data_postagem": "0000-00-00 00:00:00",
"data_entrega": "0000-00-00"
}
}
]
}
Mais sobre Webservice
Consulte nossa tabela de retorno aqui.
Não conhece todos os métodos webservice da Moovin? Veja nossa lista completa aqui.
Caso tenha dúvidas em como realizar o envio ou formatos de envio, veja nesta nossa documentação aqui.