Ativar contrato
POST /enable_contract
Resumo
Este endpoint permite ativar um contrato previamente desativado em uma unidade específica.
Descrição
Utilize este endpoint para reativar logicamente um contrato, alterando seu status para ativo. O contato deve existir e estar associado à unidade informada.
Requisição
Body da Requisição
O corpo deve ser um objeto JSON com os seguintes parâmetros:
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
access_token | string | Sim | Token de autenticação do usuário. | aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee |
unit_token | string | Sim | Token identificador da unidade. | aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee |
id_token_contract | string | Sim | Token identificador do contato a ser ativado. | aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee |
Exemplo de Requisição
Curl
curl -X POST 'https://portal.fipli.pro/api/v1/enable_contract' \
-H 'Content-Type: application/json' \
-d '{
"access_token": "<access_token>",
"unit_token": "<unit_token>",
"id_token_contract": "<id_token_contract>"
}'
Resposta
200 OK
Ativação realizada com sucesso.
{
"success": true,
"message": "Contract enabled successfully.",
"data": null
}
Erros Comuns
| Status | Mensagem | Descrição |
|---|---|---|
400 | "Missing parameters" | Algum parâmetro obrigatório (access_token, unit_token, id_token_contract) não foi enviado. |
403 | "Invalid data" | Token de autenticação inválido ou não autorizado. |
500 | "Something went wrong. Please try again later." | Erro interno no servidor. |