Manual de Integração WebService

Bem-vindo à documentação oficial do nosso ERP. Aqui você encontrará todas as informações necessárias para autenticar e consumir dados via API JSON.

Histórico de Versões

Versão Data Detalhes da Atualização
v1.6 06/12/2025 Implementei a validação Automática do Pagamento PIX
v1.5 29/11/2025 Integração com Mercado Pago (SaaS).
v1.4 22/09/2025 Implementado validação de segurança por Token.
v1.3 19/09/2025 Mudança na estrutura de banco de dados e usuários WS.
v1.2 12/09/2025 Atualização obrigatória de Login e Token.
v1.0 01/08/2025 Lançamento da versão inicial.

Como obter Acesso

Para consumir os dados, siga estritamente os passos abaixo:

Passo 1: Solicitação

Acesse a página de cadastro e crie sua conta de administrador.

Ir para Cadastro

Após enviar, aguarde a mensagem: "Solicitação de administrador enviada para aprovação!"

Tela de Cadastro
Passo 2: Pagamento & Token

Após a aprovação, faça login e realize o pagamento (Pix) para liberar seu acesso.

Ir para Login/Pagamento

⚠️ Atenção: O token gerado tem validade de 24 horas após a confirmação do pagamento.

Painel do Desenvolvedor com Token
Passo 3: Consumo

Ao confirmar o pagamento, você será redirecionado para o Painel do Desenvolvedor. Copie o token gerado e utilize nos endpoints.

Painel do Desenvolvedor com Token

Exemplo de uso na URL:

http://arthurappel.com.br/ERP/json/produtos_json.php?token=a1b2c3d4...

Endpoints Disponíveis

Clique nos cards abaixo para ver os detalhes de cada serviço.

GET Funcionários

Retorna a lista de funcionários cadastrados.

Estrutura:

Campo Tipo Descrição
cd_funcionario Int Identificador único do funcionário (ID)
ds_funcionario String Nome completo do funcionário
ds_cpf String CPF do funcionário
ds_email String Endereço de e-mail
ds_celular String Número de celular
ds_endereco String Endereço residencial completo
ds_senha String Senha de acesso (Hash)
dt_nascimento Date Data de nascimento
ds_situacao String Situação cadastral

Exemplo de Resposta:


[
  {
    "cd_funcionario": "1",
    "ds_funcionario": "João da Silva",
    "ds_cpf": "123.456.789-00",
    "ds_email": "joao.silva@email.com",
    "ds_situacao": "Ativo"
  }
]
GET Produtos

Lista o estoque completo com preços e quantidades.

Estrutura:

CampoTipoDescrição
idIntIdentificador único
nomeStringNome do produto
descricaoStringDescrição do Produto
categoria_idIntId da categoria
precoDecimalPreço do Produto
quantidadeIntQuantidade em Estoque
estoque_minimoIntAlerta de reposição
data_cadastroDatetimeData de Cadastro

Exemplo de Resposta:


[
  {
    "id": "1",
    "nome": "Dipirona",
    "descricao": "Analgésico e antipirético 500mg",
    "categoria_id": "2",
    "preco": "5.50",
    "quantidade": "100",
    "estoque_minimo": "20",
    "data_cadastro": "2025-09-06 14:30:00"
  }
]
GET Categorias

Categorias para organização dos produtos.

Estrutura:

CampoTipoDescrição
idIntIdentificador único
nomeStringNome da categoria
descricaoStringDescrição da Categoria
[{"id":"1","nome":"Analgesicos","descricao":"Medicamentos para dor"}]
GET Clientes

Base completa de clientes.

Estrutura:

CampoTipoDescrição
cliente_idIntIdentificador único (PK)
nome_clienteStringNome completo
cpf_clienteStringCPF
email_clienteStringE-mail
celular_clienteStringTelefone
endereco_clienteStringEndereço
data_nascimentoDateData de nascimento
data_cadastroDateData de cadastro

Exemplo de Resposta:


[
  {
    "cliente_id": "1",
    "nome_cliente": "Maria Oliveira",
    "email_cliente": "maria.oliveira@email.com",
    "celular_cliente": "(11) 99876-5432"
  }
]
GET Vendas

Histórico de transações.

Estrutura:

CampoTipoDescrição
id_vendaIntIdentificador único (PK)
data_vendaDateData da venda
valor_totalDecimalValor total
statusStringSituação (Pago/Pendente)
cliente_idIntID do cliente (FK)

Exemplo de Resposta:


[
  {
    "id_venda": "10",
    "data_venda": "2025-09-06",
    "valor_total": "150.50",
    "status": "Pago",
    "cliente_id": "1"
  }
]
GET Itens da Venda

Detalhes dos produtos dentro de cada venda.

Estrutura:

CampoTipoDescrição
id_itemIntIdentificador do item
id_vendaIntID da venda
id_produtoIntID do produto
quantidadeIntQtd vendida
preco_unitarioDecimalValor unitário
subtotalDecimalValor total do item

Exemplo de Resposta:


[
  {
    "id_item": "1",
    "id_venda": "10",
    "id_produto": "5",
    "quantidade": "2",
    "subtotal": "51.00"
  }
]
GET Receitas Médicas

Receitas vinculadas aos clientes com link para PDF.

Estrutura:

CampoTipoDescrição
idIntIdentificador (PK)
pacienteStringNome do paciente
medicoStringNome do médico
data_receitaDateData da receita
arquivo_pathStringURL do PDF
cliente_idIntID do cliente (FK)

Exemplo de Resposta:


[
  {
    "id": "1",
    "paciente": "Arthur",
    "medico": "Dr. Silva",
    "arquivo_path": "receitas/receita_arthur.pdf"
  }
]