Subir certificado digital
POST/v1/certificates
Sube un certificado digital A1 vía multipart/form-data. La clave privada y la contraseña se cifran en reposo y nunca son devueltas por la API. El endpoint detecta duplicados por thumbprint y asocia automáticamente el certificado a un person por el CNPJ/CPF extraído.
Valores aceptados para type:
pfx— enviarfile(PFX/P12 binario) ypassword.cert_key— enviarcert_file(PEM del certificado) ykey_file(PEM de la clave).combined_pem— enviarfile(PEM con certificado + clave).cert_key_password— enviarcert_file,key_fileypassword(clave protegida por contraseña).
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 422
- 429
- 500
Certificado subido y almacenado con éxito.
El cuerpo de la solicitud falló en la validación.
Token bearer ausente o inválido.
Token válido, pero sin permiso para esta operación. Con code insufficient_scope, details.required trae el único conjunto mínimo de scopes que, sumados a details.granted, dejaría pasar la solicitud: el scope del recurso (billing/{recurso}, o billing/all fuera del catálogo) y luego el verbo simple — por ejemplo ["billing/customers", "delete"].
Recurso no encontrado en la organización actual.
El cuerpo de la solicitud falló en la validación.
Límite de solicitudes excedido.
Error inesperado en el servidor.