contratanteobjectObligatorio← InicioFleetPay / API
Autorizar a un contratante a emitir en tu nombre
Parámetros, estructura de datos y respuestas del contrato versionado.
POST
/fiscal/cte-subcontratacao/autorizacoesLas descripciones técnicas se traducen del contrato versionado. Se conservan los identificadores y el JSON originales; se omiten los ejemplos de datos.
Quien llama es la subcontratada, titular del certificado. Autoriza al contratante indicado en el cuerpo a llamar POST /fiscal/cte-subcontratacao/lote con subcontratada.cnpj igual a su CNPJ. El lote se crea en la cuenta de la subcontratada, con su certificado, numeración, bandeja fiscal, conductor y vehículo; el contratante queda registrado como solicitante. El contratante debe ser una transportista cliente de FleetPay. Idempotente: ya activa → 200.
Autenticación
[
{
"oauth2": []
},
{
"chaveApi": []
}
]La disponibilidad depende del entorno, los permisos habilitados y el proveedor. Esta referencia no ejecuta solicitudes ni recibe credenciales.
Parámetros
No hay parámetros declarados para esta operación.
Cuerpo de la Solicitud
Obligatorio
application/json
Respuestas
200 Respuesta HTTP
Ya estaba autorizada (mismo cuerpo que 201).
201 Respuesta HTTP
Autorización concedida.
application/json
Headers
X-Request-IdIdentificador de correlación de la llamada.
403 Respuesta HTTP
Ámbito fiscal deshabilitado en la clave, o clave sin transportista activo.
Headers
X-Request-IdIdentificador de correlación de la llamada.
404 Respuesta HTTP
contratante_nao_encontrada — el CNPJ no pertenece a una transportista cliente.
422 Respuesta HTTP
contratante_invalida — el CNPJ de la propia empresa, o un error de validación del cuerpo.
429 Respuesta HTTP
Límite por transportista excedido.
Headers
X-Request-IdIdentificador de correlación de la llamada.
Retry-AfterSegundos hasta un nuevo intento.
500 Respuesta HTTP
Fallo interno sin detalles de las integraciones operativas.
Headers
X-Request-IdIdentificador de correlación de la llamada.
Definición Completa de la Operación
{
"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": []
}