Introdução

O EDI é um canal de comunicação que visa a integração de qualquer sistema com o TSS. Dessa forma, qualquer ERP pode emitir documentos eletrônicos como Nota Fiscal de Serviço, Nota Fiscal Eletrônica, Eventos da SEFAZ, Capa de Lote e Conhecimento de Transporte.

Os Jobs que devem ser adicionados no INI para utilização do EDI estão descritos no item Configuração do EDI.

Para que a integração ocorra, o EDI do TSS Manager deve receber o documento que pode ser disponibilizado de algumas formas:

Arquivo XML.
Web Service.

Os processos que compõem o EDI são:

Importação.
Transmissão.
Exportação.
Impressão.

Fluxo de Processamento do EDI

Após a importação com sucesso pelo EDI, o arquivo é transmitido para que o TSS processe o documento eletronicamente, enquanto isso, o processo de Exportação verifica se o arquivo transmitido já tem um retorno para ser exportado.

A impressão é feita apenas quando o documento enviado está autorizado para uso.

Exemplo: NF-e foi autorizada na SEFAZ.

Toda configuração do EDI deve ser feita através da interface do TSS Manager em dois locais.

Configurações / Geral

Configurações / Entidades.

Selecione a opção Configurar e, em seguida, a pasta de EDI (essa configuração deve ser entidade por entidade).

A impressão é feita no processo paralelo com a exportação, pois, é feita a verificação do status do documento para que seja impresso assim como a exportação.

Documentos Contemplados pelo EDI

Os documentos atendidos pelo TSS Manager na integração feita através do EDI são:

Nota Fiscal Eletrônica: o leiaute do documento a ser enviado deve ser o mesmo padrão da SEFAZ.
- Envio
- Cancelamento
- Inutilização

Nota Fiscal de Serviço Eletrônica: o leiaute do documento a ser enviado deve ser o mesmo padrão das prefeituras.
- Envio.
- Substituição.

Carta de Correção: o leiaute do documento a ser enviado deve ser conforme descrito no item Leiaute XML dos documentos.
Capa de lote eletrônica: o leiaute do documento a ser enviado deve ser conforme descrito no item Leiaute XML dos documentos.

Arquivo XML

A integração com arquivo XML acontece quando o sistema cria o arquivo em uma pasta configurada para leitura, que é feita através de processos do EDI. Esse XML tem um leiaute padrão disponibilizado pela TOTVS.

Quando o processo verifica a existência de um ou mais arquivos, ele automaticamente importa para o TSS Manager com o objetivo de começar o processo de integração e envio do documento.

O retorno desse processamento ocorre no momento em que o EDI gera um arquivo de exportação, também, com um leiaute definido pela TOTVS em uma pasta configurada para exportação, assim, o sistema pode ler o arquivo exportado e alimentar sua base com as informações deste retorno.

Web Service

A integração do EDI via Web Service é a melhor, segura e mais rápida forma de enviar os documentos de um sistema para o TSS Manager processar o documento. Para isso, é necessário que o sistema utilizado para controlar o envio dos documentos seja preparado para integrar com o Web Service do EDI, de acordo com o seguinte padrão:

Web Service: TSSManagerEDI. Esse é o Web Service responsável pela integração do sistema com o EDI do TSS Manager.

Métodos

Este método deve ser utilizado para que seja enviado ao TSS Manager EDI o documento que será processado e enviado eletronicamente.

Estrutura:

Parâmetros de entrada:

<USERTOKEN>Alfanumérico</USERTOKEN>

</MESSAGE>

</MESSAGES>

</SENDMESSAGEEDI>

Parâmetro	Tipo	Tam	Pai	Observação
USERTOKEN	Alfanumérico	006	SENDMESSAGEEDI	Token de bilhetagem para execução do serviço.
MESSAGES	Tag Raiz	--	SENDMESSAGEEDI	Tag Raiz das mensagens.
MESSAGE	Tag Raiz	--	MESSAGES	Tag Raiz da Mensagem.
XML	Base64	1-500KB	MESSAGE	XML com o documento a ser importado no EDI (Verificar item “Leiaute XML EDI” deste documento).

Parâmetros de saída:

<DOCS>

<CODE>Numeric</CODE>

<ID>AlfaNumerico</ID>

<MESSAGE>AlfaNumerico</MESSAGE>

</DETDOC>

</DOCS>

</SENDMESSAGEEDIRESULT>

</SENDMESSAGEEDIRESPONSE>

Parâmetro	Tipo	Tam	Pai	Observação
DOCS	Tag Raiz	--	SENDMESSAGEEDIRESULT	Retorno dos documentos.
DETDOC	Tag Raiz	--	DOCS	Informações do processamento do documento.
CODE	Numérico	02	DETDOC	Código de retorno do processamento de gravação do arquivo.
ID	Alfanumérico	unbouded	DETDOC	ID de Identificação da mensagem.
MESSAGE	Alfanumérico	0-250	DETDOC	Descrição do código de retorno.

Método de consulta por ID dos documentos enviados pelo EDI para o TSS.

Estrutura:

Parâmetros de entrada:

<USERTOKEN>Alfanumérico</USERTOKEN>

<CPFCNPJ>Numérico</CPFCNPJ>

<MODELO>Alfanumérico</MODELO>

<IDINI>String</IDINI>

<IDFIM>String</IDFIM>

</RECEIVEDOCEDI>

Parâmetro	Tipo	Tam	Pai	Observação
USERTOKEN	Alfanumérico	006	RECEIVEDOCEDI	Token de bilhetagem para execução do serviço.
CPFCNPJ	Numérico	11-14	RECEIVEDOCEDI	CPF/CNPJ do remetente do documento ao EDI.
MODELO	Alfanumérico	02	RECEIVEDOCEDI	Modelo do documento: 55=nfe 56=nfse 110110=Carta de Correção Cle=Capa de Lote
IDINI	Alfanumérico	unbouded	RECEIVEDOCEDI	Número do ID Inicial
IDFIM	Alfanumérico	Unbouded	RECEIVEDOCEDI	Número do ID Final

Parâmetros de saída:

<IDENTIFICACAO>String</IDENTIFICACAO>

</RETDETDOC>

</RETDOCS>

</RECEIVEDOCEDIRESULT>
</SENDMESSAGEEDIRESPONSE>

Parâmetro	Tipo	Tam	Pai	Observação
RETDOCS	Tag Raiz	--	RECEIVEDOCEDIRESULT	Documentos retornados.
RETDETDOC	Tag Raiz	--	RETDOCS	Dados do documento.
IDENTIFICACAO	String	50	RETDETDOC	Identificação do documento.
XML	Base64	1-500KB	RETDETDOC	XML de retorno com o documento importado no EDI (Verificar item “Leiaute XML EDI” deste documento).

Páginas filhas

EDI - TSS Manager