A integração de utilities é feito a partir do envio destes documentos para a OCR no portal da Qive, após o envio estes documentos de energia, água, gás e telecom são tratados e disponibilizados para integração ao Qive Conexões TOTVS Protheus via API.
Pré-requisitos
Caso já tenha contratado na Qive a captura para Utilities, solicite a liberação ao gerente da sua conta para enviar estes documentos para o OCR, ou então ao time de suporte Qive. Caso ainda não tenha realizado a contratação você pode solicitar um orçamento.
Atualize o Qive Conexões TOTVS Protheus para a versão mais recente conforme link aqui.
Parametrizações envolvidas
Já no Qive Conexões TOTVS Protheus acesse a opção Outras ações - Parâmetros, aba Utilities e defina as Espécies relacionada a cada tipo de documento, caso possua mais de 1 espécie pode informar separado por ;.
Poderá também definir o produto padrão, não é obrigatório pois poderá informar manual também no momento da importação.
Caso seja informado mais de uma espécie no campo, ele ficará habilitado para edição na tela de importação. Caso tenha somente uma espécie informada, a mesma é carregada e o campo fica desabilitado para edição.
Configurações envolvidas
Com a possibilidade de incluir utilities no Protheus, houve um problema referente ao CNPJ de destino do documento, ou o Tomador. Algumas empresas emitem o documento com caracteres especiais para esconder o CNPJ, com isso o Qive Conexões não sabe para qual filial o documento pertence e acaba desconsiderando.
Então em Outras ações - Configurações - De/Para UN. Cons. x Filial foi criado a opção do cliente cadastrar a amarração de Unidade Consumidora x CNPJ da Filial:
Ao incluir um novo registro, são solicitados os seguintes campos:
● CNPJ da Filial
● Unidade Consumidora Energia
● Unidade Consumidora Água
● Unidade Consumidora Gás
IMPORTANTE: O preenchimento da Unidade Consumidora e CNPJ devem ser feitos utilizando apenas números, sem a inclusão de pontos ou barras.
Na prática como funciona
Quando o sistema capturar uma utilitie, seja de energia, água ou gás, primeiro vai tentar identificar o CNPJ do destinatário que veio no documento. Caso não consiga, irá pegar o Código da Unidade Consumidora e buscar na tabela de De/Para. Se encontrar, colocará o documento na filial correspondente. Agora, se o sistema não conseguir identificar o CNPJ e não encontrar um registro de De/Para, o documento é colocado na primeira filial válida, porém com uma nova legenda de ‘Utilitie s/ Filial encontrada’ e impedindo a importação desse documento.
Para que o sistema permita a importação desses documentos nessa legenda, é necessário verificar o cadastro de De/Para e inserir a amarração, conforme mostra a mensagem de erro ao tentar importar o documento:
Após feito as parametrizações e configurações acima mencionadas poderá seguir com a importação do documento seja manual ou via regra automática.
Neste vídeo mostramos como realizar a importação de Utilities.
Dicionário envolvido
ARQV_UTPD - URL para download de PDF de Utilitie
ARQV_UUTI - Url para download das utilities
ARQV_PUTI - Controle de paginação do download de utilities
MV_XGTTABD - Código da tabela de amarração de Utilitie x Filial.
MV_XGTESPE - Espécie para utilitie de Energia
MV_XGTESPW - Espécie para utilitie de Água
MV_XGTESPT - Espécie para utilitie de Telecom
MV_XGTESPG - Espécie para utilitie de Gás
MV_XGTUEPR - Produto padrão para utilitie de Energia
MV_XGTUAPR - Produto padrão para utilitie de Água
MV_XGTUTPR - Produto padrão para utilitie de Telecom
MV_XGTUGPR - Produto padrão para utilitie de Gás