Certificados digitales

Cada documento tributario debe ir firmado electrónicamente en nombre del contribuyente. Emify usa el certificado digital de la empresa emisora para firmar los documentos antes de enviarlos al ente tributario.

Qué es

El certificado digital es un archivo emitido por una autoridad certificadora reconocida por el ente tributario, asociado al contribuyente. Sin un certificado válido y vigente cargado en la empresa, Emify no puede firmar ni emitir documentos.

Subir un certificado

Se sube el archivo PKCS#12 (.pfx o .p12) mediante multipart/form-data, con estos campos:

Campo	Obligatorio	Descripción
`certificate`	Sí	El archivo `.pfx` o `.p12`.
`password`	No	Contraseña del archivo. Si se omite, se intenta abrirlo sin contraseña.
`certificate_tax_id_number`	Sí	RUT del titular del certificado, sin puntos y con guion (`12345678-5`). Ver abajo.

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'

La respuesta es 201 con el id del certificado:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Las fechas de vigencia se leen del propio certificado: no se envían.

El RUT es el del titular, no el de la empresa

En Chile, el certificado digital se emite a nombre de una persona natural: el representante legal o quien la empresa autorizó ante el SII. certificate_tax_id_number es el RUT de esa persona, no el RUT de la empresa. Emify usa ese RUT cada vez que actúa ante el SII con el certificado: al enviar los documentos firmados, al pedir, reobtener o anular folios y al responder documentos recibidos. Si se informa otro RUT —por ejemplo, el de la empresa—, esas operaciones pueden fallar ante el SII: la solicitud y la reobtención de folios, en particular, fallan con un error de autenticación.

Emify no compara este RUT con el que figura dentro del certificado. Un RUT equivocado no se detecta al subirlo, sino después, cuando falla una operación ante el SII.

Errores

HTTP	Código	Qué pasó
`400`	`MISSING_REQUEST_PART`	Falta el archivo `certificate`.
`400`	`MISSING_REQUEST_PARAMETER`	Falta `certificate_tax_id_number`.
`400`	`CERTIFICATE_EMPTY`	El archivo llegó vacío.
`400`	`CERTIFICATE_INVALID_PASSWORD`	El archivo no se pudo abrir: la contraseña no corresponde o no es un PKCS#12.
`400`	`CERTIFICATE_UNREADABLE`	El archivo se abrió, pero no contiene un certificado.

Los errores de autenticación y de acceso a la empresa (401, 403) son los generales de la API. Ver Errores.

Gestión de certificados

Acción	Endpoint
Subir certificado	`POST /api/companies/{idCompany}/certificates`
Listar certificados	`GET /api/companies/{idCompany}/certificates/list`
Obtener un certificado	`GET /api/companies/{idCompany}/certificates/{id}`
Eliminar certificado	`DELETE /api/companies/{idCompany}/certificates/{id}`

Los certificados tienen fecha de vencimiento. Un certificado vencido impide la emisión: desde el día siguiente a su vencimiento, Emify rechaza cada documento con 422 y el error CERTIFICATE_EXPIRED, sin registrarlo ni consumir folio. Renuévalo antes de que expire y súbelo a la empresa.

Sube el certificado como parte del alta de una empresa, junto con la solicitud de folios, para dejarla lista para emitir.

Cómo funciona

Configuración de la empresa

Emisión y recepción

Certificados digitales

Qué es

Subir un certificado

El RUT es el del titular, no el de la empresa

Errores

Gestión de certificados

​Qué es

​Subir un certificado

​El RUT es el del titular, no el de la empresa

​Errores

​Gestión de certificados

Qué es

Subir un certificado

El RUT es el del titular, no el de la empresa

Errores

Gestión de certificados