---
title: "Atualizar uma Ordem de Carga existente"
method: PUT
path: "/v1/logistica/empresas/{codigoEmpresa}/ordens-carga/{codigoOrdemCarga}"
tags: ["Logística"]
---

# Atualizar uma Ordem de Carga existente

`PUT /v1/logistica/empresas/{codigoEmpresa}/ordens-carga/{codigoOrdemCarga}`

## Request

- Base URL: `https://api.sankhya.com.br`
- URL: `https://api.sankhya.com.br/v1/logistica/empresas/{codigoEmpresa}/ordens-carga/{codigoOrdemCarga}`
- Auth: API key in header `Authorization`

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.

## Path parameters

- `codigoEmpresa` integer, required
- `codigoOrdemCarga` integer, required

## Request body

- OrdemCargaPut: Representa uma Ordem de Carga no sistema.
  - `codigoOrdemCarga` integer: Código de identificação da Ordem de Carga.
  - `codigoEmpresa` integer: Código da empresa da ordem de carga.
  - `codigoRoteirizador` string: Id da rota planejada na ferramenta de roteirização.
  - `nomeEmpresa` string: Nome da empresa da ordem de carga.
  - `dataInicio` string: Data de início da operação.
  - `dataPrevistaSaida` string: Data prevista para a saída do veículo.
  - `horaSaida` string: Hora prevista para a saída.
  - `codigoVeiculo` integer: Código do veículo alocado para a carga.
  - `codigoRegiao` integer: Código da região de destino da ordem de carga.
  - `nomeRegiao` string: Nome da região de destino.
  - `codigoTransportadora` integer: Código do parceiro Transportadora.
  - `nomeTransportadora` string: Nome da transportadora.
  - `codigoMotorista` integer: Código do parceiro Motorista.
  - `nomeMotorista` string: Nome do motorista.
  - `roteiro` string: Descrição detalhada do roteiro a ser seguido.
  - `tipo` 1 | 2 | 3: Define o tipo da Ordem de Carga. 1: Ambos, 2: Entrada, 3: Saída.
  - `situacao` 1 | 2: Situação atual da Ordem de Carga. 1: Aberta, 2: Fechada.
  - `pesoMaximo` number, float: Peso máximo suportado pela carga em Kg.
  - `metroCubicoMaximo` number, float: Volume máximo suportado pela carga em m³.
  - `observacoes` string: Observações gerais sobre a ordem de carga.

## Response `200`

Ordem de Carga atualizada com sucesso.

- OrdemCargaResponse
  - `ordemCarga` OrdemCarga: Representa uma Ordem de Carga no sistema.
    - `codigoOrdemCarga` integer: Código de identificação da Ordem de Carga.
    - `codigoEmpresa` integer: Código da empresa da ordem de carga.
    - `codigoRoteirizador` string: Id da rota planejada na ferramenta de roteirização.
    - `nomeEmpresa` string: Nome da empresa da ordem de carga.
    - `dataInicio` string: Data de início da operação.
    - `dataPrevistaSaida` string: Data prevista para a saída do veículo.
    - `horaSaida` string: Hora prevista para a saída.
    - `codigoVeiculo` integer: Código do veículo alocado para a carga.
    - `codigoRegiao` integer: Código da região de destino da ordem de carga.
    - `nomeRegiao` string: Nome da região de destino.
    - `codigoTransportadora` integer: Código do parceiro Transportadora.
    - `nomeTransportadora` string: Nome da transportadora.
    - `codigoMotorista` integer: Código do parceiro Motorista.
    - `nomeMotorista` string: Nome do motorista.
    - `roteiro` string: Descrição detalhada do roteiro a ser seguido.
    - `tipo` 1 | 2 | 3: Define o tipo da Ordem de Carga. 1: Ambos, 2: Entrada, 3: Saída.
    - `situacao` 1 | 2: Situação atual da Ordem de Carga. 1: Aberta, 2: Fechada.
    - `pesoMaximo` number, float: Peso máximo suportado pela carga em Kg.
    - `metroCubicoMaximo` number, float: Volume máximo suportado pela carga em m³.
    - `observacoes` string: Observações gerais sobre a ordem de carga.

## Other responses

- `400`: Requisição inválida.
- `401`: Não autorizado.
- `404`: Ordem de Carga não encontrada.
- `500`: Erro interno do servidor.

---

[API](https://skmtc.dev/sankhya/apis/api-sankhya.md) - [All operations](https://skmtc.dev/sankhya/apis/api-sankhya/llms.txt) - [OpenAPI document](https://skmtc.dev/sankhya/apis/api-sankhya/revisions/b3c833e7aab1?raw)
