Documentação da tabela produtos
Endpoints de produtos 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 produtos
POST /produtos
POST
https://mobtef.conexaoapi.com.br/mpm/produtos
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 |
|---|---|
| codigo | string |
| nome | string (obrigatório) |
| grupo_id | int |
| unidade_id | int (obrigatório) |
| preco | double (obrigatório) |
| estoque | double |
| path_imagem | string | null |
| integracao | string |
| fiscal_id | int |
| cean | string |
| cest | string |
| ncm | string |
Body da requisição
{
"codigo": "1201",
"nome": "COCA-COLA LATA 350ML",
"grupo_id": 584,
"unidade_id": 120,
"preco": 6.5,
"estoque": 80,
"path_imagem": null,
"integracao": "PRODUTO_1201",
"fiscal_id": 2,
"cean": "7894900011517",
"cest": "1704702",
"ncm": "22021000"
}
cURL (homologação)
curl --location 'https://mobtef-homolog.conexaoapi.com.br/mpm/produtos' \
--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 '{
"codigo": "1201",
"nome": "COCA-COLA LATA 350ML",
"grupo_id": 584,
"unidade_id": 120,
"preco": 6.5,
"estoque": 80,
"path_imagem": null,
"integracao": "PRODUTO_1201",
"fiscal_id": 2,
"cean": "7894900011517",
"cest": "1704702",
"ncm": "22021000"
}'
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": 901
}
]
}
GET /produtos
GET
https://mobtef.conexaoapi.com.br/mpm/produtos
O GET pode ser usado para sincronização por data (atualizacao) ou para buscar um registro específico informando produto_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) |
| produto_id | int — opcional (consulta de um produto) |
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": "produto_id", "value": 901 }
]
cURL (homologação)
curl --location 'https://mobtef-homolog.conexaoapi.com.br/mpm/produtos' \
--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 'produto_id: 901'
Campos e tipos (resposta)
| Campo | Tipo |
|---|---|
| status | string |
| message | string |
| data | array |
| data[].id | int |
| data[].codigo | string |
| data[].nome | string |
| data[].estoque | double |
| data[].unidade_id | int |
| data[].preco | double |
| data[].ativo | bool |
| data[].grupo_id | int |
| data[].integracao | string | null |
| data[].cean | string | null |
| data[].cest | string | null |
| data[].ncm | string | null |
Exemplo de resposta
{
"status": "success",
"message": "Operação realizada com sucesso.",
"data": [
{
"id": 901,
"codigo": "1201",
"nome": "COCA-COLA LATA 350ML",
"estoque": 80,
"unidade_id": 120,
"preco": 6.5,
"ativo": true,
"grupo_id": 584,
"integracao": "PRODUTO_1201",
"cean": "7894900011517",
"cest": "1704702",
"ncm": "22021000"
}
]
}
PUT /produtos
PUT
https://mobtef.conexaoapi.com.br/mpm/produtos
No PUT, informe produto_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 |
| produto_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": "produto_id", "value": 901 },
{ "key": "Content-Type", "value": "application/json" }
]
Campos e tipos (body da requisição)
| Campo | Tipo |
|---|---|
| codigo | string |
| nome | string |
| grupo_id | int |
| unidade_id | int |
| preco | double |
| estoque | double |
| path_imagem | string | null |
| ativo | bool |
Body da requisição
{
"codigo": "1201",
"nome": "COCA-COLA LATA 350ML",
"grupo_id": 584,
"unidade_id": 120,
"preco": 7.0,
"estoque": 120,
"path_imagem": null,
"ativo": true
}
cURL (homologação)
curl --location --request PUT 'https://mobtef-homolog.conexaoapi.com.br/mpm/produtos' \
--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 'produto_id: 901' \
--header 'Content-Type: application/json' \
--data '{
"codigo": "1201",
"nome": "COCA-COLA LATA 350ML",
"grupo_id": 584,
"unidade_id": 120,
"preco": 7.0,
"estoque": 120,
"path_imagem": null,
"ativo": true
}'
Campos e tipos (resposta)
| Campo | Tipo |
|---|---|
| status | string |
| message | string |
| data | array |
| data[].id | int |
| data[].nome | string |
| data[].codigo | string |
| data[].ativo | bool |
Exemplo de resposta
{
"status": "success",
"message": "Atualizado com sucesso.",
"data": [
{
"id": 901,
"nome": "COCA-COLA LATA 350ML",
"codigo": "1201",
"ativo": true
}
]
}