---
title: "Incluir uma nova Ordem de Carga"
method: POST
path: "/v1/logistica/ordens-carga"
tags: ["Logística"]
---

# Incluir uma nova Ordem de Carga

`POST /v1/logistica/ordens-carga`

Permite incluir uma nova Ordem de Carga no ERP.

## Request body

- OrdemCargaPost — Representa uma Ordem de Carga no sistema.
  - `codigoOrdemCarga` integer — Código de identificação da Ordem de Carga.
  - `codigoEmpresa` integer, required — 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, required — Define o tipo da Ordem de Carga. 1: Ambos, 2: Entrada, 3: Saída.
  - `situacao` 1 | 2, required — 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`

Operação bem sucedida. Retorna a Ordem de Carga criada.

- 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.
- `403` — Acesso proibido.
- `500` — Erro interno do servidor.

---

[API](https://skmtc.net/sankhya/apis/api-sankhya.md) · [All operations](https://skmtc.net/sankhya/apis/api-sankhya/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sankhya/api-sankhya/revisions/0a3e81ca6195/schema)