Simped · API

Integração ERP + Simped

Esta API conecta o ERP utilizado pela farmácia ao Simped, software de gestão de compras. Envie vendas e posição de estoque para manter os dados de compra atualizados; consulte os registros sincronizados e integre cotações ao fluxo do ERP.

Base URLhttps://api.simped.com.br

Fluxo recomendado
1. Autentique o ERP em POST /login e guarde o token.
2. Envie os dados em JSON para as rotas de vendas, estoque ou cotações, incluindo o CNPJ da loja e os identificadores do produto.
3. Use as rotas GET para consultar os dados disponíveis para o grupo autenticado.

Autenticação

Obtenha um token antes de chamar as rotas protegidas.

POST/loginAuthController@login

Corpo da requisição

Envie as credenciais em JSON. O token retornado deve ser enviado no cabeçalho Authorization nas chamadas autenticadas.

{
  "login": "seu_login",
  "senha": "sua_senha"
}

Campos

Campo	Significado para a integração
`login`	Usuário de integração cadastrado no Simped.
`senha`	Senha correspondente ao usuário de integração.

Resposta de sucesso · 200

{ "token": "eyJ..." }

Erros documentados no controller

400 login ou senha não informado.
401 credenciais inválidas.

Cabeçalho das rotas protegidas: Authorization: Bearer SEU_TOKEN. Envie também Content-Type: application/json e Accept: application/json.

Cotações

Cria uma cotação e associa os produtos e lojas enviados.

POST/cotacaoCotacaoController@store

Requer autenticação.Bearer token

Corpo da requisição

Envie um objeto com produtos como lista. Cada item usa os campos abaixo:

{
  "produtos": [
    {
      "ean": "7891234567890",
      "descricao": "Produto exemplo",
      "cnpjLoja": "00000000000100",
      "quantidade": "10",
      "precoReferencia": "12.50",
      "codigo_erp": 1001,
      "aceitaSubs": 1
    }
  ]
}

Campos do item

Campo	Significado para a integração
`ean`	Código de barras do produto usado para localizar ou correlacionar o cadastro no Simped.
`descricao`	Descrição comercial do produto enviada pelo ERP.
`cnpjLoja`	CNPJ da loja participante da cotação; identifica a unidade dentro do grupo.
`quantidade`	Quantidade solicitada para este produto na cotação.
`precoReferencia`	Preço de referência unitário informado pelo ERP.
`codigo_erp`	Código numérico do produto no ERP, usado para relacionar o item entre os sistemas.
`aceitaSubs`	Indicador numérico de aceitação de substitutos: `0` = falso/não; `1` = verdadeiro/sim.

Resposta de sucesso · 200

{
  "data": "Cotação criada com sucesso!",
  "cotacao": 123
}

Erros documentados no controller

400 nenhum produto informado ou lista inválida.
500 falha ao criar cotação ou inserir produtos.

Vendas

Sincroniza vendas e consulta os registros associados ao grupo autenticado.

POST/vendaVendaController@store

Requer autenticação. O corpo é uma lista de vendas; os campos são lidos para cada item.Bearer token

Corpo da requisição

Informe data_venda no formato datetime YYYY-MM-DD HH:MM:SS.

[
  {
    "cnpj": "00000000000100",
    "ean": "7891234567890",
    "descricao": "Produto exemplo",
    "grupoproduto_nome": "Higiene",
    "fabricante_nome": "Fabricante exemplo",
    "estoque": "15",
    "qtd_vendido": "3",
    "custo_unitario": "8.25",
    "venda_unitaria": "12.90",
    "data_venda": "2026-10-13 14:30:00",
    "numero_nota": "NF-1001",
    "id_produto": 420042
  }
]

Campos do item

