Você está usando um navegador que não é suportado pelo Tiny. Saiba mais

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.

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.

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. Os dados serão enviados ao webhook conforme as configurações selecionadas pelo usuário.

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 produto
versao string - obrigatório Versão do Webhook 1.0.0
dados object - obrigatório Elemento utilizado para representar os dados enviados pelo webhook Baixar exemplo de payload de produto

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.

Elemento Tipo Tamanho Ocorrência Descrição Exemplo
mapeamentos[] array - obrigatório Lista que engloba os itens a serem retornados Baixar exemplo de retorno
mapeamentos[].mapeamento object - obrigatório Elemento utilizado para representar o retorno relacionado a um mapeamento -
mapeamentos[].mapeamento.idMapeamento int - obrigatório Identificador do produto/variação no Tiny -
mapeamentos[].mapeamento.skuMapeamento string - obrigatório Identificador do produto na plataforma do integrador, utilizado para criar o mapeamento no Tiny -
mapeamentos[].mapeamento.urlProduto string - opcional URL do produto na loja -
mapeamentos[].mapeamento.urlImagem string - opcional URL da imagem principal do produto na loja -
mapeamentos[].mapeamento.error string - opcional Erro retornado pelo integrador a ser exibido para o usuário -

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.