Boas práticas do TX2

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:

 * 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:

Incorreto:

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:

*Exceto EFD-Reinf 

Incorreto:

 *Exceto EFD-Reinf 

No EFD-Reinf, a forma correta seria assim:

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:

 * Será adicionado o nome do respectivo documento/grupo que será incluído e/ou salvo.