> ## Documentation Index
> Fetch the complete documentation index at: https://docs.machine.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Excluir tarifa da categoria

> Encerra uma **tarifa extra** da categoria: ela deixa de valer na hora e sai da listagem. A tarifa padrão não pode ser excluída, apenas editada.

| Status | Quando |
|---|---|
| 401 | Gestor não autenticado no header `Authorization` (Basic) |
| 403 | Gestor sem a permissão de API de categoria (`api_integracao_categoria`) no cargo da bandeira |
| 404 | Categoria ou tarifa inexistente, ou de outra bandeira |
| 409 | Tarifa padrão, ou tarifa já encerrada (excluída ou substituída por nova versão) |

Requer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo da bandeira com a permissão de API de categoria (`api_integracao_categoria`) no cargo; sem ela, responde 403.



## OpenAPI

````yaml pages/v2/openapi-corridas.json DELETE /configuracoes/categorias/{id}/tarifas/{tarifaId}
openapi: 3.1.0
info:
  title: API de Integração
  description: API de Integração v2 - Corridas
  license:
    name: MIT
  version: 2.0.0
servers:
  - url: https://api-vendas.taximachine.com.br/api/v2/integracao
  - url: https://api.taximachine.com.br/api/v2/integracao
security:
  - basicAuth: []
    ApiKeyAuth: []
paths:
  /configuracoes/categorias/{id}/tarifas/{tarifaId}:
    delete:
      summary: Excluir tarifa da categoria
      description: >-
        Encerra uma **tarifa extra** da categoria: ela deixa de valer na hora e
        sai da listagem. A tarifa padrão não pode ser excluída, apenas editada.


        | Status | Quando |

        |---|---|

        | 401 | Gestor não autenticado no header `Authorization` (Basic) |

        | 403 | Gestor sem a permissão de API de categoria
        (`api_integracao_categoria`) no cargo da bandeira |

        | 404 | Categoria ou tarifa inexistente, ou de outra bandeira |

        | 409 | Tarifa padrão, ou tarifa já encerrada (excluída ou substituída
        por nova versão) |


        Requer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo
        da bandeira com a permissão de API de categoria
        (`api_integracao_categoria`) no cargo; sem ela, responde 403.
      parameters:
        - name: id
          in: path
          required: true
          description: Id da categoria. Deve pertencer à central autenticada.
          schema:
            type: integer
        - name: tarifaId
          in: path
          required: true
          description: Id da tarifa. Deve ser uma tarifa vigente da categoria `id`.
          schema:
            type: integer
      responses:
        '200':
          description: Tarifa encerrada
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      id:
                        type: integer
                        description: Id da tarifa encerrada.
              example:
                success: true
                data:
                  id: 4822
        '401':
          description: Gestor não autenticado (Authorization Basic ausente ou inválido).
          content:
            application/json:
              schema:
                type: object
              example:
                success: false
                errors:
                  - code: B5
                    message: Usuário e/ou senhas inválidos.
        '403':
          description: >-
            Gestor sem a permissão de API de categoria
            (api_integracao_categoria).
          content:
            application/json:
              schema:
                type: object
              example:
                success: false
                errors:
                  - code: 68
                    message: >-
                      O usuário informado não tem permissão para realizar essa
                      operação.
        '404':
          description: Categoria ou tarifa não encontrada
          content:
            application/json:
              schema:
                type: object
              examples:
                categoria:
                  summary: Categoria inexistente ou de outra bandeira
                  value:
                    success: false
                    errors:
                      - code: 0
                        message: Categoria informada não existe.
                tarifa:
                  summary: Tarifa inexistente ou de outra categoria
                  value:
                    success: false
                    errors:
                      - code: 0
                        message: Tarifa não encontrada na categoria informada.
        '409':
          description: Tarifa padrão ou já encerrada
          content:
            application/json:
              schema:
                type: object
              examples:
                padrao_nao_excluivel:
                  summary: Tarifa padrão
                  value:
                    success: false
                    errors:
                      - code: 0
                        message: A tarifa padrão não pode ser excluída, apenas editada.
                tarifa_encerrada:
                  summary: Tarifa já encerrada
                  value:
                    success: false
                    errors:
                      - code: 0
                        message: >-
                          A tarifa foi encerrada ou substituída por uma nova
                          versão. Consulte as tarifas vigentes da categoria.
        '500':
          description: Erro interno
          content:
            application/json:
              schema:
                type: object
              example:
                success: false
                errors:
                  - code: 0
                    message: Falha na operação
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api-key
      description: Obrigatório. Sua chave API.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.