Revogar a autorização de uma contratante

Parâmetros, estrutura de dados e respostas do contrato versionado.

DELETE/fiscal/cte-subcontratacao/autorizacoes/{cnpj}

revokeEmissionGrantBase de Homologação: https://api.fleetpay.site/v1

Descrições técnicas preservadas do contrato versionado. Exemplos de dados foram omitidos da cópia pública.

Fecha a porta na hora: o próximo lote da contratante com subcontratada.cnpj responde 403 emissao_nao_autorizada. Lotes já criados não mudam. A linha revogada fica para auditoria.

Autenticação

[
  {
    "oauth2": []
  },
  {
    "chaveApi": []
  }
]

A disponibilidade depende do ambiente, dos escopos habilitados e do provedor. Esta referência não executa chamadas nem recebe credenciais.

Parâmetros

cnpjpath · stringObrigatório

CNPJ da contratante (com ou sem pontuação).

Restrições

{
  "type": "string"
}

Respostas

200 Resposta HTTP

Autorização revogada.

`application/json`

403 Resposta HTTP

Escopo fiscal desabilitado na chave, ou chave sem transportadora ativa.

`application/json`

ErrorEnvelope ↗

errorobjectObrigatório

ErrorBody ↗

Headers

X-Request-Id

Identificador de correlação da chamada.

404 Resposta HTTP

autorizacao_nao_encontrada — não há autorização ativa para essa contratante.

429 Resposta HTTP

Limite por transportadora excedido.

`application/json`

ErrorEnvelope ↗

errorobjectObrigatório

ErrorBody ↗

Headers

X-Request-Id

Identificador de correlação da chamada.

Retry-After

Segundos até uma nova tentativa.

500 Resposta HTTP

Falha interna sem detalhes de integrações operacionais.

`application/json`

ErrorEnvelope ↗

errorobjectObrigatório

ErrorBody ↗

Headers

X-Request-Id

Identificador de correlação da chamada.

Definição Completa da Operação

{
  "tags": [
    "CT-e de subcontratação"
  ],
  "summary": "Revogar a autorização de uma contratante",
  "operationId": "revokeEmissionGrant",
  "description": "Fecha a porta na hora: o próximo lote da contratante com `subcontratada.cnpj` responde\n`403 emissao_nao_autorizada`. Lotes já criados não mudam. A linha revogada fica para auditoria.\n",
  "parameters": [
    {
      "name": "cnpj",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string"
      },
      "description": "CNPJ da contratante (com ou sem pontuação)."
    }
  ],
  "responses": {
    "200": {
      "description": "Autorização revogada.",
      "content": {
        "application/json": {}
      }
    },
    "403": {
      "$ref": "#/components/responses/Forbidden"
    },
    "404": {
      "description": "`autorizacao_nao_encontrada` — não há autorização ativa para essa contratante."
    },
    "429": {
      "$ref": "#/components/responses/RateLimited"
    },
    "500": {
      "$ref": "#/components/responses/InternalError"
    }
  },
  "method": "DELETE",
  "path": "/fiscal/cte-subcontratacao/autorizacoes/{cnpj}"
}