> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zynvo.uy/llms.txt
> Use this file to discover all available pages before exploring further.

# Guía de Onboarding

> Pasos completos para integrar tu empresa y emitir tu primer comprobante electrónico

## Requisitos Previos

Antes de comenzar, asegúrate de tener:

<CardGroup cols={2}>
  <Card title="API Key" icon="key">
    Obtén tu API Key desde el [Dashboard de Zynvo](https://app.zynvo.uy/settings/api)
  </Card>

  <Card title="Permisos de Desarrollador" icon="code">
    Activa el modo desarrollador en tu cuenta para usar sandbox
  </Card>

  <Card title="Credenciales DGI" icon="id-card">
    Usuario y contraseña de e-Factura DGI de la empresa
  </Card>

  <Card title="Certificado Digital" icon="certificate">
    Archivo .p12 y contraseña del certificado digital
  </Card>
</CardGroup>

## 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).

<Steps>
  <Step title="Verificar eRUT">
    Consulta y verifica los datos fiscales de la empresa en DGI antes de registrarla.

    **Endpoint**: `GET /erut/{rut}`
  </Step>

  <Step title="Registrar Empresa">
    Crea la empresa en el sistema con los datos obtenidos del eRUT.

    **Endpoint**: `POST /enterprises`
  </Step>

  <Step title="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`
  </Step>

  <Step title="Esperar Evento de Validación">
    Aguarda el webhook `efactura.login` que confirma la homologación o migración satisfactoria al sistema.

    **Webhook**: `efactura.login`

    Los permisos `HOMO` o `PROD` confirman el acceso a los ambientes correspondientes.
  </Step>

  <Step title="Cargar Certificado Digital">
    Carga el certificado digital (.p12) de la empresa para firmar los comprobantes.

    **Endpoint**: `POST /enterprises/{rut}/certificate`
  </Step>

  <Step title="Actualizar Plan y Fecha de Inicio">
    Actualiza la empresa con el plan contratado y la fecha de inicio del servicio.

    **Endpoint**: `PATCH /enterprises/{rut}`
  </Step>

  <Step title="Subir CAEs">
    Carga los archivos XML de los CAEs (Códigos de Autorización Electrónica) obtenidos desde DGI.

    **Endpoint**: `POST /enterprises/{rut}/caes`
  </Step>

  <Step title="Comenzar a Facturar">
    ¡Todo listo! Emite y envía tu primer comprobante electrónico a DGI.

    **Endpoint**: `POST /enterprises/{rut}/cfes`
  </Step>
</Steps>

<Tip>
  **Usa Sandbox Mode**: Incluye el header `X-Sandbox-Mode: true` en todos estos pasos para probar sin afectar producción ni consumir CAEs reales.
</Tip>

## ¿Necesitas Ayuda?

Si encuentras problemas durante el onboarding:

* Consulta la sección de [Errores Comunes](#errores-comunes)
* Revisa la [documentación de Sandbox](/api-reference/sandbox)
* Contacta a soporte: [soporte@zynvo.uy](mailto:soporte@zynvo.uy)

***

## Errores Comunes

<AccordionGroup>
  <Accordion title="Error 403: No tienes permisos para usar sandbox">
    **Solución**: Asegúrate de que tu cuenta tenga activado el flag `is_developer`. Contacta a soporte para habilitarlo.
  </Accordion>

  <Accordion title="Error 400: RUT inválido o ya registrado">
    **Solución**: Verifica que el RUT esté correcto (sin puntos ni guiones) y que no esté ya registrado en el sistema.
  </Accordion>

  <Accordion title="Error en verificación de e-Factura">
    **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
  </Accordion>

  <Accordion title="Error al subir certificado: contraseña incorrecta">
    **Solución**: Verifica que la contraseña del archivo .p12 sea correcta. El certificado debe ser válido y no estar vencido.
  </Accordion>
</AccordionGroup>