> ## 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.

# referência das definições gerais

cada seção de configuração da marca, com os campos, os valores aceitos e o valor padrão.

## as regras do pedido

### divisão do pedido

os critérios escolhidos aqui são os mesmos que separam o pedido em divisões, descritos em [as divisões e as condições do pedido](/docs/pedidos/as-divisoes-e-as-condicoes-do-pedido-v2).

| campo | o que faz | valores |
| - | - | - |
| tipos de divisão do pedido | define em quantos pedidos o pedido se quebra ao ser finalizado, e por qual critério | seleção múltipla com as opções disponibilidade, janela de entrega e um item por tipo de classificação de produto cadastrado na marca. uma marca nova começa dividindo por disponibilidade |

disponibilidade e janela de entrega não podem ser selecionadas ao mesmo tempo, e no máximo um tipo de classificação de produto é aceito.

este seletor é liberado pelo time da teceo.

dividir por disponibilidade ou por janela de entrega troca o formato de outras duas seções: pedido mínimo passa de um campo para dois, e coleção vigente do pedido faz o mesmo. dividir apenas por classificação de produto não quebra o pedido.

<Accordion title="exemplo, marca que divide por disponibilidade">
  * pedido mínimo exibe dois campos, pré-venda com R\$ 5.000 e pronta-entrega com R\$ 2.000
  * o campo total é zerado
  * coleção vigente do pedido exibe coleção do pedido de pré-venda e coleção do pedido de pronta-entrega
</Accordion>

<Accordion title="exemplo, marca que divide apenas por um tipo de classificação de produto">
  * pedido mínimo exibe um campo só, total, com R\$ 5.000
  * os campos de pré-venda e de pronta-entrega são zerados
  * coleção vigente do pedido exibe um campo só, coleção do pedido
</Accordion>

### pedido mínimo

sem um valor mínimo atendido, o pedido não é aprovado. os dois formatos nunca coexistem: gravar um zera o outro.

| campo | o que faz | valores |
| - | - | - |
| total | valor mínimo do pedido inteiro. não é cobrado do administrador da marca, nem quando o pedido tem classificação de produto | campo monetário. padrão vazio. aparece só quando a marca não divide por disponibilidade nem por janela de entrega |
| pré-venda | valor mínimo de cada pedido de pré-venda | campo monetário. padrão vazio. aparece só quando a marca divide por disponibilidade ou por janela de entrega |
| pronta-entrega | valor mínimo de cada pedido de pronta-entrega | campo monetário. padrão vazio. mesma condição de exibição do campo anterior |

as mensagens de bloqueio trazem o valor exigido: valor mínimo do pedido não atingido, pedido mínimo de pré-venda não atingido e pedido mínimo de pronta-entrega não atingido.

### inatividade do pedido

pedidos em rascunho que passam do prazo definido mudam para o status abandonado. o pedido não é excluído, e o estoque reservado é liberado. o pedido muda para abandonado em até uma hora depois do prazo.

os prazos de pré-venda, de estoque-futuro e de pronta-entrega são independentes, cada um com um seletor e um campo de horas.

| campo | o que faz | valores |
| - | - | - |
| data de referência para pré-venda | define de qual data o prazo de pré-venda conta | data de criação (padrão) ou data de modificação |
| inativar pré-venda após (h) | prazo em horas até o abandono | numérico, até 4 dígitos, mínimo de 1 hora. padrão vazio |
| data de referência para estoque-futuro | mesma função, no prazo de estoque-futuro | data de criação (padrão) ou data de modificação |
| inativar estoque-futuro após (h) | prazo em horas até o abandono | numérico, até 4 dígitos, mínimo de 1 hora. padrão vazio |
| data de referência para pronta-entrega | mesma função, no prazo de pronta-entrega | data de criação (padrão) ou data de modificação |
| inativar pronta-entrega após (h) | prazo em horas até o abandono | numérico, até 4 dígitos, mínimo de 1 hora. padrão vazio |

campo de horas vazio significa que o pedido não é abandonado por esse prazo, e o estoque segue reservado sem prazo. um único item que estoure o prazo da disponibilidade dele abandona o pedido inteiro. pedido sem itens é abandonado por um prazo fixo, independente do que a marca configurou.

