Contrato de Faturamento

O menu Faturamento > Contratos guarda o acordo comercial de cada depositante: quem é o cliente, até quando vale, quais serviços são cobrados e por qual regra. É esse cadastro que o Fechamento de Período lê para apurar — sem contrato vigente no período, não há o que apurar.

1. A lista de contratos

Faturamento > Contratos abre a tela "Contratos de Faturamento", em cards, um por contrato.

Cada card mostra o cliente, o número do contrato e a vigência, com os selos da situação (Rascunho, Em vigência ou Encerrado) e, quando existirem, os selos Quinzenal, ISS % e Take-or-Pay. A vigência sem data de fim aparece como "(em aberto)".

Na barra de ferramentas você tem o campo "Buscar por cliente ou número...", o filtro de situação, o filtro de periodicidade e o botão "Novo contrato".

No rodapé do card ficam cinco ações: Editar, Consultar, Contrato, Proposta e Excluir. Consultar abre o mesmo formulário em leitura — o botão Salvar não aparece.

2. Cliente e vigência (aba Dados Cadastrais)

1. 1

   **Cliente** — Digite nome do cliente ou CNPJ e escolha na lista. É obrigatório: sem cliente selecionado, o Salvar recusa com "Cliente é obrigatório.".

2. 2

   **Número do Contrato** — Campo livre. É o número que aparece no card, na busca e no seletor de contratos do fechamento.

3. 3

   **Vigência — Início** — Obrigatória. Define a partir de quando o contrato pode ser usado num fechamento.

4. 4

   **Vigência — Fim** — Opcional. Deixe em branco para vigência em aberto.

5. 5

   **Pagamento** — Forma de Pagamento, Condição de Pagamento e Forma de Vencimento (Dia fixo do mês, Dia da semana ou Após emissão (dias)). São os dados usados quando o fechamento vira nota fiscal de serviço.

3. Condições Comerciais

Aba que define como o contrato é apurado e cobrado.

Por dentro, a alíquota incide sobre o total: ISS = subtotal × alíquota / (1 − alíquota). Por fora, incide só sobre o subtotal: ISS = subtotal × alíquota.

O exemplo do próprio quadro da tela: subtotal de R$ 1.000 a 5% dá ISS de R$ 52,63 e total de R$ 1.052,63 por dentro; e ISS de R$ 50,00 com total de R$ 1.050,00 por fora.

1. 1

   **Periodicidade** — Mensal ou "Quinzenal (1ª e 2ª quinzena)". Quinzenal quebra a apuração em 1ª quinzena (até o dia 15) e 2ª quinzena (do 16 ao fim), e o fechamento passa a mostrar dois cartões lado a lado.

2. 2

   **Forma de Cobrança** — Nota Fiscal ou Boleto.

3. 3

   **Take or Pay — Faturamento Mínimo Mensal** — Piso garantido do mês. Se a apuração ficar abaixo, o fechamento acrescenta a linha "FATURAMENTO MÍNIMO (TAKE OR PAY)" completando a diferença. Zero = sem piso.

4. 4

   **Grade Extra** — Marque "Este contrato permite movimentação extra" e informe o Valor por operação. Duas regras automáticas: os dias da semana marcados (ex.: Sáb) e "Acima de N movimentações no dia" (0 = desligado; as excedentes do dia, por ordem de horário, viram extra).

5. 5

   **AD VALOREM (seguro)** — Modo de apuração Fiscal calcula sozinho sobre a soma das NFs de entrada do período. Modo Manual não gera linha: a prévia do fechamento mostra um aviso e o faturista lança o valor à mão. O percentual em si fica no item PERCENTUAL do Tarifário, que também define a base: "Somente entradas do período" (padrão) ou "Saldo inicial + entradas" — esta cobra também sobre a mercadoria que já estava no armazém no 1º dia, usando o saldo em valor da aba Saldos do fechamento (ex.: LEVO). Por isso dois contratos com o mesmo percentual podem fechar diferente.

6. 6

   **ISS** — Alíquota (%), Município ISS e a escolha entre Por dentro e Por fora.

