---
title: "Adicionar certificado digital."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-Emissor-documentoEmissor--CertificadoDigital-Adicionar/post"
---

> Full API specification: https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050.md

# Adicionar certificado digital.

`POST` `/api/v1/Emissor/{documentoEmissor}/CertificadoDigital/Adicionar`

Permite adicionar o certificado digital para o emissor. O certificado digital é fundamental para emissão de documentos fiscais. ⚠️ **ATENÇÃO**: O sistema só permite o uso de certificado digital modelo A1 com extensão de arquivo .PFX ou .P12. 🚨 **IMPORTANTE**: Após o vencimento do certificado digital atual, o mesmo deve ser removido para adição de um novo.

## Path parameters

- `documentoEmissor` (string, required) - Documento do emissor associado ao certificado.

## Request body

Content types: `multipart/form-data`

## Responses

- `200` - OK
- `400` - Bad Request
- `401` - Unauthorized
- `403` - Forbidden
- `500` - Internal Server Error

## OpenAPI definition

```yaml
openapi: 3.0.4
info:
  title: Stone Tax API
  version: 1.0.0
servers:
  - url: https://stone-tax-sdx.stone.com.br
    description: Ambiente de Desenvolvimento
  - url: https://stone-tax.stone.com.br
    description: Ambiente de Produção
paths:
  /api/v1/Emissor/{documentoEmissor}/CertificadoDigital/Adicionar:
    post:
      tags:
        - Emissor
      summary: Adicionar certificado digital.
      description: >-
        Permite adicionar o certificado digital para o emissor. O certificado
        digital é fundamental para emissão de documentos fiscais.


        ⚠️ **ATENÇÃO**: O sistema só permite o uso de certificado digital modelo
        A1 com extensão de arquivo .PFX ou .P12.


        🚨 **IMPORTANTE**: Após o vencimento do certificado digital atual, o
        mesmo deve ser removido para adição de um novo.
      parameters:
        - name: documentoEmissor
          in: path
          description: Documento do emissor associado ao certificado.
          required: true
          schema:
            type: string
      requestBody:
        content:
          multipart/form-data:
            schema:
              required:
                - CertificadoDigital
                - Senha
              type: object
              properties:
                CertificadoDigital:
                  minLength: 1
                  type: string
                  description: Arquivo PFX contendo o certificado digital do emissor.
                  format: binary
                Senha:
                  minLength: 1
                  type: string
                  description: Senha do certificado digital.
            encoding:
              CertificadoDigital:
                style: form
              Senha:
                style: form
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/CertificadoDigitalViewModel"
            application/json:
              schema:
                $ref: "#/components/schemas/CertificadoDigitalViewModel"
            text/json:
              schema:
                $ref: "#/components/schemas/CertificadoDigitalViewModel"
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "401":
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "403":
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "500":
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
      security:
        - BearerAuth: []
security:
  - BearerAuth: []
components:
  schemas:
    CertificadoDigitalViewModel:
      type: object
      properties:
        numeroSerie:
          type: string
          description: Número de série do certificado.
          nullable: true
        dataValidade:
          type: string
          description: Data de validade do certificado.
          format: date
          example: 2025-03-31
      additionalProperties: false
      description: Informações do certificado digital.
    ResponseErrorResult:
      type: object
      properties:
        status:
          type: integer
          format: int32
        titulo:
          type: string
          nullable: true
        erros:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          nullable: true
      additionalProperties: false
  securitySchemes:
    BearerAuth:
      type: http
      description: Autenticação via token JWT. Obtenha o token através do endpoint
        /Autenticacao/ObterToken usando Basic Auth. O token expira em 1 hora.
      scheme: bearer
      bearerFormat: JWT
```