### coleção vigente do pedido

define qual coleção o pedido carrega: pedido de pronta-entrega usa a coleção de pronta-entrega, pedido de pré-venda usa a de pré-venda, e os demais casos usam a coleção geral.

| campo | o que faz | valores |
| - | - | - |
| coleção do pedido | coleção usada quando a marca não divide por disponibilidade nem por janela de entrega | busca entre as coleções da marca, exibidas como nome e código. padrão vazio |
| coleção do pedido de pré-venda | coleção usada nos pedidos de pré-venda | mesma busca. padrão vazio. aparece só quando a marca divide por disponibilidade ou por janela de entrega |
| coleção do pedido de pronta-entrega | coleção usada nos pedidos de pronta-entrega | mesma busca. padrão vazio. mesma condição de exibição do campo anterior |

### previsão de faturamento

são duas regras independentes, uma por tipo de pedido. a previsão vira campo obrigatório no pedido, exceto quando calculada a partir da data de integração e para a loja com o pedido em rascunho. a mensagem de bloqueio é data de previsão de faturamento é obrigatória.

| campo | o que faz | valores |
| - | - | - |
| regra para pré-venda | define como a data prevista de faturamento é calculada nos pedidos de pré-venda | desabilitar (padrão), entrada manual, calculado a partir da data do pedido, usar data de início da janela de entrega, usar data de fim da janela de entrega, calculado a partir da data de integração do pedido |
| regra para pronta-entrega | mesma função nos pedidos de pronta-entrega | desabilitar (padrão), entrada manual, calculado a partir da data do pedido, calculado a partir da data de integração do pedido |
| calcular data após (dias) | número de dias somado à data de criação do pedido | numérico. aparece só quando a regra escolhida é calculado a partir da data do pedido |

com desabilitar, não há previsão. com entrada manual, a data é digitada no pedido. as opções de janela de entrega usam a data da janela quando ela ainda está no futuro, e a data de hoje quando já passou.

<Accordion title="exemplo, regra calculada a partir da data do pedido">
  regra para pré-venda em calculado a partir da data do pedido, com calcular data após (dias) preenchido com 30:

  * pedido de pré-venda criado em 1 de março
  * previsão de faturamento: 31 de março
  * o mesmo pedido, com o campo de dias vazio, fica com previsão na própria data de criação
</Accordion>

<Accordion title="exemplo, regra calculada a partir da data de integração">
  regra para pronta-entrega em calculado a partir da data de integração do pedido:

  * pedido de pronta-entrega criado em 1 de março, ainda não integrado
  * previsão de faturamento: vazia, e o campo não é exigido para finalizar
  * o campo calcular data após (dias) não aparece, e nenhum dia é somado
  * integrado em 10 de março, a previsão passa a 10 de março
</Accordion>

as duas regras convivem com valores diferentes: uma marca pode manter pré-venda em usar data de início da janela de entrega e pronta-entrega em entrada manual.

### pedidos

| campo | o que faz | valores |
| - | - | - |
| indicador numérico do talão de pedidos | define o que o contador do talão exibe | exibir quantidade de itens (padrão) ou exibir quantidade de peças |
| habilitar campo “tipo de venda” no mais condições do pedido. | torna tipo de venda um campo obrigatório nas condições do pedido | chave de seleção. padrão desligado |
| permitir que pedidos de pronta-entrega sigam direto para "aprovado", sem passar por "em aprovação". | dispensa a etapa de aprovação. vale apenas quando o pedido é somente de pronta-entrega e quem envia tem perfil da marca | chave de seleção. padrão desligado |
| permitir criar novos pedidos para clientes bloqueados. | libera a criação de pedido para cliente bloqueado | chave de seleção. padrão desligado |
| permitir aprovar pedidos de clientes bloqueados. | libera a aprovação de pedido de cliente bloqueado | chave de seleção. padrão desligado |
| habilitar frete. | habilita o frete no pedido | chave de seleção. padrão desligado |
| impedir que representantes criem pedidos sem cliente. | exige um cliente no pedido criado pelo representante | chave de seleção. padrão desligado |