7. 7

   **Data de corte do apontamento** — No fim da aba, em "Apontamento do checklist". A partir dessa data, o que o conferente aponta no checklist da qualidade passa a ser lido em QUILOS; antes dela, em PALETES. Em branco, vale o padrão do sistema. Preencha com a data em que a pergunta do coletor mudou PARA ESTE CLIENTE — a troca acontece cliente a cliente, e ler "38 paletes" como 38 kg cobra R$ 2,40 no lugar de R$ 1.704,24, sem aviso em lugar nenhum além do valor da fatura.

4. Tarifário: adicionar e remover serviço

O tarifário é a lista de serviços que compõem o cálculo. Cada linha é um acordeão: clique no cabeçalho para abrir e editar.

1. 1

   **Adicionar serviço** — Use o campo "Adicionar serviço" e busque pelo nome. A linha nasce com o tipo, a unidade e o valor do catálogo. Se não encontrar, a mensagem é clara: "Nenhum serviço encontrado. Cadastre em Faturamento > Serviços.".

2. 2

   **Tipo de cobrança** — Tonelada, Posição, Fixo, Quinzenal, Armazenagem (saldo), Percentual (% valor NF entrada) ou Manual (referência de preço).

3. 3

   **Aplicação** — Todas, Entrada ou Saída / Expedição. Restringe o item a um lado da operação.

4. 4

   **Unidade, Tarifa e Valor mínimo** — O valor mínimo eleva o total do item quando a conta do período fica abaixo dele.

5. 5

   **Base de peso** — Aparece em Tonelada e Armazenagem. "Líquido × fator" (padrão) usa o peso líquido multiplicado pelo fator. "Peso bruto real" cobra o bruto que veio da operação e ignora o fator — use quando a relação entre bruto e líquido muda de produto para produto e nenhum fator fixo representa o contrato.

6. 6

   **Fator de peso** — Só aparece com a base "Líquido × fator". Bruto = líquido × fator; o padrão é 1,0.

7. 7

   **Volume mínimo (t)** — Garantia de tonelagem do item. Se o período não alcançar o piso, o fechamento cobra a diferença na tarifa da primeira faixa. Zero desliga. É diferente do Take or Pay do contrato, que é um piso em reais para o contrato inteiro.

8. 8

   **Escopo de estoque** — Um rótulo livre (por exemplo BOX05). Preenchido, o item de armazenagem passa a ter uma posição de estoque só dele, alimentada apenas pelas movimentações que casam com os filtros desse item. Vazio, ele usa o saldo geral do contrato. Serve para o contrato que cobra armazenagem de uma câmara específica e movimentação de todo o resto.

9. 9

   **Isento de ISS** — Ligue quando a tarifa já é praticada com o ISS por dentro. O item entra no total do fechamento, mas fica fora da base do imposto e do Take or Pay — sem isso o ISS seria cobrado duas vezes sobre a mesma rubrica.

10. 10

    **Rubrica do produto** — Para quando a mesma nota traz produtos de tarifas diferentes. "PADRAO" cobra os produtos sem rubrica marcada; um rótulo (por exemplo IOGURTE) cobra só os produtos marcados com ele. Vazio, o item cobra o peso inteiro da movimentação. Veja a seção "Rubrica do produto".

11. 11

    **Base da armazenagem** — Só em Armazenagem: "Saldo final do período" (padrão) ou "Estoque inicial + entradas", que cobra o que passou pelo armazém sem abater as saídas.

12. 12

    **Medir por** — Obrigatório no tipo "Por quantidade": é ele que decide a grandeza cobrada, não a Unidade. Cinco opções — Pallet (UAs movimentadas), Pallet (etiqueta do cliente), Caixa, Movimentação e Hora de permanência (portaria). Sem escolher, o item aparece com a tarja "SEM BASE — COBRA ZERO" e a prévia do fechamento avisa: ele entra na fatura valendo nada.

13. 13

    **Pallet: as duas opções são diferentes** — "UAs movimentadas" conta as UAs distintas que a movimentação tocou — um picking fracionado conta a UA inteira. "Etiqueta do cliente" conta as etiquetas de pallet distintas que vieram do cliente. O mesmo carregamento pode dar números diferentes nas duas; escolha a que o contrato combinou.

