EMISOR_NOT_PROVISIONED

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 ante el certificador.

Habilitar un emisor requiere darlo de alta ante el certificador autorizado (un trámite que QAPI gestiona por ti — típicamente tarda menos de una hora una vez completados los requisitos del contribuyente). Mientras el alta no esté completa, la emisión live de ese NIT se rechaza con este error; el sandbox no se ve afectado.

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 ante el certificador. Solicitá la habilitación desde el dashboard; te avisaremos al completarse.",
  "invalid_params": [
    { "scope": "project", "project_id": "…", "nit_emisor": "12345678" }
  ]
}

scope indica qué emisor falta habilitar: "project" (el NIT del proyecto) o "account" (el NIT de tu cuenta, con el que emite el módulo de factura sin proyecto).

Cómo resolverlo

1. Solicita la habilitación desde el dashboard: en la configuración del proyecto (o en Configuración → Empresa para el NIT de tu cuenta) usa "Solicitar habilitación".
2. Completa los requisitos del contribuyente que se te indican (RTU, acreditar al certificador ante la SAT desde la Agencia Virtual, firma electrónica y datos de contacto). Sin ellos el alta no puede procesarse.
3. Espera 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 puedes 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.