Inicio rápido

Emite tu primer documento tributario electrónico con la API de Emify.

Esta guía te lleva desde tus credenciales hasta emitir un documento. Los ejemplos usan la URL de producción https://api.emify.co.

Prerequisitos

• Una API key activa (ver Autenticación).
• Una empresa emisora configurada con certificado digital y folios (CAF) vigentes (ver Dar de alta una empresa).

1. Identifica tu empresa

Lista las empresas asociadas a tu API key para obtener el company_id con el que vas a operar.

curl https://api.emify.co/api/companies \
  -H "X-Api-Key: tu_api_key"

2. Emite un documento

Envía el documento a emitir. Emify lo genera, firma y remite al ente tributario de forma asíncrona.

curl -X POST https://api.emify.co/api/companies/{company_id}/invoices \
  -H "X-Api-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d @factura.json

La respuesta incluye el identificador del documento y su estado inicial. El procesamiento ante el ente tributario es asíncrono. Para un ejemplo completo del cuerpo (emisor, receptor, ítems, impuestos y totales), ver Emitir un comprobante.

3. Consulta el estado

Recupera el documento para ver su estado de procesamiento.

curl https://api.emify.co/api/companies/{company_id}/invoices/{invoice_id} \
  -H "X-Api-Key: tu_api_key"

En lugar de consultar el estado por polling, configura un webhook para recibir una notificación cuando el documento cambie de estado.

Siguientes pasos

Referencia de la API

Explora todos los endpoints disponibles.

Webhooks

Recibe eventos en tiempo real sobre tus documentos.