Como vincular Serviços Adicionais ao ERP de Assinaturas?

Visão geral

Os Serviços Adicionais permitem gerar cobranças relacionadas aos serviços prestados pela administradora. Quando utilizados em conjunto com o ERP de Assinaturas, os valores calculados podem ser enviados para faturamento, centralizando a gestão financeira dos serviços contratados.

Este artigo aborda o cadastro e a utilização dos Serviços Adicionais para faturamento no ERP de Assinaturas. A configuração técnica da integração deve ser realizada previamente.

Quando usar este artigo

Utilize este artigo quando a administradora precisar cadastrar um Serviço Adicional vinculado ao ERP de Assinaturas para faturamento automático dos serviços prestados aos condomínios.

Sintoma ou cenário

A administradora deseja cadastrar um novo serviço que será faturado pelo ERP de Assinaturas, vinculando-o a uma conta bancária cadastrada nesse módulo.

Benefício para o usuário ou operação

Permite configurar cobranças individualizadas por condomínio, com valores e regras específicos para cada contrato de gestão;
Envia os valores calculados automaticamente ao ERP de Assinaturas, eliminando a necessidade de lançamentos manuais no módulo financeiro;
Permite controlar o período de vigência de cada serviço faturado, garantindo que a cobrança ocorra apenas no intervalo definido;
Possibilita a replicação da configuração para outros condomínios com o mesmo perfil de contratação.

Onde acessar / contexto de uso

Condomínio > Dados do Condomínio > Serviços Adicionais > Adicionar serviço.

Pré-requisitos (Antes de começar)

Perfil Exato: Permissão de Administrador (código 1000) — necessária para acessar os dados do condomínio e gerenciar serviços adicionais.
Recursos Sistêmicos: ERP de Assinaturas contratado e ativo; Integração via API entre o sistema de Condomínios e o ERP de Assinaturas previamente configurada e habilitada. Consulte o artigo sobre como realizar essa integração antes de prosseguir.
Insumos e Dados Técnicos: Tipo de serviço a ser faturado (ex.: A receber: cobrança liquidada); Produto ou serviço cadastrado no sistema; Valor e tipo de cálculo do serviço definidos; Período de vigência do serviço (data de início obrigatória).

Causas prováveis

A administradora firmou um novo contrato de gestão com um condomínio e precisa configurar a cobrança do serviço prestado por meio do ERP de Assinaturas;
Houve alteração nas condições contratuais do serviço prestado ao condomínio, exigindo o cadastro de um novo serviço adicional com valor ou tipo de cálculo diferente;
A administradora deseja padronizar o faturamento de um serviço existente, vinculando-o ao ERP de Assinaturas para eliminar lançamentos manuais.

Como fazer ou corrigir

Antes de cadastrar o serviço, certifique-se de que a integração via API entre o sistema de Condomínios e o ERP de Assinaturas já foi realizada. Sem essa integração, o serviço não poderá ser vinculado ao módulo financeiro.

Para cadastrar um Serviço Adicional vinculado ao ERP de Assinaturas:

Acesse Condomínio > Dados do Condomínio > Serviços Adicionais;
Clique em Adicionar serviço.
No formulário "Novo serviço adicional", preencha os campos:
- Tipo do serviço: selecione o tipo correspondente ao serviço prestado (ex.: A receber: cobrança liquidada);
- Tipo de cálculo: selecione a forma de apuração do valor (ex.: Valor fixo);
- Valor (R$): informe o valor a ser cobrado;
- Produto / serviço: selecione o produto cadastrado no sistema;
- Conta bancária (Assinaturas): selecione a conta bancária cadastrada no ERP de Assinaturas.
Expanda a seção Vigência e informe a Data de início. A Data de término é opcional e deve ser preenchida apenas quando o serviço tiver prazo definido;
Se desejar aplicar desconto ao serviço, expanda a seção Aplicação de desconto e configure as condições;
Se o mesmo serviço precisar ser replicado para outros condomínios, marque a opção "Replicar configuração de serviço para outros condomínios" antes de salvar;
Clique em Salvar.

Resultado esperado

Após salvar, o sistema exibirá a mensagem "Serviço cadastrado para 1 condomínio com sucesso!". O serviço passará a aparecer na listagem de Serviços Adicionais do condomínio com status Pendente, aguardando o processamento do ciclo de faturamento correspondente ao período de vigência configurado. Ao ser processado, o status será atualizado para Faturado e o valor será enviado ao ERP de Assinaturas.

Quando escalar

O serviço permanece com status Pendente após o processamento do ciclo de faturamento;
Os valores não aparecem no ERP de Assinaturas após o faturamento;
Há divergência entre o valor cadastrado no serviço e o valor faturado no ERP de Assinaturas;
O sistema retorna o erro "502: Condomínio não vinculado a um cliente" ao tentar salvar o serviço.

Informações que devem ser reunidas antes do escalonamento

Nome da licença de condomínios e assinaturas;
Nome do Serviço Adicional cadastrado;
Tipo de serviço e tipo de cálculo configurados;
Período de vigência configurado;
Nome da conta bancária selecionada no campo "Conta bancária (Assinaturas)";
Print do formulário preenchido e da mensagem de erro apresentada.

Regras importantes / Observações

É obrigatório que a integração com o sistema de Assinaturas tenha sido realizada previamente;
A vigência determina o período em que o serviço será considerado para faturamento. Serviços sem vigência válida não serão processados;
Alterações realizadas após o processamento do ciclo de faturamento refletirão somente nos próximos faturamentos;
A opção de replicar a configuração para outros condomínios aplica as mesmas regras de serviço, tipo de cálculo, valor e conta bancária aos demais condomínios selecionados.

Problemas comuns e como resolver

Problema: Erro "502: Condomínio não vinculado a um cliente" ao tentar salvar o serviço.
Causa provável: O condomínio não está associado a um cliente no ERP de Assinaturas, indicando que a integração via API não foi concluída corretamente para esse condomínio.
Ação recomendada: Verifique se o condomínio está devidamente vinculado a um cliente no ERP de Assinaturas. Se a configuração estiver correta e o erro persistir, escale para o time técnico com as informações de escalonamento.

Dúvidas relacionadas

P: A integração via API é configurada automaticamente ao cadastrar o serviço? R: Não. O cadastro do Serviço Adicional e a configuração da integração via API são processos independentes e precisam ser realizados separadamente.

P: O que acontece se eu alterar a vigência de um serviço já faturado? R: A alteração impacta apenas os períodos futuros. Faturamentos já processados não são recalculados.

P: Posso aplicar a mesma configuração de serviço para vários condomínios de uma vez? R: Sim. Antes de salvar, marque a opção "Replicar configuração de serviço para outros condomínios" e selecione os condomínios desejados.

Palavras-chave de busca

serviços adicionais, ERP de assinaturas, faturamento de serviços, cobrança de serviços adicionais, vigência de serviço, integração via API, conta bancária assinaturas, faturamento recorrente, condomínio vinculado a cliente, erro 502 serviços adicionais