Schemas
Customer
idIdentificador unico do cliente.
business_unit_idID da unidade de negocio do cliente.
nameNome completo do cliente.
documentDocumento do cliente (CPF/CNPJ).
person_typeTipo de pessoa do cliente: F (Pessoa fisica) ou J (Pessoa juridica).
Lista de emails do cliente. Vazia quando o cliente nao tem nenhum.
Lista de telefones do cliente. Vazia quando o cliente nao tem nenhum.
created_atData e hora de criacao do cliente, em UTC.
updated_atData e hora da ultima atualizacao do cliente, em UTC.
Debt
idIdentificador unico da divida.
customer_idID do cliente associado a divida.
debt_group_idID do grupo de divida associado.
business_unit_idID da unidade de negocio da divida.
statusStatus da dívida. Valores possíveis: PENDING (Pendente - dívida aguardando cobrança), SETTLED (Liquidada - dívida foi paga), ON_HOLD (Cobrança pausada - cobrança temporariamente suspensa), ARCHIVED (Arquivada - dívida arquivada para fins históricos e fora do fluxo de cobrança), UNDER_CONTRACT (Em acordo - dívida está incluída em um acordo)
is_collectableIndica se a divida esta apta para cobranca.
is_contractableIndica se a divida pode ser incluida em acordo.
original_valueValor original da divida.
today_valueValor atualizado da divida na data atual.
due_dateDia de vencimento da divida.
origin_dateDia de origem da divida. Nula quando a divida foi criada sem ela.
external_idIdentificador externo da divida no sistema de origem. Nulo quando a divida foi criada sem ele.
origin_contract_idCodigo do contrato ou acordo original no sistema de origem.
created_atData e hora de criacao da divida, em UTC.
updated_atData e hora da ultima atualizacao da divida, em UTC.
DebtGroup
idIdentificador unico do grupo de divida.
business_unit_idID da unidade de negocio do grupo de divida.
nameNome do grupo de divida.
requires_debt_confessionIndica se o grupo exige confissao de divida para fechar acordo.
Regras de encargo da regua do grupo, aplicadas por faixa de atraso. Vazia quando o grupo nao tem regra.
created_atData e hora de criacao do grupo de divida, em UTC.
updated_atData e hora da ultima atualizacao do grupo de divida, em UTC.
DebtGroupRule
idIdentificador unico da regra.
penaltyMulta aplicada, em percentual.
interestJuros ao mes, em percentual.
days_overdueDias de atraso a partir dos quais a regra vale.
created_atData e hora de criacao da regra, em UTC.
updated_atData e hora da ultima atualizacao da regra, em UTC.
Goal
idIdentificador unico da meta.
business_unit_idID da unidade de negocio da meta.
nameNome da meta.
typeO que a meta mede: VALUE (valor negociado em R$) ou CONTRACTS (quantidade de acordos).
targetAlvo a ser atingido. Em VALUE é um valor em reais; em CONTRACTS é a quantidade de acordos (inteiro).
realizedRealizado no período da meta, na mesma unidade do alvo. Meta agendada retorna 0.
user_idID do coletor responsável. Nulo quando a meta vale para toda a equipe.
debt_group_idID do grupo de dívidas. Nulo quando a meta vale para todos os grupos.
start_dateInício do período de apuração.
end_dateFim do período de apuração.
closed_atInstante do encerramento, em UTC. Nulo enquanto a meta estiver aberta. No encerramento por prazo e o fim do ultimo dia do periodo, que em UTC cai no dia seguinte ao end_date.
statusSituação da meta: SCHEDULED (período ainda não começou), ACTIVE (em andamento) ou CLOSED (encerrada). Encerrar é irreversível. O prazo vencido também encerra a meta.
status_reasonPor que a meta foi encerrada: MANUALLY_CLOSED (alguém clicou) ou DEADLINE_REACHED (o período acabou). Nulo enquanto estiver aberta.
is_frozenIndica se a composição de acordos foi congelada (ao encerrar).
Série recorrente da qual a meta faz parte. Nulo em meta avulsa.
Diagnóstico da meta agora. Nulo se ainda estiver agendada.
created_atData e hora de criacao da meta, em UTC.
updated_atData e hora da ultima atualizacao da meta, em UTC.
GoalRecurrence
idIdentificador da série recorrente.
interval_daysDuração de cada meta da série, em dias. A próxima meta começa no dia seguinte ao fim da anterior, então as datas não acompanham o mês de calendário.
indexPosição da meta na série, começando em 0.
is_activeFalso depois que a recorrência é interrompida: nenhuma meta nova é criada.
is_templateIndica se esta meta é a meta-modelo da série: as próximas metas copiam dela nome, tipo, alvo e escopo. Na criação, a meta-modelo é a primeira da série.
GoalProgress
healthSituação frente ao alvo: ACHIEVED (atingida), ON_TRACK (no ritmo), ATTENTION (atenção), AT_RISK (em risco) ou NOT_ACHIEVED (não atingida).
measured_untilAté que dia o realizado vale. Em meta ativa é hoje; em meta encerrada é o fim efetivo da apuração.
duration_daysDias de start_date a end_date, inclusive.
elapsed_daysQuantos dias do período já passaram na apuração.
remaining_daysDias que ainda faltam no prazo. Zero se a meta já encerrou.
achieved_percentPercentual do alvo já feito (0 a 100).
elapsed_percentPercentual do tempo já passado (0 a 100), ritmo linear.
remaining_targetQuanto falta para bater o alvo, na unidade do tipo da meta. Em CONTRACTS é inteiro.
forecastChute do total no fim do período se o ritmo atual se mantiver, arredondado em duas casas. Nulo se a meta já encerrou ou o prazo passou.
Valor do campo daily pace.
GoalDetail
idIdentificador unico da meta.
business_unit_idID da unidade de negocio da meta.
nameNome da meta.
typeO que a meta mede: VALUE (valor negociado em R$) ou CONTRACTS (quantidade de acordos).
targetAlvo a ser atingido. Em VALUE é um valor em reais; em CONTRACTS é a quantidade de acordos (inteiro).
realizedRealizado no período da meta, na mesma unidade do alvo. Meta agendada retorna 0.
user_idID do coletor responsável. Nulo quando a meta vale para toda a equipe.
debt_group_idID do grupo de dívidas. Nulo quando a meta vale para todos os grupos.
start_dateInício do período de apuração.
end_dateFim do período de apuração.
closed_atInstante do encerramento, em UTC. Nulo enquanto a meta estiver aberta. No encerramento por prazo e o fim do ultimo dia do periodo, que em UTC cai no dia seguinte ao end_date.
statusSituação da meta: SCHEDULED (período ainda não começou), ACTIVE (em andamento) ou CLOSED (encerrada). Encerrar é irreversível. O prazo vencido também encerra a meta.
status_reasonPor que a meta foi encerrada: MANUALLY_CLOSED (alguém clicou) ou DEADLINE_REACHED (o período acabou). Nulo enquanto estiver aberta.
is_frozenIndica se a composição de acordos foi congelada (ao encerrar).
Série recorrente da qual a meta faz parte. Nulo em meta avulsa.
Diagnóstico da meta agora. Nulo se ainda estiver agendada.
created_atData e hora de criacao da meta, em UTC.
updated_atData e hora da ultima atualizacao da meta, em UTC.
Realizado de cada dia de start_date até o fim da apuração (measured_until limitado ao end_date). Dias sem acordo vêm com amount 0, e a soma fecha com realized. Vazio em meta agendada.
Acordos congelados na composição da meta. Vazio enquanto a composição não estiver congelada — como na meta ativa deste exemplo. Cada acordo tem os campos de GoalContractSnapshot.
GoalContractSnapshot
contract_idID do acordo.
customer_idID do cliente titular do acordo. Nulo se o cliente foi removido.
customer_nameNome atual do cliente. Nulo se o cliente foi removido.
valueValor do acordo na composição congelada.
negotiated_dateData em que o acordo foi negociado.
status_at_closeStatus do acordo quando a composição foi congelada.
GoalWrite
nameNome da meta.
typeO que a meta mede: VALUE (valor negociado em R$) ou CONTRACTS (quantidade de acordos).
targetAlvo a ser atingido. Maior que zero. Em CONTRACTS deve ser inteiro.
start_dateInício do período de apuração.
end_dateFim do período de apuração. Igual ou posterior ao início. O período não pode passar de 730 dias. Em meta recorrente, não pode ser alterado na atualização.
user_idID do coletor da unidade. Omita ou envie nulo para meta geral (toda a equipe).
debt_group_idID do grupo de dívidas da unidade. Omita ou envie nulo para todos os grupos.
is_recurringSó na criação; ignorado na atualização. true torna a meta recorrente: quando o período termina, uma nova meta com a mesma duração (em dias, de start_date a end_date) começa no dia seguinte. Veja POST /goals.
apply_to_followingSó na atualização de meta de uma série ativa. Verdadeiro aplica a alteração também à meta agendada seguinte e torna esta meta a meta-modelo da série. Falso (padrão) altera só esta meta. Editar a própria meta-modelo sempre vale para as próximas.
CustomerError
messageMensagem de erro legivel.
error_codeCodigo interno do erro.
status_codeCodigo HTTP do erro.
GoalError
messageMensagem de erro legivel.
error_codeCodigo interno do erro.
status_codeCodigo HTTP do erro.
Contract
idIdentificador unico do acordo.
customer_idID do cliente titular do acordo.
business_unit_idID da unidade de negocio do acordo.
statusStatus do acordo. Valores possíveis: ACTIVE (Ativo - acordo em andamento), DEBT_CONFESSION_PENDING (Confissão Pendente - aguardando assinatura da confissão de dívida), OVERDUE (Atrasado - acordo com parcelas em atraso), TERMINATED (Quebrado - acordo cancelado), SETTLED (Liquidado - todas as parcelas foram pagas)
descriptionDescricao do acordo.
valueValor total do acordo, ja com os descontos aplicados.
total_discountDesconto total concedido no acordo.
Parcelas do acordo, da mais antiga para a mais recente.
Dividas incluidas no acordo.
settled_atData e hora da liquidacao do acordo, em UTC. Nulo enquanto o acordo nao for liquidado.
created_atData e hora de criacao do acordo, em UTC.
updated_atData e hora da ultima atualizacao do acordo, em UTC.
ContractInstallment
idIdentificador unico da parcela.
statusStatus da parcela. Valores possíveis: PENDING (Pendente - parcela aguardando pagamento), PAID (Pago - parcela foi paga), OVERDUE (Atrasado - parcela vencida e não paga), SETTLED (Liquidado - parcela liquidada), CANCELLED (Cancelado - parcela cancelada), IN_ANALYSIS (Pagamento em análise - pagamento com cartão em análise de risco no gateway; volta para PENDING ou OVERDUE se reprovado, ou vira PAID se aprovado)
valueValor da parcela.
due_dateData de vencimento da parcela.
DebtStateError
messageMensagem de erro legivel.
error_codeCodigo interno do erro.
status_codeCodigo HTTP do erro.
BlocklistError
messageMensagem de erro legivel.
error_codeCodigo interno do erro.
status_codeCodigo HTTP do erro.
RevokedTokenError
messageMensagem de erro legivel.
error_codeCodigo interno do erro.
status_codeCodigo HTTP do erro.
ExpiredTokenError
messageMensagem de erro legivel.
error_codeCodigo interno do erro.
status_codeCodigo HTTP do erro.
AuthError
messageMensagem de erro legivel.
error_codeCodigo interno do erro.
status_codeCodigo HTTP do erro.
NotFoundError
messageMensagem de erro legivel.
error_codeCodigo interno do erro.
status_codeCodigo HTTP do erro.
WebhookEvent
idID único do evento
typeTipo do evento
versionVersão do formato do evento
created_atData e hora do evento, em UTC.
dataDados específicos do evento
WebhookEventDebt
idID único do evento
typeTipo do evento
versionVersão do formato do evento
created_atData e hora do evento, em UTC.
Dados específicos do evento
WebhookEventDebtCreated
idID único do evento
typeTipo do evento
versionVersão do formato do evento
created_atData e hora do evento, em UTC.
Dados específicos do evento
WebhookEventDebtHeld
idID único do evento
typeTipo do evento
versionVersão do formato do evento
created_atData e hora do evento, em UTC.
Dados específicos do evento
WebhookEventDebtArchived
idID único do evento
typeTipo do evento
versionVersão do formato do evento
created_atData e hora do evento, em UTC.
Dados específicos do evento
WebhookEventDebtUnarchived
idID único do evento
typeTipo do evento
versionVersão do formato do evento
created_atData e hora do evento, em UTC.
Dados específicos do evento
WebhookEventDebtReactivated
idID único do evento
typeTipo do evento
versionVersão do formato do evento
created_atData e hora do evento, em UTC.
Dados específicos do evento
WebhookEventCustomerCreated
idID único do evento
typeTipo do evento
versionVersão do formato do evento
created_atData e hora do evento, em UTC.
Dados específicos do evento
WebhookEventContract
idID único do evento
typeTipo do evento
versionVersão do formato do evento
created_atData e hora do evento, em UTC.
Dados específicos do evento
WebhookEventContractCreated
idID único do evento
typeTipo do evento
versionVersão do formato do evento
created_atData e hora do evento, em UTC.
Dados específicos do evento
WebhookEventContractTerminated
idID único do evento
typeTipo do evento
versionVersão do formato do evento
created_atData e hora do evento, em UTC.
Dados específicos do evento
WebhookEventContractSettled
idID único do evento
typeTipo do evento
versionVersão do formato do evento
created_atData e hora do evento, em UTC.
Dados específicos do evento
WebhookEventContractInstallmentPaid
idID único do evento
typeTipo do evento
versionVersão do formato do evento
created_atData e hora do evento, em UTC.
Dados específicos do evento

