Planilha modelo do tiss.cx: numeração automática, zeros e outros detalhes de preenchimento
A planilha modelo do tiss.cx foi feita pra você preencher sem ler manual. Mas ela tem alguns recursos que passam despercebidos e que resolvem dúvidas bem comuns: de onde vem o número do lote, por que o zero do começo da carteirinha some, como mandar menos guias por arquivo XML.
Este artigo reúne esses detalhes. Boa parte deles está resumida na aba (0) Documentação da própria planilha; aqui vai a versão com exemplos.
Os códigos entre chaves: numeração automática
Na aba (1) Convênios, as colunas Sequencial Transação e Número do Lote já vêm preenchidas com isto:
{ANO}{MES:2}{DIA:2}{SEQ:4}
Não é erro, nem é pra apagar. Cada trecho entre chaves é uma variável que o sistema troca por um valor na hora da conversão:
| Variável | Vira |
|---|---|
{DIA} |
o dia em que a conversão é feita |
{MES} |
o mês em que a conversão é feita |
{ANO} |
o ano em que a conversão é feita |
{SEQ} |
um número sequencial, que o sistema controla pra você |
O número depois dos dois-pontos é o tamanho: o valor é completado com zeros à esquerda até chegar naquela quantidade de dígitos. O tamanho vai de 1 a 12.
Então, numa conversão feita em 5 de outubro de 2026, com o sequencial em 37:
| Você escreve | Sai no XML |
|---|---|
{SEQ} |
37 |
{SEQ:4} |
0037 |
{MES} |
10 |
{DIA:2} |
05 |
{ANO}{MES:2}{DIA:2}{SEQ:4} |
202610050037 |
Por isso o modelo usa {MES:2} e {DIA:2}: sem o tamanho, janeiro viraria 1 e o número mudaria de comprimento ao longo do ano.
Três coisas que vale saber:
- O tamanho só completa, nunca corta.
{ANO:2}continua saindo2026. - Maiúsculas ou minúsculas, tanto faz.
{seq:4}funciona igual a{SEQ:4}. - Use cada variável uma vez só por célula. Você pode misturar texto fixo e variáveis, mas a segunda aparição da mesma variável na mesma célula não é substituída.
Onde as variáveis funcionam
Só nestes cinco campos:
- Sequencial Transação e Número do Lote, na aba de convênios;
- Número Guia Prestador, Guia Principal e Número Guia Operadora, na aba de guias.
Em qualquer outra coluna, o texto entre chaves vai para o XML do jeito que você digitou.
De onde vem o sequencial
O {SEQ} não é um número só. O sistema guarda três contadores para cada operadora: um de transação, um de lote e um de guia. O Sequencial Transação usa o primeiro, o Número do Lote usa o segundo, e os campos da aba de guias usam o terceiro. A cada conversão eles avançam sozinhos, e a conversão seguinte continua de onde a anterior parou.
Se você precisar acertar um contador (por exemplo, pra continuar a numeração que já usava antes), entre na sua conta e vá em Conta → Configurações, na seção Operadoras.
Sem conta, o sistema não tem onde guardar esses contadores, e a numeração recomeça do 1 a cada conversão. Quem envia lotes todo mês deve converter logado, pra não repetir número de lote.
E se a operadora exigir uma numeração própria?
É só apagar o código e digitar o número que ela pede. As variáveis são uma conveniência, não uma obrigação. Se a operadora não pede nada específico, deixe como veio.
"# Guias por XML": arquivos menores
O padrão TISS limita cada XML a 100 guias. Você não precisa se preocupar com isso: pode colocar centenas de guias na planilha, e o sistema divide para você em vários XMLs de até 100 guias, cada um com o seu número de lote.
A coluna # Guias por XML, na aba de convênios, serve pra quando a operadora quer menos que isso. Coloque ali o máximo de guias que você quer em cada arquivo, e a divisão passa a seguir esse número, só para aquele convênio:
| Guias na planilha | # Guias por XML | XMLs gerados |
|---|---|---|
| 250 | (vazio) | 3, com 100, 100 e 50 guias |
| 250 | 50 | 5, com 50 guias cada |
| 3 | 1 | 3, com uma guia cada |
O número vai de 1 a 100. Acima de 100 o sistema recusa a planilha e aponta essa célula, porque o padrão TISS não aceita lotes maiores. Se a operadora não pede nada diferente, deixe a coluna vazia.
"Zeros à direita?": 75 ou 75.00
Essa coluna existe no modelo SADT completo e muda só a forma de escrever os valores no XML.
| Valor na planilha | Vazio ou N | S |
|---|---|---|
| 75 | 75 |
75.00 |
| 75,5 | 75.5 |
75.50 |
| 75,25 | 75.25 |
75.25 |
O valor é o mesmo nos dois casos; muda só a escrita. Para o padrão TISS, tanto 75 quanto 75.00 são válidos, mas algumas operadoras exigem os zeros à direita nos valores monetários. Se o portal da operadora devolver o arquivo reclamando do formato dos valores, escolha S nessa coluna e converta de novo.
Repare que na planilha você digita com vírgula, como sempre faz no Excel. O ponto que aparece no XML é o separador que o padrão TISS usa, e o sistema faz essa troca.
Números que começam com zero
Você digita 0012345 numa célula, aperta Enter e o Excel mostra 12345. Ele entendeu aquilo como número e jogou fora os zeros da frente. Num código de prestador, numa senha ou num número de guia, isso muda o dado.
A saída é digitar um apóstrofo antes do número:
'0012345
O apóstrofo avisa o Excel que aquilo é texto. Ele não aparece na célula e não vai para o XML: o que sai é 0012345, com os zeros.
Algumas colunas do modelo já vêm formatadas como texto, e nelas os zeros ficam sem você fazer nada; é o caso de Número Carteira. Mas é comum a colagem sobrescrever essa formatação: você copia com os zeros à esquerda e, ao colar, o Excel some com eles. Nesse caso, digite o apóstrofo: ele funciona em qualquer célula de texto livre.
Onde tirar outras dúvidas
- Qual modelo usar e o que cada aba pede: como preencher a planilha.
- Se um campo é obrigatório na versão da sua operadora: campos por versão TISS.
- Os modelos para baixar: modelos de planilha.
Pronto pra converter?
Com a planilha preenchida, o Conversor TISS.cx gera o XML TISS válido, no padrão da ANS, em segundos, e aponta a aba e a linha de qualquer campo que precise de ajuste. São 20 guias grátis por mês.