Preguntas frecuentes

Lo que más nos preguntan los equipos que se integran con nosotros.

¿Cómo consigo acceso para probar la API?
No hay registro público — es un modelo de onboarding asistido. Ver Cómo obtener tu API Key. Si tu empresa todavía no está certificada ante DGII, ese es un paso previo (ver la guía de certificación).
¿Necesito saber construir y firmar XML yo mismo?
No. Le mandas JSON a POST /emitir y nosotros construimos el XML según el XSD oficial de DGII, lo firmamos con tu certificado, y lo enviamos. Tu integración nunca toca XML directamente, salvo que quieras usar la herramienta independiente de Firmar XML del panel para otro propósito.
¿Qué pasa si DGII rechaza un documento?
POST /emitir responde 422 con el motivo real de DGII dentro de respuestaDGII — no perdemos ese detalle. Además, la respuesta completa de DGII queda guardada y se puede volver a consultar después desde el panel admin, sin tener que re-emitir nada.
¿Puedo controlar el número de eNCF que se le asigna a mi factura?
Sí, opcionalmente — envía tu propio encf en el cuerpo del request. Si lo omites, se asigna automáticamente de tu secuencia autorizada. No puedes mezclar: si envías uno, tiene que corresponder exactamente al tipo (tipoeCF) que estás emitiendo.
¿Cuál es la diferencia entre e-CF y RFCE?
Un e-CF completo va con todos los datos del documento. Un RFCE es un resumen — solo aplica al tipo 32 (Consumo) cuando el monto es menor a RD$250,000, y así lo decide DGII, no nosotros ni tú. Nuestra API lo maneja automáticamente según el monto que envíes.
¿Qué pasa si mi certificado está por vencer?
Leemos la fecha real de vencimiento de tu certificado .p12 al momento de cargarlo, y el panel de administración te avisa cuando se acerca (configurable, por defecto 30 días antes). También se puede mandar una alerta por WhatsApp automática.
¿Puedo recibir facturas de mis proveedores, no solo emitir las mías?
Sí — es la recepción B2B. DGII exige exponer 4 endpoints propios bajo un subdominio único de tu empresa (no bajo tu API Key, porque quien te llama es el sistema de otro contribuyente). Ver Recepción B2B — el subdominio y su certificado SSL se generan automáticamente al activarte.
¿Cuánto tarda DGII en aceptar o rechazar un envío?
La mayoría de las veces, la respuesta de /emitir ya viene con el estado final. Si DGII devuelve "en proceso", nuestra API reintenta automáticamente hasta 3 veces antes de responderte — si sigue en proceso después de eso, guarda el trackId y consulta GET /resultado/{trackId} más tarde.
¿Hay límite de cuántos documentos puedo emitir?
Hoy no hay un tope técnico por empresa — el único límite real es tu secuencia autorizada por DGII para cada tipo de e-CF (consultable en GET /secuencias). Un modelo de planes/cuotas propio de CLIFACTUR está en nuestra hoja de ruta.
¿Cómo sé si un error es de mi integración o de DGII?
Consulta GET /servicios primero — es un health check en vivo de los servicios de DGII (autenticación, recepción, consulta). Si DGII mismo está caído, vas a verlo ahí antes de perder tiempo revisando tu propio código.