/users/v1/{id}Modificar Usuario
El endpoint /users/v1/{id} permite actualizar la información de un usuario a través de su id.
Consideraciones
Para bloquear un usuario deberás enviar el status con el valor BLOCKED y el valor CLIENT_INTERNAL_REASON en el campo status_reason.
Para reactivar un usuario que bloqueaste, deberás enviar status con valor ACTIVE.
Consideraciones sobre usuarios repetidos
Cada usuario debe tener un email único. También debe ser única la combinación de tipo de documento de identidad y valor.
Consideraciones sobre los documentos de identidad a utilizar
Para Argentina
Los tipos de documento de identidad aceptados son los siguientes:
- DNI
- LE
- LC
- CI
- PASSPORT
En el caso del DNI, validaremos que su extensión sea de 7 u 8 caracteres.
El tipo de documento fiscal aceptado es:
- CUIL
En el caso del CUIL, validaremos que los primeros dos dígitos sean 20, 23, 24, 27, 30, 33 o 34 y que su extensión sea de exactamente 11 caracteres
Para Brasil
Los tipos de documento de identidad aceptados son los siguientes:
- RG
- CNH
El tipo de documento fiscal aceptado es:
- CPF
En el caso de CPF, validaremos que su extensión sea de exactamente 11 caracteres.
Para México
Los tipos de documento de identidad aceptados son los siguientes:
- INE
- PASSPORT
El documento fiscal no es obligatorio incluirlo, pero el tipo aceptado es:
- RFC
Para Colombia
Los tipos de documento de identidad aceptados son los siguientes:
- CC
- CE
- PPT
- PASSPORT
Para CC validaremos que su extensión sea entre 5 y 11 caracteres.
Para CE validaremos que su extensión sea entre 6 y 7 caracteres.
Para PPT validaremos que su extensión sea entre 1 y 8 caracteres.
El documento fiscal no es obligatorio incluirlo, pero el tipo aceptado es:
- NIT
En el caso del NIT, validaremos que su extensión sea de exactamente 10 caracteres.
Para Perú
Los tipos de documento de identidad aceptados son los siguientes:
- DNI
- CE
- PASSPORT
En el caso del DNI, validaremos que su extensión sea de exactamente 8 caracteres, todos numéricos
En el caso del CE o PASSPORT, validaremos que su extensión sea de hasta 12 caracteres alfanuméricos
El tipo de documento fiscal aceptado es:
- RUC
En el caso del RUC, validaremos que los primeros dos dígitos sean 10, 15 o 17 y que su extensión sea de 11 dígitos.
Para Chile
Los tipos de documento de identidad aceptados son los siguientes:
- CI
En el caso del RUT, validaremos que su extensión sea entre 8 y 12 caracteres, incluido el digito verificador, el cual puede ser un dígito o una letra k.
El tipo de documento fiscal aceptado es:
- RUT
En el caso del RUT, validaremos que su extensión sea entre 8 y 12 caracteres, incluido el digito verificador, el cual puede ser un dígito o una letra k.
Consideraciones sobre el domicilio legal
Para Argentina
Si operas en Argentina, el domicilio legal del usuario tendrá que ser de alguna de estas provincias:
- Buenos Aires
- Catamarca
- Chaco
- Chubut
- Ciudad Autónoma de Buenos Aires
- Corrientes
- Córdoba
- Entre Ríos
- Formosa
- Jujuy
- La Pampa
- La Rioja
- Mendoza
- Misiones
- Neuquén
- Río Negro
- Salta
- San Juan
- San Luis
- Santa Cruz
- Santa Fe
- Santiago del Estero
- Tierra del Fuego
- Tucumán
Para Brasil
Si operas en Brasil, deberás completar el campo zipcode con un dato válido, ya que lo usaremos para determinar la dirección legal del usuario.
Para México
En caso que el país de operatoria sea México, no existe ningún requisito especial respecto a los campos de dirección legal del usuario.
Para Chile
En caso que el país de operatoria sea Chile, no existe ningún requisito especial respecto a los campos de dirección legal del usuario.
Parámetros disponibles
application/jsonDetalle de respuestas
{
"name": "Diego",
"surname": "Pomelo",
"identification_type": "DNI",
"identification_value": 42345678,
"birthdate": "1998-08-20",
"gender": "MALE",
"email": "[email protected]",
"phone": "1123456789",
"tax_identification_type": "CUIL",
"tax_identification_value": 20423456789,
"nationality": "ARG",
"tax_condition": "VAT_REGISTERED",
"status": "ACTIVE",
"status_reason": "CLIENT_INTERNAL_REASON",
"legal_address": {
"street_name": "Av. Corrientes",
"street_number": 300,
"floor": 1,
"apartment": "A",
"zip_code": 1414,
"neighborhood": "Villa Crespo",
"city": "CABA",
"region": "Buenos Aires",
"additional_info": "Torre 2",
"country": "ARG"
}
}curl -X PATCH "https://api.pomelo.la/users/v1/example_value" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"name": "Diego",
"surname": "Pomelo",
"identification_type": "DNI",
"identification_value": 42345678,
"birthdate": "1998-08-20",
"gender": "MALE",
"email": "[email protected]",
"phone": "1123456789",
"tax_identification_type": "CUIL",
"tax_identification_value": 20423456789,
"nationality": "ARG",
"tax_condition": "VAT_REGISTERED",
"status": "ACTIVE",
"status_reason": "CLIENT_INTERNAL_REASON",
"legal_address": {
"street_name": "Av. Corrientes",
"street_number": 300,
"floor": 1,
"apartment": "A",
"zip_code": 1414,
"neighborhood": "Villa Crespo",
"city": "CABA",
"region": "Buenos Aires",
"additional_info": "Torre 2",
"country": "ARG"
}
}'{
"data": {
"id": "usr-203c6jQq0O3nVWXj6jRUQXy7QkC",
"name": "Diego",
"surname": "Pomelo",
"identification_type": "DNI",
"identification_value": 42345678,
"birthdate": "1998-08-20",
"gender": "MALE",
"email": "[email protected]",
"phone": "1123456789",
"tax_identification_type": "CUIL",
"tax_identification_value": 20423456789,
"nationality": "ARG",
"tax_condition": "VAT_REGISTERED",
"status": "ACTIVE",
"operation_country": "ARG",
"legal_address": {
"street_name": "Av. Corrientes",
"street_number": 300,
"floor": 1,
"apartment": "A",
"zip_code": 1414,
"neighborhood": "Villa Crespo",
"city": "CABA",
"region": "Buenos Aires",
"additional_info": "Torre 2",
"country": "ARG"
}
}
}