Preguntas frecuentes (FAQ)
Generales
¿Que es la facturacion electronica?
Es un sistema que permite emitir, recibir y almacenar comprobantes fiscales en formato digital, reemplazando el papel. En Republica Dominicana esta regulado por la DGII.
¿Es obligatorio usar facturacion electronica?
La DGII implementa la obligatoriedad de forma gradual para todos los contribuyentes. Es recomendable iniciar la adaptacion lo antes posible.
¿Que es Zarela PSFE?
Es una Plataforma de Servicios de Facturacion Electronica que abstrae la complejidad tecnica y regulatoria del e-CF: firma, secuencias, envio resiliente, retencion legal y endpoints publicos obligatorios.
Tecnicas
¿Que necesito para integrarme con Zarela?
Un sistema capaz de generar JSON con estructura DGII/XSD y hacer solicitudes HTTP a la API REST de Zarela. Puedes usar cualquier lenguaje. Ver Vista general de integracion.
¿Como me autentico? ¿Necesito login o token?
No. La integracion server-to-server usa una API key por ambiente en el header X-API-KEY. No hay login con usuario/contrasena ni intercambio de tokens Bearer. Ver Autenticacion.
¿Puedo validar un documento sin emitirlo?
Si. Envia el documento con validate=true: Zarela valida estructura, totales y XSD sin consumir secuencia ni enviar a la DGII. Ver Envio de documentos.
¿Tengo que decidir entre enviar el documento extendido o el resumen (RFCE)?
No. Para facturas de consumo (E32), Zarela decide automaticamente segun el MontoTotal (umbral RD$250,000). Tu siempre envias el documento completo.
¿Debo esperar la respuesta de la DGII antes de completar la venta?
La API responde 202 despues de registrar y encolar la emision; esa respuesta no equivale a aceptacion de la DGII. Tu ERP debe guardar documentId/encf, continuar segun la politica fiscal y de contingencia de tu empresa, y consultar el estado final por lote. La emision debe enviarse a Zarela en el momento en que se genera, no acumularse para enviarla al final del dia.
¿Como consulto el estado de muchos documentos a la vez?
Con la consulta por lote POST /{env}/documentos-ecf/status/batch (hasta 100, recomendado 50). Ver Consulta de documentos.
¿Que pasa si mi sistema ya genera facturas en otro formato?
Solo implementas la transformacion de tu formato al JSON DGII/XSD (o al contrato simplificado). Zarela se encarga del resto.
Certificacion y cumplimiento
¿Como obtengo un certificado digital?
A traves de una autoridad certificadora autorizada, como la Camara de Comercio de Santo Domingo.
¿Como certifico mi RNC ante la DGII?
Con el runner de certificacion de Zarela: ejecutas las pruebas de simulacion, descargas el evidence pack y completas los pasos del portal DGII. Ver la guia de certificacion.
¿Que URLs configuro en el portal DGII?
Las URLs de recepcion y aprobacion comercial de Zarela para el ambiente correspondiente (CerteCF para certificar, eCF para produccion). La URL de autenticacion se deja en blanco. Ver el Paso 3 de la certificacion.
¿Zarela cumple con los requisitos de la DGII?
Zarela implementa los principales contratos tecnicos del e-CF: firma XMLDSig (RSA-SHA256), validacion XSD, acuses, anulaciones, aprobacion comercial y endpoints publicos. La habilitacion fiscal de cada RNC y el paso a produccion dependen de completar la certificacion y recibir confirmacion de la DGII; la existencia de una funcion en la plataforma no sustituye esa autorizacion.
¿Como evito duplicar una factura si la solicitud termina en timeout?
Repite exactamente el mismo JSON con el mismo eNCF. Zarela devolvera el documento original cuando el contenido coincida; si ese eNCF llega con informacion fiscal diferente, respondera 409 ENCF_PAYLOAD_MISMATCH. Ver Errores y reintentos.
¿Como recibe mi ERP los cambios de estado y documentos inbound?
Puedes consultar status/batch y, adicionalmente, configurar webhooks. Los webhooks permiten recibir cambios asincronos e incluyen el inboundDocumentId necesario para automatizar aprobaciones comerciales.
Seguridad y privacidad
¿Como se protegen mis certificados y datos?
Los certificados se almacenan cifrados; la contrasena del .p12 nunca se expone al navegador despues de la carga inicial. Toda comunicacion usa HTTPS y las operaciones sensibles quedan auditadas.
¿Quien puede acceder a mis e-CF?
Tu empresa, los receptores de tus comprobantes y la DGII cuando la regulacion lo requiera.
¿Cuanto tiempo se conservan los documentos?
Zarela conserva los XML firmados y artifacts fiscales por 10 anos conforme a la normativa de la DGII, incluso cuando a la DGII solo se envio el resumen RFCE.