Registro e inicio
Para comenzar a emitir e-CF con Zarela PSFE, sigue estos pasos. El objetivo es dejar lista una cuenta con API keys por ambiente y un certificado digital valido para firmar.
1. Creacion de cuenta
El primer paso es crear tu cuenta en el portal de Zarela:
- Visita el portal de registro de Zarela y completa el formulario con los datos del contribuyente (RNC, razon social, contacto).
- Confirma tu direccion de correo electronico.
A diferencia de otros proveedores, en Zarela el acceso al portal (email y contrasena) y las credenciales de API estan separadas. La API no usa login con usuario/contrasena ni tokens Bearer: la integracion server-to-server se autentica siempre con una API key por ambiente (X-API-KEY).
2. Acceder al portal
Una vez confirmada tu cuenta:
- Inicia sesion en el portal de Zarela.
- Explora el panel para familiarizarte con: documentos emitidos, secuencias, anulaciones, certificacion y consumo de API.
3. Crear una API Key por ambiente
Para integrar programaticamente necesitas una API key. Zarela expone tres ambientes y cada uno requiere su propia key:
| Ambiente | Proposito |
|---|---|
TesteCF | Pruebas tecnicas internas y desarrollo. |
CerteCF | Proceso de certificacion ante la DGII. |
eCF | Produccion (facturacion fiscal oficial). |
Pasos:
- En el portal, ve a la seccion API Keys.
- Crea una nueva key, selecciona el ambiente e ingresa una descripcion (por ejemplo
eCF - ERP produccion). - La API key se muestra resumida. Usa Copiar para obtener el valor completo cuando lo necesites; esta operación es segura y queda auditada.
- Asigna los scopes necesarios segun lo que hara la integracion.
Scopes disponibles
| Scope | Permite |
|---|---|
ecf:validate | Pre-flight (validate=true) sin consumo fiscal. |
ecf:create | Crear y emitir documentos e-CF. |
ecf:read | Scope reservado para superficies de consulta/artifacts habilitadas por cuenta; no es necesario para status/batch. |
status:read | Consultar estado por lote (status/batch). |
tenant:admin | Secuencias, anulaciones, certificacion y aprobacion comercial. |
Nunca reutilices una API key de CerteCF en eCF. Usa una key por sistema o integracion y rotala periodicamente.
4. Cargar certificado digital
Es indispensable cargar el certificado digital (archivo .p12) que Zarela usara para firmar electronicamente tus documentos XML:
- En el portal, ve a la seccion Certificados y sube tu archivo
.p12junto con su contrasena. - Zarela mostrara el RNC asociado y la fecha de expiracion del certificado.
- El certificado se almacena cifrado (vault de certificados); la contrasena nunca queda expuesta al navegador.
Si aun no cuentas con un certificado digital, puedes obtenerlo a traves de la Camara de Comercio de Santo Domingo.
Requisitos previos para certificarte
Para obtener el certificado y completar la certificacion, tu empresa debe cumplir los requisitos de la DGII. Consulta el documento oficial Proceso de Certificacion para ser Emisor Electronico.
Siguiente paso
Con la cuenta, las API keys y el certificado listos, continua con la integracion tecnica.