Ir al contenido
GET
/cloud/plataforma/clientes
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).

estado
string
Allowed values: pendiente activo desactivado

Filtra por estado.

externalId
string

Busca por tu id.

Clientes.

Media typeapplication/json
Array<object>
object
id
string
nombre
string
externalId
string | null
estado
string
Allowed values: pendiente activo desactivado
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
Allowed values: conectado pruebas produccion
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.