1876 Configuracao Servicos

Área de Ferramentas

O recurso Configuração de Serviços centraliza os parâmetros utilizados por serviços e rotinas integradas do Touch ERP. Entre eles estão a distribuição de documentos fiscais, tarefas automáticas, consulta de preços, estatísticas comerciais, conciliação financeira e precificação de produtos.

Cada cadastro possui uma Descrição, uma Chave única do serviço e uma lista de Itens de configuração. Os itens exibidos dependem do serviço selecionado.

Acesso: Ferramentas > TI > Configurações > Configuração de Serviços — recurso 1876.

Configuração e execução do serviço

Este cadastro informa como o serviço deve funcionar. O agendamento e a execução, quando necessários, são definidos na tarefa ou na rotina que utiliza a configuração.

Salvar uma configuração não significa executar o serviço imediatamente. Para serviços em segundo plano, confira também a tarefa do servidor e seu resultado de processamento. Para configurações utilizadas em telas, selecione o cadastro na operação correspondente.

Antes de começar

Identifique o serviço que será configurado e reúna os dados solicitados por ele, como:

Identificadores das empresas e das configurações de certificado.
Ambiente de homologação ou produção, quando aplicável.
Credenciais da integração, quando solicitadas.
Endereços de consulta e modelos de apresentação, no caso de terminais de preços.
Avaliadores, tabelas de variáveis e critérios de custo, no caso da precificação.

Quando um item solicitar um ID, informe o identificador do cadastro indicado, e não sua descrição. O ID da empresa, por exemplo, não é o CNPJ.

Como cadastrar

Acesse o recurso e inicie um novo cadastro.
Informe uma Descrição que identifique o serviço e sua finalidade. Exemplo: Distribuição de CT-e — empresa principal.
Selecione a Chave única do serviço.
Aguarde o carregamento dos itens na grade.
Preencha a coluna Valor de cada parâmetro necessário, conforme a descrição do item e as orientações do serviço.
Confira os dados e salve.
Vincule ou utilize a configuração na tarefa ou rotina correspondente.
Confira o resultado de uma execução para confirmar o funcionamento.

O nome informado na descrição não escolhe o serviço. Essa escolha é feita pelo campo Chave única do serviço.

Campos do cadastro

Campo	Como utilizar
Descrição	Nome para identificar a configuração. É obrigatório.
Chave única do serviço	Selecione o tipo de serviço na lista. É obrigatório e determina os itens exibidos.
Identificador do item	Identificação do registro na grade, quando disponível. Não substitui os IDs solicitados na coluna Valor.
Item	Nome utilizado pelo sistema para identificar o parâmetro, como `id_empresa`.
Descrição do item	Explica o parâmetro e, em alguns casos, os códigos, separadores ou unidades esperados.
Valor	Conteúdo utilizado pelo serviço. É a coluna destinada ao preenchimento dos parâmetros.

Os itens são fornecidos pelo sistema conforme a chave escolhida. Não é necessário criar nomes de parâmetros manualmente.

Como alterar uma configuração existente

Localize e abra o cadastro.
Confira a chave do serviço e os valores já informados.
Altere somente os parâmetros necessários.
Salve e confira o comportamento na rotina que utiliza a configuração.

Ao abrir um cadastro existente, a tela atualiza a lista de parâmetros disponíveis para o serviço, preservando os valores dos itens que continuam disponíveis. Novos itens podem aparecer sem preenchimento; itens que deixaram de fazer parte do serviço não aparecem na lista atualizada.

Trocar manualmente a chave limpa a lista de valores da tela e carrega os itens do novo serviço em branco. Não utilize essa troca apenas para consultar parâmetros de outro serviço em um cadastro que deseja manter. Se a troca foi acidental, saia sem salvar e reabra o registro salvo.

Regras de preenchimento

Informe números sem símbolos monetários, sinais de percentual ou separadores de milhar, salvo orientação específica do item.
Nos parâmetros decimais desta grade textual, utilize ponto quando o serviço esperar um número decimal, como 2.5.
Utilize 0 e 1 para Não e Sim somente nos itens que adotam essa convenção. Outros campos possuem códigos próprios.
Respeite a unidade indicada: horas, dias, segundos e percentuais não são equivalentes.
Quando houver listas, utilize o separador indicado pelo próprio parâmetro.
Um campo em branco pode assumir um padrão ou impedir a execução, dependendo do serviço. Não trate o branco como uma opção geral de desativação.
Confira as credenciais e os modelos de integração com o responsável pela implantação. Utilize dados ilustrativos em exemplos e solicitações de ajuda, sem divulgar chaves secretas.