as duas chaves de cliente bloqueado são independentes entre si, e nenhuma delas libera cliente inativo.

ao ligar a chave de pronta-entrega direto para aprovado, a plataforma abre a confirmação deseja mesmo ativar esta configuração?, com o aviso de que pedidos integrados no status em aprovação desconsideram a configuração.

impedir pedido sem cliente vale só para o representante. independente da configuração, a loja nunca cria pedido sem cliente, e pedido sugerido é isento.

a chave habilitar frete é liberada pelo time da teceo.

### configurações do copiar pedido

| campo | o que faz | valores |
| - | - | - |
| obrigar a cópia das condições do pedido, quando aplicável. | mantém as condições do pedido original ao copiar como rascunho ou como sugestão | chave de seleção. padrão desligado |

## o contrato e o pagamento

### contrato de pedidos

o PDF do contrato é a capa somada ao PDF do pedido, montado com as escolhas de configuração do pdf do pedido. contrato já existente não é regerado.

| campo | o que faz | valores |
| - | - | - |
| clique ou arraste para adicionar um arquivo | anexa um documento da marca, concatenado ao PDF do pedido | um arquivo, apenas PDF. opcional. com o arquivo enviado, a tela exibe a miniatura, o nome e a ação de excluir |
| geração automática de contrato | define em qual status o contrato é gerado automaticamente | em revisão ou aprovação, em aprovação, aprovado. padrão vazio, e vazio significa que o contrato não é gerado automaticamente |
| exigir assinatura para finalizar o pedido | define quem precisa assinar | assinatura não obrigatória (padrão), apenas assinatura da loja, assinatura da loja e da marca |

as mensagens de bloqueio são assinatura da loja no pedido é obrigatória e assinatura do pedido é obrigatória.

com assinatura exigida e geração automática configurada, assinar faz o pedido avançar de status automaticamente.

### configuração do pdf do pedido

| campo | o que faz | valores |
| - | - | - |
| orientação da folha | define a orientação do arquivo exportado | retrato (21cm x 29,7cm), padrão, ou paisagem (29,7cm x 21cm) |
| modelo de exportação | define quantas fotos acompanham cada item | compacto, sem fotos; padrão, com 1 foto pequena por item; detalhado, com 2 fotos médias por item; ampliado, com 1 foto grande por item. padrão: padrão |
| agrupar por | define o critério de agrupamento dos itens | nenhum (padrão), entrega, coleção, categoria, subcategoria, produto, e um item por tipo de classificação de produto cadastrado na marca |
| ordenar por | define a ordem dos itens dentro do agrupamento | últimos itens adicionados (padrão), nome A-Z, código, referência do produto |
| criar resumo dos pedidos quando aplicável. | acrescenta um resumo ao arquivo | chave de seleção. padrão ligado |
| exibir valores de sell-in. | exibe os valores de sell-in no arquivo | chave de seleção. padrão ligado |
| exibir composição de preço. | exibe a composição de preço | chave de seleção. padrão ligado. fica indisponível com sell-in desligado |
| exibir variação de preço por tamanho. | exibe a variação de preço por tamanho | chave de seleção. padrão desligado. fica indisponível com sell-in desligado |
| exibir markup e preço de sell-out. | exibe markup e preço de sell-out | chave de seleção. padrão desligado |

desligar exibir valores de sell-in desliga junto composição de preço e variação de preço por tamanho.

### forma de pagamento

| campo | o que faz | valores |
| - | - | - |
| habilitar juros acumulados nas formas de pagamento. | acumula os juros das formas de pagamento | chave de seleção. padrão desligado |

esta chave é liberada pelo time da teceo.

### gateway de pagamento

com a exigência ligada, o link de pagamento só é gerado depois da liberação, por tipo de pedido. o gateway exige pedido dividido e moeda em real.

| campo | o que faz | valores |
| - | - | - |
| exigir liberação do pagamento em pedidos de pré-venda. | condiciona a geração do link de pagamento à liberação, nos pedidos de pré-venda | chave de seleção. padrão desligado |
| exigir liberação do pagamento em pedidos de pronta-entrega. | mesma função nos pedidos de pronta-entrega | chave de seleção. padrão desligado |

## o que cada perfil vê e alcança

