> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teceo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# formas de pagamento

## o que são as formas de pagamento

nem todo cliente compra nas mesmas condições. uma loja pode pagar à vista com desconto, outra prefere boleto parcelado, outra ainda negocia um prazo maior por já ter um histórico de relacionamento com a marca. sem controle sobre isso, cada negociação vira uma exceção manual.

é para isso que existem as formas de pagamento na teceo: as condições de pagamento que a marca cadastra e disponibiliza, para que sejam escolhidas no momento do pedido, seguindo as regras que a própria marca definiu.

## a condição certa, disponível na hora certa

a marca cadastra as formas de pagamento que aceita, como à vista, boleto em parcelas ou uma condição especial para um determinado prazo. no momento de fechar o pedido, o cliente escolhe entre as opções disponíveis para ele, sem precisar negociar isso separadamente com o vendedor.

isso agiliza o fechamento do pedido, porque a condição comercial já está pronta para ser escolhida, em vez de depender de uma conversa à parte.

## nem toda forma de pagamento é para todo mundo

a marca pode restringir quais formas de pagamento ficam disponíveis para quais clientes, de acordo com o perfil, o histórico ou a condição comercial acordada com cada um. assim, um cliente novo pode ter opções diferentes de um cliente com anos de relacionamento e limite de crédito já estabelecido.

a marca mantém o controle sobre o risco de cada negociação, sem abrir a mesma condição para todos indistintamente.

as formas de pagamento são o que transforma a negociação comercial em algo já configurado dentro do pedido, deixando claro, para cada cliente, como ele pode pagar antes mesmo de perguntar.

## criar uma forma de pagamento

