Listar clientes
GET
/cloud/plataforma/clientes
const url = 'https://app.openfactura.co/cloud/plataforma/clientes?estado=pendiente';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://app.openfactura.co/cloud/plataforma/clientes?estado=pendiente' \ --header 'Authorization: Bearer <token>'Tus clientes con su estado, qué tan listos están para emitir (preparacion) y qué les falta (falta).
Authorizations
Sección titulada «Authorizations»Parameters
Sección titulada «Parameters»Query Parameters
Sección titulada «Query Parameters»estado
string
Filtra por estado.
externalId
string
Busca por tu id.
Responses
Sección titulada «Responses»Clientes.
Media typeapplication/json
Array<object>
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" }]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" }}Para asistentes de IA: llms.txt ·llms-full.txt ·cada página en Markdown añadiendo .md a su ruta.