### estoque

| campo | o que faz | valores |
| - | - | - |
| esconder estoque dos perfis | oculta o estoque disponível na grade para os perfis selecionados, que passam a ver o disponível vazio | seleção múltipla com as opções representantes e cliente. padrão vazio |
| limitar quantidade máxima de estoque exibida na grade | define o teto exibido na grade. acima do teto, a pessoa vê o limite e não o número real, já descontado o que está no pedido | numérico, até 4 dígitos. padrão vazio, e vazio significa sem teto. fica indisponível quando o estoque está escondido de todos os perfis |

o administrador da marca nunca tem teto de estoque: vê sempre o número real.

### acesso de produtos

| campo | o que faz | valores |
| - | - | - |
| permitir que lojistas e representantes acessem apenas produtos incluídos nos catálogos aos quais têm acesso. | filtra o que a pessoa enxerga em listagem, detalhes, busca, SKUs, catálogos e kits | chave de seleção. padrão desligado |
| permitir que representantes vendam apenas produtos dos catálogos aos quais o cliente possui permissão. | valida o que o representante pode vender para aquele cliente | chave de seleção. padrão desligado. fica indisponível com a chave acima desligada |

a primeira olha os catálogos de quem está logado. a segunda olha os catálogos vinculados ao cliente do pedido, e só existe para o perfil vendedor.

o catálogo padrão é excluído das duas checagens: com a restrição ligada, estar no catálogo padrão não libera o produto. o administrador da marca não é filtrado por nenhuma das duas. no showroom público sem pessoa logada, a restrição não é aplicada.

<Accordion title="exemplo, produto já adicionado ao pedido, com as duas chaves ligadas">
  * o produto passa na primeira regra, porque item já adicionado ao pedido continua acessível
  * o mesmo produto é barrado na segunda regra, que não tem essa isenção, se o cliente do pedido não tem catálogo com ele
  * o representante não conclui a venda daquele item para aquele cliente
</Accordion>

## o que o catálogo e o produto exibem

### configurações de preço

| campo | o que faz | valores |
| - | - | - |
| habilitar markups | habilita o markup no produto e no pedido | chave de seleção. padrão ligado |
| exibir preço de sell-out sugerido no produto | exibe o preço de sell-out sugerido nos detalhes do produto | chave de seleção. padrão ligado |
| exibir produtos com preço de sell-in zerado no catálogo | mantém no catálogo os produtos cujo preço de sell-in é zero | chave de seleção. padrão desligado |

### catálogos

| campo | o que faz | valores |
| - | - | - |
| exibir filtro de preço de sell-in nos catálogos | acrescenta o filtro de preço de sell-in aos catálogos | chave de seleção. padrão desligado |

### sell-out

define o período de vendas de sell-out exibido no catálogo, nos detalhes do produto e no pedido, com limite de 365 dias.

| campo | o que faz | valores |
| - | - | - |
| período de referência | define como o período é delimitado | últimos dias, que conta um número de dias até a data atual, ou intervalo personalizado, com data inicial e final. padrão: últimos dias |
| últimos dias | número de dias contados até hoje | numérico, de 1 a 365. padrão 180. o erro acima do teto é insira um valor menor ou igual a 365. |
| data inicial e data final | delimitam o intervalo personalizado | seletores de data. o intervalo só é considerado válido com as duas datas preenchidas, e o erro acima do teto é o intervalo não pode passar de 365 dias. |

### grade

| campo | o que faz | valores |
| - | - | - |
| modelo de grade | define como a grade é exibida em produtos e pedidos | padrão, que exibe mais tamanhos na grade, ou expandida, que exibe os nomes dos tamanhos por extenso. padrão: padrão |

### valor de bloqueio na grade

| campo | o que faz | valores |
| - | - | - |
| máx | define a quantidade máxima de peças que podem ser adicionadas na grade com o cadeado fechado | numérico, até 2 dígitos. padrão 9 |

### mídias

