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

Envio de nota fiscal

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

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.

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 nota_fiscal
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.chaveAcesso string - obrigatório Chave de acesso da nota fiscal -
dados.numero string - obrigatório Número da nota fiscal -
dados.serie int - obrigatório Série da nota fiscal -
dados.urlDanfe string - obrigatório URL de acesso do DANFE da nota fiscal https://erp.tiny.com.br/doc.view?id=11111222223333
dados.idPedidoEcommerce string - obrigatório Identificador do pedido do e-commerce cadastrado na pedido do Tiny -
dados.dataEmissao date - obrigatório Data de emissão da nota fiscal -
dados.valorNota float - obrigatório Valor da nota fiscal -
dados.idNotaFiscalTiny int - obrigatório Identificador da nota fiscal no Tiny -

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.

Elemento Tipo Tamanho Ocorrência Descrição Exemplo
error string - opcional Erro retornado pelo integrador a ser exibido para o usuário -