---
title: "CFOPs - Listar."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-RecursosAdicionais-Cfop-Listar/get"
---

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

# CFOPs - Listar.

`GET` `/api/v1/RecursosAdicionais/Cfop/Listar`

Fornece uma listagem completa dos <strong>Códigos Fiscais de Operações e Prestações (CFOP)</strong>. Este recurso é fundamental para determinar a natureza da circulação de mercadorias ou a prestação de serviços. ⚠️ **ATENÇÃO**: A escolha incorreta do CFOP pode impactar diretamente na apuração de impostos e na validação da nota fiscal pela SEFAZ. Utilize os filtros para restringir a busca ao cenário de negócio desejado. 🔍 **DICA DE INTEGRAÇÃO**: Recomenda-se o cache dessas informações no sistema local, realizando consultas periódicas para capturar novos códigos ou alterações em indicadores de faturamento e devolução.

## Query parameters

- `codigoCfop` (string, optional) - Filtrar pelo código numérico do CFOP.
- `busca` (string, optional) - Filtrar por campo de busca genérico.
- `tipoOperacao` (string, optional) - Filtrar pelo tipo de operação (Entrada/Saída).
- `tipoDestino` (string, optional) - Filtrar pelo tipo de destino.
- `tipoIcms` (string, optional) - Filtrar pelo tipo de incidência do ICMS.
- `tipoDestinatario` (string, optional) - Filtrar pelo tipo de destinatário.
- `permiteNfe` (boolean, optional) - Filtrar se permite emissão de NFe.
- `indicaComunicacao` (boolean, optional) - Filtrar se indica serviços de comunicação.
- `indicaTransporte` (boolean, optional) - Filtrar se indica serviços de transporte.
- `indicaDevolucao` (boolean, optional) - Filtrar se caracteriza devolução.
- `indicaCombustivel` (boolean, optional) - Filtrar se envolve combustíveis.
- `compoeFaturamento` (boolean, optional) - Filtrar se compõe faturamento.
- `offset` (integer, int32, optional) - Quantidade de registros a serem pulados.
- `limit` (integer, int32, optional) - Limite máximo de registros por página.

## Header parameters

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

