> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airbee.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancelamentos e exclusão de objetos

> Entenda quando cancelar, arquivar, desvincular ou excluir um registro e o que permanece na sua operação depois de cada ação.

Este guia ajuda você a escolher a ação correta quando não precisa mais de uma reserva, acomodação, hóspede ou outro registro da Airbee. Você também verá o que permanece guardado e quando uma exclusão remove informações relacionadas.

Na Airbee, **cancelar**, **arquivar**, **desvincular** e **excluir** têm resultados diferentes:

* **Cancelar** encerra uma operação, mas mantém o histórico.
* **Arquivar** tira um item de uso ou de exibição sem apagá-lo.
* **Desvincular** mantém os dois itens, mas remove a relação entre eles.
* **Excluir** remove o registro definitivamente quando não há um histórico que precisa ser preservado.

## Antes de começar

Antes de confirmar uma ação:

* confira se o item tem reserva, pagamento, contrato ou utilização registrada;
* confirme se você quer apenas tirá-lo de uso ou removê-lo de vez;
* lembre-se de que cancelar uma reserva paga não faz um reembolso automaticamente;
* verifique se você tem permissão para realizar a ação na operação selecionada.

<Warning>
  Cancelamento e reembolso são ações diferentes. Ao cancelar uma reserva paga, consulte o pagamento relacionado antes de combinar qualquer devolução com o hóspede.
</Warning>

## Exemplo prático

Marina administra o **Chalé da Serra**. A equipe criou duas reservas para o mesmo atendimento por engano. Uma delas ainda está pendente e não possui pagamento nem contrato. Essa cópia pode ser excluída.

A outra reserva já foi confirmada e possui pagamento registrado. Nesse caso, se a estadia não for mais acontecer, Marina deve cancelá-la. A reserva deixa de ocupar o calendário, mas continua disponível para consulta junto com o hóspede e o histórico financeiro.

## Como escolher a ação

<Steps>
  <Step title="Confira o histórico do item">
    Abra o item que deseja remover e procure reservas, pagamentos, contratos, utilizações ou outros registros relacionados. Quando existe histórico, prefira **Cancelar**, **Arquivar** ou **Desativar**.
  </Step>

  <Step title="Escolha entre cancelar, arquivar ou excluir">
    Use **Cancelar** para encerrar uma reserva sem apagar o que aconteceu. Use **Arquivar** ou **Desativar** para tirar um item de uso sem perder seu histórico. Use **Excluir** somente quando o item foi criado por engano ou ainda não possui movimentações relacionadas.
  </Step>

  <Step title="Leia a confirmação antes de continuar">
    A Airbee informa quando outros itens serão removidos, preservados ou apenas desvinculados. Revise essa mensagem antes de confirmar uma ação irreversível.
  </Step>

  <Step title="Confira o resultado">
    Volte à lista ou ao calendário e confirme se o item saiu de uso, deixou de ocupar datas ou foi removido conforme esperado. Consulte também o perfil do hóspede e o **Financeiro** quando a ação envolver uma reserva.
  </Step>
</Steps>

## O que acontece em cada caso

