QAPI está en beta — la API puede cambiar sin previo aviso. Usá sandbox para pruebas.
QAPIQAPIDocs · by DTEVIA
Errores

EMISOR_NOT_PROVISIONED (409)

El NIT emisor aún no está habilitado para emitir en live. Solicitá la habilitación desde el dashboard.

HTTP 409 Conflict

Intentaste emitir un DTE en modo live con un emisor (el NIT de tu cuenta o el de un proyecto) que todavía no está habilitado para emitir en live.

Habilitar un emisor requiere un alta que QAPI gestiona por vos: vos no tratás con nadie más. El tiempo que toma es variable: te avisamos apenas se completa. Mientras el alta no esté lista, la emisión live de ese NIT se rechaza con este error; el sandbox no se ve afectado.

¿Tu emisor ya estaba habilitado y emitía bien? Entonces lo que falta no es el alta sino el plan: ese caso devuelve SUBSCRIPTION_INACTIVE (403), y se resuelve renovando la suscripción.

Ejemplo

{
  "type": "https://docs.dtevia.com.gt/errors/emisor-not-provisioned",
  "title": "EMISOR_NOT_PROVISIONED",
  "status": 409,
  "detail": "El emisor NIT 12345678 de el proyecto 'Mi Tienda' aún no está habilitado para emitir en live. Solicitá la habilitación desde el dashboard: nosotros gestionamos el alta y te avisamos al completarse.",
  "context": { "scope": "project", "project_id": "…", "nit_emisor": "12345678" }
}

Con una API key, scope es siempre "project": falta habilitar el NIT del proyecto de tu key —incluido el proyecto del emisor de tu cuenta, que también es un proyecto—, y project_id dice cuál.

Cómo resolverlo

  1. Solicitá la habilitación desde el dashboard: en la configuración del proyecto (o en Configuración → Empresa para el NIT de tu cuenta) usá "Solicitar habilitación".
  2. Completá los requisitos del contribuyente que se te indican (RTU, acreditar ante la SAT —desde la Agencia Virtual— al certificador que te indiquemos, firma electrónica y datos de contacto). Sin ellos el alta no puede procesarse.
  3. Esperá la confirmación: cuando el emisor quede habilitado, el estado del proyecto cambia en el dashboard y la emisión live de ese NIT empieza a funcionar. Te notificaremos al completarse.
  4. Mientras tanto podés seguir probando en sandbox (POST /v1/sandbox/invoices o una API key test), que no requiere habilitación.

Si ya solicitaste la habilitación y este error persiste más de lo esperado, contacta soporte indicando el NIT emisor.

En esta página