GuiasAPIs

Envio de Notas Fiscais

O envio das notas fiscais referentes a um pedido ocorre após a confirmação do pagamento, e é feito pelo Fornecedor. Este processo pode ser realizado via API do Tino, através da integração nativa com a VTEX ou via No Code.

Escolha a forma de envio:

  • Via API: Ideal para quem deseja integrar diretamente com o Tino. Saiba mais.

  • Via VTEX: Para usuários da plataforma VTEX com integração nativa. Saiba mais.

  • Via No Code: Via portal do Tino. Saiba mais.

Conceitos BásicosCopied!

Quando um pagamento usando o Tino é confirmado, criamos uma Reserva de Limite, que indica que o crédito da pessoa compradora equivalente ao valor da compra foi reservado e não pode ser usado em outras compras até que quite sua dívida — ou até que a reserva seja expirada, ou até mesmo via Cancelamento de pedido autorizado.

Para todos os tipos de integração:

  • O prazo que o comprador tem para pagar ao Tino começa a partir da data de emissão das notas, e não de seu envio;

  • Cada nota enviada se torna um ou mais boletos para o comprador, que deve pagá-lo de acordo com a opção de parcelamento escolhida;

  • O Fornecedor tem até 15 dias após a data de emissão da nota fiscal para enviá-la. Caso esse prazo seja excedido, é necessário entrar em contato com o suporte de integração;

  • O Fornecedor pode optar por:

    • Envio total: envio de todas as notas de uma vez, podendo ser uma só;

    • Envio parcial: envio das múltiplas notas de um pedido notas de forma faseada;

  • A expiração do pedido é configurável pelo Fornecedor:

    • O Fornecedor pode escolher se deseja que os pedidos expirem em um prazo determinado, ou não;

    • Esta configuração é independente do prazo de 15 dias para envio da nota fiscal, ou seja, pode-se determinar que o pedido expire em qualquer data, mas a nota fiscal deve ser enviada ao tino em até 15 dias após a emissão da nota fiscal.

Ajuste de Valor na Nota FiscalCopied!

Se precisar ajustar o valor devido a alterações no pedido, é só enviar a nota fiscal com o valor correto. É possível faturar até 5% acima ou qualquer valor abaixo do valor da reserva.

Exemplos:

  1. Reserva: R$ 1.000, item de R$ 50 indisponível → Nota única de R$ 950 → R$ 50 devolvidos ao limite.

  2. Reserva: R$ 1.000, item de R$ 50 indisponível → Notas de R$ 500 e R$ 450 → Total de R$ 950 → R$ 50 devolvidos ao limite.

Envio via APICopied!

O envio de notas fiscais via API do Tino permite um processo simples e eficiente, com as seguintes características:

  • Envio de XMLs:

    O fornecedor pode enviar os XMLs das notas fiscais diretamente para o Tino através de uma chamada à API. É possível enviar uma ou mais notas fiscais relacionadas a um mesmo pedido.

  • Processamento Automático:

    Cada nota enviada via API é processada automaticamente, gerando um ou mais boletos para o comprador de forma imediata.

  • Gestão de Reservas:

    Caso nenhuma nota fiscal seja enviada e o Fornecedor tenha configurado essa opção, a Reserva de Limite pode ser expirada automaticamente após o prazo estabelecido.

Para mais informações sobre endpoints, payloads e exemplos de requisição, consulte nossa documentação detalhada da API.

Consulte também como realizar reembolsos ou cancelamentos de notas fiscais na seção de próximos passos.

Envio via VTEXCopied!

Para Fornecedores que utilizam a VTEX, o Tino oferece uma integração nativa que automatiza o processo de envio das notas fiscais:

  1. Após a confirmação do pagamento pelo Tino, o pedido fica disponível no painel da VTEX;

  2. O Fornecedor emite a nota fiscal e faz o envio através do painel VTEX ou através da integração de seu ERP com a VTEX;

  3. A integração do Tino captura automaticamente as notas fiscais que chegam na VTEX;

  4. Os boletos são gerados automaticamente para o comprador conforme as notas fiscais são processadas.

Requisitos para Integração VTEX

  • É desejável que o XML da nota fiscal seja enviado no campo embeddedInvoice da estrutura da order da VTEX.

  • Este campo é essencial para o funcionamento correto da integração, pois é a partir dele que o Tino captura as informações da nota fiscal

  • Caso esse campo não esteja sendo preenchido é necessário entrar em contato com o suporte do Tino para ser discutida possíveis soluções

E-mail de contato para suporte: integracoes@tino.com.br

Benefícios da integração VTEX:

  • Não é necessário desenvolvimento adicional

  • Processo totalmente integrado ao fluxo normal da VTEX

  • Captura automática das notas fiscais

Importante: Em ambos os casos, o prazo para pagamento começa a contar a partir da data de emissão da nota fiscal, independentemente do momento do envio ou captura pelo sistema.

Próximos PassosCopied!

Para informações sobre como realizar reembolsos ou cancelamentos de notas fiscais, consulte nossa documentação de reembolso e cancelamento.