Crear un cliente
POST
/cloud/plataforma/clientes
const url = 'https://app.openfactura.co/cloud/plataforma/clientes';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"nombre":"Casa Barista","externalId":"cliente-482","datos":{"nit":"0614-290786-102-3","nrc":"123456-7","razonSocial":"example","nombreComercial":"example","correo":"[email protected]","telefono":"example"}}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://app.openfactura.co/cloud/plataforma/clientes \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "nombre": "Casa Barista", "externalId": "cliente-482", "datos": { "nit": "0614-290786-102-3", "nrc": "123456-7", "razonSocial": "example", "nombreComercial": "example", "correo": "[email protected]", "telefono": "example" } }'Crea un cliente pendiente con su propio espacio (organización aislada). Lo que ya sabes de él (datos) llega prellenado a su alta.
Authorizations
Sección titulada «Authorizations»Request Bodyrequired
Sección titulada «Request Bodyrequired»Media typeapplication/json
object
nombre
required
string
Example
Casa BaristaexternalId
Tu propio id del cliente; único en tu cuenta.
string | null
Example
cliente-482datos
Lo que ya sabes del cliente; prellena su alta.
object
nit
string
Example
0614-290786-102-3nrc
string
Example
123456-7razonSocial
string
nombreComercial
string
correo
string format: email
telefono
string
Responses
Sección titulada «Responses»Cliente creado.
Media typeapplication/json
object
id
string
nombre
string
externalId
string | null
estado
string
datos
Lo que ya sabes del cliente; prellena su alta.
object
nit
string
nrc
string
razonSocial
string
nombreComercial
string
correo
string format: email
telefono
string
organizationId
Su espacio (existe desde que lo creas).
string | null
preparacion
string | null
falta
string | null
enlaceExpira
integer | null
aceptado
integer | null
creado
integer
Example
{ "estado": "pendiente", "datos": { "nit": "0614-290786-102-3", "nrc": "123456-7" }, "preparacion": "conectado", "falta": "Sus credenciales de producción"}Datos inválidos
Media typeapplication/json
object
error
object
code
string
message
string
details
Example
{ "error": { "code": "plan_requerido" }}Tu plan no lo incluye (plan_requerido)
Media typeapplication/json
object
error
object
code
string
message
string
details
Example
{ "error": { "code": "plan_requerido" }}Sin permiso o clave no habilitada para Plataforma (clave_sin_plataforma)
Media typeapplication/json
object
error
object
code
string
message
string
details
Example
{ "error": { "code": "plan_requerido" }}Conflicto (p. ej. cliente_no_pendiente, external_id_repetido)
Media typeapplication/json
object
error
object
code
string
message
string
details
Example
{ "error": { "code": "plan_requerido" }}Límite de empresas del plan (limite_plan)
Media typeapplication/json
object
error
object
code
string
message
string
details
Example
{ "error": { "code": "plan_requerido" }}Para asistentes de IA: llms.txt ·llms-full.txt ·cada página en Markdown añadiendo .md a su ruta.