---
title: "DANFE NFCe (PDF)."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-Nfce-filtro--ObterDanfe--tipoDanfe---formato/get"
---

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

# DANFE NFCe (PDF).

`GET` `/api/v1/Nfce/{filtro}/ObterDanfe/{tipoDanfe}/{formato}`

Recupera a representação gráfica da NFCe, conhecida como <strong>DANFE (Documento Auxiliar da Nota Fiscal Eletrônica)</strong>. 📄 **FORMATO DE SAÍDA**: O recurso retorna o arquivo em formato <strong>PDF</strong>, codificado em <strong>Base64</strong>. Para a visualização, o sistema consumidor deve realizar o decode da string e salvar o binário com a extensão `.pdf`. ⚖️ **VALIDADE JURÍDICA**: O DANFE é apenas um documento auxiliar para facilitar a consulta e o transporte das mercadorias. Ele não substitui o arquivo <strong>XML</strong>, que é o documento fiscal eletrônico de existência apenas digital e valor jurídico real. 🧪 **TESTE**: Em ambiente de sandbox, o DANFE gerado conterá a marca d'água "SEM VALOR FISCAL - AMBIENTE DE HOMOLOGAÇÃO", conforme exigência da SEFAZ para testes. 🔍 **DISPONIBILIDADE**: O documento só poderá ser gerado para chaves de acesso que possuam o status de <strong>Autorizada</strong> ou <strong>Cancelada</strong> na base de dados.

## Path parameters

- `tipoDanfe` (string, required) - Tipo de danfe para NFCe.
- `formato` (string, required) - Formato do danfe.
- `filtro` (string, required) - Chave de acesso da nota fiscal (44 dígitos) ou Código ERP.

## Header parameters

- `DocumentoEmissor` (string, required) - Documento do emissor.

## Responses

- `200` - OK
- `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/Nfce/{filtro}/ObterDanfe/{tipoDanfe}/{formato}:
    get:
      tags:
        - Nfce
      summary: DANFE NFCe (PDF).
      description: >-
        Recupera a representação gráfica da NFCe, conhecida como <strong>DANFE
        (Documento Auxiliar da Nota Fiscal Eletrônica)</strong>. 


        📄 **FORMATO DE SAÍDA**: O recurso retorna o arquivo em formato
        <strong>PDF</strong>, codificado em <strong>Base64</strong>. Para a
        visualização, o sistema consumidor deve realizar o decode da string e
        salvar o binário com a extensão `.pdf`.


        ⚖️ **VALIDADE JURÍDICA**: O DANFE é apenas um documento auxiliar para
        facilitar a consulta e o transporte das mercadorias. Ele não substitui o
        arquivo <strong>XML</strong>, que é o documento fiscal eletrônico de
        existência apenas digital e valor jurídico real.


        🧪 **TESTE**: Em ambiente de sandbox, o DANFE gerado conterá a marca
        d'água "SEM VALOR FISCAL - AMBIENTE DE HOMOLOGAÇÃO", conforme exigência
        da SEFAZ para testes.


        🔍 **DISPONIBILIDADE**: O documento só poderá ser gerado para chaves de
        acesso que possuam o status de <strong>Autorizada</strong> ou
        <strong>Cancelada</strong> na base de dados.
      parameters:
        - name: tipoDanfe
          in: path
          description: Tipo de danfe para NFCe.
          required: true
          schema:
            $ref: "#/components/schemas/TipoDanfeNfceModelEnum"
        - name: formato
          in: path
          description: Formato do danfe.
          required: true
          schema:
            $ref: "#/components/schemas/FormatoDanfeModelEnum"
        - name: filtro
          in: path
          description: Chave de acesso da nota fiscal (44 dígitos) ou Código ERP.
          required: true
          schema:
            type: string
        - name: DocumentoEmissor
          in: header
          description: Documento do emissor.
          required: true
          schema:
            type: string
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                type: string
            application/json:
              schema:
                type: string
            text/json:
              schema:
                type: string
        "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:
    TipoDanfeNfceModelEnum:
      enum:
        - Danfe56mm
        - Danfe80mm
      type: string
      description: Tipo de danfe para NFCe.
    FormatoDanfeModelEnum:
      enum:
        - Html
        - Pdf
      type: string
      description: Formato do DANFE
    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
```