henriquescastilho Protocolo: Criar Tirinhas — 3S-001
O que e uma tirinha
Uma tirinha e um bloco dentro de um xlsx unico do mes, contendo todas as cirurgias de um medico naquele periodo. Cada bloco tem o seu proprio header, suas linhas de cirurgia, separador e linha TOTAL.
Saida esperada
<pasta_da_empresa>/
└── Tirinhas_LCOSTA_<Mes>_<Ano>.xlsx (1 unico arquivo por mes)
O xlsx tem uma unica aba "Tirinhas" contendo todos os medicos como blocos empilhados, separados por uma linha em branco entre cada bloco:
[BLOCO MEDICO 1]
HEADER | Empresa | Data | Paciente | Hospital | Valor | Taxa
linha 1 ...
linha 2 ...
separador
TOTAL valor taxa
(linha em branco)
[BLOCO MEDICO 2]
HEADER | Empresa | Data | Paciente | Hospital | Valor | Taxa
...
- Linhas de Cranio primeiro, depois Coluna, dentro de cada bloco
- Se o medico so tem cirurgias de uma especialidade, mostra apenas essas
- Cada bloco tem sua propria linha Total com Valor + Taxa
- Os medicos aparecem em ordem alfabetica
A coluna de taxa por linha se chama "Taxa (20%)" (ou apenas "Taxa" quando o medico tem override de aliquota) — nunca "comissao". A linha TOTAL no rodape de cada bloco totaliza tanto a coluna de Valor quanto a de Taxa.
Passo 1 — Localizar o arquivo de entrada
O usuario indica um .xlsx. Se nao indicar, verificar o workspace por arquivos recentes.
Extrair periodo (ex: "03.2026" → "Marco 2026") e UF do nome do arquivo.
Passo 2 — Detectar abas
python3 <skill_dir>/scripts/gerar_tirinhas.py --detect --input <caminho>
- Cranio/Neuro: aba com "Neuro", "Cranio" no nome
- Coluna: aba com "Coluna" no nome
- Usar
--cranio-tabe--coluna-tabpara forcar manualmente
Passo 3 — Gerar as tirinhas (xlsx + pdf)
Sempre gerar as duas saidas (xlsx para edicao, pdf paisagem A4 para impressao):
python3 <skill_dir>/scripts/gerar_tirinhas.py \
--input <caminho_xlsx> \
--output "<pasta_da_empresa>/Tirinhas_LCOSTA_<Mes>_<Ano>.xlsx" \
--empresa "L.COSTA"
python3 <skill_dir>/scripts/gerar_tirinhas_pdf.py \
--input <caminho_xlsx> \
--output "<pasta_da_empresa>/Tirinhas_LCOSTA_<Mes>_<Ano>.pdf" \
--empresa "L.COSTA"
XLSX: 1 unico arquivo, todos os medicos como blocos empilhados separados por linha em branco. Sobrescreve se ja existir.
PDF: mesmo conteudo em paisagem A4 (842x595pt) com margens de 15mm. Cada bloco tenta caber em 1 pagina (KeepTogether). Se um bloco for maior que uma pagina, parte automaticamente e o header se repete no topo (repeatRows=1). Cores fieis ao xlsx (paleta amarela).
Passo 4 — Entregar
Informar ao usuario:
- Quantos blocos foram gerados (quantos medicos)
- Volume total e taxa total
- Caminho do xlsx gerado
Nao e necessario listar todos os blocos — so o resumo.
Configuracoes padrao
| Parametro | Valor |
|---|---|
| Empresa | L.COSTA (3S-001 = código interno) |
| Taxa (repasse medico) | 20% sobre o valor da cirurgia (pos-desconto) |
| Nome linha taxa | Taxa (20%) — nunca "comissao" |
| Escopo | Todos medicos |
| Formato de data | dd/mm/yyyy |
| Moeda | R$ (BRL) |
| Coluna classificacao | CLASSIFICACAO (valores: ELETIVA, URGENCIA, EMERGENCIA) |
| Desconto URGENCIA | 10% silencioso (reduz o VALOR antes do calculo da Taxa) |
| Desconto EMERGENCIA | 10% silencioso (reduz o VALOR antes do calculo da Taxa) |
| ELETIVA | Sem desconto |
Regras de calculo
- Ler valor da cirurgia (coluna
TOTAL GERAL - DESCONTOou equivalente). - Se a coluna
CLASSIFICACAOda linha forURGENCIAouEMERGENCIA, multiplicar o valor por 0,90 (10% de desconto silencioso — sem coluna extra na tira). - A coluna
TAXA (20%)da tira e o repasse ao medico = valor (ja com desconto se for o caso) x 0,20. - Total da tira = soma dos valores ja com desconto aplicado.
Overrides de taxa por medico
Algumas tirinhas usam taxa diferente de 20% em uma especialidade especifica. Quando isso acontece o cabecalho da coluna na tira fica como "TAXA" (sem o "(20%)") para sinalizar que ha mistura de aliquotas.
| Medico | Especialidade | Taxa |
|---|---|---|
| Juliano Berteli de Figueiredo | Coluna | 25% |
| Juliano Berteli de Figueiredo | Cranio | 20% (default) |
| Edson Vargas de Oliveira Netto | Coluna | 25% |
| Edson Vargas de Oliveira Netto | Cranio | 20% (default) |
Para adicionar novos overrides, editar TAXA_OVERRIDE em scripts/gerar_tirinhas.py.
Comissoes dos vendedores (script separado)
Alem das tirinhas (medicos), a skill tambem gera as comissoes dos vendedores em um xlsx unico consolidado.
python3 <skill_dir>/scripts/gerar_comissoes.py \
--input "<caminho_xlsx_origem>" \
--output "<caminho_xlsx_destino>"
Regras
| Regra | Valor |
|---|---|
| Comissao default | 4% |
| Comissao em cirurgias de COLUNA do Juliano Berteli | 3,5% |
| Comissao em cirurgias de COLUNA do Edson Vargas de Oliveira Netto | 3,5% |
| Base de calculo | VALOR CHEIO da cirurgia (coluna TOTAL / Total Geral verificado) — antes de qualquer desconto, inclusive o de URGENCIA/EMERGENCIA |
Identificacao do vendedor
Vem da coluna AGENTE CORRETO (ou AGENTE). O script remove o prefixo CONTRACTOR -
e procura o nome em VENDORS. Vendedores conhecidos:
- Saint Clair Barbosa de Oliveira
- Luiz Henrique Castilho Viana de Castilho
Para adicionar mais vendedores, editar VENDORS em scripts/gerar_comissoes.py.
Saida
- Um arquivo .xlsx unico
- Uma aba por vendedor (nome canonico do vendedor como nome da aba)
- Aba
SEM AGENTEse houver linhas sem AGENTE preenchido (sem calculo de comissao) - Cada aba: Vendedor | Data | Medico | Paciente | Hospital | Especialidade | Valor (cheio) | Comissao
- Linha TOTAL no rodape com soma de Valor e Comissao
- A palavra "comissao" e usada apenas para vendedores — nunca para medicos (medicos = "Taxa")