Dar de alta una empresa

Antes de emitir necesitas una empresa emisora configurada. Esta guía cubre el alta de la empresa y la carga de todo lo necesario para operar: logo, certificado digital y folios (CAF). Todas las peticiones usan tu API key en el header X-Api-Key. Consulta Autenticación para saber cómo obtenerla.

1. Crear la empresa

curl -X POST https://api.emify.co/api/companies \
  -H "X-Api-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "legal_name": "CONTABILIUM CHILE SPA",
    "tax_identification_document_code": "RUT",
    "tax_identification_document_number": "77450199-1",
    "country": "CL",
    "start_activities_date": "2023-01-01"
  }'

La respuesta incluye el id de la empresa (company_id), que usarás en el resto de las rutas.

Los valores de tax_identification_document_code y country provienen de los catálogos de referencia. Para Chile, el país es CL y el documento tributario es RUT.

2. Cargar el logo (opcional)

El logo aparece en la representación impresa (PDF) de los documentos.

curl -X POST https://api.emify.co/api/companies/{company_id}/logo \
  -H "X-Api-Key: tu_api_key" \
  -F 'logo=@/ruta/al/logo.jpg'

3. Cargar el certificado digital

Sin un certificado válido y vigente, la empresa no puede firmar ni emitir documentos.

curl -X POST https://api.emify.co/api/companies/{company_id}/certificates \
  -H "X-Api-Key: tu_api_key" \
  -F 'certificate=@/ruta/al/certificado.pfx' \
  -F 'password=contraseña_del_certificado' \
  -F 'certificate_tax_id_number=12345678-5'

certificate_tax_id_number es el RUT de la persona titular del certificado, no el de la empresa. Ver Certificados digitales para más detalle.

4. Cargar los folios (CAF)

Carga el archivo de folios autorizados para cada tipo de documento que vas a emitir.

curl -X POST https://api.emify.co/api/companies/{company_id}/enumeration/upload \
  -H "X-Api-Key: tu_api_key" \
  -F 'file=@/ruta/al/caf.xml'

La respuesta incluye el id_document_type al que quedó vinculada la enumeración.

5. Setear el próximo folio a usar

Si vienes facturando con otro sistema, indica desde qué número debe continuar cada tipo de documento para respetar la correlatividad. Si omites este paso, la numeración arranca en el folio disponible más bajo del rango cargado.

curl -X PUT "https://api.emify.co/api/companies/{company_id}/enumeration/document-type/{document_type_id}/next-folio" \
  -H "X-Api-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "next_folio_number": 61 }'

El ajuste es global por tipo de documento: marca como usados todos los folios menores al número enviado en todos los CAF activos. Ver Folios y CAF.

6. Webhooks

No hay nada que configurar por empresa: el webhook es uno solo para toda tu cuenta y recibe también los eventos de las empresas nuevas. Si todavía no lo configuraste, ver Webhooks.

Listo para emitir

Con la empresa creada, el certificado cargado y los folios configurados, ya puedes emitir tu primer comprobante.

Cómo funciona

Configuración de la empresa

Emisión y recepción

Dar de alta una empresa

1. Crear la empresa

2. Cargar el logo (opcional)

3. Cargar el certificado digital

4. Cargar los folios (CAF)

5. Setear el próximo folio a usar

6. Webhooks

Listo para emitir

​1. Crear la empresa

​2. Cargar el logo (opcional)

​3. Cargar el certificado digital

​4. Cargar los folios (CAF)

​5. Setear el próximo folio a usar

​6. Webhooks

​Listo para emitir

1. Crear la empresa

2. Cargar el logo (opcional)

3. Cargar el certificado digital

4. Cargar los folios (CAF)

5. Setear el próximo folio a usar

6. Webhooks

Listo para emitir