Skip to content
Documentação IntegraDoor

Cancelamento de Guia

tissCancelaGuia

Cancela uma guia

Campos obrigatórios (TISS 4.01.00)

  • ans:tipoTransacao: CANCELA_GUIA
  • ans:sequencialTransacao: identificador único por transação
  • ans:dataRegistroTransacao e ans:horaRegistroTransacao
  • ans:codigoPrestadorNaOperadora: código do prestador credenciado
  • ans:registroANS: número da operadora de destino
  • ans:loginPrestador e ans:senhaPrestador: credenciais IntegraDoor (senha em MD5)
  • ans:numeroGuiaPrestador: número da guia a ser cancelada
  • ans:tipoGuia: tipo da guia (1 = SP/SADT, 2 = Internação etc.)
  • ans:hash: valor opcional para controle de integridade
<?xml version="1.0" ?>
<soapenv:Envelope xmlns:ans="http://www.ans.gov.br/padroes/tiss/ansemas" xmlns:soapenv="http://ansemas.xmlsoap.org/soap/envelope/" soapenv:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
  <soapenv:Body>
    <ans:cancelaGuiaWS>
      <ans:cabecalho>
        <ans:identificacaoTransacao>
          <ans:tipoTransacao>CANCELA_GUIA</ans:tipoTransacao>
          <ans:sequencialTransacao>250525020314</ans:sequencialTransacao>
          <ans:dataRegistroTransacao>2025-05-25</ans:dataRegistroTransacao>
          <ans:horaRegistroTransacao>02:03:14.100Z</ans:horaRegistroTransacao>
        </ans:identificacaoTransacao>
        <ans:origem>
          <ans:identificacaoPrestador>
            <ans:codigoPrestadorNaOperadora>GUID_Credencial</ans:codigoPrestadorNaOperadora>
          </ans:identificacaoPrestador>
        </ans:origem>
        <ans:destino>
          <ans:registroANS>123456</ans:registroANS>
        </ans:destino>
        <ans:Padrao>4.01.00</ans:Padrao>
        <ans:loginSenhaPrestador>
          <ans:loginPrestador>login_IntegraDoor</ans:loginPrestador>
          <ans:senhaPrestador>senha_IntegraDoor_md5</ans:senhaPrestador>
        </ans:loginSenhaPrestador>
      </ans:cabecalho>
      <ans:cancelaGuia>
        <ans:dadosPrestador>
          <ans:codigoPrestadorNaOperadora>GUID_Credencial</ans:codigoPrestadorNaOperadora>
        </ans:dadosPrestador>
        <ans:tipoCancelamento>
          <ans:tipoCancelamentoGuia>
            <ans:tipoGuia>1</ans:tipoGuia>
            <ans:numeroGuiaPrestador>1234567890</ans:numeroGuiaPrestador>
          </ans:tipoCancelamentoGuia>
        </ans:tipoCancelamento>
      </ans:cancelaGuia>
      <ans:hash>8a87e61fc52c9ebc56040bf2c2d5b908</ans:hash>
    </ans:cancelaGuiaWS>
  </soapenv:Body>
</soapenv:Envelope>

Resposta Sucesso

<?xml version="1.0" ?>
<s:Envelope xmlns:s="http://ansemas.xmlsoap.org/soap/envelope/">
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLansema-instance" xmlns:xsd="http://www.w3.org/2001/XMLansema">
    <reciboCancelaGuiaWS xmlns="http://www.ans.gov.br/padroes/tiss/ansemas">
      <cabecalho>
        <identificacaoTransacao>
          <tipoTransacao>CANCELAMENTO_GUIA_RECIBO</tipoTransacao>
          <sequencialTransacao>250525020314</sequencialTransacao>
          <dataRegistroTransacao>2025-05-24</dataRegistroTransacao>
          <horaRegistroTransacao>23:03:16</horaRegistroTransacao>
        </identificacaoTransacao>
        <origem>
          <registroANS>123456</registroANS>
        </origem>
        <destino>
          <identificacaoPrestador>
            <codigoPrestadorNaOperadora>07729954000189</codigoPrestadorNaOperadora>
          </identificacaoPrestador>
        </destino>
        <Padrao>4.01.00</Padrao>
      </cabecalho>
      <reciboCancelaGuia>
        <reciboCancelaGuia>
          <registroANS>123456</registroANS>
          <dadosPrestador>
            <codigoPrestadorNaOperadora>07729954000189</codigoPrestadorNaOperadora>
          </dadosPrestador>
          <retornoStatus>
            <guiasCanceladas>
              <dadosGuia>
                <tipoGuia>1</tipoGuia>
                <numeroGuiaPrestador>1234567890</numeroGuiaPrestador>
                <statusCancelamento>1</statusCancelamento>
              </dadosGuia>
            </guiasCanceladas>
          </retornoStatus>
        </reciboCancelaGuia>
      </reciboCancelaGuia>
      <hash>354a8f6e6575a91436d06a1c2ee70d25</hash>
    </reciboCancelaGuiaWS>
  </s:Body>
</s:Envelope>

Resposta Erro

<S:Envelope xmlns:S="http://ansemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <reciboCancelaGuiaWS xmlns="http://www.ans.gov.br/padroes/tiss/ansemas" xmlns:ns2="http://www.w3.org/2000/09/xmldsig#">
         <cabecalho>
            <identificacaoTransacao>
               <tipoTransacao>CANCELAMENTO_GUIA_RECIBO</tipoTransacao>
               <sequencialTransacao>1010100001</sequencialTransacao>
               <dataRegistroTransacao>2025-05-24</dataRegistroTransacao>
               <horaRegistroTransacao>23:01:57</horaRegistroTransacao>
            </identificacaoTransacao>
            <origem>
               <registroANS>123456</registroANS>
            </origem>
            <destino>
               <identificacaoPrestador>
                  <codigoPrestadorNaOperadora>07729954000189</codigoPrestadorNaOperadora>
               </identificacaoPrestador>
            </destino>
            <Padrao>4.01.00</Padrao>
         </cabecalho>
         <reciboCancelaGuia>
            <mensagemErro>
               <codigoGlosa>3148</codigoGlosa>
               <descricaoGlosa>TIPO DE TRANSACAO INVALIDO</descricaoGlosa>
            </mensagemErro>
         </reciboCancelaGuia>
         <hash>9f23e0c229d026f887377e198314ecd4</hash>
      </reciboCancelaGuiaWS>
   </S:Body>
</S:Envelope>

Códigos de glosa

  • 1301 - Tipo de guia inválido
  • 1307 - Número de guia inválido
  • 1321 - Validade da guia expirada
  • 1404 - Não existe guia de autorização relacionada
  • 3148 - Tipo de transação inválido