Crear cliente

post

https://api.loggro.com/apik/loggro-facturacion/v1/clientes

Crea un nuevo cliente en Pymes.

Campos del body

Campo	Tipo	Obligatorio	Descripción
`uuid`	string	No	UUID del cliente (32 chars hex). Si se envía, se realiza un upsert con ese identificador.
`id`	string	Sí (si no hay `uuid`)	Número de identificación del cliente. Máx. 30 caracteres.
`tipoId`	string	No	Tipo de identificación: `CC`, `NIT`, `PS`, `DE`, etc. Por defecto `CC`.
`dv`	string	No	Dígito de verificación. Se valida automáticamente para `CC` y `NIT`. Máx. 2 caracteres.
`nombres`	string	Sí (si `tipoId` ≠ NIT)	Nombres del cliente. Máx. 150 caracteres.
`apellidos`	string	Sí (si `tipoId` ≠ NIT)	Apellidos del cliente. Máx. 100 caracteres.
`nombresCompletos`	string	Sí (si `tipoId` = NIT)	Razón social o nombre completo. Máx. 510 caracteres.
`direccion`	string	No	Dirección del cliente. Máx. 60 caracteres.
`telefono`	string	No	Teléfono (solo dígitos). Máx. 12 caracteres.
`email`	string	No	Correo electrónico. Máx. 60 caracteres.
`ciudad_codigo`	string	No	Código DANE de la ciudad. Máx. 5 caracteres.

Reglas de negocio

Para personas naturales (tipoId distinto de NIT): son obligatorios nombres y apellidos.
Para personas jurídicas (tipoId = NIT): es obligatorio nombresCompletos.
El dv se valida automáticamente para CC y NIT. Si no coincide con el calculado, retorna 400.
Para tipoId = PS o DE el campo id admite caracteres alfanuméricos ([A-Z0-9], entre 3 y 32 chars).
Si el cliente ya existe pero está inactivo o suspendido, el servicio lo reactiva con los datos enviados y retorna 201.
Si el cliente ya existe y está activo, retorna 400 con código cliente.crear.ya-existe.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

uuid

string

length between 32 and 32

UUID del cliente existente en Pymes. Si se envía, no se requieren los demás campos.

string

length ≤ 30

Número de identificación del cliente

tipoId

string

length between 2 and 32

Defaults to CC

Tipo de identificación (CC, NIT, PS, DE, etc.)

string

length ≤ 2

Dígito de verificación. Se valida automáticamente para CC y NIT.

nombres

string

length ≤ 150

Nombres del cliente. Requerido si tipoId no es NIT.

apellidos

string

length ≤ 100

Apellidos del cliente. Requerido si tipoId no es NIT.

nombresCompletos

string

length ≤ 510

Nombre completo o razón social. Requerido si tipoId es NIT.

direccion

string

length ≤ 60

Dirección del cliente

telefono

string

length ≤ 12

Teléfono del cliente (solo dígitos)

string

length ≤ 60

Correo electrónico del cliente

ciudad_codigo

string

length ≤ 5

Código DANE de la ciudad del cliente

Responses

500

Error interno del servidor

201Cliente creado exitosamente

400Datos inválidos o regla de negocio no satisfecha