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_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
codigostring
nomestring (obrigatório)
grupo_idint
unidade_idint (obrigatório)
precodouble (obrigatório)
estoquedouble
path_imagemstring | null
integracaostring
fiscal_idint
ceanstring
ceststring
ncmstring
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
statusstring
messagestring
dataarray
data[].idint
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_idint
tokenint
usuario_idint
dispositivo_idint
dispositivo_modelint
dispositivo_tipoint
app_versaoint
app_nomestring
plataformastring
atualizacaostring (data) — opcional (sincronização)
produto_idint — 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
statusstring
messagestring
dataarray
data[].idint
data[].codigostring
data[].nomestring
data[].estoquedouble
data[].unidade_idint
data[].precodouble
data[].ativobool
data[].grupo_idint
data[].integracaostring | null
data[].ceanstring | null
data[].ceststring | null
data[].ncmstring | 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_idint
usuario_idint
tokenint
dispositivo_idint
dispositivo_modelint
dispositivo_tipoint
app_versaoint
app_nomestring
plataformastring
produto_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": "produto_id", "value": 901 },
  { "key": "Content-Type", "value": "application/json" }
]
Campos e tipos (body da requisição)
Campo Tipo
codigostring
nomestring
grupo_idint
unidade_idint
precodouble
estoquedouble
path_imagemstring | null
ativobool
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
statusstring
messagestring
dataarray
data[].idint
data[].nomestring
data[].codigostring
data[].ativobool
Exemplo de resposta
{
  "status": "success",
  "message": "Atualizado com sucesso.",
  "data": [
    {
      "id": 901,
      "nome": "COCA-COLA LATA 350ML",
      "codigo": "1201",
      "ativo": true
    }
  ]
}