Se você já é cliente da TecnoSpeed, sabe que nossas integrações são feitas (na grande maioria) através do arquivo Tx2. Caso ainda não seja ou está começando agora, aqui vai uma explicação do que é esse arquivo:
O arquivo Tx2 é uma extensão criada e utilizada pela TecnoSpeed para facilitar a integração com nossos componentes, para que você possa pensar mais na experiência com o cliente do que na resolução do problema.
Porém, como tudo (nem tudo são flores na vida) temos algumas boas práticas no momento da geração desse arquivo que merecem atenção (e muita!).
Abaixo teremos as boas práticas gerais que você deve seguir e após isso, um link para as especificidades de cada documento.
A utilização do Tx2
Além da já citada facilidade de integração, o Tx2 tem também como objetivo evitar que você precise mudar todo o fluxo de seu código quando ocorrem alterações nos campos pela Receita/Sefaz/Prefeitura.
Isso ocorre porque nós da TecnoSpeed é que iremos nos responsabilizar por adaptar esses campos para o que a Receita/Sefaz/Prefeitura exige!
É importante ressaltarmos que procuramos seguir ao máximo o ID dos campos conforme disponibilizado nos manuais da Receita/Sefaz/Prefeitura, porém, nem sempre é possível, devido a atualizações no manual e a necessidade de repassar o mínimo possível de impacto das atualizações para os usuários dos nossos componentes.
Observação: Para não ocorrer problemas de acentuação, utilize o conteúdo do parâmetro aArquivoTX2 com encode ANSI.
Primeiros passos
Primeiro é necessário entender como é feita a montagem do Tx2:
O Tx2 sempre irá começar com a Tag INCLUIR* e finalizar com a Tag SALVAR*.
Exemplo do evento S-1000 do eSocial:
INCLUIRS1000
...
SALVARS1000
* Será adicionado o nome do respectivo documento/grupo que será incluído e/ou salvo.
Os campos são sempre montados na estrutura campo=valor e é interessante que sigam exatamente o nome disponibilizado na documento, sendo assim, case sensitive, respeitando-se as letras maiúsculas e minúsculas.
É importante evitar espaços em branco entre o Igual (=) ou antes do nome do campo(evite fazer a indentação do Tx2) pois em diversos casos esse espaço em branco é lido como caractere.
Correto:
tpAmb_4=2
Incorreto:
TPaMB_4 = 2
ou
TPAMB_4 = 2
ou
tpamb_4 = 2
ou
tpAamb_4 = 2
Outro ponto importante, é evitar quebras de linhas desnecessárias entre os campos bem como linhas em branco.
Uma questão que sempre traz dúvidas, separadores de milhar e decimal. No Tx2, você deverá usar apenas o separador de decimal, e o mesmo deve ser feito com o ponto ( . ), exceto o EFD-Reinf, onde o separado de decimal é a virgula ( , ).
Abaixo como deve ser informado o valor R$ 1.789,35 no Tx2.
Correto:
vlrBolsa_136=1789.35*
*Exceto EFD-Reinf
Incorreto:
vlrBolsa_136=1,789.35
ou
vlrBolsa_136=178935
ou
vlrBolsa_136=1.78935
ou
vlrBolsa_136=1789,35*
*Exceto EFD-Reinf
No EFD-Reinf, a forma correta seria assim:
vlrBolsa_136=1789,35
Grupos com múltiplas ocorrências
Nesses casos iremos utilizar o mesmo padrão de inclusão do arquivo, começar com a Tag INCLUIR* e finalizar com a Tag SALVAR* para cada registro que será adicionado, sempre respeitando a ocorrência minima/máxima desse grupo.
Exemplo do evento S-1050 do eSocial:
INCLUIRS1050
tpAmb_4=2
procEmi_5=1
verProc_6=1.0
tpInsc_8=1
nrInsc_9=13930441
codHorContrat_13=1
iniValid_14=2017-07
fimValid_15=
hrEntr_17=0800
hrSaida_18=1700
durJornada_19=480
perHorFlexivel_20=S
INCLUIRHORARIOINTERVALO_21
tpInterv_22=1
durInterv_23=15
iniInterv_24=0900
termInterv_25=0915
SALVARHORARIOINTERVALO_21
INCLUIRHORARIOINTERVALO_21
tpInterv_22=1
durInterv_23=15
iniInterv_24=1700
termInterv_25=1715
SALVARHORARIOINTERVALO_21
SALVARS1050
* Será adicionado o nome do respectivo documento/grupo que será incluído e/ou salvo.
Comentários
1 comentário
Link do e-Social quebrado
Por favor, entre para comentar.