Definição da Regra de Vínculo com Documento Anterior na Importação de Lote Guia

1) Para um primeiro entendimento todo arquivo Lote Guia (Internação, Honorários e SADT) o sistema grava o número da guia do GPS (guiautor) no campo docrecon.dec-3. Esse número vem da tag <ans:numeroGuiaOperadora> e é uma guia existente no sistema. Grava também o número da guia do prestador no campo docrecon.char-1, esse número vem da tag <ans:numeroGuiaPrestador> no XML. E no campo docrecon.dec-2 é gravado as informações conforme o tipo do XML. <ans:numeroGuiaSolicitacaoInternacao> para Internação, <ans:guiaPrincipal> para SADT e <ans:guiaSolicInternacao> para Honorários.

2) Atualmente o sistema permite realizar vínculo com documento anterior em três tipos de XML: Internação, Honorários e SADT.

Ou seja, é possível vincular:

• Internação  com --> Internação
• Honorários  com --> Internação
• SADT        com --> Internação

3) Qual tag o sistema utiliza para vincular com o XML de Internação?

Cada tipo de XML existe uma tag específica para vínculo com o documento anterior de Internação:

XML Internação


XML Honorários


XML SADT


Então a regra fica da seguinte forma:

Ponto de Atenção: essa tag é opcional, não é obrigatório o vínculo com o documento anterior.

4) Como funciona internamente o processo de vínculo com documento anterior?

Primeiramente o sistema verifica se a tag de vínculo está preenchida:



Após essa validação o sistema realiza a busca pelo documento anterior, essa busca é realizada de quatro formas:

#1 Busca um documento na base com o mesmo prestador e período do XML que está sendo importado:

Após a busca, efetuasse uma verificação em três etapas para o vínculo.

Primeiro, é verificado se a tag de vínculo é igual ao campo numeroGuiaOperadora do documento na base. Caso sim, efetua o vínculo.

Segundo, é verificado se a tag de vínculo é igual ao campo numeroGuiaPrestadora do documento na base. Caso sim, efetua o vínculo.

Terceiro, é verificado se o documento da base possui ano (docrecon.aa-guia-atendimento) e número da guia (docrecon.nr-guia-atendimento) com os mesmos valores definidos através do cadastro de parâmetros de importação do prestador do xml que está sendo importado. Caso sim, efetua o vínculo.

#2 Se não encontrou na busca anterior, Busca um documento do mesmo lote que está sendo importado com o mesmo prestador e período do XML importado:


Realiza as mesmas validações da primeira busca e grava as informações do documento anterior, caso encontrar o mesmo número de guia.


#3 Se não encontrou na busca anterior, Busca um documento do mesmo período e número de guia do XML importado:


Realiza as mesmas validações da primeira busca e grava as informações do documento anterior, caso encontrar o mesmo número de guia.

#4 Se não encontrou na busca anterior, Busca um documento do mesmo período e número de guia do XML importado:

Realiza as mesmas validações da primeira busca e grava as informações do documento anterior, caso encontrar o mesmo número de guia.

5) Estudo de Caso

Importando primeiro um XML de Internação e após, importar um XML de Honorários, o sistema realizou o vínculo da seguinte forma:

XML Internação


XML Honorários

Mesmo número de Guia: 201803458147. Guia existente no TOTVS.

É possível observar nas duas imagens anteriores, que os XMLs são de prestadores diferentes. O de Internação é o prestador: 970-109518, o de Honorários é o prestador: 970-128574. O sistema permite vincular documentos de prestadores iguais e também XMLs de prestadores diferentes.

O sistema realizou o vínculo conforme pode ser visto na tela de dados do documento:

Em azul o documento original importado (Honorários). Em vermelho o documento vinculado (Internação).