Iniciar o retomar la certificación
const url = 'https://app.openfactura.co/api/v1/ext/certificacion/iniciar';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"receptor":"openfactura","desdeCero":true,"alcance":"minimo"}'};
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/api/v1/ext/certificacion/iniciar \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "receptor": "openfactura", "desdeCero": true, "alcance": "minimo" }'Receptor de los Créditos Fiscales de prueba: openfactura (Open Factura, recomendado) o los datos de otro contribuyente con NRC; no se guarda como cliente. Hacienda no acepta el propio emisor (409 receptor_propio); con credenciales reales hace falta un receptor (409 receptor_ccf_requerido). Permisos dte:emit y dte:invalidate.
Authorizations
Sección titulada «Authorizations»Request Bodyrequired
Sección titulada «Request Bodyrequired»object
Receptor de los CCF de prueba: “openfactura” (recomendado) o los datos de otro contribuyente, con NRC. No es un cliente guardado. Si se omite se conserva el anterior.
object
object
Responses
Sección titulada «Responses»Certificación.
object
La certificación sólo corre en el ambiente de pruebas.
object
Credenciales del simulador: es un simulacro, nada llega a Hacienda.
Milisegundos desde 1970; nulo si no se ha iniciado.
Receptor de los CCF de prueba; nulo = el propio emisor (sólo en un simulacro).
object
object
El rechazo del MH (u otro error) que detuvo la certificación.
object
Example
{ "ambiente": "00", "estado": "sin_iniciar", "alcance": "minimo", "metas": [ { "id": "facturas" } ], "ultimoError": { "operacion": "facturas" }}Datos inválidos
object
object
Example
{ "error": { "code": "plan_requerido" }}Falta la clave o la sesión
object
object
Example
{ "error": { "code": "plan_requerido" }}Sin permiso o clave no habilitada para Plataforma (clave_sin_plataforma)
object
object
Example
{ "error": { "code": "plan_requerido" }}No existe o no es tuyo
object
object
Example
{ "error": { "code": "plan_requerido" }}Conflicto (p. ej. cliente_no_pendiente, external_id_repetido)
object
object
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.