Cómo empezar
ZarelaFact es una API para emitir comprobantes fiscales electrónicos (e-CF) ante la DGII. Tu sistema envía cada venta en JSON; ZarelaFact la convierte a XML, la firma con tu certificado, la envía a la DGII y guarda los documentos durante 10 años.
Esta guía va en orden. Sigue los pasos y usa el enlace Siguiente al final de cada página.
Qué necesitas
- Un certificado digital
.p12de la empresa que va a emitir. Es obligatorio incluso para probar. - Un sistema capaz de hacer llamadas HTTP con JSON. Sirve cualquier lenguaje.
- Para producción, los rangos de eNCF que la DGII autorizó a tu empresa. Tu sistema asigna cada número.
Los pasos
Crea tu cuenta →
Como empresa que emite sus facturas o como ERP/POS con varios clientes.
Paso 2Sube tu certificado →
Lo usamos para firmar cada comprobante. Sin él no se firma nada, ni en pruebas.
Paso 3Crea tu API key →
Una por ambiente: TesteCF (pruebas), CerteCF (certificación) y eCF (producción).
Paso 4Integra tu software →
Arma el JSON de cada tipo de e-CF, envíalo y consulta su estado.
Paso 5Certifícate ante la DGII →
Un asistente envía tus pruebas y te guía en los pasos que haces en la DGII.
Lee primero Varios clientes (Partners). Con una sola clave de API das de alta a cada cliente, lo certificas y emites por él sin que salga de tu producto.
Respuestas rápidas
| Pregunta | Respuesta corta |
|---|---|
| ¿Cuánto cuesta? | 50 e-CF al mes gratis en producción y planes por volumen. Ver Planes y pagos. |
| ¿Cómo contrato un plan? | Lo pagas con tarjeta desde Empresa → Planes en el portal; las pruebas y la certificación son gratis. |
| ¿Hay un certificado de prueba? | No. Usa el .p12 real de la empresa, también en pruebas. |
| ¿Tengo que generar el XML o firmarlo? | No. Envías JSON; ZarelaFact lo convierte, lo firma y lo envía. |
| ¿Tienen webhooks? | Sí, opcionales. La consulta por lote siempre funciona. Ver Webhooks. |
| ¿Qué datos de proveedor pongo en la DGII? | Software ZarelaFact, proveedor ZARELA GROUP SRL, RNC 133-81616-4. Ver Certifícate ante la DGII. |
Más respuestas en Preguntas frecuentes. ¿Dudas? Escríbenos a [email protected].