Cadastro pelo administrador
Crie, renomeie, desative e reative centros no portal, respeitando as permissões de acesso à conta.
CENTROS DE CUSTO PARA RECEBIMENTOS
Saiba de onde vem cada recebimento com centros de custo.
Organize as cobranças de uma mesma conta por unidade, departamento, projeto ou operação. O administrador cadastra os centros de custo, a equipe classifica as transações e o financeiro filtra os valores e recebíveis no portal.
- Por conta
- cadastro isolado em cada tenant
- Opcional
- classificação na criação da cobrança
- Portal e API
- centro vinculado à transação
- Relatórios
- filtros e exportação CSV
PASSO A PASSO
Como organizar cobranças por centro de custo
Use nomes que correspondam à forma como sua empresa acompanha o resultado das operações.
- 01
Cadastre os centros da conta
O administrador acessa Centros de custo no portal e cria, por exemplo, Unidade Centro, Projeto Expansão ou Serviços. Cada centro pertence a uma conta.
- 02
Classifique na emissão
Selecione o centro no formulário de cobrança ou informe cost_center_id na API. O campo é opcional e o centro deve estar ativo e pertencer à conta emissora.
- 03
Filtre os recebimentos
Escolha o centro na Visão geral e em Transações para consultar o recorte financeiro e localizar as cobranças correspondentes.
- 04
Exporte e acompanhe
Exporte o CSV com nome e ID do centro para conciliar no seu sistema. Use o filtro de cobranças sem centro para encontrar registros não classificados.
EXEMPLO REAL DA API
Consulte transações por centro de custo na API
Depois de cadastrar os centros no portal, use uma chave com transactions:read para listar e consultar os dados da conta.
- Na criação de uma cobrança, envie o campo opcional cost_center_id com o ID escolhido.
- A chave consulta o próprio tenant por padrão. O centro da cobrança precisa pertencer ao tenant emissor.
- Mantenha as credenciais no backend. Preserve a chave e o corpo originais ao repetir uma tentativa de criação.
# Liste os centros e copie o ID do centro desejado.
curl --fail-with-body 'https://api.calebepay.com.br/v1/cost-centers' \
-H "X-API-Key: $CALEBE_API_KEY"
# Substitua cc_exemplo pelo ID retornado.
curl --fail-with-body 'https://api.calebepay.com.br/v1/transactions?cost_center_id=cc_exemplo' \
-H "X-API-Key: $CALEBE_API_KEY"
# Para cobranças sem classificação, use cost_center_id=unassigned.RECURSOS
Visibilidade financeira dentro de cada tenant
Mantenha a estrutura de contas e acrescente uma classificação gerencial às cobranças.
Classificação opcional
Integrações existentes continuam criando cobranças sem centro. Novas emissões podem informar o identificador.
Filtros no servidor
O filtro de centro recorta transações antes da paginação e aplica o mesmo critério aos totais e à série da Visão geral.
Nome e ID no histórico
A transação apresenta a identificação do centro. Renomear preserva o ID e atualiza o nome exibido.
CSV e webhooks
A exportação inclui o centro de custo e os eventos de transação incluem cost_center_id quando houver classificação.
Desativação sem perder histórico
Centros inativos impedem novas associações e continuam disponíveis para consultar as cobranças antigas.
O que é centro de custo no Calebe Pay?
É uma classificação gerencial para separar cobranças e recebimentos dentro da mesma conta, chamada de tenant na API. O centro pode representar uma unidade, equipe, projeto ou linha de serviço que o financeiro precisa acompanhar.
Por exemplo, uma empresa com duas unidades pode emitir cobranças com o centro Unidade Centro ou Unidade Norte e depois comparar o recorte de cada operação. O recurso organiza os recebimentos; não registra despesas nem substitui a contabilidade ou o ERP.
Centro de custo, conta e split de pagamentos
A conta define a titularidade e as configurações da operação. O centro de custo identifica a origem gerencial da cobrança dentro dessa conta. Já o split calcula a divisão financeira conforme a hierarquia e as tarifas cadastradas.
Classificar uma transação por centro não muda taxas, divisão de valores ou destino bancário dos repasses. Para separar operações financeiras de estabelecimentos diferentes, avalie a estrutura de contas vinculadas.
Entenda o split de pagamentos →Conheça a API para contas e cobranças →
Relatórios de recebíveis por unidade e projeto
O filtro de centro na Visão geral recorta totais, série temporal e valores líquidos calculados. Em Transações, o filtro consulta os registros do centro antes de paginar. Também é possível consultar cobranças sem classificação.
Os agrupamentos e subtotais da tabela consideram os registros da página carregada. Para analisar o total do período, use o resumo filtrado da Visão geral. Valores líquidos calculados não substituem a confirmação da liquidação financeira.
Quais cobranças aceitam centro de custo?
O campo cost_center_id é opcional na criação de Pix, boleto, cartão de crédito, checkout e débito avulso de Pix Automático, conforme a disponibilidade do método na conta. Checkouts já criados preservam o centro ao gerar a cobrança.
Ciclos de assinaturas não recebem essa classificação automaticamente nesta versão. O cadastro de centros é compartilhado entre teste e produção, mas as transações e os totais continuam separados por ambiente.
Consultar o contrato técnico de centros de custo →Conheça o Pix Automático →
PERGUNTAS FREQUENTES
Dúvidas sobre centros de custo
Não achou a resposta? Fale com um especialista pelo WhatsApp.
Quem pode cadastrar centros de custo?
O administrador do tenant e o administrador global, dentro do escopo autorizado, podem criar, renomear, desativar e reativar centros pelo portal. Cada centro pertence a um único tenant.
O centro de custo é obrigatório na transação?
Não. A classificação é opcional. Quando cost_center_id é omitido, a cobrança fica sem centro e pode ser encontrada pelo filtro de registros não classificados.
Posso usar um centro de custo de outra conta?
Não. A cobrança só aceita um centro ativo do próprio tenant emissor, mesmo quando o usuário administra mais de uma conta.
O centro direciona o repasse para outra conta bancária?
Não. O centro de custo organiza a análise gerencial dos recebimentos. Ele não altera o destino bancário, as tarifas ou o split da transação.
O que acontece quando um centro é desativado?
Ele deixa de aceitar novas associações e continua disponível no histórico e nos filtros. Checkouts criados antes da desativação mantêm sua classificação ao gerar a cobrança.
Assinaturas recebem centro de custo automaticamente?
Ainda não. O campo é aceito nas modalidades avulsas compatíveis e em checkouts, mas os ciclos de assinaturas não herdam centro de custo nesta versão.
CADASTRO 100% ONLINE · CERCA DE 6 MINUTOS