Actualizar usuario

Actualice la información de los usuarios en su comercio. Esta funcionalidad le permite modificar los roles, privilegios o cualquier otro dato pertinente de los usuarios existentes en Qentaz. Es esencial proporcionar la información actualizada precisa para asegurar que la gestión de usuarios en el sistema refleje los cambios deseados de manera efectiva y segura.

Ruta

PATCH /v1/merchant/team/{phone|email}

Encabezado

Name	Value
Content-Type*	application/json
x-auth-token*	{token}

Cuerpo

Name	Type	Description
nickname	string	Es el nombre con el que nos comunicaremos con el usuario, por ejemplo ¡Hola Carlos! Ejemplo: Carlos
role	string	Define el rol que tendrá el usuario dentro de Trazo. collector | member | analyst | specialist
collect_limit	numeric	Valor máximo autorizado para recaudar por el usuario en efectivo. Ejemplo: 2000000
phone	string	Número de celular del usuario (incluir el código de área del país). Ejemplo: 573112223333
email	string	Correo del usuario. Ejemplo: [email protected]
external_user_id	string	Identificador asignado para el usuario. Ejemplo: KFF122

Respuesta

200

{
    "message": "The user has been updated.",
    "updated_at": "2024-08-27T13:33:52+00:00"
}

400

{
    "error": "The user with 573112223333 is not registered in the system."
}

401

{
    "status": "unauthorized",
    "code": "Q103",
    "error": "El x-auth-token se encuentra vencido. Por favor genera un nuevo token y reintenta de nuevo el cobro."
}

---

Ejemplo

cURL

curl --location --request PATCH '{{base_url}}/v1/merchant/team/573112223333' \
--header 'x-auth-token: {{token}}' \
--header 'Content-Type: application/json' \

--data '{
    "nickname": "DIEGO",
    "role": "member",
    "collect_limit": 10000000,
    "user_country": "Colombia",
    "user_state": "Cundinamarca",
    "user_city": "Bogotá",
    "external_user_id": "NTC73G"
}'

NodeJS (Axios)

const axios = require('axios');
let data = JSON.stringify({
  "nickname": "DIEGO",
  "role": "member",
  "collect_limit": 10000000,
  "user_country": "Colombia",
  "user_state": "Cundinamarca",
  "user_city": "Bogotá",
  "external_user_id": "NTC73G"
});

let config = {
  method: 'patch',
  maxBodyLength: Infinity,
  url: `${base_url}/v1/merchant/team/573112223333`,
  headers: { 
    'x-auth-token': token, //Añadir token 
    'Content-Type': 'application/json'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Python

import requests
import json

url = f"{base_url}/v1/merchant/team/573112223333"

payload = json.dumps({
  "nickname": "DIEGO",
  "role": "member",
  "collect_limit": 10000000,
  "user_country": "Colombia",
  "user_state": "Cundinamarca",
  "user_city": "Bogotá",
  "external_user_id": "NTC73G"
})
headers = {
  'x-auth-token': token, #Añadir token
  'Content-Type': 'application/json'153'
}

response = requests.request("PATCH", url, headers=headers, data=payload)

print(response.text)