Crear un webhook para el cliente
POST
/cloud/plataforma/clientes/{id}/webhooks
const url = 'https://app.openfactura.co/cloud/plataforma/clientes/example/webhooks';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"url":"https://pos.casabarista.sv/webhooks/openfactura","descripcion":"example","eventos":["dte.procesado","dte.rechazado"]}'};
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/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í.
Authorizations
Sección titulada «Authorizations»Parameters
Sección titulada «Parameters»Path Parameters
Sección titulada «Path Parameters»id
required
string
Id del cliente (cli_… o uuid)
Request Bodyrequired
Sección titulada «Request Bodyrequired»Media typeapplication/json
object
url
required
string format: uri
Example
https://pos.casabarista.sv/webhooks/openfacturadescripcion
string | null
eventos
required
Array<string>
Example
[ "dte.procesado", "dte.rechazado"]Responses
Sección titulada «Responses»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.