| campo | o que faz | valores |
| - | - | - |
| exibir a foto de outra cor do produto quando não houver mídias | compartilha as fotos de uma cor com as outras do mesmo produto que não têm nenhuma mídia | chave de seleção. padrão desligado |
| mídias | define o formato de exibição das mídias | quadrado (1:1) ou retangular (16:10). padrão: retangular (16:10) |
| modelos de zoom | define o comportamento da ampliação | zoom imediato, que amplia a imagem direto para a tela cheia, ou zoom com prévia, que mostra uma prévia ajustada à tela antes de ampliar. padrão: zoom imediato |

com a configuração de exibir a foto de outra cor ativada, a cor que não tem mídia própria usa a de uma única outra cor do mesmo produto, escolhida nesta ordem:

1. a cor com mais mídias cadastradas.
2. em caso de empate, a primeira cor em ordem alfabética do nome.

já no item do pedido, temos um critério extra que prioriza cores com pelo menos uma foto, pois ele não exibe mídias do tipo "vídeo".

se o produto-cor possuir mídias próprias, mesmo com a configuração ativa, continua com as dele. a imagem da cor, exibida no seletor de cores, continua sempre a da própria cor.

### produtos relacionados

| campo | o que faz | valores |
| - | - | - |
| classificação | define qual tipo de classificação de produto gera as sugestões de produtos relacionados nos detalhes do produto | busca entre os tipos de classificação de produto cadastrados na marca. padrão vazio |
| habilitar edição das grades dos produtos relacionados nos detalhes do produto. | permite montar as grades dos produtos relacionados sem sair dos detalhes do produto | chave de seleção. padrão desligado |

## a marca e quem opera nela

### representante

| campo | o que faz | valores |
| - | - | - |
| habilitar tabela de preço por representante | faz a aba de tabelas de preço aparecer no cadastro do representante | chave de seleção. padrão desligado |
| habilitar alteração de representante no pedido | libera a troca do representante do pedido. desligada, a troca fica só com o administrador da marca | chave de seleção. padrão ligado |
| permitir que representantes visualizem outros representantes vinculados ao mesmo cliente | mostra ao representante os demais representantes que têm clientes em comum com ele | chave de seleção. padrão desligado |

a mensagem de bloqueio da troca de representante é não é possível editar o representante do pedido.

### conexões

| campo | o que faz | valores |
| - | - | - |
| aceitar automaticamente convites de clientes com representante. | aceita o convite sem intervenção quando todas as condições são atendidas | chave de seleção. padrão desligado |
| permitir que vendedores enviem convites diretamente ao lojista. | libera o envio de convite pelo representante, sem passar pela marca | chave de seleção. padrão desligado |

o aceite automático só ocorre quando todas as condições valem ao mesmo tempo: o convite veio da loja, não há auto-bloqueio de conexão, o cliente já tem representante vinculado, e não existe convite recusado antes. as condições completas estão em [configurar o aceite automático](/docs/conexoes/configurar-o-aceite-automatico-v2).

### habilitar showroom

| campo | o que faz | valores |
| - | - | - |
| habilitar showroom público | torna público o showroom da marca. desligado, a URL pública cai na tela de login mesmo com o showroom montado | chave de seleção. padrão desligado |

o que o showroom público expõe e como ele é montado está em [habilitar o showroom público](/docs/showroom/habilitar-o-showroom-publico).

### fuso horário

| campo | o que faz | valores |
| - | - | - |
| fuso horário | define o fuso da marca, usado no cálculo do abandono de pedidos, na expiração de estoque, e no período de sell-out | seletor com a lista de fusos e a localidade correspondente. padrão: Brasília |

### suporte via whatsapp

| campo | o que faz | valores |
| - | - | - |
| WhatsApp | registra o número que os clientes usam para tirar dúvidas durante o cadastro pelo link da marca | campo de texto com máscara de celular. padrão vazio |

### dropbox

| campo | o que faz | valores |
| - | - | - |
| separador | caractere que separa o código do produto no nome do arquivo sincronizado | campo de texto. padrão: sublinhado |

sem configuração, a seção traz a ação de configurar. com o dropbox conectado, ela traz o separador e a ação de remover configuração, que desconecta a conta e interrompe a sincronização imediatamente.

para consultar a conexão da conta, o padrão de nome dos arquivos e os limites de cada produto, acesse [dropbox](/docs/configuracoes/dropbox).


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