{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Revogando o Acesso de uma Empresa 🔒"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"revogando-o-acesso-de-uma-empresa-","__idx":0},"children":["Revogando o Acesso de uma Empresa 🔒"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"visão-geral","__idx":1},"children":["Visão Geral"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O acesso da sua aplicação aos dados de uma empresa pode ser encerrado a qualquer momento — pela própria empresa, pelo suporte da Conta Azul ou pela sua aplicação."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Revogar é útil quando o cliente cancela o serviço, quando a integração é desativada no seu sistema ou quando você precisa encerrar uma conexão por conta própria. Depois da revogação, a empresa só volta a ser acessível com um novo consentimento."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"como-revogar","__idx":2},"children":["Como Revogar"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --location --request DELETE 'https://api-v2.contaazul.com/oauth/connections/ID_EMPRESA' \\\n--header 'Authorization: Bearer ACCESS_TOKEN_GERADO'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"componentes-da-requisição","__idx":3},"children":["Componentes da Requisição"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Finalidade"},"children":["Finalidade"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ID_EMPRESA"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificador da empresa cuja conexão será encerrada"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authorization"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Access token válido da conexão, no formato Bearer"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sua aplicação ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["não"]}," informa o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_id"]},": ele é lido do próprio access token. Por isso não é possível revogar a conexão de outra aplicação."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"como-obter-o-id_empresa","__idx":4},"children":["Como obter o ID_EMPRESA"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O identificador vem do endpoint de conta conectada:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --location 'https://api-v2.contaazul.com/v1/pessoas/conta-conectada' \\\n--header 'Authorization: Bearer ACCESS_TOKEN_GERADO'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O campo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_empresa"]}," da resposta é o valor que vai na URL de revogação."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"respostas","__idx":5},"children":["Respostas"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Código"},"children":["Código"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Significado"},"children":["Significado"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["204"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Acesso revogado. A resposta não tem corpo."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["204"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O acesso já estava revogado. A operação é idempotente."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Access token ausente, inválido ou expirado."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Não existe conexão ativa entre sua aplicação e a empresa informada."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["502"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A revogação não pôde ser concluída. Repita a requisição."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"️-o-que-acontece-com-os-tokens","__idx":6},"children":["⚠️ O que acontece com os tokens"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A revogação invalida o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refresh_token"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["imediatamente"]},": a próxima renovação falha e não é mais possível obter novos tokens para aquela empresa."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access_token"]}," já emitido, porém, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["continua válido até o fim da sua vida útil de 1 hora"]},". Isso é uma característica do formato do token, que carrega a própria validade."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Na prática, isso significa duas coisas:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Chamadas feitas com um access token ainda dentro da validade continuam funcionando por até uma hora após a revogação."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Repetir a chamada de revogação dentro dessa janela devolve ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["204"]}," novamente. Depois dela, o próprio token expira e a resposta passa a ser ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"como-sua-aplicação-descobre-que-a-empresa-revogou","__idx":7},"children":["Como sua aplicação descobre que a empresa revogou"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quando a revogação parte da empresa ou do suporte da Conta Azul, sua aplicação descobre na ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["próxima renovação de token"]},", que passa a falhar com um erro específico. Veja ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/renewingaccesstoken#erros-na-renova%C3%A7%C3%A3o"},"children":["Etapa 3 - Renovando o token de acesso"]}," para o detalhamento dos erros de renovação."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"voltando-a-acessar","__idx":8},"children":["Voltando a acessar"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Não há reativação automática. Para acessar novamente os dados da empresa, inicie um novo fluxo de autorização a partir da ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/requestingcode"},"children":["Etapa 1"]}," e obtenha um novo consentimento."]}]},"headings":[{"value":"Revogando o Acesso de uma Empresa 🔒","id":"revogando-o-acesso-de-uma-empresa-","depth":1},{"value":"Visão Geral","id":"visão-geral","depth":2},{"value":"Como Revogar","id":"como-revogar","depth":2},{"value":"Componentes da Requisição","id":"componentes-da-requisição","depth":2},{"value":"Como obter o ID_EMPRESA","id":"como-obter-o-id_empresa","depth":2},{"value":"Respostas","id":"respostas","depth":2},{"value":"⚠️ O que acontece com os tokens","id":"️-o-que-acontece-com-os-tokens","depth":2},{"value":"Como sua aplicação descobre que a empresa revogou","id":"como-sua-aplicação-descobre-que-a-empresa-revogou","depth":2},{"value":"Voltando a acessar","id":"voltando-a-acessar","depth":2}],"frontmatter":{"seo":{"title":"Revogando o Acesso de uma Empresa 🔒"}},"lastModified":"2026-09-15T13:52:56.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/revokingaccess","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}