Cancelamento de Guia

tissCancelaGuia

O método tissCancelaGuia é utilizado para registrar a solicitação de cancelamento de uma guia autorizada previamente, como guias de SP/SADT, internação, entre outras. Esta transação é realizada por meio do IntegraDoor, conforme especificação do padrão TISS 4.01.00.

Info

É importante observar que o comportamento das operadoras em relação ao cancelamento pode variar. Algumas operadoras processam o cancelamento imediatamente, enquanto outras mantêm a solicitação em análise por até 24 horas antes de confirmar o cancelamento. Além disso, cancelamentos solicitados após 5 dias da autorização original, via de regra, somente poderão ser realizados por contato direto com a operadora — seja por telefone ou por meio do portal online da própria operadora.

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

Exemplo de Requisição

<?xml version="1.0" ?>
<soapenv:Envelope xmlns:sch="http://www.ans.gov.br/padroes/tiss/schemas"
          soapenv:encodingStyle="http://www.w3.org/2003/05/soap-encoding"
          xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
          <soapenv:Body>
            <sch:cancelaGuiaWS>
              <sch:cabecalho>
                <sch:identificacaoTransacao>
                  <sch:tipoTransacao>CANCELA_GUIA</sch:tipoTransacao>
                  <sch:sequencialTransacao>250527112105</sch:sequencialTransacao>
                  <sch:dataRegistroTransacao>2025-01-16</sch:dataRegistroTransacao>
                  <sch:horaRegistroTransacao>11:21:05.892Z</sch:horaRegistroTransacao>
                </sch:identificacaoTransacao>
                <sch:origem>
                  <sch:identificacaoPrestador>
                    <sch:codigoPrestadorNaOperadora>00000000-0000-0000-0000-000000000000</sch:codigoPrestadorNaOperadora>
                  </sch:identificacaoPrestador>
                </sch:origem>
                <sch:destino>
                  <sch:registroANS>000000</sch:registroANS>
                </sch:destino>
                <sch:Padrao>4.01.00</sch:Padrao>
                <sch:loginSenhaPrestador>
                  <sch:loginPrestador>[email protected]</sch:loginPrestador>
                  <sch:senhaPrestador>aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa</sch:senhaPrestador>
                </sch:loginSenhaPrestador>
              </sch:cabecalho>
              <sch:cancelaGuia>
                <sch:dadosPrestador>
                  <sch:codigoPrestadorNaOperadora>00000000-0000-0000-0000-000000000000</sch:codigoPrestadorNaOperadora>
                </sch:dadosPrestador>
                <sch:tipoCancelamento>
                  <sch:tipoCancelamentoGuia>
                    <sch:tipoGuia>1</sch:tipoGuia>
                    <sch:numeroGuiaPrestador>99999999</sch:numeroGuiaPrestador>
                  </sch:tipoCancelamentoGuia>
                </sch:tipoCancelamento>
              </sch:cancelaGuia>
              <sch:hash>ffffffffffffffffffffffffffffffff</sch:hash>
            </sch:cancelaGuiaWS>
          </soapenv:Body>
</soapenv:Envelope>

