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

Planes y facturación

Ciclo de vida de la suscripción — cambio de plan, cobros fallidos, baja, qué implica el corte y la política de reembolso.

Los planes de QAPI son mensuales, sin permanencia, y se cobran por adelantado desde el checkout del dashboard. Esta página describe cómo se cambia de plan y qué pasa con tu cuenta cuando un cobro falla, cuando das de baja el plan, y en qué casos procede un reembolso.

Para las cuotas de cada plan, ver Planes y cuotas.

QAPI nunca ve los datos de tu tarjeta

El pago ocurre en una página hospedada por la procesadora de pagos. QAPI no recibe ni almacena números de tarjeta: de nuestro lado solo quedan identificadores opacos de la suscripción.

Cambiar de plan

Subir y bajar de plan no siguen el mismo camino:

Cómo se haceCuándo aplica
Subir de planAutoservicio: lo elegís en Configuración → Plan y facturación → Cambiar plan y pagás con tarjetaApenas se confirma el cobro, sin interrumpir el servicio
Bajar de planEscribinos a soporte y lo coordinamosAl inicio del siguiente período, para que aproveches lo que ya pagaste

El monto exacto lo ves antes de confirmar

El checkout muestra el importe en Resumen del pedido antes de que confirmes nada. Los precios de lista están en Planes y cuotas; un plan que ahí figure como "Por confirmar" todavía no se puede contratar en línea (PLAN_NOT_PURCHASABLE) — escribinos y lo activamos.

Agentes de retención de IVA

Antes de pagar, en el paso ¿A quién facturamos?, te preguntamos si tu empresa es agente de retención de IVA. La respuesta cambia cómo contratás:

Basic y StarterBusiness
No sos agente de retenciónPago con tarjetaPago con tarjeta
Sos agente de retenciónNo disponibles: no admiten retencionesPor cotización: facturación manual y pago por transferencia

Si respondés que sí, en lugar del botón de pago aparece un formulario de cotización (contacto, volumen estimado de DTEs y un comentario). Te escribimos con el monto y los datos para la transferencia; mientras tanto podés seguir usando el sandbox. Intentar pagar con tarjeta devuelve WITHHOLDING_AGENT_QUOTE_ONLY.

¿No sabés si sos agente de retención?

Lo designa la SAT. Consultalo con tu contador antes de responder. Si te equivocaste, cambiá la respuesta la próxima vez que pases por el checkout.

Excedentes

Los excedentes te dejan seguir emitiendo después de agotar el saldo del mes. Cada DTE extra se cobra en tu próxima renovación, a la misma tarjeta y en la misma moneda de tu suscripción. El precio por DTE extra de cada plan está en la página de Precios; siempre es mayor que el precio por DTE del plan, así que si te pasás seguido, subir de plan te sale más barato (el panel te lo sugiere cuando conviene).

  • Los activás vos, en Configuración → Plan y facturación → Permitir excedentes. Vienen apagados y se pueden activar con un plan pagado (OVERAGE_REQUIRES_PAID_PLAN). Apagarlos se puede siempre.
  • Arrancan recién cuando usaste todo el saldo del plan. Mientras te queden DTEs sin usar —libres en la cuenta o en otros proyectos—, el proyecto que agotó su cuota se bloquea y te pide reasignar (MONTHLY_QUOTA_EXCEEDED).
  • Tienen un tope mensual: Basic hasta 500, Starter hasta 2,000 y Business hasta 3,000 DTEs en total por mes (saldo incluido). Al llegar al tope la emisión se pausa hasta el mes siguiente (OVERAGE_CAP_REACHED).
  • En Configuración → Plan y facturación ves en tiempo real los DTEs usados, los que te quedan, los excedentes del mes y el monto estimado.

Te avisamos antes

Te llega un correo al 80% y al 100% del saldo del mes, una sola vez por nivel. Si no tenés los excedentes activados, el del 100% te explica cómo hacerlo.

Cuando un cobro falla

Un cobro rechazado no corta el servicio en el acto. La suscripción queda en mora y el cobro se reintenta automáticamente:

MomentoQué pasa
Día 0El cobro falla. Te avisamos por correo y la suscripción queda en mora. Seguís emitiendo con normalidad.
Día 3Primer reintento automático.
Día 8Segundo y último reintento automático.
Si los dos fallanLa suscripción se da de baja y se aplica el corte.

Tenés unos 8 días para corregir el medio de pago

El correo de cobro rechazado no significa que se te haya cortado el servicio: mientras la suscripción está en mora, la emisión live sigue funcionando. Si actualizás la tarjeta antes del último reintento y el cobro entra, la mora se limpia sola y no perdés nada.

En Configuración → Plan y facturación podés ver el estado real de tu suscripción en cualquier momento: si un cobro viene fallando, si hay una baja programada y hasta qué fecha llega lo que ya pagaste.

Dar de baja el plan

Cuando la suscripción termina —porque la diste de baja vos, o porque los reintentos de cobro fallaron— el corte se programa para el final del período que ya pagaste, no para el momento de la baja.

CasoCuándo se corta
Baja voluntariaYa pagaste el mes en curso: se te respeta hasta que termine.
Baja por cobros fallidosEl período ya venció, así que el corte es inmediato.

Cancelar no te quita lo que ya pagaste

Dar de baja el plan no te descuenta el mes en curso: seguís emitiendo en live hasta la fecha en que ese período termina, y al final del mes no se te cobra nada más.

Cómo dar la baja

La baja es autoservicio: en Configuración → Plan y facturación está el botón "Cancelar suscripción". Antes de confirmar te decimos hasta qué fecha seguís cubierto, y esa misma fecha queda visible en la pantalla después.

Cancelar no devuelve el pago

