# ZarelaFact > ZarelaFact es una API REST para emitir comprobantes fiscales electrónicos (e-CF) ante la DGII de República Dominicana: tu sistema envía cada venta en JSON y ZarelaFact la convierte a XML, la firma con el certificado del emisor, la envía a la DGII y la guarda 10 años. Hay dos formas de integrarse: - Cuenta directa: una empresa emite con su propio RNC. Header `X-API-KEY` (una clave por ambiente) y rutas `https://api.zarelafact.com/{ambiente}`, con ambiente `TesteCF` (pruebas), `CerteCF` (certificación) o `eCF` (producción). - API Partner: un ERP, POS o SaaS emite por varios clientes, cada uno con su Cuenta fiscal. Header `X-PARTNER-KEY` y rutas `https://api.zarelafact.com/partner/v1`. La documentación está en español. El contrato exacto de cada ruta está en el OpenAPI. ## Empieza aquí - [Integra con IA](https://zarelafact.com/docs/integration/ai-assistants): prompts listos para que un asistente de código integre ZarelaFact, para cuenta directa y para Partners. Por defecto integran las facturas 31 y 32 y la nota de crédito 34 (el 41, si se pide), y una tabla indica la página de cada función extra. - [OpenAPI](https://zarelafact.com/docs/openapi.yaml): contrato OpenAPI 3.1 (YAML) de la API directa y de la API Partner: rutas, campos, respuestas y errores. - [Cómo empezar](https://zarelafact.com/docs/): los pasos en orden, de la cuenta a la certificación ante la DGII. - [1. Crea tu cuenta](https://zarelafact.com/docs/getting-started/registration): cuenta directa o Partner, y cuál elegir. - [2. Sube tu certificado (.p12)](https://zarelafact.com/docs/getting-started/certificate): el certificado digital es obligatorio en todos los ambientes, también en TesteCF. - [3. Crea tu API key](https://zarelafact.com/docs/getting-started/api-keys): una clave por ambiente (`zrl_test_`, `zrl_cert_`, `zrl_live_`) y sus permisos. ## Integración (cuenta directa) - [Cómo funciona la integración](https://zarelafact.com/docs/integration/overview): ambientes, URL base y flujo asíncrono de emisión. - [Autenticación API](https://zarelafact.com/docs/integration/authentication): header `X-API-KEY`, errores de autenticación y límites de solicitudes. - [Formato JSON de e-CF](https://zarelafact.com/docs/integration/document-format): JSON con la estructura de la DGII (raíz `ECF`) y contrato simplificado opcional. - [Envío de e-CF](https://zarelafact.com/docs/integration/send-documents): `POST /{ambiente}/documentos-ecf`, `?validate=true`, `Prefer: wait=10`, estados, idempotencia por eNCF, contingencia y errores. - [Ejemplos JSON por tipo](https://zarelafact.com/docs/integration/ecf-types): un JSON completo para cada tipo de e-CF (31, 32, 33, 34, 41, 43, 44, 45, 46 y 47). - [Consulta de e-CF](https://zarelafact.com/docs/integration/query-documents): consulta por lote, datos para imprimir, `dgiiMessages` y `lastError`. - [Webhooks](https://zarelafact.com/docs/integration/webhooks): eventos, verificación de `Zarela-Signature` y deduplicación por `Zarela-Event-Id`. - [Representación impresa](https://zarelafact.com/docs/integration/printed-representation): código de seguridad, QR, PDF tamaño carta y XML firmado. - [Anulación de e-NCF](https://zarelafact.com/docs/integration/annulments): anular rangos de eNCF no usados (ANECF) por API. - [Recepción y aprobación comercial](https://zarelafact.com/docs/integration/commercial-approval): documentos recibidos de proveedores y aprobación o rechazo comercial (ACECF). - [Certifica ante la DGII](https://zarelafact.com/docs/certification/process): los 12 pasos de la certificación como emisor electrónico y la activación de producción. ## API Partner (varios clientes) - [Varios clientes (Partners)](https://zarelafact.com/docs/partners/overview): cuentas fiscales, credenciales, carga del certificado, titularidad del RNC y ambientes. - [Qué construir en tu ERP, POS o SaaS](https://zarelafact.com/docs/partners/implementation): datos, pantallas, emisión y procesos de backend. - [Guía paso a paso](https://zarelafact.com/docs/partners/quickstart): recorrido con cada llamada, del alta del cliente a la emisión. - [Certificación de cada contribuyente](https://zarelafact.com/docs/partners/certification): pantalla de pasos incrustable (`certification-sessions`), set de pruebas, caso CerteCF y atestaciones. - [Activación y emisión eCF](https://zarelafact.com/docs/partners/production): activación de producción, emisión, estado, XML y PDF, anulación y documentos recibidos. - [Webhooks de la API Partner](https://zarelafact.com/docs/partners/webhooks): registro por API, firma, eventos, reintentos y mantenimiento. - [Referencia de rutas y errores](https://zarelafact.com/docs/partners/reference): todas las rutas `/partner/v1`, permisos, reglas de payload, errores y límites. ## Optional - [Planes y pagos](https://zarelafact.com/docs/getting-started/plans): precios, consumo y el error `402 PAYMENT_REQUIRED`. - [Preguntas frecuentes](https://zarelafact.com/docs/resources/faq): respuestas cortas por tema. - [Mejores prácticas](https://zarelafact.com/docs/resources/best-practices): arquitectura, reintentos, seguridad y contingencia. - [Cómo leer los Logs DGII](https://zarelafact.com/docs/resources/dgii-logs): el pipeline de cada e-CF en el portal y sus eventos. - [Glosario](https://zarelafact.com/docs/resources/glossary): términos de la facturación electrónica e-CF.