Certificado digital

Para firmar e-CF a nombre de tu empresa, Firmo necesita tu certificado digital para procedimientos tributarios, en formato .p12, emitido por una entidad autorizada por el INDOTEL. En sandbox no hace falta: el simulador firma con un certificado autofirmado.

Subir el certificado#

POST/v1/company/certificate

Se envía como multipart/form-data con dos campos: archivo (el .p12) y password.

curl -X POST https://api.firmo.do/v1/company/certificate \
  -H "Authorization: Bearer $FIRMO_API_KEY" \
  -F "archivo=@certificado.p12" \
  -F "password=$P12_PASSWORD"

Verificar#

GET /v1/company devuelve el estado del certificado:

{
  "rnc": "131000000",
  "razonSocial": "Tu Empresa SRL",
  "ambiente": "sandbox",
  "certificado": { "cargado": true, "titular": "ANA RODRIGUEZ", "venceEn": "2027-09-30" }
}

Antes de que venza, te avisamos con el webhook certificado.por_vencer.

Cómo se guarda#

• El archivo y la contraseña se cifran con AES-256-GCM antes de guardarse, con una llave maestra separada de la base de datos.
• El certificado nunca se devuelve por la API ni se guarda en texto plano.
• Más detalles en Seguridad.