Nome alternativo da conta-corrente
O endereço ecmanagertransactions, equivalente a manager_transactions, usado pelo app de representantes já instalado.
O app de representantes chama a conta-corrente de ecmanagertransactions, o nome da classe EcManagerTransactions em minúsculas e sem sublinhado. Os dois endereços desta página (com e sem /v1.0) executam o mesmo código de Conta-corrente do representante: mesmos parâmetros, mesma resposta, mesmos erros. Exigem um usuário administrador.
/api/v1.0/ecmanagertransactionsAdminMesmo que manager_transactions (GET), forma com versão
Igual a GET /api/v1.0/manager_transactions: extrato e saldo do representante.
Parâmetros de consulta
manager_idstringinternal_codestringuser_idstringtypestringCDC) ou descontos (D).pageintegerpadrão: 1items_per_pageintegerpadrão: 10/api/v1.0/ecmanagertransactionsAdminMesmo que manager_transactions (POST), forma com versão
Igual a POST /api/v1.0/manager_transactions: lançamento manual de crédito ou redução.
Corpo da requisição
amountnumberobrigatórioscopestringobrigatórioA soma; qualquer outro texto subtrai.manager_idstringinternal_codestringuser_idstring/api/ecmanagertransactionsAdminMesmo que manager_transactions (GET), forma sem versão
Igual a GET /api/manager_transactions: extrato e saldo do representante.
Parâmetros de consulta
manager_idstringinternal_codestringuser_idstringtypestringCDC) ou descontos (D).pageintegerpadrão: 1items_per_pageintegerpadrão: 10/api/ecmanagertransactionsAdminMesmo que manager_transactions (POST), forma sem versão
Igual a POST /api/manager_transactions: lançamento manual de crédito ou redução.
Corpo da requisição
amountnumberobrigatórioscopestringobrigatórioA soma; qualquer outro texto subtrai.manager_idstringinternal_codestringuser_idstringExemplo de requisição
curl "$BASE_URL/api/v1.0/ecmanagertransactions?manager_id=2" -u "$ADMIN_EMAIL:$API_KEY"
curl -X POST "$BASE_URL/api/v1.0/ecmanagertransactions" \
-u "$ADMIN_EMAIL:$API_KEY" \
-H "Content-Type: application/json" \
-d '{"amount":50,"scope":"A","manager_id":2}'Resposta
{
"success": true,
"message": "",
"balance": "150.00",
"transactions": [],
"search": { "page": 1, "items_per_page": 10, "total_items": 0 }
}Os campos completos e o formato do lançamento estão em Conta-corrente do representante.
Erros
Os mesmos de Conta-corrente do representante: 400 para corpo inválido, amount ou scope ausentes, saldo insuficiente e representante numérico inexistente; 401 sem credencial; 403 sem perfil de administrador; e as respostas 200 enganosas (result: null, lista vazia) quando o identificador não é número.