Registro e Inicio

Configura tu cuenta y empieza a emitir comprobantes fiscales electrónicos en minutos.

Crea tu cuenta, sube tu certificado y empieza el proceso para emitir e-CF.

1. Crear cuenta

Registra tu empresa proporcionando:

RNC: Registro Nacional del Contribuyente (9 u 11 dígitos)
Razón social: Nombre legal de la empresa
Email: Correo electrónico del administrador
Password: Mínimo 8 caracteres

Puedes crear tu cuenta desde el formulario de registro. Te enviaremos un email para verificar tu dirección.

cURL

curl -X POST https://ecf.frandeone.com/api/register \
  -H "Content-Type: application/json" \
  -d '{
    "rnc": "131880657",
    "business_name": "Mi Empresa SRL",
    "email": "[email protected]",
    "password": "MiPassword123"
  }'

La respuesta incluye tu API Key y API Secret:

Response

{
  "success": true,
  "data": {
    "id": 1,
    "rnc": "131880657",
    "business_name": "Mi Empresa SRL",
    "api_key": "ecf_sk_a1b2c3d4e5f6...",
    "api_secret": "ecf_ss_x9y8z7w6v5u4..."
  }
}

⚠

Guarda tu API Secret. Solo se muestra una vez al registrarte. Si lo pierdes, deberás generar uno nuevo desde el dashboard.

2. Obtener API Keys

Necesitas dos credenciales para usar la API:

Credencial	Header	Descripción
`API Key`	`X-API-KEY`	Identifica tu cuenta. Se envía en todas las peticiones.
`API Secret`	`Authorization`	Se usa junto con email/password para autenticarte y obtener tokens JWT.

Puedes ver tu API Key en cualquier momento desde Configuración > Credenciales API.

3. 2. Subir certificado digital (.p12)

Para firmar documentos electrónicos, necesitas un certificado digital .p12 emitido por una entidad certificadora autorizada por la DGII.

Obtén tu certificado

Contacta una entidad certificadora autorizada (ej: CertiSign, DigiCert) y solicita un certificado de firma digital para emisor de e-CF.

Súbelo desde el Dashboard

Ve a Certificados, selecciona tu archivo .p12 e ingresa la contraseña.

O súbelo via API

Usa el endpoint POST /api/certificates con multipart/form-data.

cURL

curl -X POST https://ecf.frandeone.com/api/certificates \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-API-KEY: ecf_sk_..." \
  -F "file=@mi_certificado.p12" \
  -F "passphrase=MiPasswordCert"

🔒

Tu certificado se almacena con cifrado de grado bancario. La contraseña nunca se guarda en texto plano. Solo se descifra en memoria al momento de firmar.

4. Ambientes disponibles

Frande ECF opera en tres ambientes. El ambiente se especifica en la URL:

Ambiente	URL base	Uso
`TesteCF`	`/TesteCF/`	Desarrollo y pruebas. No se reporta a la DGII. Ideal para integrar tu sistema.
`CerteCF`	`/CerteCF/`	Certificación ante la DGII. Usa este ambiente para el proceso formal de certificación.
`eCF`	`/eCF/`	Producción. Documentos reales reportados a la DGII.

💡

Recomendamos empezar con TesteCF para integrar tu sistema. Luego pasar a CerteCF para el proceso de certificación, y finalmente a eCF para producción.

Siguiente paso

Ya tienes cuenta, API keys y certificado. Ahora aprende a autenticarte en la API para empezar a emitir documentos.

3. Lo que sigue: certificación DGII

Antes de emitir e-CF reales, tu empresa debe pasar el proceso de certificación ante la DGII. Nosotros te guiamos:

El wizard de certificación te lleva paso a paso por los 14 requisitos.
Emites un set de prueba en TesteCF, luego un set formal en CerteCF.
Firmas la declaración jurada y, al aprobar la DGII, pasas a producción (eCF) automáticamente.

Accede al Wizard de Certificación desde tu dashboard, o lee el detalle del proceso.