1. **abra o cadastro**

   em configurações, abra [**formas de pagamento**](https://app.teceo.co/settings/payment-methods) e clique em **criar forma de pagamento**.

2. **opcional: marque restringir as políticas comerciais**

   fica no alto do cadastro e condiciona a forma a uma política. o efeito está em [restringir a forma às políticas](#restringir-a-forma-às-políticas).

3. **escolha o meio de pagamento**

   selecione boleto, cartão de crédito, transferência, cheque ou pix. o meio classifica a forma e decide se as opções de [pagamento pelo gateway](#exigir-o-pagamento-pelo-gateway-da-teceo) aparecem no cadastro.

4. **informe o código e o nome**

   os dois identificam a forma e não podem se repetir entre as formas da sua marca, na criação e na edição. duas formas que só diferem por acento são consideradas iguais, e a plataforma recusa o salvamento informando qual forma já usa aquele código ou aquele nome.

5. **marque as disponibilidades**

   selecione ao menos uma entre pré-venda, pronta-entrega, estoque-futuro e matéria-prima. a forma é recusada no pedido cuja disponibilidade ela não cobre.

6. **defina os perfis com acesso**

   administrador da marca vem marcado. marque também lojista e vendedor(a) conforme quem vai usar a forma. na finalização, o pedido é recusado quando quem aplicou a forma tem um perfil fora da lista.

7. **opcional: preencha as observações**

   é o campo livre para registrar as condições combinadas, como prazo ou parcelamento acordado.

8. **preencha o código do desconto e o desconto no pedido**

   os dois já vêm preenchidos com 0, e o código do desconto precisa continuar preenchido: apagá-lo impede o salvamento. o desconto no pedido aceita de 0 a 100.

9. **opcional: informe o juros acumulado no pedido**

   o campo só aparece quando habilitar juros acumulados nas formas de pagamento está ligado em definições gerais. a mesma forma não aceita desconto e juros ao mesmo tempo: com os dois maiores que zero, a plataforma recusa com não é possível preencher desconto e juros ao mesmo tempo.

10. **opcional: informe a etiqueta**

    é o texto curto que acompanha a forma, com até 15 caracteres.

11. **decida se a forma já entra em uso**

    forma de pagamento ativa? vem marcado. desmarque para preparar a forma antes de liberá-la: enquanto estiver inativa, ela não é oferecida no fechamento do pedido. a forma inativada depois de já ter sido escolhida continua no pedido que a usou.

12. **clique em salvar**

## exigir o pagamento pelo gateway da teceo

as opções de pagamento dentro da plataforma aparecem no cadastro quando o meio de pagamento é cartão de crédito ou pix e a sua marca tem um gateway de pagamento configurado. em marcas integradas ao sistema de gestão as opções não aparecem com pix, e continuam aparecendo com cartão de crédito.

1. **marque exigir pagamento via gateway dentro da teceo.**

   o pagamento só fica liberado depois da aprovação do administrador da marca no tipo de pedido correspondente, e a cobrança é enviada manualmente pelo administrador da marca ou pelo representante.

2. **escolha em definir pagamento por**

   * para cobrar o valor inteiro do pedido, selecione **valor integral**.
   * para cobrar uma entrada e deixar o restante para depois, selecione **valor parcial**, preencha o valor mínimo, em percentual, e escolha o pagamento complementar entre onze opções.

3. **defina o número máximo de parcelas**

   aceita de 1 a 12. no pix o valor é sempre 1.

trocar para valor integral limpa o valor mínimo e o pagamento complementar no salvamento.

<Accordion title="exemplo, valor parcial com mínimo de 30%">
  forma de pagamento com **valor parcial**, valor mínimo **30%** e pagamento complementar **boleto bancário direto**.

  num pedido de R\$ 1.000:

  * R\$ 300 é o quanto o gateway cobra, por ser o mínimo de 30%.
  * R\$ 700 fica para o pagamento complementar, que é o boleto.

  o mesmo cadastro com **valor integral** cobraria os R\$ 1.000 pelo gateway, e o valor mínimo e o pagamento complementar não seriam preenchidos.
</Accordion>

## quais formas o cliente enxerga no pedido

* o cliente com formas de pagamento próprias enxerga só as dele, e as do grupo não têm efeito. um vínculo no cadastro dele já faz isso valer, qualquer que seja a forma vinculada.
* o cliente sem formas próprias enxerga as do grupo.
* quando nem o cliente nem o grupo têm formas vinculadas, o cliente enxerga todas as formas ativas da sua marca.

em qualquer um dos três níveis a lista já vem filtrada pelas formas ativas da marca do pedido.

as formas próprias são definidas no [cadastro do cliente](/docs/clientes/criar-um-cliente-v2), que avisa: defina formas de pagamento somente se desejar associá-las a este cliente em específico (irá prevalecer sobre qualquer definição de grupo). as do grupo são definidas na aba regras do [grupo de clientes](/docs/configuracoes/grupos-de-clientes), e o grupo sem nenhuma forma vinculada aparece como sem restrição de formas de pagamento.

## restringir a forma às políticas

* com restringir as políticas comerciais desmarcada, a forma aparece sempre, respeitada a ordem de vínculo.
* marcada, a forma só aparece quando uma política a libera, e uma única política que cumpra os critérios é suficiente.

a forma restrita sem nenhuma política que a libere não é listada no pedido, e isso é o resultado esperado da marcação: ela existe para ser liberada caso a caso. o que a política precisa cumprir e como montá-la estão em [liberar formas de pagamento](/docs/politicas/liberar-formas-de-pagamento).

## editar, ativar e inativar

na lista, clique em qualquer informação da linha para abrir o cadastro. é o mesmo formulário da criação, com a aba única **dados gerais**.

as colunas ativo e restrição às políticas são botões: clique nelas para alterar a forma na própria linha, sem confirmação.

para alterar várias ao mesmo tempo, selecione as linhas e use **ativar formas de pagamento** ou **inativar formas de pagamento**. as duas pedem confirmação, e o efeito na lista não é imediato. ativar e inativar são as únicas ações em massa da tela.

## excluir uma forma de pagamento

na lista, use a ação de excluir na linha da forma. na confirmação deseja excluir?, clique em **continuar**.

<Warning>
  a exclusão é definitiva. não há como desfazer.
</Warning>

a forma em uso não é excluída, e a plataforma informa qual vínculo impediu: condições de pedido, clientes ou grupos de clientes. a ação aparece na linha mesmo nas formas que não podem ser excluídas. o vínculo com política é apagado junto e não impede nada.

para deixar de oferecer uma forma que não pode ser excluída, desmarque forma de pagamento ativa?.

## encontrar uma forma na lista

a lista traz código, nome, meio de pagamento, disponibilidade, perfis com acesso, desconto, juros, etiqueta, restrição às políticas e ativo, nessa ordem. as formas mais recentes vêm no topo, e a lista carrega 20 por vez conforme a rolagem avança.

* o campo de busca procura pelo nome ou pelo código da forma de pagamento.
* clique no cabeçalho para ordenar por código, nome, desconto ou juros. as demais colunas não ordenam.
* os filtros de meio de pagamento, disponibilidade e perfis com acesso reduzem a lista pelos mesmos valores do cadastro.
* os filtros de etiqueta da forma de pagamento, desconto na forma de pagamento, juros na forma de pagamento e restrição às políticas separam as formas que têm cada um daquelas que não têm.
* status da forma de pagamento separa ativas de inativas, e pagamento na teceo separa as que cobram por valor integral das que cobram por valor parcial.
* a escolha de quais colunas aparecem fica salva e vale nos próximos acessos. restrição às políticas vem oculta, e código e nome não podem ser ocultados.

## a forma de pagamento e o seu sistema de gestão

o pedido enviado ao sistema de gestão leva o código, o nome, o desconto, o código do desconto, o juros, a disponibilidade e o pagamento complementar da forma.

na importação de pedidos, a teceo identifica a forma pelo código, ignorando zeros à esquerda e acentos. sem uma forma cadastrada com aquele código, a importação acusa erro.

o código do desconto é o que identifica o desconto no sistema de gestão: quando houver desconto, ele precisa ser o que existe lá, e o percentual precisa corresponder ao que aquele código representa. conforme a integração da sua marca, o envio do pedido falha quando há desconto e o código do desconto está zerado.

o meio de pagamento não participa dessa correspondência: ele classifica a forma dentro da teceo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.