v1

latestOpenAPI 3.0.3Licença Sankhya2026-07-24161242654.8 KB
Logística

Atualizar uma Ordem de Carga existente

Permite a atualização completa dos dados de uma Ordem de Carga a partir do seu código de identificação e do código da empresa.

put/v1/logistica/empresas/{codigoEmpresa}/ordens-carga/{codigoOrdemCarga}

Path parameters

codigoEmpresainteger required

Código da empresa à qual a Ordem de Carga pertence.

codigoOrdemCargainteger required

Código da Ordem de Carga que deve ser atualizada.

Request body

codigoOrdemCargainteger

Código de identificação da Ordem de Carga.

codigoEmpresainteger

Código da empresa da ordem de carga.

codigoRoteirizadorstring

Id da rota planejada na ferramenta de roteirização.

nomeEmpresastring

Nome da empresa da ordem de carga.

dataIniciostring

Data de início da operação.

dataPrevistaSaidastring

Data prevista para a saída do veículo.

horaSaidastring

Hora prevista para a saída.

codigoVeiculointeger

Código do veículo alocado para a carga.

codigoRegiaointeger

Código da região de destino da ordem de carga.

nomeRegiaostring

Nome da região de destino.

codigoTransportadorainteger

Código do parceiro Transportadora.

nomeTransportadorastring

Nome da transportadora.

codigoMotoristainteger

Código do parceiro Motorista.

nomeMotoristastring

Nome do motorista.

roteirostring

Descrição detalhada do roteiro a ser seguido.

tipo1 | 2 | 3

Define o tipo da Ordem de Carga. 1: Ambos, 2: Entrada, 3: Saída.

situacao1 | 2

Situação atual da Ordem de Carga. 1: Aberta, 2: Fechada.

pesoMaximonumber float

Peso máximo suportado pela carga em Kg.

metroCubicoMaximonumber float

Volume máximo suportado pela carga em m³.

observacoesstring

Observações gerais sobre a ordem de carga.

Example request

{
  "codigoOrdemCarga": 901,
  "codigoEmpresa": 1,
  "nomeEmpresa": "Empresa Matriz Ltda.",
  "dataInicio": "12/09/2025",
  "dataPrevistaSaida": "13/09/2025",
  "horaSaida": "14:30",
  "codigoVeiculo": 205,
  "codigoRegiao": 10,
  "nomeRegiao": "TRIÂNGULO MINEIRO",
  "codigoTransportadora": 432,
  "nomeTransportadora": "Transportadora Rápida S.A.",
  "codigoMotorista": 8115,
  "nomeMotorista": "José da Silva",
  "roteiro": "Seguir pela BR-050 até Uberlândia, depois BR-365...",
  "tipo": 3,
  "situacao": 1,
  "pesoMaximo": 25000.5,
  "metroCubicoMaximo": 88.7,
  "observacoes": "Carga frágil, manusear com cuidado."
}

Response

Ordem de Carga atualizada com sucesso.

Example response

{
  "ordemCarga": {
    "codigoOrdemCarga": 901,
    "codigoEmpresa": 1,
    "nomeEmpresa": "Empresa Matriz Ltda.",
    "dataInicio": "12/09/2025",
    "dataPrevistaSaida": "13/09/2025",
    "horaSaida": "14:30",
    "codigoVeiculo": 205,
    "codigoRegiao": 10,
    "nomeRegiao": "TRIÂNGULO MINEIRO",
    "codigoTransportadora": 432,
    "nomeTransportadora": "Transportadora Rápida S.A.",
    "codigoMotorista": 8115,
    "nomeMotorista": "José da Silva",
    "roteiro": "Seguir pela BR-050 até Uberlândia, depois BR-365...",
    "tipo": 3,
    "situacao": 1,
    "pesoMaximo": 25000.5,
    "metroCubicoMaximo": 88.7,
    "observacoes": "Carga frágil, manusear com cuidado."
  }
}