Verificar Consumidor

Verificando o contexto da unidade consumidora (UC):

Verify context flow

Descrição

A verificação de contexto de unidade consumidora ocorre junto à concessionária de energia abrangendo a necessidade do sistema consumidor do motor de verificar a situação atual do usuário.

CampoTipoDescrição
dealershipIdnumberObrigatório. Chave fornecida a cada parceiro.
companyCodenumberNumero da compania (requerido para energisa).
installationNumbernumberObrigatório. Numero da UC presente na conta.
cpfstringCPF do cliente (requerido para enel).

Exemplos de utilização

curl --location '{motor_base_url}/validate?dealershipId=0&companyCode=0&installationNumber=0'

Retornos aguardados

{
    "hasPending": [false, true], // é uma UC válida, porém pode estar em débito.
    "isValid": true,
    "message": null,
    "motive": null
}

Retornos de erro

{
    "hasPending": false,
    "isValid": false,
    "message": "Client not found on {service_name}",
    "motive": "Not found"
}

O endpoint de verificação de contexto irá sempre consultar o serviço da concessionária portanto, caso o serviço externo esteja offline, nesse caso o padrão será modificado.

️🚫

Status Code 500

{
    "message": "Service is unavailable, please try again later"
}