Ir al contenido
POST
/cloud/plataforma/clientes/{id}/webhooks
curl --request POST \
--url https://app.openfactura.co/cloud/plataforma/clientes/example/webhooks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "url": "https://pos.casabarista.sv/webhooks/openfactura", "descripcion": "example", "eventos": [ "dte.procesado", "dte.rechazado" ] }'

Vive en el espacio del cliente y recibe sólo sus eventos (sin cliente). Tus webhooks de cuenta ya reciben los de todos tus clientes con cliente. El secreto sólo aparece aquí.

id
required
string

Id del cliente (cli_… o uuid)

Media typeapplication/json
object
url
required
string format: uri

Example

https://pos.casabarista.sv/webhooks/openfactura
descripcion
string | null
eventos
required
Array<string>

Example

[
"dte.procesado",
"dte.rechazado"
]

Webhook creado.

Media typeapplication/json
object
id
string
url
string
descripcion
string | null
eventos
Array<string>
activo
boolean
secreto

Sólo aparece aquí.

string

Example

{
"secreto": "whsec_…"
}

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

No existe o no es tuyo

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

Para asistentes de IA: llms.txt ·llms-full.txt ·cada página en Markdown añadiendo .md a su ruta.