## 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/RecursosAdicionais/Cfop/Listar:
    get:
      tags:
        - RecursosAdicionais
      summary: CFOPs - Listar.
      description: >-
        Fornece uma listagem completa dos <strong>Códigos Fiscais de Operações e
        Prestações (CFOP)</strong>. Este recurso é fundamental para determinar a
        natureza da circulação de mercadorias ou a prestação de serviços.


        ⚠️ **ATENÇÃO**: A escolha incorreta do CFOP pode impactar diretamente na
        apuração de impostos e na validação da nota fiscal pela SEFAZ. Utilize
        os filtros para restringir a busca ao cenário de negócio desejado.


        🔍 **DICA DE INTEGRAÇÃO**: Recomenda-se o cache dessas informações no
        sistema local, realizando consultas periódicas para capturar novos
        códigos ou alterações em indicadores de faturamento e devolução.
      parameters:
        - name: codigoCfop
          in: query
          description: Filtrar pelo código numérico do CFOP.
          schema:
            type: string
        - name: busca
          in: query
          description: Filtrar por campo de busca genérico.
          schema:
            type: string
        - name: tipoOperacao
          in: query
          description: Filtrar pelo tipo de operação (Entrada/Saída).
          schema:
            $ref: "#/components/schemas/TipoOperacaoCfopModelEnum"
        - name: tipoDestino
          in: query
          description: Filtrar pelo tipo de destino.
          schema:
            $ref: "#/components/schemas/TipoDestinoCfopModelEnum"
        - name: tipoIcms
          in: query
          description: Filtrar pelo tipo de incidência do ICMS.
          schema:
            $ref: "#/components/schemas/TipoIcmsCfopModelEnum"
        - name: tipoDestinatario
          in: query
          description: Filtrar pelo tipo de destinatário.
          schema:
            $ref: "#/components/schemas/TipoDestinatarioCfopModelEnum"
        - name: permiteNfe
          in: query
          description: Filtrar se permite emissão de NFe.
          schema:
            type: boolean
        - name: indicaComunicacao
          in: query
          description: Filtrar se indica serviços de comunicação.
          schema:
            type: boolean
        - name: indicaTransporte
          in: query
          description: Filtrar se indica serviços de transporte.
          schema:
            type: boolean
        - name: indicaDevolucao
          in: query
          description: Filtrar se caracteriza devolução.
          schema:
            type: boolean
        - name: indicaCombustivel
          in: query
          description: Filtrar se envolve combustíveis.
          schema:
            type: boolean
        - name: compoeFaturamento
          in: query
          description: Filtrar se compõe faturamento.
          schema:
            type: boolean
        - name: offset
          in: query
          description: Quantidade de registros a serem pulados.
          schema:
            type: integer
            format: int32
            default: 1
        - name: limit
          in: query
          description: Limite máximo de registros por página.
          schema:
            type: integer
            format: int32
            default: 10
        - name: DocumentoEmissor
          in: header
          description: Documento do emissor.
          schema:
            type: string
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/ListarCfopsViewModelListPaginationResponse"
            application/json:
              schema:
                $ref: "#/components/schemas/ListarCfopsViewModelListPaginationResponse"
            text/json:
              schema:
                $ref: "#/components/schemas/ListarCfopsViewModelListPaginationResponse"
        "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:
    TipoOperacaoCfopModelEnum:
      enum:
        - Entrada
        - Saida
      type: string
      description: Tipo de operação do CFOP.
    TipoDestinoCfopModelEnum:
      enum:
        - Estadual
        - Interestadual
        - Exterior
      type: string
      description: Tipo de destino do CFOP.
    TipoIcmsCfopModelEnum:
      enum:
        - IcmsTributado
        - IcmsRetido
        - Ambos
      type: string
      description: Tipo de ICMS do CFOP.
    TipoDestinatarioCfopModelEnum:
      enum:
        - NaoContribuinte
        - Ambos
      type: string
      description: Tipo de destinatário do CFOP.
    ListarCfopsViewModelListPaginationResponse:
      type: object
      properties:
        offset:
          type: integer
          format: int32
        limit:
          type: integer
          format: int32
        total:
          type: integer
          format: int32
        data:
          type: array
          items:
            $ref: "#/components/schemas/ListarCfopsViewModel"
          nullable: true
      additionalProperties: false
    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
    ListarCfopsViewModel:
      type: object
      properties:
        codigoCfop:
          type: string
          description: Código numérico do CFOP.
          nullable: true
        descricao:
          type: string
          description: Descrição detalhada da operação fiscal.
          nullable: true
        tipoOperacao:
          $ref: "#/components/schemas/TipoOperacaoCfopModelEnum"
        tipoDestino:
          $ref: "#/components/schemas/TipoDestinoCfopModelEnum"
        tipoIcms:
          $ref: "#/components/schemas/TipoIcmsCfopModelEnum"
        tipoDestinatario:
          $ref: "#/components/schemas/TipoDestinatarioCfopModelEnum"
        permiteNfe:
          type: boolean
          description: Indica se o CFOP permite a emissão de Nota Fiscal Eletrônica.
        indicaComunicacao:
          type: boolean
          description: Indica se a operação é relativa a serviços de comunicação.
        indicaTransporte:
          type: boolean
          description: Indica se a operação é relativa a serviços de transporte.
        indicaDevolucao:
          type: boolean
          description: Indica se a operação é de devolução de mercadoria.
        indicaCombustivel:
          type: boolean
          description: Indica se a operação envolve combustíveis ou lubrificantes.
        compoeFaturamento:
          type: boolean
          description: Indica se o valor da operação compõe o faturamento da empresa.
      additionalProperties: false
      description: Dados para listagem de CFOPs (Código Fiscal de Operações e de
        Prestações).
  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
```