---
title: "Retornar lista de Ordens de Carga"
method: GET
path: "/v1/logistica/ordens-carga"
tags: ["Logística"]
---

# Retornar lista de Ordens de Carga

`GET /v1/logistica/ordens-carga`

Permite acessar a lista de Ordens de Carga cadastradas no ERP, com a possibilidade de filtrar por empresa.

## Query parameters

- `page` integer, required
- `modifiedSince` string
- `codigoEmpresa` integer
- `codigoRoteirizador` string

## Response `200`

Operação bem sucedida.

- OrdemCargaResponseList
  - `ordensCarga` OrdemCarga[]
    - `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.
  - `pagination` PaginationInfo — Contém as informações de paginação da resposta.
    - `page` string — O número da página atual.
    - `offset` string — O deslocamento de registros.
    - `total` string — O número total de registros na consulta.
    - `hasMore` string — Indica se existem mais páginas a serem consultadas.

## Other responses

- `400` — Requisição inválida.
- `401` — Não autorizado.
- `404` — Recurso não encontrado.
- `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)