---
title: "EmitirNfeDevolucaoInputModel"
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/schemas/EmitirNfeDevolucaoInputModel"
---

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

# EmitirNfeDevolucaoInputModel

Dados da nota fiscal de devolução.

## 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
components:
  schemas:
    ModeloNotaFiscalModelEnum:
      enum:
        - Nfe
        - Nfce
      type: string
      description: Modelo de nota fiscal.
    TipoEmissaoNfeModelEnum:
      enum:
        - Automatica
        - Normal
        - ContingenciaFsda
        - ContingenciaSvcan
        - ContingenciaSvcrs
      type: string
      description: Tipo de emissão de NFe.
    EmitirNfeDevolucaoDestinatarioInputModel:
      required:
        - documento
        - endereco
        - nome
      type: object
      properties:
        tipoDocumento:
          $ref: "#/components/schemas/TipoDocumentoNotaFiscalModelEnum"
        documento:
          minLength: 1
          type: string
          description: Documento do destinatário.
        nome:
          maxLength: 60
          minLength: 2
          type: string
          description: Nome do destinatário.
        endereco:
          $ref: "#/components/schemas/EmitirNfeDevolucaoEnderecoInputModel"
        telefone:
          type: string
          description: Telefone do destinatário.
          nullable: true
        inscricaoEstadual:
          type: string
          description: Inscrição estadual do destinatário.
          nullable: true
        inscricaoSuframa:
          type: string
          description: Inscrição SUFRAMA.
          nullable: true
        inscricaoMunicipal:
          type: string
          description: Inscrição municipal.
          nullable: true
        email:
          type: string
          description: Email do destinatário.
          nullable: true
      additionalProperties: false
      description: Dados do destinatário em nota fiscal de devolução.
    NfeAuxXmlInputModel:
      required:
        - documento
      type: object
      properties:
        tipoDocumento:
          $ref: "#/components/schemas/TipoDocumentoNotaFiscalModelEnum"
        documento:
          minLength: 1
          type: string
          description: Documento autorizado.
      additionalProperties: false
      description: Documentos autorizados a capturar e visualizar a NFe.
    EmitirNfeDevolucaoDetalheItemInputModel:
      required:
        - item
        - quantidadeDevolvida
      type: object
      properties:
        item:
          minimum: 0
          exclusiveMinimum: true
          type: integer
          description: Número da sequência do item na nota.
          format: int32
        quantidadeDevolvida:
          minimum: 0
          exclusiveMinimum: true
          type: number
          description: Quantidade de itens a serem devolvidos.
          format: double
        rastros:
          type: array
          items:
            $ref: "#/components/schemas/EmitirNfeDevolucaoDetalheItemRastroInputModel"
          description: Informações de rastro do item.
          nullable: true
      additionalProperties: false
      description: Dados de devolução do item da nota.
    TipoDocumentoNotaFiscalModelEnum:
      enum:
        - Cpf
        - Cnpj
        - IdEstrangeiro
      type: string
      description: Tipo de documento.
    EmitirNfeDevolucaoEnderecoInputModel:
      required:
        - bairro
        - cep
        - codigoMunicipio
        - logradouro
        - nomeMunicipio
        - numero
      type: object
      properties:
        logradouro:
          maxLength: 60
          minLength: 2
          type: string
          description: Logradouro.
        numero:
          maxLength: 60
          minLength: 1
          type: string
          description: Número.
        complemento:
          type: string
          description: Complemento.
          nullable: true
        bairro:
          maxLength: 60
          minLength: 1
          type: string
          description: Bairro.
        codigoMunicipio:
          maxLength: 7
          minLength: 7
          type: string
          description: Código do município.
        nomeMunicipio:
          maxLength: 60
          minLength: 2
          type: string
          description: Nome do município.
        uf:
          $ref: "#/components/schemas/UfExtNotaFiscalModelEnum"
        cep:
          minLength: 1
          type: string
          description: CEP.
        codigoPais:
          type: string
          description: Código do país.
          nullable: true
        pais:
          type: string
          description: Nome do país.
          nullable: true
      additionalProperties: false
      description: Dados do endereço do destinatário nas notas de devolução.
    EmitirNfeDevolucaoDetalheItemRastroInputModel:
      required:
        - dataFabricacao
        - dataValidade
        - numeroLote
      type: object
      properties:
        numeroLote:
          maxLength: 20
          minLength: 1
          type: string
          description: Número do lote do produto.
        quantidadeLote:
          minimum: 0
          exclusiveMinimum: true
          type: number
          description: Quantidade do lote.
          format: double
        dataFabricacao:
          minLength: 1
          type: string
          description: Data de fabricação do lote.
          format: date-time
        dataValidade:
          minLength: 1
          type: string
          description: Data de validade do lote.
          format: date-time
      additionalProperties: false
      description: Dados de rastreabilidade do item da NFe .
    UfExtNotaFiscalModelEnum:
      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
        - EX
      type: string
      description: Lista de Unidades Federativas para Nota Fiscal incluíndo exterior.
    EmitirNfeDevolucaoInputModel:
      required:
        - identificadorDocumentoFiscalDevolvido
      type: object
      properties:
        codigoErp:
          type: string
          description: Identificador da operação fiscal no ERP.
          nullable: true
        serie:
          type: string
          description: Série do documento fiscal (Informar somente se estiver configurado
            para geração numérica manual).
          nullable: true
        numeroDocumento:
          type: integer
          description: Numero do documento fiscal (Informar somente se estiver configurado
            para geração numérica manual).
          format: int64
          nullable: true
        modeloDocumentoFiscalDevolvido:
          $ref: "#/components/schemas/ModeloNotaFiscalModelEnum"
        identificadorDocumentoFiscalDevolvido:
          minLength: 1
          type: string
          description: Identificador da nota fiscal a ser devolvida - Chave de acesso ou
            Código ERP.
        tipoEmissao:
          $ref: "#/components/schemas/TipoEmissaoNfeModelEnum"
        destinatario:
          $ref: "#/components/schemas/EmitirNfeDevolucaoDestinatarioInputModel"
        autXml:
          type: array
          items:
            $ref: "#/components/schemas/NfeAuxXmlInputModel"
          description: Documentos autorizados a visualizar a NFe.
          nullable: true
        itensDevolvidos:
          type: array
          items:
            $ref: "#/components/schemas/EmitirNfeDevolucaoDetalheItemInputModel"
          description: Lista de itens devolvidos (Informar nulo para devolução completa da
            nota).
          nullable: true
      additionalProperties: false
      description: Dados da nota fiscal de devolução.
```