Ir al contenido
PUT
/api/v1/ext/marca/plataforma
curl --request PUT \
--url https://app.openfactura.co/api/v1/ext/marca/plataforma \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "activa": true, "nombre": "example", "slug": "example", "color": "example", "correoSoporte": "example", "whatsappSoporte": "example" }'

Requiere el plan Platform y una cuenta que no sea administrada por otra plataforma (si no, 402 plan_requerido). Todos los campos son opcionales. activa la enciende o apaga; al apagarla, o si el plan vence, nada se borra y todo vuelve a la marca de Open Factura. Permiso emisor:write.

Media typeapplication/json
object
activa
boolean
nombre
string
>= 2 characters <= 40 characters
slug
string
/^[a-z][a-z0-9-]{2,31}$/
color
string
/^#[0-9a-fA-F]{6}$/
correoSoporte
string | null
whatsappSoporte
string | null

Example generated

{
"activa": true,
"nombre": "example",
"slug": "example",
"color": "example",
"correoSoporte": "example",
"whatsappSoporte": "example"
}

Marca blanca.

Media typeapplication/json
object
disponible

Si tu plan incluye marca blanca.

boolean
activa
boolean
nombre

2 a 40 caracteres.

string | null
slug
string | null
color

Hexadecimal #rrggbb con contraste suficiente sobre fondo oscuro.

string | null
logo
object
tipo
string
url
string
correoSoporte
string | null
whatsappSoporte
string | null
remitente
object
direccion
string
verificado
boolean
urlBase

Base de los enlaces de alta de tus clientes: tu dominio activo o, si no, el de Open Factura.

string
dominiosPropios
object
disponible
boolean
dominios
Array<object>
object
id
string
host
string
estado
string
Allowed values: pendiente verificando activo error
error
string | null
dns

Registros que debes crear en el DNS de tu dominio.

Array<object>
object
tipo
string
Allowed values: CNAME TXT
nombre
string
valor
string
para
string
Allowed values: trafico propiedad certificado
creado
integer
activado
integer | null

Example

{
"color": "#3b82f6",
"dominios": [
{
"host": "facturas.tuempresa.com",
"estado": "pendiente",
"dns": [
{
"tipo": "CNAME",
"para": "trafico"
}
]
}
]
}

Datos inválidos

Media typeapplication/json
object
error
object
code
string
message
string
details

Example

{
"error": {
"code": "plan_requerido"
}
}

Falta la clave o la sesión

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"
}
}

slug_en_uso: otra plataforma ya usa ese identificador.

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.