Campo	Significado para a integração
`cnpj`	CNPJ da farmácia/loja onde a venda ocorreu. Deve identificar uma loja vinculada ao grupo do token.
`ean`	Código de barras para associar a venda ao produto no Simped.
`descricao`	Descrição do produto conforme o cadastro do ERP.
`grupoproduto_nome`	Nome do grupo ou categoria do produto.
`fabricante_nome`	Nome do fabricante do produto.
`estoque`	Saldo em estoque informado para o produto na loja no momento da integração.
`qtd_vendido`	Quantidade vendida registrada nesta venda.
`custo_unitario`	Custo unitário do produto para esta venda.
`venda_unitaria`	Valor líquido unitário de venda.
`data_venda`	Data e hora da venda no formato `YYYY-MM-DD HH:MM:SS`.
`numero_nota`	Número ou identificador do documento fiscal da venda.
`id_produto`	Código interno numérico do produto no ERP. É registrado junto à venda para relacionar o identificador do ERP ao produto no Simped.

Resposta de sucesso · 200

{ "data": "Vendas salvas!" }

Erros documentados no controller

400 funcionalidade indisponível para o plano do grupo ou lista vazia.
500 nenhuma venda foi salva.

GET/vendaVendaController@index

Requer autenticação. Retorna vendas do grupo do token, sem parâmetros de consulta.Bearer token

Resposta · 200

{
  "data": [
    {
      "cd_venda": 123,
      "id_produto": 420042,
      "cnpj": "00000000000100",
      "ean": "7891234567890",
      "descricao": "Produto exemplo",
      "fabricante": "Fabricante exemplo",
      "grupo": "Higiene",
      "estoque": 15,
      "qtd_vendido": 3,
      "custo_unitario": 8.25,
      "venda_unitaria": 12.9,
      "data_venda": "2026-10-13 14:30:00"
    }
  ]
}

Identificador do ERP

id_produto é o código interno numérico do produto no ERP, retornado para que o ERP reconheça o item associado à venda no Simped.

Estoque

Atualiza o estoque dos produtos e consulta a posição atual do grupo.

POST/estoqueProdutoEstoqueProdutoController@store

Requer autenticação. O corpo é uma lista de produtos. O CNPJ deve corresponder a uma loja cadastrada no grupo.Bearer token

Corpo da requisição

[
  {
    "cnpj": "00000000000100",
    "ean": "7891234567890",
    "nome": "Produto exemplo",
    "fabricante_nome": "Fabricante exemplo",
    "grupoproduto_nome": "Higiene",
    "id_produto": 420042,
    "estoque": "24",
    "produto_excecao": 1,
    "produto_pbm": 0
  }
]

Campos do item

Campo	Significado para a integração
`cnpj`	CNPJ da loja onde o estoque está sendo atualizado; deve estar cadastrada no grupo.
`ean`	Código de barras usado para localizar ou cadastrar o produto no Simped.
`nome`	Descrição do produto conforme o ERP.
`fabricante_nome`	Nome do fabricante do produto.
`grupoproduto_nome`	Nome do grupo ou categoria do produto.
`id_produto`	Código interno numérico do produto no ERP, associado ao registro de estoque.
`estoque`	Quantidade disponível informada pelo ERP para a loja e o produto.
`produto_excecao`	Indica se o produto é uma exceção: `1` para sim e `0` para não.
`produto_pbm`	Indica se o produto participa de PBM: `1` para sim e `0` para não.

Resposta de sucesso · 200

{
  "success": "Estoque sincronizados.",
  "totalRegistros": 1
}

Erros documentados no controller

400 funcionalidade indisponível para o plano do grupo ou lista vazia.
500 CNPJ não localizado ou falha ao registrar estoque.

GET/estoqueProdutoEstoqueProdutoController@index

Requer autenticação. Retorna os produtos com estoque do grupo do token, sem parâmetros de consulta.Bearer token

Resposta · 200

{
  "data": [
    {
      "cd_estoqueproduto": 123,
      "cnpj": "00000000000100",
      "ean": "7891234567890",
      "nome": "Produto exemplo",
      "fabricante_nome": "Fabricante exemplo",
      "grupoproduto_nome": "Higiene",
      "id_produto": 420042,
      "estoque": 24,
      "produto_excecao": 1,
      "produto_pbm": 0
    }
  ]
}