Para facilitar o intercâmbio de dados com outros sistemas que necessitam de dados do SAM ou obter dados de outros sistemas para serem utilizados pelo SAM, a Multitec padronizou a estrutura dos arquivos TXT a fim de atender esta necessidade:
1 - Conteúdo: As linhas (registros) de cada arquivo estão identificadas da seguinte forma:
1.1 - CAMPO: Indica a posição ordinal do campo na linha do texto.
1.2 - TAM: Informa o tamanho do campo nas tabelas do SAM. Campos com conteúdos acima deste valor serão truncados nos processos de importação para as tabelas do SAM.
1.3 - TP: Informa qual o tipo do campo, sendo:
"A" - para campos alfanuméricos.
"N" - para campos numéricos (só aceitam números de 0 a 9).
"D" - para campos data (só aceitam números de 0 a 9).
1.4 - REQ: Informa se o conteúdo do campo é requerido, ou seja, se "S" seu preenchimento é obrigatório, se "N" não precisa ser informado.
1.5 - DESCRIÇÃO/CONTEÚDO: Descreve o conteúdo e o significado do campo.
1.6 - ORIGEM/DESTINO: Orientações da origem dos dados no SAM ou destino para a base do SAM.
2 – Padrão ASCII
Os dados deverão ser em ASCII ISO 8859-1 (Latin-1). Não podem ser compactados (packed decimal), zonados, binários, ponto flutuante (float point) etc., ou quaisquer outras codificações de texto, tais como EBCDIC.
3 – Organização
A organização deverá ser sequencial, ou seja, os registro devem estar ordenados sequencialmente e as linhas devem conter os campos na exata ordem descrita nos leiautes.
4 – Formatação
Os arquivos TXT poderão estar formatados de duas formas: (1) Formato flexível no qual os campos são separados por “|” (Pipe), ou (2) Formato fixo no qual não há nenhum separador entre os campos.
4.1 – Formato Flexível
Neste formato os campos do arquivo TXT são de tamanhos indefinidos e devem ser separados por “|” (Pipe ou Barra Vertical: caractere 124 da Tabela ASCII) da seguinte forma:
I – Ao início de cada linha e ao final de cada campo deve ser inserido o Pipe, mesmo que o conteúdo de tal campo seja vazio.
II – O Pipe não deve ser incluído como parte integrante do conteúdo de quaisquer campos numéricos ou alfanuméricos.
III – No final de cada linha, após o Pipe, deve haver os caracteres “CR” (Carriage Return) e “LF” (Line Feed) correspondentes a “retorno do carro” e “salto de linha” (CR e LF: caracteres 13 e 10, respectivamente, da Tabela ASCII).
IV – Os campos têm tamanhos variáveis, os tamanhos apontados neste documento dizem respeito as limitações das tabelas do SAM.
V – Nos campos não podem conter espaço antes ou depois do conteúdo.
Exemplo:
|Rafaela da Silva|SP|123456|Campinas|25022007|
|Jose Carlos|RJ|001012|Rio de Janeiro|10122010|
|Pedro|MG|20010|Alfenas|05021985|
4.2 – Formato Fixo
Neste formato os campos do arquivo TXT são de tamanhos fixos e sem separadores.
I – No final de cada linha contém os caracteres “CR” (Carriage Return) e “LF” (Line Feed) correspondentes a “retorno do carro” e “salto de linha” (CR e LF: caracteres 13 e 10, respectivamente, da Tabela ASCII).
II – Os campos têm tamanhos fixos.
Exemplo:
Rafaela da Silva SP123456Campinas 25022007
Jose Carlos RJ001012Rio de Janeiro10122010
Pedro MG020010Alfenas 05021985
4.3 – Campos Numéricos
Tipo N (número): Suprimir vírgulas e pontos. Para campos com casas decimais, a quantidade de casas, estão fixas nos leiautes e estão mensuradas no tamanho que caracteriza cada campo com uma barra “/” seguido da quantidade de casas decimais que deverão ser consideradas tanto na leitura como na gravação dos arquivos TXT.
Exemplo: CAMPO.....: 3
TAM.......: 6/2
TIPO......: N
REQ.......: S
DESCRIÇÃO.: Valor
No formato flexível: |Rafaela da Silva|SP|123456|Campinas|25022007|
No formato fixo: Rafaela da Silva SP123456Campinas 25022007
O SAM entenderá que no terceiro campo da linha contém um valor de: 1.234,56
4.4 – Campos Data
Tipo D (data): Deverão ser formatados com dois dígitos para dia, dois dígitos para mês e quatro dígitos para ano.
Exemplo: CAMPO.....: 5
TAM.......: 8
TIPO......: N
REQ.......: S
DESCRIÇÃO.: Data do documento
No formato flexível: |Rafaela da Silva|SP|123456|Campinas|25022007|
No formato fixo: Rafaela da Silva SP123456Campinas 25022007
O SAM entenderá que no quinto campo da linha contém a data: 25/02/2007
4.5 – Campos Alfanuméricos
Tipo A (alfanumérico): Podem ser usados todos os caracteres das posições da Tabela ASCII, excetuados o caractere “|” (Pipe) e os imprimíveis (caracteres 00 a 31 da Tabela ASCII).
Exemplo: CAMPO.....: 4
TAM.......: 14
TIPO......: A
REQ.......: S
DESCRIÇÃO.: Nome do município
No formato flexível: |Rafaela da Silva|SP|123456|Campinas|25022007|
No formato fixo: Rafaela da Silva SP123456Campinas 25022007
O SAM entenderá que no quarto campo da linha contém o texto: Campinas