Respuestas a las dudas tecnicas mas comunes sobre Frande ECF.
Respuestas a las dudas mas comunes de clientes emisores.
Frande ECF es una API REST que gestiona el ciclo completo de comprobantes fiscales electronicos (e-CF) para Republica Dominicana. Maneja la firma digital, envio a la DGII, recepcion de acuse, y almacenamiento seguro de documentos.
Es la plataforma que te permite emitir facturas electrónicas (e-CF) cumpliendo con la DGII. Nosotros manejamos la firma digital, el envío a la DGII y el almacenamiento seguro. Tú solo usas tu dashboard o tu ERP integrado.
No. Frande ECF es un servicio SaaS (Software as a Service). Tu sistema se comunica con nuestra API via HTTPS. No necesitas instalar librerias de firma digital, manejar XML, ni comunicarte directamente con la DGII.
Cualquier lenguaje que pueda hacer peticiones HTTP: JavaScript, PHP, C#, Java, Python, Ruby, Go, etc. La API acepta y devuelve JSON estándar.
No. Usas Frande ECF desde el navegador. entras al dashboard con tu correo y contraseña. Si tu ERP ya está integrado con nosotros, emites desde tu propio sistema sin cambios.
No. Tu única responsabilidad es subir tu certificado digital .p12 al dashboard (lo configuras una vez) y completar los pasos del wizard de certificación. Todo lo demás lo hace Frande ECF automáticamente.
La API Key (X-API-KEY) identifica tu cuenta y se envía en todas las peticiones. El API Secret se usa junto con tu email y contraseña para autenticarte y obtener tokens de acceso. La API Key es pública (identifica), el Secret es privado (autentica).
El accessToken dura 1 hora por defecto. El refreshToken dura 7 dias. Cuando el access token expire, usa el refresh token para obtener nuevos tokens sin re-autenticarte.
Contacta a soporte para generar un nuevo API Secret. El anterior se invalidara automaticamente.
Desde tu dashboard entras a Documentos → Nuevo, eliges el tipo (E31 crédito fiscal, E32 consumo, etc.), completas los datos del cliente y los ítems, y confirmas. El documento se firma y se envía a la DGII automáticamente. Si tu ERP está integrado, emites desde ahí y el dashboard muestra el estado.
En tu dashboard cada documento muestra un estado: en cola, procesando, aceptado, rechazado. Si es rechazado, te explicamos el motivo. El proceso toma segundos en la mayoría de los casos.
No directamente, pero puedes almacenar los documentos localmente y enviarlos cuando recuperes conexion. La API acepta el campo IndicadorEnvioDiferido=1 para documentos emitidos hasta 24 horas antes del envio.
Recibiras el motivo de rechazo en la respuesta o via webhook. Debes corregir el error y reenviar el documento con un nuevo eNCF. El eNCF rechazado no puede reutilizarse.
El dashboard te muestra el motivo del rechazo. Corriges los datos y emites un nuevo documento (la secuencia rechazada no se reutiliza, la DGII exige una nueva).
No directamente. Para anular un e-CF debes emitir una Nota de Credito (E34) que referencia el documento original. Para E32 (consumo) se puede usar IndicadorNotaCredito=0 que indica anulacion total.
Un e-CF aceptado no se borra. Para dejarlo sin efecto emites una Nota de Crédito (E34) desde el dashboard, referenciando el documento original.
El RFCE (Resumen de Factura de Consumo Electronico) es un documento consolidado que agrupa facturas E32 con monto menor a RD$250,000. Se genera automaticamente por la API. no necesitas hacer nada adicional.
El límite por defecto es de 60 peticiones por minuto por cuenta. Si necesitas más, contacta a soporte para ajustar el límite.
Debes solicitarlo a una entidad certificadora autorizada por la DGII. Las principales son CertiSign RD y otras entidades acreditadas. El proceso incluye validacion de identidad presencial.
Sí. Tu archivo .p12 se protege con cifrado de grado bancario antes de almacenarse. La contraseña nunca se guarda en texto plano. El certificado solo se descifra en memoria al momento de firmar un documento.
Recibirás notificaciones por email 30, 15 y 7 dias antes del vencimiento. Debes renovar tu certificado con la entidad certificadora y subirlo nuevamente. Mientras esté expirado, no podrás firmar documentos.
Si. Tu API Key funciona en TesteCF, CerteCF y eCF. El ambiente se especifica en la URL, no en las credenciales.
No. El ambiente TesteCF es completamente aislado. Los documentos se validan localmente pero no se envian a la DGII. Ideal para desarrollo y pruebas.
No. TesteCF es un ambiente de pruebas aislado. Lo que emites ahí no se reporta a la DGII. lo usas para familiarizarte con el flujo sin consecuencias fiscales.
El proceso tecnico (emitir set de pruebas) puede completarse en 1-2 dias si tu integracion esta lista. La revision y aprobacion por parte de la DGII toma entre 5 y 15 dias habiles.
Si tus datos están listos, el proceso técnico toma 1-2 días. La revisión y aprobación final por parte de la DGII toma entre 5 y 15 días hábiles.
Actualmente se envian notificaciones cuando un documento cambia de estado (RECIBIDO → ACEPTADO, RECIBIDO → RECHAZADO). El payload incluye el eNCF, nuevo estado, y detalles del documento.
Las notificaciones se reintentan hasta 3 veces con intervalos crecientes (1 min, 5 min, 15 min). Si todas las entregas fallan, puedes consultar los estados manualmente vía la API.
Escríbenos a [email protected] o llama al 809-765-3566 en horario laboral.