14. 14

    **Hora de permanência** — Conta chegada → saída da portaria, uma vez por portaria, mesmo que a carga tenha vários pedidos. É uma aproximação: inclui fila e espera, não só o tempo de operação.

15. 15

    **Base do percentual** — Só no tipo Percentual (AD VALOREM). "Somente entradas do período" (padrão) cobra sobre o que entrou; "Saldo inicial + entradas" cobra também sobre a mercadoria que já estava no armazém no 1º dia — é o caso da LEVO. Escolhendo a segunda, aparecem os dois campos abaixo.

16. 16

    **Cobrar a abertura** — Aparece com "Saldo inicial + entradas". "A cada período de fechamento" (padrão) cobra a mercadoria parada em todo fechamento; "Uma vez por mês" só cobra quando o período começa no dia 1º. Use a segunda em contrato quinzenal: sem ela, fechar 01–15 e depois 16–31 cobra o seguro da abertura duas vezes, enquanto fechar o mês inteiro de uma vez cobra uma — o valor passa a depender de como o faturista clicou.

17. 17

    **Abertura recortada** — Aparece com "Saldo inicial + entradas". Desligado (padrão), a abertura é a do contrato inteiro, mesmo que o item tenha filtros. Ligado, ela respeita os filtros do item — e aí o Escopo de estoque passa a ser obrigatório, porque a abertura é um número que vem encadeado do fechamento anterior e só a cadeia por escopo guarda saldo separado por recorte.

18. 18

    **Tipo de carga** — Todas, Paletizada ou Estivada — para tarifas diferentes por tipo de carga.

19. 19

    **Operações específicas** — Chips com as operações ativas. Vazio, o item usa o filtro por mercado; com operações marcadas, o item cobra SÓ essas operações.

20. 20

    **Serviço complementar** — Liga a exibição do item na tabela de complementares da proposta. É referência de preço: a cobrança entra como lançamento.

21. 21

    **Cobrança pelo apontado do coletor** — Ligado, os apontamentos de checklist desse serviço entram ATIVOS no fechamento. Desligado, entram como sugestão desativada, e o faturista decide.

22. 22

    **Faixa escolhida pelo volume de** — Aparece com a tabela progressiva no modo "Faixa atingida". Normalmente o degrau é escolhido pelo volume do próprio serviço; aqui você pode apontar outro serviço do tarifário para ditar o degrau. A tarifa continua sendo a deste item — muda só qual volume decide em que faixa ele está.

23. 23

    **Tabela progressiva** — Disponível em Tonelada e Armazenagem. Faixas com teto crescente mais uma faixa final "acima". Modo "Faixa atingida" (todo o volume paga a tarifa alcançada) ou "Cascata" (cada fatia paga a tarifa da própria faixa). Base "Volume da quinzena" ou "Acumulado do mês" — nesta, a 2ª quinzena reprecifica o mês e lança a diferença.

24. 24

    **Remover serviço** — Abra a linha e clique em "Remover serviço", no fim do bloco.

5. CNPJs cobertos: um contrato para o grupo

Na aba Dados Cadastrais, logo abaixo de Cliente e vigência.

Tem cliente que opera por mais de um CNPJ e mesmo assim recebe uma fatura só. É o caso de um depositante em que a entrada de mercadoria acontece por uma filial e o cross-docking por outras três: são quatro cadastros de pessoa no sistema, mas um único acordo comercial.

O cliente escolhido lá em cima continua sendo o titular — é dele a nota. Em "CNPJs cobertos" você acrescenta os outros cadastros do grupo. No fechamento, o sistema varre as movimentações do titular e de todos os CNPJs listados, como se fossem um só.

Para incluir, busque pelo nome ou CNPJ no campo "Adicionar CNPJ ao contrato" e escolha na lista. Cada linha incluída mostra o código e o nome, com o botão Remover ao lado. Deixe a lista vazia se o contrato é de um CNPJ só — é o caso da maioria.

6. Rubrica do produto: duas tarifas na mesma nota

Para quando a nota não pode ser cobrada por uma tarifa só.

Os filtros normais do tarifário — operação, aplicação, tipo de carga — trabalham no nível da movimentação: ou a nota inteira entra no item, ou não entra. Isso resolve quase todo contrato, mas não resolve o caso em que a mesma nota fiscal traz produtos com tarifas diferentes. Uma nota de recebimento com iogurte e frios, por exemplo, em que o iogurte tem tarifa própria.

A rubrica resolve isso partindo a nota por produto. Cada produto pode receber uma rubrica de faturamento; produto sem rubrica é tratado como "PADRAO". No fechamento, o sistema soma o peso de cada rubrica separadamente e cada item do tarifário cobra só a fatia que lhe cabe.

Na prática são dois itens no tarifário apontando para as mesmas operações: um com Rubrica do produto = PADRAO e outro com o rótulo específico. Os dois veem a mesma nota, mas cada um cobra a sua parte — e a soma das partes é exatamente o peso da nota, nunca mais nem menos.

Quem marca o produto é a tela Faturamento > Rubricas de Produto. Ela lista os produtos já ordenados pelo peso movimentado no período e começa filtrada em "só os sem rubrica" — que é a fila de trabalho. Você seleciona as linhas, digita o rótulo e marca todas de uma vez; os rótulos já em uso viram botões, para não errar a digitação.

O rateio fica congelado no fechamento. Se alguém reclassificar um produto meses depois, um fechamento já apurado não muda de valor.

7. Simulação

A aba Simulação testa o tarifário antes de valer no mundo real, e nada é gravado. Ela exige o contrato salvo — em contrato novo aparece "Salve o contrato para simular".

Informe Início e Fim, use "Adicionar movimento" para criar linhas de exemplo (data, tipo entrada/saída, operação e peso líquido) e clique em "Simular faturamento".

O resultado sai no mesmo formato do fechamento: um cartão por quinzena com os itens apurados e o total. O motor de cálculo é exatamente o mesmo do fechamento real.

8. Proposta, contrato e relatório

Três abas de documento, três finalidades diferentes. Todas usam o mesmo editor: "Editar template" libera a escrita, "Inserir Macro" insere os blocos dinâmicos, "Tela cheia" amplia e "Concluir edição" volta à visão limpa.

Aba Proposta: é a proposta comercial apresentada ao cliente antes do contrato — serviços básicos, complementares, premissas e condições gerais. As tabelas vêm do tarifário, e os itens marcados como "serviço complementar" caem na tabela própria. Gera em PDF ("Gerar Proposta (PDF)") ou Word ("Gerar Proposta (DOCX)").

Aba Template do Contrato: o texto jurídico. Aqui o "Usar modelo" é diferente do das outras abas — ele aplica o modelo COMPLETO (templates, condições comerciais e o tarifário padrão do modelo), preservando cliente, número e vigência que você já digitou. Gera em Word por "Gerar Contrato (DOCX)".

Aba Template do Relatório: o layout da impressão do fechamento. O fechamento do cliente usa esse template quando o relatório dele estiver vazio.

Nas abas Proposta e Template do Relatório, "Usar modelo" aplica somente o texto daquele documento: condições e tarifário do contrato não mudam.

Contrato novo já nasce com o template padrão de proposta, com as tabelas do tarifário dentro. Se o template for editado e ficar sem as macros de tabela (tabela_servicos_basicos / tabela_servicos_complementares), a aba mostra um aviso: a proposta sairia bonita e sem nenhum preço. Use "Inserir Macro" ou "Usar modelo" para trazê-las de volta.

Cada documento gerado fica guardado como documento do contrato.

9. Anexos

A aba Anexos guarda documentos ligados ao contrato: rascunhos, e-mail de aprovação, planilha da negociação. O botão é "Escolher arquivo".

Em contrato já gravado, o anexo sobe na hora. Em contrato novo ele fica numa fila e sobe assim que você clicar em Salvar — por isso, num contrato novo, o anexo só existe de fato depois do primeiro Salvar.

10. Situação: Rascunho, Em vigência, Encerrado

O contrato nasce como Rascunho e o formulário não tem campo para trocar a situação. Isso não trava nada: o fechamento aceita contratos em Rascunho e Em vigência, e ignora apenas os Encerrados e os excluídos.

Para tirar um contrato de circulação sem apagá-lo, o caminho prático é preencher Vigência — Fim. A partir daquela data ele deixa de aparecer nos fechamentos dos períodos seguintes.

Parâmetros que mudam esta tela

Perguntas frequentes

**Cadastrei o serviço e ele não aparece na busca do Tarifário. Por quê?** O tarifário lê o catálogo de Faturamento > Serviços. Confira se o serviço foi salvo e está ativo — a lista de inativos não entra.

**O contrato cobra a mesma nota com duas tarifas diferentes. Como configuro?** Crie dois itens no tarifário apontando para as mesmas operações e use o campo Rubrica do produto: um com PADRAO e outro com o rótulo específico (por exemplo IOGURTE). Marque os produtos daquele rótulo no cadastro de produto. Cada item passa a cobrar só a sua fatia, e a soma das fatias é exatamente o peso da nota.

**Marquei a rubrica no item mas ele apurou zero.** Nenhum produto está marcado com aquele rótulo, ou o rótulo está escrito diferente no produto e no item. Ele precisa ser idêntico nos dois lugares. Enquanto isso, todo o peso cai no item com rubrica PADRAO.

**A armazenagem está cobrando sobre um estoque maior do que a câmara que eu quero cobrar.** Por padrão a armazenagem usa o saldo geral do contrato, que soma tudo. Preencha o Escopo de estoque no item (um rótulo como BOX05) e ajuste os filtros dele — operações, aplicação, tipo de carga. O item passa a ter uma posição de estoque só dele.

**O cliente tem quatro CNPJs e quer uma fatura só. Preciso de quatro contratos?** Não. Faça um contrato no CNPJ que recebe a nota e liste os outros em CNPJs cobertos, na aba Dados Cadastrais. O fechamento varre todos juntos. Lembre de abrir o fechamento pelo cliente titular.

**Mudei uma tarifa. Isso altera os fechamentos que já fiz?** Fechamento já salvo guarda os valores apurados. A tarifa nova entra num fechamento novo, ou quando o fechamento antigo for recalculado (qualquer alteração na tela refaz o cálculo). Fechamento finalizado não recalcula: ele abre somente para leitura.

**Como encerro um contrato antigo?** A tela não tem botão de encerrar. Na prática, preencha Vigência — Fim: a partir dessa data o contrato para de aparecer nos fechamentos. Excluir também tira da lista, e é reversível no banco por ser exclusão lógica.

**Qual a diferença entre "Serviço complementar" e o tipo "Manual"?** Complementar é exibição: o serviço vai para a tabela de complementares da proposta. Manual é comportamento de cálculo: o item não gera linha automática no fechamento. Um item pode ser as duas coisas ao mesmo tempo.

**Em contrato quinzenal, o take-or-pay cobra duas vezes?** Não. A comparação é feita uma vez, na 2ª quinzena, somando as duas quinzenas contra o piso mensal. Período que cobre só a 1ª quinzena não consolida.

**Marquei sábado na grade extra. O que acontece com as movimentações de sábado?** Elas são marcadas automaticamente como extra no fechamento, saem dos serviços por peso e viram uma linha "MOVIMENTACAO EXTRA" cada, com o valor por operação do contrato. O faturista ainda pode desmarcar linha a linha na aba Movimentações.

**O que a Simulação grava?** Nada. Ela usa o tarifário salvo e movimentos fictícios que você digita, só para conferir o resultado. Nenhum fechamento é criado.

Telas relacionadas

**Contratos** (/apes-local/wms/faturamento/contrato/grid) — Lista de contratos de faturamento

**Fechamentos** (/apes-local/wms/faturamento/fechamento/grid) — Apuração do período usando este contrato

**Serviços** (/apes-local/wms/services/grid) — Catálogo que alimenta o tarifário

**Operações** (/apes-local/wms/faturamento/operacoes/grid) — Operações usadas nos filtros do item do tarifário

**Rubricas de Produto** (/apes-local/wms/faturamento/rubricas-produto/grid) — Classificação em lote dos produtos por rubrica de faturamento

**Modelos de contrato** (/apes-local/wms/faturamento/modelos/grid) — Modelos aplicados por "Usar modelo"