Endpoint responsável por solicitar a criação de uma negativação vinculada a uma cobrança existente no Asaas.
Essa chamada inicia o fluxo de negativação da dívida a partir de uma cobrança previamente cadastrada. Além dos dados da cobrança, a requisição exige o envio de informações complementares do cliente e, quando aplicável, da documentação comprobatória da dívida.
Regra importante antes de integrar
Para utilizar esse endpoint, é necessário que a conta possua permissão para criação de negativações via API.
Caso a funcionalidade ainda não esteja habilitada, é necessário entrar em contato com o gerente de contas Asaas para solicitar a liberação.
Parâmetros principais da requisição
Alguns campos possuem papel central no envio da negativação:
payment - Identificador único da cobrança que será vinculada à negativação.
type - Tipo de negativação que será solicitada. Atualmente, o valor disponível é:
CREDIT_BUREAU
description - Descrição do produto ou serviço prestado que originou a dívida.
customerName - Nome do cliente que será negativado.
customerCpfCnpj - CPF ou CNPJ do cliente.
customerPrimaryPhone - Telefone principal do cliente.
customerSecondaryPhone - Telefone secundário do cliente.
customerPostalCode - CEP do endereço do cliente.
customerAddress - Logradouro do cliente.
customerAddressNumber - Número do endereço do cliente.
customerComplement - Complemento do endereço do cliente.
customerProvince - Bairro do cliente.
documents - Arquivo com nota fiscal e/ou contrato com firma reconhecida em cartório.
Relação com a cobrança
A negativação sempre parte de uma cobrança existente.
Por esse motivo, a integração deve armazenar corretamente o identificador da cobrança e garantir que o registro utilizado no campo payment corresponda exatamente à dívida que será negativada.
Documentação comprobatória
Dependendo do fluxo de análise, a negativação poderá exigir documentação comprobatória da dívida.
O envio correto desses documentos é importante para evitar reprovação na análise e necessidade de reenvio posterior.