Inicio rápido

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.

Primeros pasos

Conceptos

Inicio rápido

Prerequisitos

1. Identifica tu empresa

2. Emite un documento

3. Consulta el estado

Siguientes pasos

Referencia de la API

Webhooks

​Prerequisitos

​1. Identifica tu empresa

​2. Emite un documento

​3. Consulta el estado

​Siguientes pasos

Referencia de la API

Webhooks

Prerequisitos

1. Identifica tu empresa

2. Emite un documento

3. Consulta el estado

Siguientes pasos