| Item                                  | Ações disponíveis                                                          | Quando a exclusão definitiva não é usada                                             | O que acontece                                                                                                                                                              |
| ------------------------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Reserva**                           | Cancelar ou excluir                                                        | Quando está confirmada, foi paga, veio de um calendário conectado ou possui contrato | Cancelar libera as datas e mantém o histórico. Excluir uma reserva permitida não exclui o hóspede nem os registros financeiros da operação.                                 |
| **Hóspede**                           | Arquivar, anonimizar quando aplicável ou excluir um cadastro sem histórico | Quando possui reservas, pagamentos ou outras movimentações relacionadas              | O histórico da operação é preservado. Uma solicitação de privacidade segue um fluxo próprio para proteger os dados pessoais sem apagar registros que precisam ser mantidos. |
| **Acomodação**                        | Arquivar, reativar ou excluir                                              | Quando possui reservas ou movimentações relacionadas                                 | Arquivar tira a acomodação do ar e impede novas reservas. A exclusão definitiva de uma acomodação sem histórico também remove suas fotos, calendários e regras próprias.    |
| **Proprietário**                      | Excluir                                                                    | Quando a equipe decidir manter o cadastro para consulta                              | As acomodações permanecem na operação e ficam sem proprietário vinculado até uma nova atribuição.                                                                           |
| **Desconto**                          | Desativar ou excluir                                                       | Quando já foi utilizado                                                              | Desativar impede novos usos e preserva o histórico. Um desconto nunca utilizado pode ser excluído junto com seus cupons.                                                    |
| **Cupom**                             | Desativar ou excluir                                                       | Quando já foi utilizado                                                              | Desativar impede novos usos. As utilizações anteriores permanecem no histórico.                                                                                             |
| **Modelo de contrato**                | Excluir                                                                    | Quando ainda deve ser usado em novas reservas                                        | Os contratos já emitidos permanecem guardados. Apenas o modelo reutilizável deixa de aparecer para novas emissões.                                                          |
| **Contrato emitido**                  | Cancelar ou invalidar quando disponível                                    | Depois de gerado ou assinado                                                         | O documento e seu histórico permanecem associados à reserva.                                                                                                                |
| **Regra de preço**                    | Excluir ou remover de uma acomodação                                       | —                                                                                    | A regra deixa de afetar as datas e acomodações vinculadas. Reservas já criadas mantêm os valores registrados nelas.                                                         |
| **Depoimento**                        | Arquivar ou excluir                                                        | Quando você quer apenas retirá-lo da vitrine                                         | Arquivar esconde o depoimento e permite publicá-lo novamente. Excluir remove o registro definitivamente.                                                                    |
| **Calendário conectado**              | Desconectar                                                                | —                                                                                    | A conexão deixa de receber atualizações. As reservas já importadas permanecem na Airbee, a menos que uma remoção específica seja confirmada.                                |
| **Foto da acomodação**                | Excluir                                                                    | —                                                                                    | A foto deixa de aparecer na acomodação. Se era a capa, outra foto disponível passa a ocupar esse lugar.                                                                     |
| **Membro da equipe**                  | Remover acesso ou revogar convite                                          | O responsável principal pela operação não pode ser removido dessa forma              | A pessoa perde o acesso, mas as reservas, acomodações e alterações feitas por ela permanecem.                                                                               |
| **Chave de API**                      | Revogar                                                                    | Chaves não são apagadas para preservar o histórico de acesso                         | A integração perde o acesso imediatamente e a chave continua identificada como revogada.                                                                                    |
| **Pagamento, recebível ou transação** | Cancelar, estornar ou reembolsar quando a situação permitir                | Sempre                                                                               | Registros financeiros não são excluídos pelo painel. Eles permanecem para conferência da operação.                                                                          |

## Por que alguns itens permanecem guardados

Uma operação de hospedagem precisa manter contexto para que a equipe consiga responder perguntas e conferir o que aconteceu. Por isso, a Airbee preserva itens relacionados a:

* pagamentos, recebimentos, reembolsos e contestações;
* contratos e registros de assinatura;
* reservas confirmadas, canceladas ou já realizadas;
* utilização de descontos e cupons;
* alterações de acesso da equipe.

Manter esse histórico evita que uma exclusão simples transforme um pagamento em um valor sem explicação ou faça uma reserva desaparecer do perfil de um hóspede.

## Quando excluir um item também remove outros

Alguns itens existem apenas como parte de outro cadastro. Quando o cadastro principal pode ser excluído definitivamente, esses itens relacionados também deixam de ter utilidade.

Exemplos:

* excluir uma acomodação sem histórico remove suas fotos, calendários e regras próprias;
* excluir uma regra de preço remove seus vínculos com acomodações e períodos;
* excluir um desconto nunca utilizado remove os cupons criados para ele;
* excluir uma foto remove sua exibição na acomodação e pode alterar a capa.

Antes dessas ações, a Airbee apresenta uma confirmação com o efeito esperado.

## Como conferir o resultado

* Uma reserva cancelada aparece como **Cancelada** e deixa de ocupar as datas.
* Uma acomodação arquivada sai do ar e continua disponível entre os itens arquivados.
* Um hóspede com histórico continua relacionado às reservas que precisam ser consultadas.
* Pagamentos e transações continuam disponíveis no **Financeiro**.
* Um item excluído definitivamente não aparece mais na lista correspondente.

## Se algo não sair como esperado

* **A opção Excluir não aparece:** o item possui histórico ou é controlado por outra origem. Procure **Cancelar**, **Arquivar**, **Desativar** ou **Desconectar**.
* **A reserva foi cancelada, mas o pagamento continua visível:** isso é esperado. Revise o pagamento e faça o reembolso separadamente quando necessário.
* **A acomodação foi arquivada em vez de excluída:** existe histórico relacionado que precisa permanecer disponível.
* **Um calendário foi desconectado, mas as reservas continuam no calendário:** desconectar interrompe novas atualizações; não apaga automaticamente o histórico importado.
* **Você não consegue remover um membro:** confirme sua permissão e verifique se a pessoa é a responsável principal pela operação.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Reservas" href="/reservas">
    Entenda os status e como cada reserva afeta o calendário.
  </Card>

  <Card title="Calendários" href="/calendarios">
    Veja como conectar, sincronizar e acompanhar calendários externos.
  </Card>

  <Card title="Hóspedes e comunicação" href="/plataforma/hospedes-e-comunicacao">
    Conheça o histórico reunido no perfil de cada hóspede.
  </Card>

  <Card title="Payments e Financeiro" href="/plataforma/payments-e-financeiro">
    Saiba como acompanhar pagamentos, recebíveis e movimentações.
  </Card>
</CardGroup>
