Dar de alta una empresa

Crea una empresa emisora, carga su certificado y sus folios, y déjala lista para emitir.

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'

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. Configurar webhooks (opcional)

Registra un webhook para recibir el estado de tus documentos sin hacer polling. Ver Webhooks.

Listo para emitir

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