Webhooks API 2.0

Fluxo

Após criar sua conta no Tiny, envie um e-mail para integracao@tiny.com.br informando que deseja utilizar o serviço de webhooks, enviando o cpf/cnpj de sua conta de testes. Os passos para o processo de desenvolvimento da integração via webhook serão enviados por e-mail.

Ao finalizar o desenvolvimento de sua integração, entre em contato com o e-mail integracao@tiny.com.br para que seja realizado o processo de homologação e disponibilização da estrutura de webhooks aos usuários Tiny que integram com sua plataforma.

Atualizações de estoque

Informa ao integrador qualquer modificação de estoque ocorrida no Tiny para produtos mapeados com a plataforma configurada.

Configurações

1

Acesse Menu → Configurações → Aba E-commerce → Integrações e selecione sua integração de testes.

2

Acesse a aba Configurações e informe os valores desejados nos campos da seção Regras de estoque.

3

Acesse a aba Webhook e informe a URL em que deseja receber as notificações no campo URL de notificações do estoque.

Payload enviado

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.

Envio de produtos

Envia ao integrador os dados do produto cadastrado no Tiny, no momento da ação do seller de enviar produtos para o e-commerce. Cada produto é enviado individualmente.

Configurações

1

Acesse Menu → Configurações → Aba E-commerce → Integrações e selecione sua integração de testes.

2

Acesse a aba Configurações e informe os valores desejados nos campos da seção Sincronização de produtos.

3

Acesse a aba Webhook e informe a URL em que deseja receber as notificações no campo URL para envio de produtos.

Payload enviado

Confirmação de recebimento

O envio é síncrono, ou seja, o Tiny espera o retorno do integrador no momento do envio.

Para confirmar o recebimento da notificação na URL configurada, o webhook deverá retornar o status HTTP 200 e o payload exibido abaixo. Cada item no array se refere à um item do payload do envio, considerando o produto pai e suas variações.

Caso o sistema integrado não retorne o status de recebimento, o payload será enviado novamente. São realizadas no máximo 2 tentativas de envio. Qualquer código de retorno fora da faixa HTTP 200 é considerado como erro e o mapeamento para o produto é rejeitado pelo Tiny.

Envio de Código de Rastreio

Envia o código de rastreio cadastrado em um pedido para o e-commerce.

Configurações

1

Acesse Menu → Configurações → Aba E-commerce → Integrações e selecione sua integração de testes.

2

Acesse a aba Notificações e informe a URL em que deseja receber as notificações no campo URL para envio do rastreio.

Payload enviado

Confirmação de recebimento

O envio é síncrono, ou seja, o Tiny espera o retorno do integrador no momento do envio.

Para confirmar o recebimento da notificação na URL configurada, o webhook deverá retornar o status HTTP 200 e o payload exibido abaixo.

Caso o sistema integrado não retorne o status de recebimento, o payload será enviado novamente. São realizadas no máximo 2 tentativas de envio. Qualquer código de retorno fora da faixa HTTP 200 é considerado como erro e o envio do rastreio é rejeitado pelo Tiny.

Envio de nota fiscal

Envia ao integrador os dados da nota fiscal de um pedido.

Configurações

1

Acesse Menu → Configurações → Aba E-commerce → Integrações e selecione sua integração de testes.

2

Acesse a aba Notificações e informe a URL em que deseja receber as notificações no campo URL para envio da nota fiscal.

Payload enviado

Confirmação de recebimento

O envio é síncrono, ou seja, o Tiny espera o retorno do integrador no momento do envio.

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. São realizadas no máximo 2 tentativas de envio. Qualquer código de retorno fora da faixa HTTP 200 é considerado como erro e o envio da nota fiscal é rejeitado pelo Tiny.

Envio de preços de produtos

Envia ao integrador os dados de preços de produtos cadastrados no Tiny. Cada produto é enviado individualmente.

Configurações

1

Acesse Menu → Configurações → Aba E-commerce → Integrações e selecione sua integração de testes.

2

Acesse a aba Webhook e informe a URL em que deseja receber as notificações no campo URL para envio dos preços.

Payload enviado

Confirmação de recebimento

O envio é síncrono, ou seja, o Tiny espera o retorno do integrador no momento do envio.

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. São realizadas no máximo 2 tentativas de envio. Qualquer código de retorno fora da faixa HTTP 200 é considerado como erro e o mapeamento para o produto é rejeitado pelo Tiny.

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

1

Acesse Menu → Configurações → Aba E-commerce → Integrações e selecione sua integração de testes.

2

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.

Payload enviado

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.