Dar de baja el plan frena la renovación, no te devuelve lo que ya pagaste. Si además querés la devolución del cobro, es un pedido aparte y tiene sus condiciones — ver Solicitar un reembolso.

Reactivar antes del corte

Mientras el corte no se haya aplicado, la baja se puede deshacer: escribinos y el plan sigue como estaba, sin corte y sin volver a contratar. Una vez aplicado el corte ya no es deshacer sino volver a contratar, que sí es autoservicio (ver abajo).

Qué implica el corte

Cuando el corte se aplica, se pausa la emisión live: POST /v1/invoices en modo live responde 403 SUBSCRIPTION_INACTIVE. Eso es todo lo que cambia:

  • Tu cuenta sigue existiendo — usuarios, proyectos, API keys y configuración quedan intactos.
  • El sandbox sigue funcionando — podés seguir probando con POST /v1/sandbox/invoices o una API key qapi_test_..., que no requieren plan activo.
  • El historial se conserva — las facturas emitidas, sus PDFs y sus UUID SAT siguen consultables con GET /v1/invoices/:id.
  • Los DTEs ya certificados siguen siendo válidos ante la SAT — su autorización no depende de tu plan.
  • No podés emitir DTEs con validez fiscal hasta volver a contratar.

El corte no borra nada

Perdés la capacidad de emitir en live, no tus datos ni tus documentos.

Volver a emitir en live

El corte es reversible y se deshace solo: renová el plan desde el dashboard y, con el cobro confirmado, la emisión live se reactiva enseguida sobre la misma cuenta y los mismos emisores. No hay que volver a solicitar habilitaciones ni escribir a soporte.

Solicitar un reembolso

Un reembolso procede solo si se cumplen las tres condiciones:

Que el cobro se haya confirmado

Tiene que haber un pago acreditado. Un checkout que abriste y no completaste no genera ningún cobro, así que no hay nada que devolver.

Pedirlo el mismo día del cobro

El plazo vence al final del día del cobro en hora de Guatemala. Si pagaste a las 20:00, tenés hasta el final de ese mismo día.

No haber emitido ninguna factura

La cuenta no puede haber emitido ningún DTE real desde ese cobro.

Si falta cualquiera de las tres, no hay reembolso: el plan se considera consumido.

Por qué la última condición

Sin ella, alguien podría contratar el plan Business, emitir sus 2,000 DTEs y pedir la plata de vuelta. El reembolso está pensado para el arrepentimiento inmediato, no para usar el servicio gratis.

Qué cuenta como "ya emitiste"

Cuenta cualquier DTE real: el mismo criterio con el que se consume la cuota del plan.

  • Sí cuentan los DTEs live, incluidos los que todavía están en proceso (PENDING, PROCESSING, SIGNING, CERTIFYING).
  • No cuentan las pruebas de sandbox (certificador MOCK) ni los DTEs que terminaron en FAILED — ahí no se emitió nada.

Por qué una factura en proceso ya cuenta

Mientras un DTE se está certificando todavía no se sabe si va a quedar emitido, y la respuesta puede llegar segundos después de que pidas el reembolso. Si no contara, un documento que certifica justo en ese momento te dejaría con la factura y con la plata devuelta.

Cómo pedirlo

El reembolso no es automático

En Configuración → Plan y facturación aparece el botón "Solicitar reembolso", pero solo si calificás: si ya emitiste una factura o pasó el día, no se muestra. El botón nos escribe a soporte — no ejecuta la devolución. Cada solicitud la resuelve una persona, en un máximo de 3 días hábiles.

Los reembolsos son totales: no se hacen parciales ni prorrateos. Una vez aprobado, el dinero puede tardar varios días hábiles adicionales en verse acreditado en tu estado de cuenta — ese plazo depende de tu banco, no de QAPI.

Qué pasa con tu cuenta cuando el reembolso se aplica

El reembolso devuelve la cuenta al estado de prueba, y a diferencia de la baja el corte es inmediato: no se respeta el resto del mes, porque ese mes dejó de estar pagado.

Qué pasa
Emisión liveSe pausa en el momento — POST /v1/invoices en live responde 403 SUBSCRIPTION_INACTIVE
Tu planVuelve a Basic, el plan de entrada, sin pago confirmado
SandboxSigue funcionando igual: no depende de ningún plan pagado
Tus datosIntactos — cuenta, usuarios, proyectos, API keys, historial y PDFs
Los DTEs ya certificadosSiguen siendo válidos ante la SAT: su autorización no depende de tu plan

Es el mismo corte que se describe en Qué implica el corte, con una sola diferencia: la fecha. Volver a emitir en live es volver a contratar, y es autoservicio.

Por eso el reembolso exige no haber emitido

Si la cuenta ya emitió facturas reales, devolver la plata dejaría documentos con validez fiscal emitidos sobre un plan que nadie pagó. Las tres condiciones de arriba son lo que mantiene esa cuenta imposible.

Cancelar y reembolsar son cosas distintas

Cancelar el plan es autoservicio (botón en Configuración) y no devuelve el pago: frena la renovación y te deja usar el mes que ya pagaste. El reembolso se pide a soporte, devuelve la plata y con ella el mes: el servicio live se corta enseguida.

Cancelar no te saca del plazo del reembolso: si pagaste hoy, cancelaste y no emitiste ninguna factura, seguís cumpliendo las tres condiciones y el botón sigue disponible hasta el final del día. Son dos pedidos separados y hay que hacer los dos.

Si ya emitiste facturas

La opción de reembolso desaparece y lo que te queda es cancelar el plan, desde Configuración → Plan y facturación. No perdés nada de lo que ya pagaste: conservás tus facturas del mes, seguís emitiendo hasta que el período termine, y al final del mes no se te cobra de nuevo.

En esta página