AC1 - Inserir um cliente na carteira
A EEmovel Agro fornece uma integração para que os nossos parceiros possam enviar os
seus novos clientes para a plataforma.Endpoint: /import-portfolio
Exemplo de solicitação utilizando a linguagem PHP:<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL =>
"https://api.master.eemovelagro.com.br/agro/hub/delivery/internal/v1[/import-portfolio](https://api.prd.agro.eemovel.com.br/agro/agro-hub/delivery/internal/import-portfolio)",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "[\n {\n \"alias\": \"CASSIANO SOBRENOME\",\n
\"document\": \"04652232328\",\n \"group_id\": 1,\n \"sales_promoter_id\":
1,\n \"description\": \"teste\",\n\t\t\t\"public\": false\n }\n]",
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key:token_api_aqui"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
Método | Parâmetro | Tipo | Observação |
---|
POST | x-api-key | header | Obtido através de solicitação à EEmovel |
| alias | body | Opcional |
| group_id | body | ID do grupo do usuário |
| document | body | Número do documento do proprietário |
| sales_promoter_id | body | ID do promotor de vendas |
| description | body | Descrição |
| public | body | Indica se o cliente estará visível para todos os grupos do provedor |
Exemplo de retorno para a requisição acima:{
"code":200,
"data":[
{
"alias":"CASSIANO SOBRENOME",
"document":"04652232328",
"error":false,
"id":1053439,
"message_id":"customer_add_sucessfull",
"name":"CASSIANO SOBRENOME"
}
],
"message":"success",
"success":true
}
A chave “data” retorna uma lista de clientes inseridos. Onde:Chave | Formato | Descrição valor |
---|
alias | String | Alias informado no payload da adição |
document | String | Documento do cliente inserido |
error | Boolean | Indica se o cliente foi inserido ou não na carteira, caso não, apresenta o motivo da não inserção |
id | Integer | ID do cliente inserido na carteira (null caso a inserção falhe) |
message_id | String | Mensagem de sucesso ou motivo do erro na inserção de cliente |
name | String | Nome do cliente inserido |
Modificado em 2025-06-23 18:25:00