Ordens de carga de veículos¶

Uma ordem de carga de veículo registra o cabeçalho histórico ou operacional de uma carga ou viagem. Ela pode identificar frota e tipo de veículo, origin e destination principais, datas planejadas e efetivas, peso ou volume transportado, distância percorrida e custo de frete.

As entregas podem referenciar esse cabeçalho por loadingOrderId. A ordem de carga, portanto, agrupa registros de execução sem repetir nessa base cada material e cada linha de ordem.

Essa base é diferente das ordens de carga planejadas consolidadas, que são outputs calculados de um Supply Plan e estão documentadas em Ordens de carga planejadas consolidadas. Ordens de carga históricas descrevem o que foi programado ou executado; ordens planejadas descrevem uma consolidação futura proposta pelo cenário.

Essa base pertence atualmente à superfície Enterprise de Data Upload. O Community não publica essa interface versionada como contrato Community.

Caminho na plataforma¶

Data > Data Operations > Transactional Data > Orders > Vehicle Loading Orders > Loading Orders

Granularidade e chave¶

Uma linha representa o cabeçalho de uma carga ou viagem histórica de veículo. Sua chave única é:

id

O identificador deve permanecer estável durante as atualizações da mesma carga. Um identificador diferente representa outra viagem física ou outro documento de carga.

Campos obrigatórios¶

Campo	Significado
`id`	Identificador único da ordem de carga do veículo

Campos opcionais¶

Campo	Significado	Valor Padrão se Não Preenchido
`fleetId`	Frota utilizada pela carga	Sem frota vinculada
`vehicleTypeId`	Tipo de veículo utilizado pela carga	Sem tipo de veículo vinculado
`mainOriginLocationId`	Location principal de expedição da carga	Sem location de origin vinculada
`mainDestinationLocationId`	Location principal de recebimento da carga	Sem location de destination principal vinculada
`originCountry`	País da origin principal	Sem país de origin atribuído
`originState`	Estado ou região da origin principal	Sem estado ou região de origin atribuído
`originCity`	Cidade da origin principal	Sem cidade de origin atribuída
`destinationCountry`	País da destination principal	Sem país de destination atribuído
`destinationState`	Estado ou região da destination principal	Sem estado ou região de destination atribuído
`destinationCity`	Cidade da destination principal	Sem cidade de destination atribuída
`plannedExpeditionDate`	Data e hora planejadas de expedição	Sem data planejada de expedição atribuída
`expeditionDate`	Data e hora efetivas de expedição	Sem data efetiva de expedição atribuída
`deliveryDate`	Data e hora efetivas de entrega	Sem data efetiva de entrega atribuída
`distanceTraveledInKm`	Distância percorrida pela carga, em quilômetros	Soma das distâncias dos drop-offs associados; se indisponível, distância da rota; caso contrário, `0`
`loadWeightUom`	Unidade utilizada por `loadWeight`	Unidade logística padrão de peso em Parâmetros Globais de Planejamento; se vazia, unidade padrão de Supply Planning e depois `UN`
`loadWeight`	Peso total informado no cabeçalho da ordem de carga	Total dos drop-offs ou linhas de entrega associados; sem essas fontes, `0` nos cálculos de peso
`loadVolumeUom`	Unidade utilizada por `loadVolume`	Unidade logística padrão de volume em Parâmetros Globais de Planejamento; se vazia, unidade padrão de Supply Planning e depois `UN`
`loadVolume`	Volume total informado no cabeçalho da ordem de carga	Total dos drop-offs ou linhas de entrega associados; sem essas fontes, `0` nos cálculos de volume
`freightCost`	Custo de frete atribuído à carga	Sem custo de frete atribuído; a ausência não é tratada como zero

Os campos de país, estado e cidade permitem preservar o contexto geográfico de uma carga histórica mesmo quando a location correspondente não está cadastrada. Quando location e campos geográficos forem preenchidos, ambos devem descrever a mesma origin ou destination.

Resolução de quantidade e distância¶

O cabeçalho da ordem de carga é a primeira fonte de peso, volume e distância. Quando a quantidade do cabeçalho estiver ausente, os cálculos podem usar drop-offs associados e depois as linhas de entrega vinculadas. Uma quantidade ausente, portanto, não cria volume transportado por si só.

A distância segue precedência semelhante: valor cadastrado no cabeçalho, drop-offs associados e depois uma rota vinculada. Quando nenhuma dessas fontes fornece distância, a projeção histórica usa 0.

O custo de frete segue uma regra econômica mais rigorosa. freightCost vazio significa que nenhum custo foi atribuído à carga; o valor não é convertido silenciosamente em zero.

Dependências¶

Frotas e tipos de veículo quando fleetId ou vehicleTypeId estiver preenchido;
Locations quando um dos campos de location estiver preenchido;
Unidades de medida para as unidades explícitas ou padrão de peso e volume e suas conversões;
Parâmetros Globais de Planejamento para as unidades padrão de logística e Supply Planning;
informações coerentes de rota ou drop-off quando a distância precisar ser derivada em vez de informada no cabeçalho.

Utilizado por¶

Entregas, que podem usar loadingOrderId para agrupar linhas de execução de ordens na mesma carga de veículo;
análises históricas por frota, tipo de veículo, origin, destination, período de expedição e período de recebimento;
reconciliação de quantidades expedidas e recebidas usando detalhes de cabeçalho, drop-off e linha de entrega;
calibração de curvas de custo logístico a partir de observações de ocupação, distância e frete;
DRP, Deployment e formação de cargas como histórico de execução e referência para futuras consolidações;
Ordens de carga planejadas consolidadas como resultado futuro de viagens comparável à execução histórica;
análise de datas planejadas contra datas efetivas de expedição e entrega;
diagnósticos de ocupação logística, distância e frete.

Validações¶

id preenchido e único;
toda frota, tipo de veículo, location e unidade preenchidos existentes;
distanceTraveledInKm, loadWeight, loadVolume e freightCost, quando preenchidos, finitos e não negativos;
unidades explícitas de peso e volume conversíveis para as unidades utilizadas pela análise;
geografia de origin e destination coerente com as locations vinculadas quando as duas formas de identificação forem preenchidas;
custo de frete ausente tratado como informação de custo incompleta, e não como viagem de custo zero;
entregas referenciando uma ordem de carga existente antes de usar seu id.