---
title: "Atualização de dados cadastrais."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-Emissor-documentoEmissor--Atualizar/put"
---

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

# Atualização de dados cadastrais.

`PUT` `/api/v1/Emissor/{documentoEmissor}/Atualizar`

Permite atualizar os dados cadastrais do emissor. ⚠️ **ATENÇÃO**: É necessário que os dados cadastrais do emissor estejam corretos e atualizados para retorno assertivo da tributação dos produtos nas consultas e emissão de notas fiscais.

## Path parameters

- `documentoEmissor` (string, required) - Documento do emissor a ser atualizado.

## Request body

Content types: `application/json-patch+json`, `application/json`, `text/json`, `application/*+json`

## Responses

- `204` - No Content
- `400` - Bad Request
- `401` - Unauthorized
- `403` - Forbidden
- `404` - Not Found
- `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}/Atualizar:
    put:
      tags:
        - Emissor
      summary: Atualização de dados cadastrais.
      description: >-
        Permite atualizar os dados cadastrais do emissor.


        ⚠️ **ATENÇÃO**: É necessário que os dados cadastrais do emissor estejam
        corretos e atualizados para retorno assertivo da tributação dos produtos
        nas consultas e emissão de notas fiscais.
      parameters:
        - name: documentoEmissor
          in: path
          description: Documento do emissor a ser atualizado.
          required: true
          schema:
            type: string
      requestBody:
        description: Dados atualizados do emissor.
        content:
          application/json-patch+json:
            schema:
              $ref: "#/components/schemas/AtualizarDadosEmissorInputModel"
          application/json:
            schema:
              $ref: "#/components/schemas/AtualizarDadosEmissorInputModel"
          text/json:
            schema:
              $ref: "#/components/schemas/AtualizarDadosEmissorInputModel"
          application/*+json:
            schema:
              $ref: "#/components/schemas/AtualizarDadosEmissorInputModel"
      responses:
        "204":
          description: No Content
        "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"
        "404":
          description: Not Found
          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:
    AtualizarDadosEmissorInputModel:
      required:
        - endereco
        - nome
        - regimeTributario
        - tipoEstabelecimento
        - tipoIcmsSt
      type: object
      properties:
        nome:
          maxLength: 60
          minLength: 3
          type: string
          description: Nome ou Razão Social do emissor.
        nomeFantasia:
          type: string
          description: Nome fantasia do emissor.
          nullable: true
        regimeTributario:
          $ref: "#/components/schemas/RegimeTributarioModelEnum"
        aliquotaCreditoSimples:
          type: number
          description: Alíquota do crédito de icms do simples nacional consedido em
            operações de revenda do regime Simples Nacional.
          format: double
          nullable: true
        tipoIcmsSt:
          $ref: "#/components/schemas/TipoIcmsStEmissorModelEnum"
        tipoEstabelecimento:
          $ref: "#/components/schemas/TipoEstabelecimentoEmissorModelEnum"
        telefone:
          maxLength: 14
          minLength: 6
          type: string
          description: Telefone de contato.
          nullable: true
        inscricaoMunicipal:
          maxLength: 15
          type: string
          description: Inscrição municipal do emissor.
          nullable: true
        cnae:
          maxLength: 7
          type: string
          description: Código CNAE principal.
          nullable: true
        cnaeSecundario:
          maxLength: 7
          type: string
          description: Código CNAE secundário.
          nullable: true
        endereco:
          $ref: "#/components/schemas/EnderecoEmissorInputModel"
        inscricoesEstaduais:
          type: array
          items:
            $ref: "#/components/schemas/InscricaoEstadualEmissorInputModel"
          description: Lista de inscrições estaduais do emissor.
          nullable: true
      additionalProperties: false
      description: Informações para atualizar os dados do emissor.
    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
    RegimeTributarioModelEnum:
      enum:
        - Mei
        - SimplesNacional
        - SimplesNacionalExcessoReceita
        - LucroPresumido
        - LucroReal
      type: string
      description: Regime tributário do emissor.
    TipoIcmsStEmissorModelEnum:
      enum:
        - Substituta
        - Substituida
      type: string
      description: Tipo de ICMS ST do emissor.
    TipoEstabelecimentoEmissorModelEnum:
      enum:
        - Outros
        - IndustriaOuEquiparado
      type: string
      description: Tipo de estabelecimento do emissor quanto ao IPI.
    EnderecoEmissorInputModel:
      required:
        - bairro
        - cep
        - codigoMunicipio
        - logradouro
        - municipio
        - numero
      type: object
      properties:
        logradouro:
          maxLength: 60
          minLength: 3
          type: string
          description: Logradouro.
        numero:
          maxLength: 60
          minLength: 1
          type: string
          description: Número.
        complemento:
          maxLength: 255
          type: string
          description: Complemento.
          nullable: true
        bairro:
          maxLength: 60
          minLength: 3
          type: string
          description: Bairro.
        codigoMunicipio:
          maxLength: 7
          minLength: 7
          type: string
          description: Código IBGE do município.
        municipio:
          maxLength: 60
          minLength: 3
          type: string
          description: Nome do município.
        uf:
          $ref: "#/components/schemas/UfModelEnum"
        cep:
          minLength: 1
          type: string
          description: CEP.
      additionalProperties: false
      description: Dados do emissor.
    InscricaoEstadualEmissorInputModel:
      required:
        - endereco
        - inscricaoEstadual
        - nome
      type: object
      properties:
        inscricaoEstadual:
          maxLength: 14
          minLength: 3
          type: string
          description: Número da Inscrição Estadual do emissor.
        nome:
          maxLength: 60
          minLength: 3
          type: string
          description: Nome na inscrição estadual.
        endereco:
          $ref: "#/components/schemas/EnderecoEmissorInputModel"
      additionalProperties: false
      description: Dados da inscrição estadual e identificação do emissor.
    UfModelEnum:
      enum:
        - RO
        - AC
        - AM
        - RR
        - PA
        - AP
        - TO
        - MA
        - PI
        - CE
        - RN
        - PB
        - PE
        - AL
        - SE
        - BA
        - MG
        - ES
        - RJ
        - SP
        - PR
        - SC
        - RS
        - MS
        - MT
        - GO
        - DF
      type: string
      description: Lista de Unidades Federativas.
  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
```