Modificar un cliente

PUT https://api.persat.com.ar/v1/clients/uid_client

Modifico alguno de los campos del cliente con número de cliente uid_client

Headers

Name	Type	Description
Content-Type*	string	application/json
Authorization*	string	Bearer API_KEY

Request Body

Name	Type	Description
company_name	string	Nombre del cliente, razón social o nombre de fantasía.
company_description	string	Descripción del cliente.
latitude	number	Ubicación del cliente, latitud
longitude	number	Ubicación del cliente, longitud
street	string	Calle en donde se encuentra el cliente. No incluir el número.
street_nbr	string	Número de la calle.
neighborhood	string	Barrio, por ej: "Devoto"
city	string	Ciudad, por ejemplo "CABA"
country	string	País, por ejemplo: "Argentina"
custom_fields	JSON Object	Campos personalizados de la ficha de clientes
type_id	Number	Identificador del tipo de cliente. Debe ser un tipo válido, de lo contrario se recibira un 409 CONFLICT como respuesta
group_id	Number	Identificador del grupo de cliente. Debe ser un grupo valido, de lo contrario se recibirá 409 CONFLICT como respuesta

200 Cliente modificado. Sólo se devuelven los campos que fueron modificados

{
    "success": true,
    "data": {
        "uid_client": "CL-0044",
        "company_name": "Persat nuevo",
        "company_description": "Logistica GPS nuevo",
        "latitude": "-32"
        "custom_fields": {
            "2": "4444-5555"
        }
    }
}

400 Valor de latitude incorrecto

{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'latitude' debe ser un número entre -90 y +90"
    }
}

404 Intento modificar un cliente que no existe.

{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "El cliente que desea modificar no existe."
    }
}

409: Conflict type_id | group_id invalidos

{
    "success": false,
    "error": {
        "status": 409,
        "type": "CONFLICT",
        "userMessage": "type_id o group_id tiene un valor invalido. Enviar los campos en 0, o no enviar dichos campos"
    }
}

409: Conflict Ya existe otro cliente con este company_name

{
    "success": false,
    "error": {
        "status": 409,
        "type": "CONFLICT",
        "userMessage": "ER_DUP_ENTRY: Duplicate entry 'Persat' for key 'company_name'"
    }
}

En caso de que la respuesta sea exitosa, sólo se devuelven los datos que fueron modificados. A diferencia de Agregar un cliente, en donde se devuelve el cliente completo

A continuación un ejemplo con curl, en donde modifico, los campos: company_name, company_description, latitude y custom_fields del cliente "CL-0044"

curl --location --request PUT "https://api.persat.com.ar/v1/clients/CL-0044" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --data "{
	\"company_name\":\"Persat nuevo\",
	\"company_description\":\"Logistica GPS nuevo\",
	\"latitude\":-32,
	\"group_id\": 2,
	\"custom_fields\": {
		\"2\": \"4444-5555\"
	}
  }"

Los campos son explicados en la sección Obtener un cliente

IMPORTANTE: En ningún caso la dirección se calcula automáticamente en base a latitude y longitude.Esto si ocurre desde la aplicación web de Persat, o desde la app de Android