Enviar certificado digital

POST 
/v1/certificates

Envia um certificado digital A1 via multipart/form-data. A chave privada e a senha são criptografadas em repouso e nunca retornadas pela API. O endpoint detecta duplicidade pelo thumbprint e associa automaticamente a um person pelo CNPJ/CPF extraído.

Valores aceitos para type:

• pfx — envia file (PFX/P12 binário) e password.
• cert_key — envia cert_file (PEM do certificado) e key_file (PEM da chave).
• combined_pem — envia file (PEM contendo certificado + chave).
• cert_key_password — envia cert_file, key_file e password (chave protegida por senha).

Request

Responses

201

Certificado enviado e armazenado com sucesso.

400

Corpo da requisição falhou na validação.

401

Token bearer ausente ou inválido.

403

Token válido, porém sem permissão para esta operação. Com code insufficient_scope, details.required traz o único conjunto mínimo de escopos que, somados a details.granted, deixaria a requisição passar: o escopo do recurso (billing/{recurso}, ou billing/all fora do catálogo) e depois o verbo puro — por exemplo ["billing/customers", "delete"].

404

Recurso não encontrado na organização atual.

422

Corpo da requisição falhou na validação.

429

Limite de requisições excedido.

500

Erro inesperado no servidor.