Actualizar cliente

Actualiza los datos de un cliente existente en Pymes.

Identificación del cliente

Se debe proporcionar al menos uno de los siguientes identificadores:

  • uuid del cliente, o
  • La combinación tipoId + id (ambos son obligatorios si se usa esta opción).

Campos del body

CampoTipoObligatorioDescripción
uuidstringCondicionalUUID del cliente (32 chars hex). Requerido si no se envía tipoId + id.
tipoIdstringCondicionalTipo de identificación. Requerido junto con id si no se envía uuid.
idstringCondicionalNúmero de identificación. Requerido junto con tipoId si no se envía uuid. Máx. 30 caracteres.
primerNombrestringNoPrimer nombre del cliente. Máx. 150 caracteres.
segundoNombrestringNoSegundo nombre del cliente. Máx. 100 caracteres.
primerApellidostringNoPrimer apellido del cliente. Máx. 100 caracteres.
segundoApellidostringNoSegundo apellido del cliente. Máx. 100 caracteres.
nombresCompletosstringNoNombre completo o razón social. Máx. 510 caracteres.
direccionstringNoDirección del cliente. Máx. 60 caracteres.
ciudad_codigostringNoCódigo DANE de la ciudad. Máx. 5 caracteres.
telefonostringNoTeléfono (solo dígitos). Máx. 12 caracteres.
emailstringNoCorreo electrónico. Máx. 60 caracteres.

Reglas de negocio

  • Si no se envía ningún identificador (uuid o tipoId + id), retorna 400.
  • Si se envía tipoId sin id (o viceversa), retorna 400.
  • Si el cliente no existe, retorna 404.
  • Solo se actualizan los campos enviados en el body; los demás se conservan.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Al menos uno de los identificadores es obligatorio: uuid o la combinación tipoId + id.

string
length ≤ 32
^[\dA-F]{32}$

UUID del cliente a actualizar

string
length between 2 and 32

Tipo de identificación (alternativo a uuid, debe enviarse junto con id)

string
length ≤ 30

Número de identificación (alternativo a uuid, debe enviarse junto con tipoId)

string
length ≤ 150

Primer nombre del cliente

string
length ≤ 100

Segundo nombre del cliente

string
length ≤ 100

Primer apellido del cliente

string
length ≤ 100

Segundo apellido del cliente

string
length ≤ 510

Nombre completo o razón social (para personas jurídicas)

string
length ≤ 60

Dirección del cliente

string
length ≤ 5

Código DANE de la ciudad

string
length ≤ 12

Teléfono del cliente (solo dígitos)

string
length ≤ 60

Correo electrónico del cliente

Responses

500

Error interno del servidor

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json