Salvar o cadastro confirma os campos gerais obrigatórios. A compatibilidade dos valores, a existência dos cadastros referenciados e a conexão com os serviços precisam ser conferidas na execução.

Serviços disponíveis

Distribuição de CT-e

Chave: distribuicao_xml_ctes.

Configura a consulta e distribuição de documentos de transporte. Os parâmetros incluem:

Item	Finalidade
`id_configuracao_certificado`	Identificação da configuração de certificado utilizada pelo serviço.
`id_empresa`	Empresa ou empresas abrangidas pela configuração, conforme o formato utilizado pela rotina.
`homologacao_producao`	Ambiente: `0` para homologação e `1` para produção.
`nsu_inicial`	Referência inicial de distribuição, utilizada também quando existe histórico de consulta em outro sistema.
`considerar_emp_destinatario`	Considerar a participação da empresa como destinatário: `0` Não; `1` Sim.
`considerar_empresa_remetente`	Considerar a empresa como remetente: `0` Não; `1` Sim.
`considerar_empresa_expedidor`	Considerar a empresa como expedidor: `0` Não; `1` Sim.
`considerar_empresa_recebedor`	Considerar a empresa como recebedor: `0` Não; `1` Sim.
`considerar_empresa_tomador`	Considerar a empresa como tomador: `0` Não; `1` Sim.

Para o procedimento específico, consulte Download/Distribuição de XML de CT-e.

Distribuição de NF-e

Chave: distribuicao_xml_nfes.

Os itens disponíveis são:

id_configuracao_certificado: configuração de certificado.
id_empresa: empresa ou empresas atendidas pela rotina.
homologacao_producao: 0 homologação; 1 produção.
considerar_apenas_notas_resp_empresa: considerar apenas notas sob responsabilidade da empresa, conforme o critério da rotina; 0 Não e 1 Sim.
nsu_inicial: referência inicial da distribuição.

O NSU representa a sequência utilizada na consulta dos documentos; não é o número da nota fiscal. Ajuste a posição inicial de acordo com o histórico que será utilizado pelo serviço.

Distribuição de NFS-e

Chave: distribuicao_xml_nfses.

Além de certificado, empresa, ambiente e NSU inicial, possui:

qtd_max_requisicoes_periodo: quantidade máxima de requisições controlada pela rotina de consulta.
timeout_entre_consultas: intervalo entre consultas, em segundos.

Na consulta documentada, quando não informados, o limite de requisições e o intervalo assumem o valor 20 cada. Ajuste esses parâmetros conforme a operação do serviço; eles não substituem o agendamento da tarefa.

Ciência automática de NF-e

Chave: ciencia_automatica_nfe.

Informe a configuração de certificado, a empresa e o parâmetro tipo_ciencia_fornecedor:

Valor	Comportamento
0	Não efetuar ciência automaticamente.
1	Efetuar ciência dos documentos abrangidos pela seleção da rotina.
2	Efetuar ciência desde que o fornecedor esteja cadastrado.
3	Efetuar ciência somente para fornecedores com ordens em aberto.

Selecione o critério definido para a operação da empresa. Ciência automática, confirmação da operação e download de XML são serviços distintos, com configurações próprias.

Confirmação automática de NF-e

Chave: confirmacao_automatica_nfe.

Os itens incluem:

id_configuracao_certificado: configuração de certificado.
id_empresa: empresa ou empresas atendidas.
delay_dias_lancamento: intervalo em dias considerado em relação ao lançamento na seleção dos documentos.
data_base: data de referência para a seleção dos documentos; precisa estar preenchida para essa execução. Informe no formato dd/MM/aaaa, por exemplo, 01/10/2026.
somente_notas_lib: restringir a seleção às notas liberadas internamente; 1 Sim e 0 Não.

Confirme os critérios com o responsável pelo processo de recebimento e manifestação antes de utilizar a rotina automática.

Download automático de NF-e

Chave: download_automatico_nfe.

Informe a configuração de certificado, a empresa e:

delay_apos_confirmacao: intervalo após a ciência ou confirmação da operação, em horas, conforme indicado na descrição do item.

O preenchimento desse intervalo não realiza a ciência nem a confirmação por si só; confira as etapas e as tarefas utilizadas no seu fluxo.

Avaliação de críticas de NF de terceiros

Chave: avaliacao_criticas_nf_terceiros.

Reúne critérios para avaliar informações cadastrais e de produtos nas notas de terceiros. Os grupos de parâmetros incluem:

Grupo	Como utilizar
Avaliações `avaliar_...`	Selecionam verificações de país, UF, cidade, logradouro, bairro, número, complemento, CEP, NCM, exceção de NCM e CEST. As opções de avaliação utilizam a convenção numérica Não/Sim.
Mensagens `msg_avaliar_...`	Referenciam mensagens de observação dinâmica pelo identificador, quando utilizadas. Não preencha esses itens como se fossem títulos livres.
Títulos `title_avaliar_...`	Permitem personalizar o título das mensagens correspondentes.
`percentual_avaliacao_similiraridade`	Define o percentual mínimo de similaridade nas comparações de texto, na escala de 0 a 100. Exemplo: `90` exige similaridade de pelo menos 90%. Confirme o resultado com exemplos conhecidos antes de ampliar o uso.
`id_usuario_responsavel`, `id_grupo_usuarios` e `id_prioridade_marketing`	Identificam os responsáveis, o grupo e a prioridade utilizados nos encaminhamentos da rotina.
`id_empresa`	Identifica a empresa da configuração.

Confira quais verificações são relevantes para o fluxo da empresa e as mensagens geradas em uma nota de teste conhecida.

Terminal de consulta de preços Gertec HTTP

Chave: terminal_consulta_precos_gertec_http.

Os itens disponíveis são:

url_consulta: endereços de consulta, separados por ; quando houver mais de um.
html_consulta: modelo HTML da apresentação do produto consultado.
media_manager_xml: conteúdo XML utilizado pelo Media Manager.
id_empresa: identificação da empresa utilizada na configuração.
html_consulta_prod_nao_encontrado: apresentação para produto não encontrado.

Utilize os modelos e endereços definidos para a implantação do terminal. Confira uma consulta com produto existente e outra com código não localizado.

Consulte também Terminais de Consulta de Preço GERTEC, link mantido da documentação anterior.

Estatísticas comerciais e IA

Chave: configuracoes_estatisticas_comerciais.

Configura o histórico e as origens de dados utilizadas nas análises comerciais:

dias_busca_historico: quantidade de dias de histórico a consultar.
incluir_ped_analise_recom_produtos: inclusão de pedidos na análise de recomendação de produtos.
incluir_nfe_analise_recom_produtos: inclusão de NF-e nessa análise.
incluir_nfce_analise_recom_produtos: inclusão de NFC-e nessa análise.

As opções de inclusão utilizam 1 para Sim e 0 para Não. Na rotina de recomendação documentada, os pedidos são incluídos mesmo quando o parâmetro de pedidos está em 0; confira essa limitação antes de considerar que foram retirados da análise. Para NF-e e NFC-e, confira os valores selecionados e os dados utilizados no resultado.

Consulte Configurações de Estatísticas Comerciais IA para as orientações específicas já existentes na wiki.

Conciliação financeira API

Chave: conciliacao_financeira_api.

Os parâmetros são:

cliente_id: identificador do cliente da integração.
cliente_secret: chave secreta desse cliente.

Esses dados são fornecidos para a integração; não correspondem ao identificador de um cliente comercial cadastrado no ERP. Preencha o par de credenciais da mesma integração e confira a conexão na rotina de conciliação.

Precificação de produtos

Chave: precificacao_produtos.

Define parâmetros utilizados nas operações de precificação, incluindo a configuração selecionada na Pré-Tabela de Preços.

