Recepción de compras

Además de emitir, una empresa recibe documentos de sus proveedores. Emify centraliza esos documentos recibidos (compras / recepciones) y te permite consultarlos, descargarlos y responder con el acuse de recibo que exige el ente tributario.

Consultar documentos recibidos

curl "https://api.emify.co/api/reception/invoices/list?company_id={company_id}" \
  -H "X-Api-Key: tu_api_key"

Acción	Endpoint
Listar recibidos	`GET /api/reception/invoices/list`
Obtener uno	`GET /api/reception/invoices/{purchase_id}`
Descargar	`POST /api/reception/invoices/{purchase_id}/download/{type}`
Enviar acuse de recibo	`POST /api/reception/invoices/{purchase_id}/send_response`

Moneda del documento

Tanto el listado como el detalle incluyen currency_code, el código ISO-4217 de la moneda en la que está expresado el total. Es solo el código: no viene acompañado de tipo de cambio.

Valor	Moneda
`CLP`	Peso chileno
`USD`	Dólar estadounidense
`EUR`	Euro
`ARS`	Peso argentino

El valor de currency_code no prueba que el emisor haya declarado esa moneda. Declararla es opcional en el documento tributario chileno y la mayoría de los documentos nacionales (tipos 33, 34 y 39) la omiten. Cuando el documento no la declara, Emify resuelve el campo a la moneda local del país del documento: CLP para Chile. Si necesitas distinguir una moneda declarada de un valor resuelto por defecto, consulta el xml del documento en el endpoint de detalle.

Si el país del documento no tiene una moneda local asociada, el campo llega null.

Acuse de recibo

El ente tributario exige que el receptor de un documento lo acepte o lo reclame dentro de un plazo. Usa send_response para enviar esa respuesta a través de Emify. En Chile, Emify la registra en el Registro de Compras y Ventas del SII, y tienes 8 días corridos desde que Emify recibió el documento.

curl -X POST "https://api.emify.co/api/reception/invoices/{purchase_id}/send_response?company_id={company_id}" \
  -H "X-Api-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "response_code": "ACD", "observations": "Documento conforme" }'

Campo	Descripción
`response_code`	Obligatorio. La acción, con el código de Emify o el del SII (ver la tabla).
`observations`	Opcional. Se agrega a la descripción de la respuesta.

Acción	Código de Emify	Código del SII	`response_status`
Aceptar el contenido	`ACP`	`ACD`	`ACC`
Reclamar el contenido	`REC`	`RCD`	`REJ`
Reclamar falta parcial de mercaderías	`RPM`	`RFP`	`PAR`
Reclamar falta total de mercaderías	`RTM`	`RFT`	`REJ`

response_code acepta cualquiera de los dos códigos. La respuesta devuelve siempre el de Emify:

{
  "id": "a1b2c3d4e5f67890abcdef1234567890",
  "response_status": "ACC",
  "response_code": "ACP",
  "response_date": "2026-11-03T10:00:00",
  "response_description": "Acepta Contenido del Documento. - Documento conforme",
  "message": "Response sent successfully"
}

El documento cambia de estado solo si el SII confirma la acción. Si falla, sigue pendiente (PEN):

Estado	`code`	Cuándo
`400`	`INVALID_RESPONSE_CODE`	El código no existe para el país de la empresa.
`400`	`RESPONSE_WINDOW_EXPIRED`	Pasaron más de 8 días desde la recepción.
`400`	`COMPANY_SUSPENDED`	La empresa está suspendida.
`400`	`CERTIFICATE_NOT_FOUND`	La empresa no tiene un certificado digital activo.
`409`	`RESPONSE_ALREADY_SENT`	El documento ya tiene una respuesta.
`422`	`SII_RESPONSE_REJECTED`	El SII rechazó la acción. El `message` trae el código y la descripción que devolvió el SII.
`500`	`SEND_RESPONSE_ERROR`	No se pudo completar la comunicación con el SII. Se puede reintentar.

Si el documento ya se aceptó o reclamó directamente en el portal del SII, Emify no lo sabe: el SII puede rechazar el nuevo envío (422 SII_RESPONSE_REJECTED) y el documento sigue en PEN en Emify.

Los endpoints de recepción reciben la empresa como parámetro company_id en la query, a diferencia de los de emisión que lo llevan en el path.

Cómo funciona

Configuración de la empresa

Emisión y recepción

Recepción de compras

Consultar documentos recibidos

Moneda del documento

Acuse de recibo

​Consultar documentos recibidos

​Moneda del documento

​Acuse de recibo

Consultar documentos recibidos

Moneda del documento

Acuse de recibo