Demander API - Transporters

This article is part of the REST Integration API documentation.

Documentation to query, insert, update and delete carriers.

Consultation

List the company’s carriers. Without filter, considers dataAlteracao from the last 6 months.

Rota: {host}/public/v1/transportadoras?pagina={pagina}&limite={limite}&filtroDataAlteracao={data}&operadorFiltro={operador}
Método: GET

Return:

{
  "transportadoras": [
    {
      "codigo": "3",
      "descricao": "Transportadora Sul",
      "ativo": 1,
      "cnpj": "12345678/0001-23",
      "codCidade": 45654,
      "endereco": "Rua Araça, 841",
      "telefone": "51999654501",
      "codTipoTransportadora": 1,
      "dataAlteracao": "2026-07-24 10:00:00"
    }
  ]
}

Insert or update

POST upsert by key codigo.

Rota: {host}/public/v1/transportadoras
Método: POST
Body: json

Property	Type	Size	Mandatory	Description
code	string	15	✓	Carrier code. Unique identifier used to insert or update (upsert).
description	string	500	✓	Carrier name/description.
active	int			Values: `0` or `1`. Default on inclusion: `1`.
cnpj	string	18		CNPJ of the carrier.
codCidade	int			City code in Demander.
address	string	255		Carrier address.
phone	string	30		Telephone of the carrier.
codTipoTransportadora	int			Values: `0` Carrier/Redispatch, `1` Carrier, `2` Redespacho. Default on inclusion: `0`.

Body:

{
  "codigo": "3",
  "descricao": "Transportadora Sul",
  "ativo": 1,
  "cnpj": "12345678/0001-23",
  "codCidade": 45654,
  "endereco": "Rua Araça, 841",
  "telefone": "51999654501",
  "codTipoTransportadora": 1
}

Return:

{
  "codigo": "3",
  "descricao": "Transportadora Sul",
  "ativo": 1,
  "cnpj": "12345678/0001-23",
  "codCidade": 45654,
  "endereco": "Rua Araça, 841",
  "telefone": "51999654501",
  "codTipoTransportadora": 1,
  "dataAlteracao": "2026-07-24 10:00:00"
}

Delete

Remove the carrier.

Rota: {host}/public/v1/transportadoras?codigo={codigo}
Método: DELETE

Return:

{
  "mensagem": "Registro excluído com sucesso."
}