Novo versionamento das APIs disponibilizadas pelo TOTVS Transmite
Novas Funcionalidades:
DHY_DTID
Finalidade do campo: Apagar recibos não lidos a mais de 5 dias.
Processo:
Toda vez que for gerado um novo recibo (DHY_ID) será gravada a data da geração do mesmo.
Após feita leitura do recibo e o mesmo ainda se encontrar pendente (status = 0) e sua data de geração for maior do que 5 dias, entendemos que este recibo não terá nenhum retorno, e por isso, ele será deletado da tabela (DHY).
DHY_FILTRO
Finalidade do campo: Salvar filtro utilizado ao solicitar um novo recibo, para não gerar um novo recibo (DHY) enquanto o anterior não foi lido (tenha retorno do Transmite).
Processo:
Toda vez que for gerado um novo recibo (DHY_ID) será gravada o filtro utilizado naquela requisição.
Ex: Filtro por tipo de documento:
Versões anteriores a V3:
NFe
CodigoFilial eq '9D5720A81A7F86EC97998D4BE5FBD7E8D0ACD06D' and DhEmi ge '2022-01-17T00:00:00' and DhEmi le '2023-01-17T23:59:59' and IntegracaoERP eq 'Pendente'
NFs
CodigoFilial eq '9D5720A81A7F86EC97998D4BE5FBD7E8D0ACD06D' and DataEmissao ge '2022-01-17T00:00:00' and DataEmissao le '2023-01-17T23:59:59' and IntegracaoERP eq 'Pendente'
CTe/CTeOs
CodigoFilial eq '9D5720A81A7F86EC97998D4BE5FBD7E8D0ACD06D' and Emissao ge '2022-01-17T00:00:00' and Emissao le '2023-01-17T23:59:59' and CpfCnpjTomador eq 'XXXXXXXXXXXXXX' and IntegracaoERP eq 'Pendente'
Versões a partir da V3:
Será avaliado parâmetro MV_DTINITR, caso preenchido será solicitado a partir da data informada no parâmetro, caso esteja em branco não haverá filtro de data na requisição.
NFe
MV_DTINITR (Preenchido)
CodigoFilial eq '9D5720A81A7F86EC97998D4BE5FBD7E8D0ACD06D' and DhEmi ge '2022-01-17T00:00:00' and IntegracaoERP eq 'Pendente' and Ator eq 'Destinatario'
MV_DTINITR (Em branco)
CodigoFilial eq '9D5720A81A7F86EC97998D4BE5FBD7E8D0ACD06D' and IntegracaoERP eq 'Pendente' and Ator eq 'Destinatario'
NFs
MV_DTINITR (Preenchido)
CodigoFilial eq '9D5720A81A7F86EC97998D4BE5FBD7E8D0ACD06D' and DataEmissao ge '2022-01-17T00:00:00' and IntegracaoERP eq 'Pendente'
MV_DTINITR (Em branco)
CodigoFilial eq '9D5720A81A7F86EC97998D4BE5FBD7E8D0ACD06D' and IntegracaoERP eq 'Pendente'
CTe/CTeOS
MV_DTINITR (Preenchido)
CodigoFilial eq '9D5720A81A7F86EC97998D4BE5FBD7E8D0ACD06D' and Emissao ge '2022-01-17T00:00:00' and CpfCnpjTomador eq 'XXXXXXXXXXXXXX' and IntegracaoERP eq 'Pendente'
MV_DTINITR (Em branco)
CodigoFilial eq '9D5720A81A7F86EC97998D4BE5FBD7E8D0ACD06D' and CpfCnpjTomador eq 'XXXXXXXXXXXXXX' and IntegracaoERP eq 'Pendente'
Quando for solicitar um recibo novamente, será avaliado se existe algum recibo pendente (status=0) com o mesmo filtro. Caso já exista não será gerado um novo recibo até que esse anterior seja lido (tenha retorno do Transmite).
MV_DTINITR
Finalidade do parâmetro: Informar data de inicio da integração Importador XML x TOTVS Transmite
Processo:
Ao informar documentos na CKO que sejam inferiores a data, serão ajustados (CKO_STRAN = '0'), dessa forma esses documentos não sofreram tentativas de atualização de status no TOTVS Transmite. Já os documentos que seja a partir da data serão analisados para que seja atualizado corretamente no TOTVS Transmite
MV_DOCREQ (V3)
Finalidade do parâmetro: Informar quantos documentos requisitar ao TOTVS Transmite por tipo de documento
Parâmetro:
MV_DOCREQ
Tipo:
Numérico
Conteúdo:
500 (Default)
Descrição:
Informar a quantidade de documentos a serem requisitados ao TOTVS Transmite
Processo:
Ao informar o parâmetro, podendo ser de 1 a 1000 (Default: 500), cada requisição de documentos ao TOTVS Transmite, eles poderão retornar a requisição com a quantidade informada no parâmetro.
Ganhos: Pode-se aumentar o tempo de recorrência da chamada do agendamento SCHEDIMPTRA, pois com menos requisições, podendo retornar mais documentos.
SCHEDIMPTRA
Finalidade do agendamento: Separar em processos a integração Importador XML x TOTVS Transmite
Processo:
Ao executar agendamento, será requisitado e lido os recibos que o TOTVS Transmite retornou.
SCHEDUPDTRA
Finalidade do agendamento: Separar em processos a integração Importador XML x TOTVS Transmite
Processo:
Ao executar agendamento, será atualizado documentos no TOTVS Transmite
Novas APIs TOTVS Transmite (V3)
Fonte COMTRANSMITE a partir:
Processo:
Retorno de quantidade de documentos por requisição (MV_DOCREQ):
Anterior a 15/02/2024:
Quantidade de documentos por requisição estava limitada a 50 documentos.
A partir de 15/02/2024:
Quantidade de documentos por requisição é definida pelo parâmetro MV_DOCREQ, que pode ser de 1 a 1000 (Default 500)
Atualização em Lote:
Anterior a 15/02/2024:
Atualização do status no TOTVS Transmite ocorria documento por documento.
A partir de 15/02/2024:
Atualização do status no TOTVS Transmite ocorre do 300 em 300 documentos.
MV_BULKTR
Fonte COMTRANSMITE a
Finalidade do parâmetro: Definir se gravação das tabelas CKO/DHY/DHZ serão feitas através do FwBulk, onde há ganho de performance na inserção de novos registros.
Processo:
F (Default): Gravação das tabelas através de RecLock
T : Gravação das tabelas através do FwBulk
Observação: Uma vez configurado, a nomenclatura do arquivo deixara de ser sequencial e passara a ser randômico para ganho de performance.
Parâmetro:
MV_BULKTR
Tipo:
Logico
Conteúdo:
F (Default)
Descrição:
Indica se gravação de novos registros seja feito via Bulk
MV_MTHRTR
Fonte COMTRANSMITE a
Finalidade do parâmetro: Definir se leitura dos recibos serão realizadas via multi thread
Processo:
1 (Default): Leitura dos recibos com 1 Thread
2 até 5 : Leitura dos recibos em N Threads
Parâmetro:
MV_MTHRTR
Tipo:
Numérico
Conteúdo:
1 (Default)
Descrição:
Numero de Threads disponível para leitura de recibos
Tempo aproximado para leitura: 4 minutos