Ir al contenido
POST
/api/v1/ext/certificacion/avanzar
curl --request POST \
--url https://app.openfactura.co/api/v1/ext/certificacion/avanzar \
--header 'Authorization: Bearer <token>'

Hasta 5 pruebas por llamada, en el ambiente de pruebas. Llama de nuevo mientras estado sea en_curso. Permisos dte:emit y dte:invalidate.

Avance de la certificación.

Media typeapplication/json
object
ambiente
required
string
Allowed values: 00 01
disponible
required

La certificación sólo corre en el ambiente de pruebas.

boolean
requisitos
required
object
emisor
boolean
credenciales
boolean
simuladas

Credenciales del simulador: es un simulacro, nada llega a Hacienda.

boolean
responsable
boolean
estado
required
string
Allowed values: sin_iniciar en_curso detenida completa
alcance
required
string
Allowed values: minimo completo
iniciada
required

Milisegundos desde 1970; nulo si no se ha iniciado.

integer | null
receptorCcf
required

Receptor de los CCF de prueba; nulo = el propio emisor (sólo en un simulacro).

object
nombre
string
nit
string
nrc
string
esOpenFactura
boolean
metas
required
Array<object>
object
id
required
string
Allowed values: facturas ccf invalidaciones contingencias remisiones notasCredito notasDebito retenciones liquidaciones contables exportaciones sujetosExcluidos donaciones retornos operacionesEspeciales
nombre
required
string
meta
required
integer
hechas
required
integer
ultimoError
required

El rechazo del MH (u otro error) que detuvo la certificación.

object
operacion
required
string
Allowed values: facturas ccf invalidaciones contingencias remisiones notasCredito notasDebito retenciones liquidaciones contables exportaciones sujetosExcluidos donaciones retornos operacionesEspeciales
codigo
required
string
mensaje
required
string
observaciones
Array<string>
operaciones
required

Lo hecho en esta tanda.

Array<object>
object
operacion
required
string
Allowed values: facturas ccf invalidaciones contingencias remisiones notasCredito notasDebito retenciones liquidaciones contables exportaciones sujetosExcluidos donaciones retornos operacionesEspeciales
numeroControl
required
string | null
codigoGeneracion
required
string | null
selloRecibido
required
string | null
aviso
required

Si el MH no respondió y se cortó la tanda: por qué. Volver a llamar la reanuda.

string | null

Example

{
"ambiente": "00",
"estado": "sin_iniciar",
"alcance": "minimo",
"metas": [
{
"id": "facturas"
}
],
"ultimoError": {
"operacion": "facturas"
},
"operaciones": [
{
"operacion": "facturas"
}
]
}

Falta la clave o la sesión

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

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.