Item	Como preencher
`id_empresas`	IDs das empresas para busca de dados, separados por `;`. Exemplo ilustrativo: `1;2`. Na operação da pré-tabela, quando não informado, é utilizada a empresa logada.
`tipo_busca_custo_tab_base`	Critério de custo: `0` Preço Médio; `1` Último Custo; `2` Valor Compra. Na operação da pré-tabela, o padrão sem preenchimento é Último Custo.
`numero_casas_decimais`	Número inteiro de casas decimais. Na operação documentada, o padrão é `2`.
`fracao_base_arredondamento`	Parâmetro de arredondamento. Veja a observação de compatibilidade abaixo antes de configurar frações.
`avaliadores_precificacao`	Grupos com ID do avaliador, ID da tabela de variáveis e tipo de preço. Veja o formato abaixo.
`tolerancia_acima`	Percentual de tolerância acima utilizado na criação dos cenários de análise.
`tolerancia_abaixo`	Percentual de tolerância abaixo utilizado na criação dos cenários de análise.

Formato dos avaliadores de precificação

Cada grupo possui três números separados por vírgula:

ID_AVALIADOR,ID_TABELA_VARIAVEIS,TIPO_PRECO

Separe vários grupos por ponto e vírgula:

15,31,0;15,32,1;15,33,2

Os números são ilustrativos. Nesse exemplo:

15,31,0: avaliador 15 com tabela de variáveis 31 para o preço de venda.
15,32,1: avaliador 15 com tabela de variáveis 32 para o preço mínimo.
15,33,2: avaliador 15 com tabela de variáveis 33 para o preço máximo.

Os tipos válidos são 0 — Venda, 1 — Mínimo e 2 — Máximo. Não utilize 3 como tipo de preço, mesmo que apareça em um exemplo antigo da descrição do parâmetro.

O segundo número é o identificador do cadastro 1609 — Tabela de Variáveis, e não o código do contexto de avaliação do recurso 1536.

Confira os avaliadores no recurso 1536 — Avaliação de Expressões e as chaves e valores das respectivas tabelas. Na operação documentada da pré-tabela, esses grupos são utilizados para criar a análise quando o produto ainda não possui uma; alterar a configuração não substitui automaticamente todos os cenários existentes.

Compatibilidade do arredondamento

Na operação atual da Pré-Tabela de Preços, fracao_base_arredondamento é lido como número inteiro. O exemplo 0.05 apresentado na descrição do item não é compatível com essa operação na versão documentada.

Para manter o padrão desse parâmetro, informe 0 ou deixe-o em branco. Para configurar arredondamento por frações de centavos, confirme com o suporte a forma compatível com a versão e a operação utilizadas. O número de casas decimais é configurado separadamente.

Como conferir o funcionamento

Confirme qual cadastro a tarefa ou operação utiliza. A descrição semelhante de dois registros não garante que ambos sejam consultados.
Confira empresa, certificado, ambiente e demais identificadores aplicáveis.
Execute a tarefa ou operação correspondente em um caso conhecido.
Consulte o resultado, as mensagens e os dados gerados.
Caso altere os parâmetros, repita a conferência antes de considerar a configuração concluída.

Para tarefas automáticas, confira o cadastro e o agendamento em Tarefas do Servidor. A frequência de execução não é definida pelo nome ou pela descrição deste cadastro.

Dúvidas e problemas frequentes

Situação	O que verificar
Não é possível salvar	Preencha a Descrição e selecione a Chave única do serviço.
A grade está vazia	Confira se uma chave foi selecionada e se o carregamento dos itens terminou. Verifique eventual mensagem de erro.
Os valores desapareceram após selecionar outro serviço	A troca manual da chave carrega os parâmetros do novo serviço em branco. Se a troca foi acidental e não foi salva, reabra o cadastro salvo.
Surgiram novos itens ao abrir uma configuração	A tela carrega a lista atual de parâmetros do serviço. Confira se os novos itens precisam de preenchimento.
O cadastro foi salvo, mas nada foi executado	Confira a tarefa, o agendamento ou a operação que utiliza a configuração. Salvar não dispara todos os serviços automaticamente.
O serviço informa empresa, certificado ou cadastro não encontrado	Confira os IDs informados e se correspondem aos cadastros utilizados pela rotina.
O serviço informa valor ou formato inválido	Confira códigos, separadores, datas e unidades. Nos grupos de precificação, cada grupo precisa de três valores separados por vírgula.
A precificação falha ao informar 0.05 no arredondamento	Confira a observação de compatibilidade desta página. Na operação documentada da pré-tabela, esse item espera um inteiro.
A alteração não afeta a operação esperada	Confira se a operação utiliza esse cadastro e se precisa ser executada novamente. Na precificação, confira também os cenários já existentes no produto.