← InícioFleetPay / API

Liberar parcelas em lote por batch de contra-CT-e

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

POST/carriers/parcelas-repasse/liberar-por-lote
liberarParcelasPorLoteContraCteBase 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.

Libera uma posição de parcela para todos os contra-CT-e autorizados pertencentes a um lote de subcontratação (batch_id). Uso exclusivo de transportador frotista sob escopo operacao.

Autenticação

Escopo Necessário
operacao — Operação
Módulo
Subcontratação
Perfis Aplicáveis
Transportador Frotista
Mecanismos
OAuth2 client_credentials (POST /oauth/token) ou API Key em Authorization: Bearer / X-Api-Key
[
  {
    "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

Identificador do lote de contra-CT-e e posição da parcela.

application/json

batch_idstringObrigatório

UUID ou ID do lote de contra-CT-e.

posicaointegerObrigatório

Número da parcela a liberar.

Respostas

200 Resposta HTTP

Operação processada com sucesso.

application/json

data—Opcional
metaobject | nullOpcional
additionalPropertiestrue
ambientestringOpcional
"homologacao" · "producao"
401 Resposta HTTP

Credencial ausente, inválida ou de outro ambiente.

403 Resposta HTTP

Escopo do painel não habilitado ou recurso fora do escopo da company.

422 Resposta HTTP

Lote sem parcelas elegíveis para liberação.

Definição Completa da Operação
{
  "tags": [
    "CT-e de subcontratação",
    "Parcelas"
  ],
  "operationId": "liberarParcelasPorLoteContraCte",
  "summary": "Liberar parcelas em lote por batch de contra-CT-e",
  "description": "Libera uma posição de parcela para todos os contra-CT-e autorizados pertencentes a um lote de subcontratação (`batch_id`). Uso exclusivo de transportador frotista sob escopo `operacao`.",
  "requestBody": {
    "required": true,
    "description": "Identificador do lote de contra-CT-e e posição da parcela.",
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "batch_id",
            "posicao"
          ],
          "properties": {
            "batch_id": {
              "type": "string",
              "description": "UUID ou ID do lote de contra-CT-e."
            },
            "posicao": {
              "type": "integer",
              "description": "Número da parcela a liberar."
            }
          }
        }
      }
    }
  },
  "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": "Lote sem parcelas elegíveis para liberação."
    }
  },
  "x-fleetpay-scope": "operacao",
  "x-fleetpay-module": "subcontratacao",
  "x-fleetpay-profiles": [
    "transportador_frotista"
  ],
  "method": "POST",
  "path": "/carriers/parcelas-repasse/liberar-por-lote",
  "parameters": []
}