Skip to main content

​
Requisitos Previos

Antes de comenzar, asegúrate de tener:

API Key

Obtén tu API Key desde el Dashboard de Zynvo

Permisos de Desarrollador

Activa el modo desarrollador en tu cuenta para usar sandbox

Credenciales DGI

Usuario y contraseña de e-Factura DGI de la empresa

Certificado Digital

Archivo .p12 y contraseña del certificado digital

​
Flujo Completo de Integración

Esta guía te llevará paso a paso desde la verificación de datos de una empresa hasta la emisión de tu primer CFE (Comprobante Fiscal Electrónico).
1

Verificar eRUT

Consulta y verifica los datos fiscales de la empresa en DGI antes de registrarla.Endpoint: GET /erut/{rut}
2

Registrar Empresa

Crea la empresa en el sistema con los datos obtenidos del eRUT.Endpoint: POST /enterprises
3

Validar Permisos de eFactura

Valida las credenciales de eFactura y verifica los permisos de homologación/producción. Este proceso es asíncrono.Endpoint: POST /enterprises/{rut}/validate-efactura
4

Esperar Evento de Validación

Aguarda el webhook efactura.login que confirma la homologación o migración satisfactoria al sistema.Webhook: efactura.loginLos permisos HOMO o PROD confirman el acceso a los ambientes correspondientes.
5

Cargar Certificado Digital

Carga el certificado digital (.p12) de la empresa para firmar los comprobantes.Endpoint: POST /enterprises/{rut}/certificate
6

Actualizar Plan y Fecha de Inicio

Actualiza la empresa con el plan contratado y la fecha de inicio del servicio.Endpoint: PATCH /enterprises/{rut}
7

Subir CAEs

Carga los archivos XML de los CAEs (Códigos de Autorización Electrónica) obtenidos desde DGI.Endpoint: POST /enterprises/{rut}/caes
8

Comenzar a Facturar

¡Todo listo! Emite y envía tu primer comprobante electrónico a DGI.Endpoint: POST /enterprises/{rut}/cfes
Usa Sandbox Mode: Incluye el header X-Sandbox-Mode: true en todos estos pasos para probar sin afectar producción ni consumir CAEs reales.

​
¿Necesitas Ayuda?

Si encuentras problemas durante el onboarding:

​
Errores Comunes

Solución: Asegúrate de que tu cuenta tenga activado el flag is_developer. Contacta a soporte para habilitarlo.
Solución: Verifica que el RUT esté correcto (sin puntos ni guiones) y que no esté ya registrado en el sistema.
Solución:
  • Verifica que las credenciales de e-Factura sean correctas
  • Asegúrate de que la empresa tenga permisos activos en DGI
  • En sandbox, las credenciales deben ser del ambiente de certificación
Solución: Verifica que la contraseña del archivo .p12 sea correcta. El certificado debe ser válido y no estar vencido.