Conectando Morning.co vía Guesty Connect

Configure e utilize a integração do Morning.co (Green Fatura) com o Guesty. Essa integração automatiza a criação de faturas provisórias, sincronizando os dados de reserva do Guesty diretamente com uma conta do Morning.co.

Antes de começar

Você precisa assinar o complemento Guesty Connect antes de poder conectar a integração:

1. Faça login na sua conta Guesty.
2. No menu de navegação lateral, clique em Integrações para abrir o menu suspenso.
3. Selecione os complementos do Guesty.
4. Clique em Guesty Connect.
5. Clique em Inscrever-se.

Conecte o Guesty ao Morning.co

Siga os passos abaixo para conectar o Morning.co ao Guesty. Este processo requer as credenciais da API da sua conta Morning.co para estabelecer uma conexão segura.

Passo a passo:

Em Morning.co

1. Faça login na sua conta Morning.co.

2. Crie um aplicativo de API no Morning.co para gerar um "ID" e um "Segredo".

3. Copie o "ID" e o "Segredo" de Morning.co.

Em Guesty

1. Faça login na sua conta Guesty.
2. No menu de navegação lateral, clique em Integrações para abrir o menu suspenso.
3. Selecione Marketplace.
4. Na barra de pesquisa à esquerda, digite "Morning.co" e clique na miniatura do Morning.co.
5. No canto superior direito, clique em Conectar.
6. Volte à janela pop-up do Guesty, cole o "ID" e o "Segredo" nos campos correspondentes e clique em Conectar.

Gerenciar campos personalizados

Assim que a integração estiver ativa, o Guesty cria automaticamente campos personalizados no nível da reserva. Esses campos controlam a lógica de automatização e armazenam informações sincronizadas do Morning.co.

• morning_issue_invoice_ready: Defina como TRUE para acionar a transferência de dados para Morning.co.

• morning_guest_name_on_invoice: Insira o nome do hóspede ou da empresa exatamente como deve aparecer na fatura. Este campo é obrigatório.

• morning_add_vat: Defina como VERDADEIRO para cidadãos israelenses. O Morning.co considera o total do Guesty como incluindo o IBS/CBS e calcula o valor do IBS/CBS a partir desse total. Se definido como FALSO, o total será enviado sem o cálculo do IBS/CBS.

• morning_invoice_generated: A integração marca este campo como VERDADEIRO assim que o rascunho é criado. Não edite este campo manualmente.

• morning_invoice_id: Este campo é preenchido automaticamente com o ID da Morning.co após uma sincronização bem-sucedida.

• morning_invoice_link_en / morning_invoice_link_he: Esses campos contêm links diretos para as versões preliminares das faturas em inglês ou hebraico.

• morning_invoice_generation_error: Se uma sincronização falhar, o motivo específico do erro aparecerá aqui para facilitar a resolução do problema.

• morning_invoice_date: Especifique a data para a qual a fatura deve ser gerada. O Morning.co não permite a criação de uma fatura com data anterior à data do último documento do mesmo tipo. Por exemplo, se a última fatura de taxa gerada foi em 3 de março, esta é a data mais antiga para a qual você poderá gerar outra fatura de taxa por meio da API. Se nenhuma data for escolhida, a fatura será criada com a data de hoje.

Compreenda os recursos de integração

A integração com o Morning.co simplifica o processo de faturamento, garantindo a precisão dos dados entre as duas plataformas.

• Criação de rascunho: A integração sempre cria uma "Fatura em Rascunho" no Morning.co para avaliação final antes da emissão.

• Métodos de Pagamento: A Morning.co recebe automaticamente o método de pagamento utilizado para a reserva na Guesty.

• Lógica do IBS/CBS: A ferramenta lida com os requisitos de taxa israelenses, extraindo o IBS/CBS dos totais inclusivos quando solicitado.

Escolha um fluxo de trabalho

Selecione um dos dois fluxos de trabalho abaixo para gerenciar como os dados chegam ao Morning.co.

Utilize o fluxo de trabalho não itemizado.

Selecione esta opção se as regras de tarifas já estiverem configuradas no Guesty. Este fluxo de trabalho envia o total da reserva como uma única linha para o Morning.co e aplica o IBS/CBS a esse total.

Utilize o fluxo de trabalho detalhado.

Selecione esta opção se os impostos não forem gerenciados no Guesty. Este fluxo de trabalho envia itens individuais do extrato, como diárias de hospedagem e taxas de limpeza, para o Morning.co. A integração então aplica a taxa calculada a cada item específico.

Utilize a integração

Após ativar a estratégia de fluxo de trabalho de sua preferência, a automação será acionada sempre que você atualizar uma reserva no Guesty. 

Para gerar a fatura provisória, certifique-se de que suas reservas no Guesty atendam aos seguintes requisitos:

• O status da reserva no Guesty é confirmed.

• morning_issue_invoice_ready está definido como TRUE na reserva.

• morning_guest_name_on_invoice contém texto e não está vazio.

• O parâmetro morning_invoice_generated está vazio ou definido como FALSE para evitar faturas duplicadas.

Mapeamento de Pagamento

A integração processa automaticamente os pagamentos de reserva com status SUCCEEDED e mapeia os IDs dos métodos de pagamento da Guesty para os tipos de pagamento correspondentes no Morning.co, como cartão de crédito, transferência bancária, dinheiro ou cheque.

Sincronização pós-geração

Uma vez gerado o projeto de fatura com o status חשבונית מס / קבלה, a integração atualiza automaticamente os campos personalizados de reserva da Guesty:

• Atualiza morning_invoice_generated para TRUE.

• morning_invoice_id é preenchido com o ID da fatura oficial da Morning.co.

• morning_invoice_link_en e morning_invoice_link_he são preenchidos com os URLs das faturas em inglês e hebraico.

• A morning_invoice_generation_error é atualizada com alertas detalhados caso ocorra algum erro durante a geração da fatura.