GuiasAPIs

VTEX

Este guia é destinado a e-commerces que utilizam a plataforma VTEX e desejam adicionar o Tino como meio de pagamento. Ele aborda a necessidade de instalar o plugin, além de detalhar como cada fluxo operacional é gerenciado na integração com a VTEX.

1. Instalação do Plugin Tino para VTEXCopied!

Para que sua loja utilize todas as funcionalidades do Tino na VTEX, é necessário instalar o plugin Tino. Essa instalação é simples e envolve três etapas principais: instalação do aplicativo, configuração das credenciais fornecidas pelo Tino e configuração do meio de pagamento na VTEX.

Atenção: Certifique-se de que o plugin esteja corretamente instalado e configurado antes de continuar com os fluxos operacionais descritos neste guia.

Para mais informações e um passo a passo detalhado dessa configuração, acesse o Guia de Instalação do Plugin Tino na VTEX.

2. Fluxos OperacionaisCopied!

Após a instalação e configuração do plugin, o Tino automatiza diversos processos relacionados ao ciclo de vida de um pedido. Confira abaixo como cada fluxo é operacionalizado na integração com VTEX.

2.1 Cadastro do Comprador

O cadastro do comprador é essencial para liberar crédito e garantir a emissão de comunicações relacionadas aos pagamentos e cobranças.

Como funciona na VTEX:

  • O cadastro é realizado diretamente no fluxo de compra, de forma rápida e integrada.

Para saber mais: Consulte a página específica sobre Cadastro do Comprador.

2.2 Fluxo de Compra e Reservas de Limite

Após a confirmação do pagamento pelo Tino, uma Reserva de Limite é criada para o valor da compra. Essa reserva garante que o crédito disponível do comprador seja utilizado exclusivamente para o pedido até que a dívida seja quitada.

Operacionalização na VTEX:

  • A integração com o plugin VTEX automatiza:

    • Realização da compra.

    • Experiência de parcelamento.

    • Atualização do status do pedido no painel VTEX.

  • Não é necessário interagir diretamente com endpoints, pois o plugin gerencia essas chamadas automaticamente.

Para mais informações: Acesse a página específica sobre Criação de Pedido.

2.3 Cancelamento de Pedidos

Pedidos que ainda não possuem notas fiscais emitidas podem ser cancelados diretamente na VTEX.

Como funciona:

  • O cancelamento do pedido libera automaticamente o limite do comprador.

  • O status do pedido é atualizado no painel VTEX e no Tino.

  • O lojista é notificado automaticamente sobre o cancelamento.

Atenção: Se uma Nota Fiscal já tiver sido enviada, será necessário realizar o reembolso (veja o item 2.5). Para informações mais detalhadas, consulte a página específica sobre Cancelamentos.

2.4 Envio de Nota Fiscal

A emissão de notas fiscais é essencial para o processamento de boletos pelo Tino.

Integração via VTEX:

  1. Após a confirmação do pagamento, o pedido aparece no painel VTEX.

  2. O fornecedor emite a Nota Fiscal e a envia normalmente via VTEX ou ERP integrado com a VTEX.

  3. A integração do Tino captura automaticamente o XML da Nota Fiscal (campo embeddedInvoice).

  4. O boleto correspondente é gerado para o comprador.

Requisito: Certifique-se de que o campo embeddedInvoice esteja sendo preenchido corretamente na estrutura da order da VTEX. Caso contrário, entre em contato com o suporte do Tino em integracoes@tino.com.br.

Para mais detalhes: Veja a página específica sobre Envio de Nota Fiscal.

2.5 Reembolso e Ajustes

Reembolsos podem ser realizados de duas formas: cancelamento total da Nota Fiscal ou edição do valor (reembolso parcial).

Como funciona na VTEX:

  1. Realize o cancelamento ou ajuste diretamente no painel VTEX.

  2. O plugin Tino captura automaticamente as alterações e atualiza o status das cobranças.

  3. Não é necessário interagir diretamente com o Tino.

Importante:

  • Reembolsos interrompem automaticamente cobranças relacionadas à Nota Fiscal.

  • Se o pagamento já tiver sido realizado, o valor será devolvido ao comprador.

  • Caso o repasse ao fornecedor já tenha ocorrido, o valor será descontado no próximo repasse.

Para informações completas: Acesse a página específica sobre Reembolsos.

2.6 Conciliação

A conciliação é essencial para a gestão financeira e contábil. Apesar de não ser automatizada pela VTEX, o Tino oferece ferramentas como o Portal Tino e as APIs de Relatórios, que permitem um controle completo das transações.

Como funciona:

  • Relatórios podem ser acessados pelo Portal Tino.

  • As APIs do Tino permitem:

    • Download de relatórios contábeis e financeiros em formato CSV.

    • Obtenção de dados em formato JSON.

Para mais informações: Acesse a página específica sobre Conciliação.

3. Suporte e Recursos AdicionaisCopied!

Se precisar de ajuda ou mais informações sobre os fluxos operacionais, entre em contato com nosso suporte técnico:

Documentação Complementar: