Contabilidade de Vendas

O que é: Faturas de vendas, os recebíveis que elas criam e os documentos que as suportam.

Visão Geral

Define a configuração mínima útil de Contabilidade de Vendas para o negócio em questão e, em seguida, constrói-a apenas quando solicitado. A saída padrão é uma recomendação curta, não uma planilha. Artefatos - CSV, SQL DDL, JSON Schema, mapeamento Notion - são produzidos sob demanda, a partir de uma única lista de campos para que não se desalinhem.

Escopo de uma linha. Esta é uma habilidade de tabela única e uma linha é uma fatura carregando um item de linha. Deliberadamente, não é um motor de faturamento com várias linhas. Uma fatura com vários itens se torna várias linhas que repetem o mesmo Invoice Number, ou é mantida em uma tabela de linha separada ao lado desta - o que o negócio realmente precisa. Decida isso na Etapa 2, não presuma.

Tudo é condicional. Nem toda venda é a crédito, nem toda fatura tem um pedido ou um challan, nem toda venda atrai IVA, e nem todo cliente deduz TDS. Esses campos existem para registrar o que foi confirmado; eles são deixados em branco quando a resposta é "não aplicável" ou "não conhecido". Nunca os preencha com um padrão para que a linha pareça completa.

Camada: Camada 3: Registro. Adequado para: Estágio inicial. Código da tabela: n/a.

Quando Usar Esta Habilidade

• contabilidade de vendas
• registro de faturas de vendas
• rastreador de faturamento e recebíveis de clientes
• log de registro de IVA de vendas

Use-a também quando o usuário descrever faturamento, cobrança ou rastreamento de quem pagou, ou o mesmo processo ocorrendo em uma planilha, um documento ou a caixa de entrada de alguém.

Não a use para: cobrança de clientes, declaração de impostos ou aconselhamento jurídico. Esta habilidade produz apenas modelos vazios - nunca armazena ou processa dados reais de clientes ou financeiros.

Como Funciona

Siga o contrato de execução compartilhado. As regras específicas do módulo abaixo definem apenas campos de domínio, decisões, cálculos e restrições de segurança.

Etapa 1 - Identificar a intenção

Leia a solicitação e escolha a intenção antes de perguntar qualquer coisa.

• "configurar" ou "construir" ou "criar" -> o usuário quer artefatos; vá para a Etapa 2.
• "nosso processo é ..." ou "está em uma planilha" -> o usuário quer mover um processo existente; capture-o, depois vá para a Etapa 2.
• "isso está certo" ou "revisar" ou "auditar" -> o usuário quer uma verificação, não uma construção; responda com base no que eles compartilham.
• "como eu faço ..." -> pergunta de aconselhamento; responda diretamente e ofereça a construção apenas se ajudar.

Em seguida, leia tudo o que o usuário já disse e descubra qual única resposta ausente realmente mudaria a recomendação. Se a solicitação já contiver o suficiente para recomendar, não pergunte nada ainda - vá para a Etapa 4. Se o usuário estiver descrevendo um problema em vez de solicitar uma construção, responda primeiro; uma pergunta não é devida.

Nunca comece com uma pergunta fixa como "Como as faturas de vendas são emitidas hoje?" quando a solicitação já respondeu a isso.

Etapa 2 - Pergunte apenas o que está faltando

Trate respostas ambíguas como não respondidas e pergunte qual opção explícita o usuário quer dizer. Registre valores desconhecidos como Unknown; Unknown não é zero. Um registro não deve ser Done quando uma verificação necessária falha.

Pule tudo o que o usuário já respondeu, em qualquer mensagem anterior. Pergunte o restante um de cada vez e pare assim que as respostas restantes não mudarem a saída.

• Volume - Quantas faturas por mês? / Aproximadamente quantas linhas por fatura?
• Documentos - Existe um pedido de venda sempre, ou apenas para alguns clientes? / Um challan de entrega é usado?
• Impostos e crédito - O IVA é cobrado, e a que taxa? / Algum cliente deduz TDS, e a que taxa? / Quantas vendas são a crédito? / Período de crédito padrão? / Quem faz o acompanhamento?
• Processo atual - Rastreado agora? / Software ou planilha? / O que está faltando?
• Resultado - O que você precisa? / Um registro de vendas, uma visualização de envelhecimento ou ambos?

Nunca invente uma resposta. Se o usuário não souber, registre como desconhecido e continue.

Etapa 3 - Mantenha o contexto interno

Mantenha as respostas nesta forma. Ela permanece interna - não é mostrada ao usuário, a menos que eles peçam, e nunca carrega um valor que o usuário não forneceu.

module: sales-accounting
intent: null            # setup | advice | review | fix | build | convert | export
scale: null             # Starter | Growth | Scale, apenas se a resposta mudar
areas:
  "Volume": null
  "Documents": null
  "Taxes and credit": null
  "Current process": null
  "Outcome": null
requested_outputs: []   # csv | sql | json | notion | xlsx - apenas formatos solicitados

…