← HomeFleetPay / API

Register or update Mandatory Cargo Insurance (RCTR-C / RC-DC) policy

Parameters, data structure and responses from the versioned contract.

POST/seguro-carga/apolices
cadastrarAtualizarApoliceSeguroCargaSandbox Base: https://api.fleetpay.site/v1

Technical descriptions are translated from the versioned contract. Original identifiers and JSON are preserved; data examples are omitted.

Registers or updates a Mandatory Cargo Insurance policy (RCTR-C and RC-DC — Law 14.599/2023; not credit insurance) with an optional link to the AT&M credential.

Authentication

Required Scope
operacao — Operations
Module
Mandatory Cargo Insurance (RCTR-C / RC-DC)
Target Profiles
Transport Manager · Dedicated Fleet Contractor · Shipper · Fleet Carrier
Schemes
OAuth2 client_credentials (POST /oauth/token) or API Key via Authorization: Bearer / X-Api-Key
[
  {
    "oauth2": []
  },
  {
    "chaveApi": []
  }
]
Availability depends on the environment, enabled scopes and provider. This reference does not execute requests or collect credentials.

Parameters

No parameters declared for this operation.

Request Body

Required

Mandatory Cargo Insurance (RCTR-C / RC-DC) policy data.

application/json

policy_modelstringOptional
"provider_own" · "fleetpay_managed"
policy_typestringOptional

Insurance line of business (e.g. rctrc, rcdc).

policy_numberstringRequired
insurer_namestringRequired
insurer_cnpjstringRequired

14-digit insurer CNPJ.

atm_credential_idinteger | nullOptional

Responses

200 HTTP Response

Operation processed successfully.

application/json

data—Optional
metaobject | nullOptional
additionalPropertiestrue
ambientestringOptional
"homologacao" · "producao"
401 HTTP Response

Missing, invalid or cross-environment credential.

403 HTTP Response

Dashboard scope not enabled or resource outside company scope.

422 HTTP Response

Invalid required policy fields.

Complete Operation Definition
{
  "tags": [
    "Seguro de Carga"
  ],
  "operationId": "cadastrarAtualizarApoliceSeguroCarga",
  "summary": "Cadastrar ou atualizar apólice de Seguro Obrigatório de Carga (RCTR-C / RC-DC)",
  "description": "Registra ou atualiza apólice de Seguro Obrigatório de Carga (RCTR-C e RC-DC — Lei 14.599/2023; não se trata de seguro de crédito) com vínculo opcional à credencial AT&M.",
  "requestBody": {
    "required": true,
    "description": "Dados da apólice de Seguro Obrigatório de Carga (RCTR-C / RC-DC).",
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "policy_number",
            "insurer_name",
            "insurer_cnpj"
          ],
          "properties": {
            "policy_model": {
              "type": "string",
              "enum": [
                "provider_own",
                "fleetpay_managed"
              ]
            },
            "policy_type": {
              "type": "string",
              "description": "Ramo da apólice (ex: rctrc, rcdc)."
            },
            "policy_number": {
              "type": "string"
            },
            "insurer_name": {
              "type": "string"
            },
            "insurer_cnpj": {
              "type": "string",
              "description": "CNPJ da seguradora com 14 dígitos."
            },
            "atm_credential_id": {
              "type": [
                "integer",
                "null"
              ]
            }
          }
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Operação processada com sucesso.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "data": {
                "anyOf": [
                  {
                    "type": "object",
                    "additionalProperties": true
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "additionalProperties": true
                    }
                  }
                ]
              },
              "meta": {
                "type": [
                  "object",
                  "null"
                ],
                "additionalProperties": true
              },
              "ambiente": {
                "type": "string",
                "enum": [
                  "homologacao",
                  "producao"
                ]
              }
            }
          }
        }
      }
    },
    "401": {
      "description": "Credencial ausente, inválida ou de outro ambiente."
    },
    "403": {
      "description": "Escopo do painel não habilitado ou recurso fora do escopo da company."
    },
    "422": {
      "description": "Dados obrigatórios da apólice inválidos."
    }
  },
  "x-fleetpay-scope": "operacao",
  "x-fleetpay-module": "seguro-carga",
  "x-fleetpay-profiles": [
    "gestor",
    "agregado_empresarial",
    "embarcador",
    "transportador_frotista"
  ],
  "method": "POST",
  "path": "/seguro-carga/apolices",
  "parameters": []
}