Resposta Sucesso

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.ans.gov.br/padroes/tiss/schemas" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <ns1:reciboCancelaGuiaWS>
            <ns1:cabecalho>
                <ns1:identificacaoTransacao>
                    <ns1:tipoTransacao>CANCELAMENTO_GUIA_RECIBO</ns1:tipoTransacao>
                    <ns1:sequencialTransacao>250527112105</ns1:sequencialTransacao>
                    <ns1:dataRegistroTransacao>2025-07-19</ns1:dataRegistroTransacao>
                    <ns1:horaRegistroTransacao>04:28:01.864Z</ns1:horaRegistroTransacao>
                </ns1:identificacaoTransacao>
                <ns1:origem>
                    <ns1:registroANS>309222</ns1:registroANS>
                </ns1:origem>
                <ns1:destino>
                    <ns1:identificacaoPrestador xsi:type="ns1:identificacaoPrestador">
                        <ns1:codigoPrestadorNaOperadora>00000000-0000-0000-0000-000000000000</ns1:codigoPrestadorNaOperadora>
                    </ns1:identificacaoPrestador>
                </ns1:destino>
                <ns1:Padrao>4.01.00</ns1:Padrao>
            </ns1:cabecalho>
            <ns1:reciboCancelaGuia>
                <ns1:reciboCancelaGuia>
                    <ns1:registroANS>309222</ns1:registroANS>
                    <ns1:dadosPrestador>
                        <ns1:codigoPrestadorNaOperadora>00000000-0000-0000-0000-000000000000</ns1:codigoPrestadorNaOperadora>
                    </ns1:dadosPrestador>
                    <ns1:retornoStatus>
                        <ns1:guiasCanceladas>
                            <ns1:dadosGuia>
                                <ns1:tipoGuia>1</ns1:tipoGuia>
                                <ns1:numeroGuiaPrestador>99999999</ns1:numeroGuiaPrestador>
                                <ns1:numeroGuiaOperadora>99999999</ns1:numeroGuiaOperadora>
                                <ns1:numeroProtocolo>33561420250718020542</ns1:numeroProtocolo>
                                <ns1:statusCancelamento>1</ns1:statusCancelamento>
                            </ns1:dadosGuia>
                        </ns1:guiasCanceladas>
                    </ns1:retornoStatus>
                </ns1:reciboCancelaGuia>
            </ns1:reciboCancelaGuia>
            <ns1:hash>a4c42c430cebf566e8ea17b4ce3e4349</ns1:hash>
        </ns1:reciboCancelaGuiaWS>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Resposta Erro

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.ans.gov.br/padroes/tiss/schemas" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <ns1:reciboCancelaGuiaWS>
            <ns1:cabecalho>
                <ns1:identificacaoTransacao>
                    <ns1:tipoTransacao>CANCELA_GUIA</ns1:tipoTransacao>
                    <ns1:sequencialTransacao>250527112105</ns1:sequencialTransacao>
                    <ns1:dataRegistroTransacao>2025-07-18</ns1:dataRegistroTransacao>
                    <ns1:horaRegistroTransacao>16:19:33.943Z</ns1:horaRegistroTransacao>
                </ns1:identificacaoTransacao>
                <ns1:origem>
                    <ns1:registroANS>309222</ns1:registroANS>
                </ns1:origem>
                <ns1:destino>
                    <ns1:identificacaoPrestador xsi:type="ns1:identificacaoPrestador">
                        <ns1:codigoPrestadorNaOperadora>c8f6a38b-306a-4ed9-a287-86228d7b566b</ns1:codigoPrestadorNaOperadora>
                    </ns1:identificacaoPrestador>
                </ns1:destino>
                <ns1:Padrao>4.01.00</ns1:Padrao>
            </ns1:cabecalho>
            <ns1:reciboCancelaGuia>
                <ns1:reciboCancelaGuia>
                    <ns1:registroANS>309222</ns1:registroANS>
                    <ns1:dadosPrestador>
                        <ns1:codigoPrestadorNaOperadora>c8f6a38b-306a-4ed9-a287-86228d7b566b</ns1:codigoPrestadorNaOperadora>
                    </ns1:dadosPrestador>
                    <ns1:retornoStatus>
                        <ns1:guiasCanceladas>
                            <ns1:dadosGuia>
                                <ns1:tipoGuia>1</ns1:tipoGuia>
                                <ns1:numeroGuiaPrestador>10628265</ns1:numeroGuiaPrestador>
                                <ns1:numeroGuiaOperadora>10628265</ns1:numeroGuiaOperadora>
                                <ns1:numeroProtocolo>33561420250718020542</ns1:numeroProtocolo>
                                <ns1:statusCancelamento>2</ns1:statusCancelamento>
                            </ns1:dadosGuia>
                        </ns1:guiasCanceladas>
                    </ns1:retornoStatus>
                </ns1:reciboCancelaGuia>
            </ns1:reciboCancelaGuia>
            <ns1:hash>803044a0ed4197d38697a5c0b77fac0c</ns1:hash>
        </ns1:reciboCancelaGuiaWS>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Códigos de glosa possíveis

• 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

Terminologia do status do cancelamento

• 1 - CANCELADA COM SUCESSO
• 2 - NÃO CANCELADO
• 3 - GUIA INEXISTENTE
• 4 - EM PROCESSAMENTO
• 5 - LOTE INEXISTENTE
• 6 - PROTOCOLO INEXISTENTE