Atualizações de situação de pedido
Informa ao integrador qualquer atualização na situação de pedidos de venda vinculados com a plataforma, ocorrida no Tiny.
Configurações
Acesse Menu → Configurações → Aba E-commerce → Integrações e selecione sua integração de testes.
Acesse a aba Webhook e informe a URL em que deseja receber as notificações no campo URL para envio de alteração na situação de pedidos.
Após a homologação da plataforma, as opções disponíveis para o usuário configurar serão as mesmas da integração de testes.
Payload enviado
| Elemento | Tipo | Tamanho | Ocorrência | Descrição | Exemplo |
|---|---|---|---|---|---|
| cnpj | string | - | obrigatório | CNPJ/CPF da conta Tiny que está enviando o payload | 48404755000188 |
| idEcommerce | int | - | obrigatório | Identificador do e-commerce em que o webhook foi configurado | - |
| tipo | string | - | obrigatório | Identificador do tipo do webhook | situacao_pedido |
| versao | string | - | obrigatório | Versão do webhook | 1.0.0 |
| dados | object | - | obrigatório | Elemento utilizado para representar os dados enviados pelo webhook | - |
| dados.idPedidoEcommerce | string | - | obrigatório | Identificador do pedido no integrador | - |
| dados.idVendaTiny | int | - | obrigatório | Identificador da venda no Tiny | - |
| dados.situacao | string | - | obrigatório | Código da nova situação do pedido conforme tabela de Situações dos Pedidos | aberto |
| dados.descricaoSituacao | string | - | obrigatório | Descrição da nova situação do pedido conforme tabela de Situações dos Pedidos | Em aberto |
Confirmação de recebimento
Para confirmar o recebimento da notificação na URL configurada, o webhook deverá retornar o status HTTP 200. Caso o sistema integrado não retorne o status de recebimento, o payload será enviado novamente.
O Tiny enviará o payload ao integrador até, no máximo, 15 vezes, com delay progressivo, aumentando em 5 minutos a cada tentativa.
