Documentação da tabela unidades

Endpoints de unidades da integração MPM+ (POST, GET e PUT). Base de produção: https://mobtef.conexaoapi.com.br/mpm. Base de homologação: https://mobtef-homolog.conexaoapi.com.br/mpm.

Tabela unidades

POST /unidades

POST https://mobtef.conexaoapi.com.br/mpm/unidades
Campos e tipos (headers)
Campo Tipo
empresa_idint
usuario_idint
tokenint
dispositivo_idint
dispositivo_modelint
dispositivo_tipoint
app_versaoint
app_nomestring
plataformastring
Content-Typestring (application/json)
Exemplo de headers
[
  { "key": "empresa_id", "value": 8 },
  { "key": "usuario_id", "value": 141 },
  { "key": "token", "value": 8041023 },
  { "key": "dispositivo_id", "value": 1 },
  { "key": "dispositivo_model", "value": 1 },
  { "key": "dispositivo_tipo", "value": 1 },
  { "key": "app_versao", "value": 1 },
  { "key": "app_nome", "value": "MEGA" },
  { "key": "plataforma", "value": "WEB" },
  { "key": "Content-Type", "value": "application/json" }
]
Campos e tipos (body da requisição)
Campo Tipo
siglavarchar(5) (obrigatório)
unidadevarchar(100) (obrigatório)
casas_decimaisint (obrigatório)
codigoint
integracaovarchar(50)
Body da requisição
{
  "sigla": "UN",
  "unidade": "UNIDADE",
  "casas_decimais": 2,
  "codigo": 10,
  "integracao": "UNIDADE_PADRAO"
}
cURL (homologação)
curl --location 'https://mobtef-homolog.conexaoapi.com.br/mpm/unidades' \
--header 'empresa_id: 8' \
--header 'usuario_id: 141' \
--header 'token: 8041023' \
--header 'dispositivo_id: 1' \
--header 'dispositivo_model: 1' \
--header 'dispositivo_tipo: 1' \
--header 'app_versao: 1' \
--header 'app_nome: MEGA' \
--header 'plataforma: WEB' \
--header 'Content-Type: application/json' \
--data '{
    "sigla": "UN",
    "unidade": "UNIDADE",
    "casas_decimais": 2,
    "codigo": 10,
    "integracao": "UNIDADE_PADRAO"
}'
Campos e tipos (resposta)
Campo Tipo
statusstring
messagestring
dataarray
data[].idint
Exemplo de resposta
{
  "status": "success",
  "message": "Criado com sucesso.",
  "data": [
    {
      "id": 120
    }
  ]
}

GET /unidades

GET https://mobtef.conexaoapi.com.br/mpm/unidades

O GET pode ser usado para sincronização por data (atualizacao) ou para buscar um registro específico informando unidade_id no header.

Campos e tipos (headers)
Campo Tipo
empresa_idint
tokenint
usuario_idint
dispositivo_idint
dispositivo_modelint
dispositivo_tipoint
app_versaoint
app_nomestring
plataformastring
atualizacaostring (data) — opcional (sincronização)
unidade_idint — opcional (consulta de uma unidade)
Exemplo de headers
[
  { "key": "empresa_id", "value": 8 },
  { "key": "token", "value": 8041023 },
  { "key": "usuario_id", "value": 141 },
  { "key": "dispositivo_id", "value": 1 },
  { "key": "dispositivo_model", "value": 1 },
  { "key": "dispositivo_tipo", "value": 1 },
  { "key": "app_versao", "value": 1 },
  { "key": "app_nome", "value": "MEGA" },
  { "key": "plataforma", "value": "WEB" },
  { "key": "unidade_id", "value": 120 }
]
cURL (homologação)
curl --location 'https://mobtef-homolog.conexaoapi.com.br/mpm/unidades' \
--header 'empresa_id: 8' \
--header 'token: 8041023' \
--header 'usuario_id: 141' \
--header 'dispositivo_id: 1' \
--header 'dispositivo_model: 1' \
--header 'dispositivo_tipo: 1' \
--header 'app_versao: 1' \
--header 'app_nome: MEGA' \
--header 'plataforma: WEB' \
--header 'unidade_id: 120'
Campos e tipos (resposta)
Campo Tipo
statusstring
messagestring
dataarray
data[].idint
data[].siglavarchar(5)
data[].casas_decimaisint
Exemplo de resposta
{
  "status": "success",
  "message": "Operação realizada com sucesso.",
  "data": [
    {
      "id": 120,
      "sigla": "UN",
      "casas_decimais": 2
    }
  ]
}

PUT /unidades

PUT https://mobtef.conexaoapi.com.br/mpm/unidades

No PUT, informe unidade_id no header para identificar o registro que será atualizado.

Campos e tipos (headers)
Campo Tipo
empresa_idint
usuario_idint
tokenint
dispositivo_idint
dispositivo_modelint
dispositivo_tipoint
app_versaoint
app_nomestring
plataformastring
unidade_idint
Content-Typestring (application/json)
Exemplo de headers
[
  { "key": "empresa_id", "value": 8 },
  { "key": "usuario_id", "value": 141 },
  { "key": "token", "value": 8041023 },
  { "key": "dispositivo_id", "value": 1 },
  { "key": "dispositivo_model", "value": 1 },
  { "key": "dispositivo_tipo", "value": 1 },
  { "key": "app_versao", "value": 1 },
  { "key": "app_nome", "value": "MEGA" },
  { "key": "plataforma", "value": "WEB" },
  { "key": "unidade_id", "value": 120 },
  { "key": "Content-Type", "value": "application/json" }
]
Campos e tipos (body da requisição)
Campo Tipo
siglavarchar(5)
unidadevarchar(100)
casas_decimaisint
codigoint
integracaovarchar(50)
ativobool
Body da requisição
{
  "sigla": "UN",
  "unidade": "UNIDADE",
  "casas_decimais": 2,
  "codigo": 10,
  "integracao": "UNIDADE_PADRAO",
  "ativo": true
}
cURL (homologação)
curl --location --request PUT 'https://mobtef-homolog.conexaoapi.com.br/mpm/unidades' \
--header 'empresa_id: 8' \
--header 'usuario_id: 141' \
--header 'token: 8041023' \
--header 'dispositivo_id: 1' \
--header 'dispositivo_model: 1' \
--header 'dispositivo_tipo: 1' \
--header 'app_versao: 1' \
--header 'app_nome: MEGA' \
--header 'plataforma: WEB' \
--header 'unidade_id: 120' \
--header 'Content-Type: application/json' \
--data '{
  "sigla": "UN",
  "unidade": "UNIDADE",
  "casas_decimais": 2,
  "codigo": 10,
  "integracao": "UNIDADE_PADRAO",
  "ativo": true
}'
Campos e tipos (resposta)
Campo Tipo
statusstring
messagestring
dataarray
data[].idint
data[].siglavarchar(5)
data[].casas_decimaisint
data[].ativobool
Exemplo de resposta
{
  "status": "success",
  "message": "Atualizado com sucesso.",
  "data": [
    {
      "id": 120,
      "sigla": "UN",
      "casas_decimais": 2,
      "ativo": true
    }
  ]
}