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:
Acesse a página de cadastro e crie sua conta de administrador.
Ir para CadastroApós enviar, aguarde a mensagem: "Solicitação de administrador enviada para aprovação!"
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.
Ao confirmar o pagamento, você será redirecionado para o Painel do Desenvolvedor. Copie o token gerado e utilize nos endpoints.
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.
Retorna a lista de funcionários cadastrados.
http://arthurappel.com.br/ERP/json/funcionarios_json.php?token={TOKEN}
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"
}
]
Lista o estoque completo com preços e quantidades.
http://arthurappel.com.br/ERP/json/produtos_json.php?token={TOKEN}
Estrutura:
| Campo | Tipo | Descrição |
|---|---|---|
| id | Int | Identificador único |
| nome | String | Nome do produto |
| descricao | String | Descrição do Produto |
| categoria_id | Int | Id da categoria |
| preco | Decimal | Preço do Produto |
| quantidade | Int | Quantidade em Estoque |
| estoque_minimo | Int | Alerta de reposição |
| data_cadastro | Datetime | Data 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"
}
]
Categorias para organização dos produtos.
http://arthurappel.com.br/ERP/json/categorias_json.php?token={TOKEN}
Estrutura:
| Campo | Tipo | Descrição |
|---|---|---|
| id | Int | Identificador único |
| nome | String | Nome da categoria |
| descricao | String | Descrição da Categoria |
[{"id":"1","nome":"Analgesicos","descricao":"Medicamentos para dor"}]
Base completa de clientes.
http://arthurappel.com.br/ERP/json/clientes_json.php?token={TOKEN}
Estrutura:
| Campo | Tipo | Descrição |
|---|---|---|
| cliente_id | Int | Identificador único (PK) |
| nome_cliente | String | Nome completo |
| cpf_cliente | String | CPF |
| email_cliente | String | |
| celular_cliente | String | Telefone |
| endereco_cliente | String | Endereço |
| data_nascimento | Date | Data de nascimento |
| data_cadastro | Date | Data de cadastro |
Exemplo de Resposta:
[
{
"cliente_id": "1",
"nome_cliente": "Maria Oliveira",
"email_cliente": "maria.oliveira@email.com",
"celular_cliente": "(11) 99876-5432"
}
]
Histórico de transações.
http://arthurappel.com.br/ERP/json/vendas_json.php?token={TOKEN}
Estrutura:
| Campo | Tipo | Descrição |
|---|---|---|
| id_venda | Int | Identificador único (PK) |
| data_venda | Date | Data da venda |
| valor_total | Decimal | Valor total |
| status | String | Situação (Pago/Pendente) |
| cliente_id | Int | ID do cliente (FK) |
Exemplo de Resposta:
[
{
"id_venda": "10",
"data_venda": "2025-09-06",
"valor_total": "150.50",
"status": "Pago",
"cliente_id": "1"
}
]
Detalhes dos produtos dentro de cada venda.
http://arthurappel.com.br/ERP/json/itens_venda_json.php?token={TOKEN}
Estrutura:
| Campo | Tipo | Descrição |
|---|---|---|
| id_item | Int | Identificador do item |
| id_venda | Int | ID da venda |
| id_produto | Int | ID do produto |
| quantidade | Int | Qtd vendida |
| preco_unitario | Decimal | Valor unitário |
| subtotal | Decimal | Valor total do item |
Exemplo de Resposta:
[
{
"id_item": "1",
"id_venda": "10",
"id_produto": "5",
"quantidade": "2",
"subtotal": "51.00"
}
]
Receitas vinculadas aos clientes com link para PDF.
http://arthurappel.com.br/ERP/json/receitas_json.php?token={TOKEN}
Estrutura:
| Campo | Tipo | Descrição |
|---|---|---|
| id | Int | Identificador (PK) |
| paciente | String | Nome do paciente |
| medico | String | Nome do médico |
| data_receita | Date | Data da receita |
| arquivo_path | String | URL do PDF |
| cliente_id | Int | ID do cliente (FK) |
Exemplo de Resposta:
[
{
"id": "1",
"paciente": "Arthur",
"medico": "Dr. Silva",
"arquivo_path": "receitas/receita_arthur.pdf"
}
]