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_id | int |
| usuario_id | int |
| token | int |
| dispositivo_id | int |
| dispositivo_model | int |
| dispositivo_tipo | int |
| app_versao | int |
| app_nome | string |
| plataforma | string |
| Content-Type | string (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 |
|---|---|
| sigla | varchar(5) (obrigatório) |
| unidade | varchar(100) (obrigatório) |
| casas_decimais | int (obrigatório) |
| codigo | int |
| integracao | varchar(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 |
|---|---|
| status | string |
| message | string |
| data | array |
| data[].id | int |
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_id | int |
| token | int |
| usuario_id | int |
| dispositivo_id | int |
| dispositivo_model | int |
| dispositivo_tipo | int |
| app_versao | int |
| app_nome | string |
| plataforma | string |
| atualizacao | string (data) — opcional (sincronização) |
| unidade_id | int — 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 |
|---|---|
| status | string |
| message | string |
| data | array |
| data[].id | int |
| data[].sigla | varchar(5) |
| data[].casas_decimais | int |
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_id | int |
| usuario_id | int |
| token | int |
| dispositivo_id | int |
| dispositivo_model | int |
| dispositivo_tipo | int |
| app_versao | int |
| app_nome | string |
| plataforma | string |
| unidade_id | int |
| Content-Type | string (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 |
|---|---|
| sigla | varchar(5) |
| unidade | varchar(100) |
| casas_decimais | int |
| codigo | int |
| integracao | varchar(50) |
| ativo | bool |
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 |
|---|---|
| status | string |
| message | string |
| data | array |
| data[].id | int |
| data[].sigla | varchar(5) |
| data[].casas_decimais | int |
| data[].ativo | bool |
Exemplo de resposta
{
"status": "success",
"message": "Atualizado com sucesso.",
"data": [
{
"id": 120,
"sigla": "UN",
"casas_decimais": 2,
"ativo": true
}
]
}