We use cookies to improve your experience and analyze site traffic. By clicking “Accept”, you agree to our use of cookies.

Learn more about our privacy practices
Corvo
English

Certificados

Envie e gerencie certificados A1 (PKCS#12) das empresas.

Permissões: nfse.certificates.view para listar e nfse.certificates.manage para upload/revogação.

POST/v1/companies/:companyId/certificates201 Created
full_access

Envia o certificado A1 (.p12/.pfx) da empresa em multipart/form-data.

CampoTipoObrigatórioDescrição
filearquivo✓Certificado PKCS#12 (.p12/.pfx), máximo 50 × 1024 bytes.
passwordstring✓Obrigatória e não vazia, até 100 caracteres.
curl -X POST "$BASE_URL/companies/$COMPANY_ID/certificates" \
  -H "X-API-Key: $CORVO_API_KEY" \
  -F 'file=@certificado.pfx' \
  -F 'password=SENHA_DO_CERTIFICADO'

Resposta — 201 Created

{
  "data": {
    "id": "9a4e2b1c-7f3d-4e6a-b8c0-1d2e3f4a5b6c",
    "companyId": "3f1c8a90-6b2e-4d5a-9c11-8e2f0a7b4d11",
    "serialNumber": "3F1C8A90",
    "issuer": "AC Exemplo",
    "subject": "CN=11222333000181",
    "fingerprint": "ab:cd:ef:12",
    "validFrom": "2026-01-01T00:00:00.000Z",
    "validUntil": "2027-01-01T00:00:00.000Z",
    "status": "active",
    "createdAt": "2026-10-10T12:00:00.000Z"
  }
}
GET/v1/companies/:companyId/certificates200 OK
full_accessinvoices_read_write

Lista os certificados de uma empresa.

curl "$BASE_URL/companies/$COMPANY_ID/certificates" \
  -H "X-API-Key: $CORVO_API_KEY"

Resposta — 200 OK

{
  "data": [
    {
      "id": "9a4e2b1c-7f3d-4e6a-b8c0-1d2e3f4a5b6c",
      "companyId": "3f1c8a90-6b2e-4d5a-9c11-8e2f0a7b4d11",
      "status": "active",
      "validUntil": "2027-01-01T00:00:00.000Z",
      "createdAt": "2026-10-10T12:00:00.000Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "hasMore": false,
    "nextCursor": null
  }
}
DELETE/v1/companies/:companyId/certificates/:certId204 No Content
full_access

Revoga um certificado e atualiza a prontidão da empresa.

curl -X DELETE "$BASE_URL/companies/$COMPANY_ID/certificates/$CERT_ID" \
  -H "X-API-Key: $CORVO_API_KEY"