Autorizar uma contratante a emitir contra-CT-e em seu nome

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

POST/fiscal/cte-subcontratacao/autorizacoes

grantEmissionBase 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.

Quem chama é a subcontratada (a dona do certificado): ela autoriza a contratante do corpo a disparar POST /fiscal/cte-subcontratacao/lote com subcontratada.cnpj = o CNPJ dela. O lote nasce na conta da subcontratada — certificado, numeração, caixa fiscal, motorista e veículo dela — e a contratante fica registrada como quem pediu. A contratante precisa ser transportadora cliente da FleetPay. Idempotente: já ativa → 200.

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

Nenhum parâmetro declarado nesta operação.

Corpo da Requisição

Obrigatório

`application/json`

contratanteobjectObrigatório

Respostas

200 Resposta HTTP

Já estava autorizada (mesmo corpo do 201).

201 Resposta HTTP

Autorização concedida.

`application/json`

Headers

X-Request-Id

Identificador de correlação da chamada.

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

contratante_nao_encontrada — o CNPJ não é de uma transportadora cliente.

422 Resposta HTTP

contratante_invalida — o próprio CNPJ; ou erro de validação do corpo.

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": "Autorizar uma contratante a emitir contra-CT-e em seu nome",
  "operationId": "grantEmission",
  "description": "Quem chama é a **subcontratada** (a dona do certificado): ela autoriza a contratante do corpo\na disparar `POST /fiscal/cte-subcontratacao/lote` com `subcontratada.cnpj` = o CNPJ dela. O\nlote nasce na conta da subcontratada — certificado, numeração, caixa fiscal, motorista e\nveículo dela — e a contratante fica registrada como quem pediu. A contratante precisa ser\ntransportadora cliente da FleetPay. Idempotente: já ativa → `200`.\n",
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "contratante"
          ],
          "properties": {
            "contratante": {
              "type": "object",
              "required": [
                "cnpj"
              ],
              "properties": {
                "cnpj": {
                  "type": "string",
                  "description": "CNPJ da contratante (com ou sem pontuação)."
                }
              }
            }
          }
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Já estava autorizada (mesmo corpo do `201`)."
    },
    "201": {
      "description": "Autorização concedida.",
      "headers": {
        "X-Request-Id": {
          "$ref": "#/components/headers/RequestId"
        }
      },
      "content": {
        "application/json": {}
      }
    },
    "403": {
      "$ref": "#/components/responses/Forbidden"
    },
    "404": {
      "description": "`contratante_nao_encontrada` — o CNPJ não é de uma transportadora cliente."
    },
    "422": {
      "description": "`contratante_invalida` — o próprio CNPJ; ou erro de validação do corpo."
    },
    "429": {
      "$ref": "#/components/responses/RateLimited"
    },
    "500": {
      "$ref": "#/components/responses/InternalError"
    }
  },
  "method": "POST",
  "path": "/fiscal/cte-subcontratacao/autorizacoes",
  "parameters": []
}