Matriz de capacidades
Qué emite exactamente Contadeo™, cómo viaja un comprobante hasta la autorización del SRI, qué separa a los ambientes de Pruebas y Producción y qué límites aplica cada plan. Todo lo de esta página es conducta real de la plataforma: las mismas reglas que aplican la API, el panel y el servidor MCP.
Tipos de comprobante
Los seis tipos de comprobante electrónico del SRI, con la versión de esquema XML con la que se emiten hoy:
| codDoc | Comprobante | Versión XML | Disponible desde |
|---|---|---|---|
| 01 | Factura | 2.1.0 | free |
| 03 | Liquidación de compra | 1.1.0 | pyme |
| 04 | Nota de crédito | 1.1.0 | free |
| 05 | Nota de débito | 1.0.0 | emprendedor |
| 06 | Guía de remisión | 1.1.0 | pyme |
| 07 | Comprobante de retención | 2.0.0 | pyme |
Cada comprobante se firma con XAdES-BES usando el certificado .p12 del
emisor (cifrado en reposo; solo se descifra en memoria al firmar) y se autoriza
en línea contra los web services del SRI. Del comprobante autorizado
descargas el RIDE (PDF) y el XML con URLs temporales que expiran en 1
hora.
Ciclo de vida de un comprobante
La emisión es asíncrona: el POST valida, reserva el secuencial y responde
202 con el comprobante en BORRADOR. Desde ahí:
BORRADOR → FIRMADO → ENVIADO → AUTORIZADO ✓
↘ DEVUELTA (recepción rechazó) RECHAZADO ✗ (autorización)
(SRI caído) ↘ CONTINGENCIA → reenvío automático → ENVIADO → ...
- El SRI suele resolver en 5 a 30 segundos. Puedes hacer polling de
GET /comprobantes/:ido suscribirte por webhooks al estado final. DEVUELTAyRECHAZADOincluyenmensajesSri: los mensajes literales del SRI (por ejemplo[45] ERROR SECUENCIAL REGISTRADO), para que el error se entienda sin abrir un ticket.- Si el SRI está caído, el comprobante pasa a CONTINGENCIA y se reenvía automáticamente durante ~24 horas, sin intervención tuya.
ANULADOes un estado interno que solo aplica sobre unAUTORIZADO, con las reglas de la Resolución NAC-DGERCGC25-00000017: hasta el día 7 del mes siguiente y nunca sobre comprobantes a consumidor final. El trámite formal de anulación se hace en SRI en línea.
Ambientes: Pruebas y Producción
Cada cuenta trabaja contra el ambiente que elija, con los dos ambientes reales del SRI:
Pruebas (ambienteActivo: 1) |
Producción (ambienteActivo: 2) |
|
|---|---|---|
| Validez | Certificación y desarrollo, sin validez tributaria | Documentos tributarios reales |
| Cupo del plan | No lo consume (tope propio de 500/mes) | Lo consume |
| Para qué | Integrar y certificar cada tipo de comprobante | Operar |
- El ambiente de Pruebas es el del propio SRI: lo que certificas ahí es exactamente lo que emitirás en Producción.
- Las lecturas nunca mezclan ambientes: los listados devuelven solo los comprobantes del ambiente activo.
- El cambio a Producción es un
PATCH(o un clic en el panel) cuando tu RUC ya certificó sus tipos de comprobante en Pruebas.
Límites por plan
| free | emprendedor | pyme | empresa | |
|---|---|---|---|---|
| Precio al año (sin IVA) | $0 | $39 | $89 | $179 |
| Comprobantes al mes (solo Producción) | 10 | 150 | 500 | 2.000 |
| Tipos incluidos | 01, 04 | 01, 04, 05 | los 6 | los 6 |
| Usuarios | 1 | 1 | ilimitados | ilimitados |
| Empresas en la cartera | 10 | ilimitadas | ilimitadas | ilimitadas |
| Clasificación del crédito de IVA | no | no | incluida | incluida |
- El IVA (15%) se agrega al pagar; el monto lo calcula siempre el servidor.
- El plan free es permanente y sin tarjeta; al llegar a sus 10 comprobantes
del mes responde
402hasta el mes siguiente. - En los planes de pago la emisión no se corta al llegar al cupo.
- Cupo compartido: una cuenta de pago puede patrocinar a las empresas de su cartera y repartir su cupo entre ellas, sin que cada una contrate un plan.
- ¿Más de 2.000 comprobantes al mes? Usa el cotizador de precios: responde sin registrarte.
API, webhooks y automatización
| Capacidad | Detalle |
|---|---|
| API keys | Prefijo cdo_, hasta 5 activas por cuenta, roles limitados (emisor, contador, lector, webhooks), nunca owner/admin, revocación instantánea |
| Idempotencia | Header Idempotency-Key en toda la emisión: reintentar no duplica ni quema secuenciales; sin caducidad, y la misma clave con cuerpo distinto responde 422 |
| Lote | Hasta 100 facturas por request con semántica parcial: una inválida no frena al resto; 402/403 sí detienen y lo pendiente queda NO_INTENTADA. 10 lotes por minuto |
| Validación de RUC | GET /sri/ruc/:ruc contra el catastro del SRI, siempre 200 con veredicto: estado, régimen, obligado a contabilidad y si tu contraparte es agente de retención; si el SRI se cae, responde con la última copia |
| Buzón de compras | Reenvía el correo de tu proveedor a tu dirección token@buzon.contadeo.com: el XML entra solo a Compras (el emisor se reconoce por el RUC receptor; la clave de acceso deduplica) y los PDF quedan a revisión en la bandeja |
| Límites de uso | 300 requests/min por cuenta; 60 emisiones individuales/min |
| Webhooks | Hasta 5 endpoints HTTPS; eventos comprobante.autorizado, comprobante.rechazado, comprobante.devuelto y f104.listo (cifras del F104 congeladas al marcar listo); firma HMAC-SHA256 (X-Contadeo-Signature); 8 reintentos con backoff |
| Exportación | Comprobantes y clientes a CSV (hasta 10.000 filas por corte) |
| Especificación | OpenAPI 3.1 con los payloads de emisión tipados, referencia interactiva y SDK oficial contadeo-sdk |
Facturar con IA (MCP)
El servidor MCP de Contadeo expone 37 tools que preparan, emiten y
autorizan comprobantes reales ante el SRI desde un asistente de IA, además del
asesor tributario (calendario, semáforo RIMPE, borrador del F104, libros).
Conector remoto https://contadeo.com/api/mcp con OAuth 2.1, o modo local con
npx -y contadeo-mcp y una API key. La matemática tributaria la hace siempre el
servidor, y el asistente confirma contigo antes de emitir.
Actualizada el 28 de agosto de 2026. Los cupos y precios son los del catálogo comercial vigente: la fuente vinculante es la página de precios y lo que aplica el servidor al emitir.