Documentação da API para BI interno
suporte
Última atualização há 4 meses
Visão Geral
A API PARA BI INTERNO é responsável por disponibilizar, em formato JSON, dados consolidados de um sistema ERP para integração com ferramentas de Business Intelligence (BI) e relatórios analíticos.
- Clientes (bi_interno_view_cliente)
- Estoque (bi_interno_view_estoque)
- Faturamento (bi_interno_view_faturamento)
- Produtos (bi_interno_view_produto)
Endpoint
URL Base:
{URL}/api/acessar_viewsMétodo HTTP:GET
{URL}/api/acessar_viewsMétodo HTTP:GET
Autenticação
| Parâmetro | Tipo | Obrigatório | Descrição |
| key | string | Sim | Chave de acesso fornecida pelo ERP para validação da requisição. A chave ⚠️ key deve ser enviada via query string, ex: {URL}/api/acessar_views?key={SEU_TOKEN_AQUI} |
Parâmetros de Consulta
| Parâmetro | Tipo | Obrigatório | Descrição |
| view | string | Sim | Nome da view a ser consultada no banco de dados. Somente letras, números e “_” são aceitos. Exemplo: bi_interno_view_cliente. |
Exemplo de Requisição
GET {URL}/api/acessar_views?key={SEU_TOKEN_AQUI}&view=bi_interno_view_cliente
Estrutura de Resposta (JSON)
Sucesso
Erro
ou, em caso de erro técnico:
Views Disponíveis
A seguir estão as views disponíveis e suas respectivas colunas retornadas.
1. bi_interno_view_cliente — Consulta de Clientes
| Campo | Descrição |
| codigo_cliente | Código do cliente |
| razao_social | Razão social |
| fantasia | Nome fantasia |
| cnpj_cliente | CNPJ ou CPF concatenado |
| estado | UF do cliente |
| cidade | Cidade |
| bairro | Bairro |
| cep | CEP |
| situacao | Situação (ATIVO, INATIVO etc.) |
| grupo_empresarial | Grupo empresarial |
| primeira_compra | Data da primeira compra |
| E-mail principal | |
| cod_vendedor | Código do vendedor |
| nom_vendedor | Nome do vendedor |
| latitude | Latitude do cliente |
| longitude | Longitude do cliente |
2. bi_interno_view_estoque — Consulta de Estoque
| Campo | Descrição |
| cod_fornecedor | Código do fornecedor |
| cnpj_distribuidor | CNPJ fixo da distribuidora |
| cod_produto | Código interno do produto |
| ean | Código de barras (EAN) |
| num_estoque | Quantidade atual em estoque |
3. bi_interno_view_faturamento — Consulta de Faturamento
| Campo | Descrição |
| id | Identificador do item |
| cnpj_distribuidor | CNPJ da distribuidora |
| data | Data de emissão da nota |
| num_nota | Número da nota fiscal |
| codigo_cliente | Código do cliente |
| cnpj_cliente | CNPJ/CPF do cliente |
| cod_vendedor | Código do vendedor |
| nom_vendedor | Nome do vendedor |
| cod_gerente | Código do gerente |
| nom_gerente | Nome do gerente |
| cod_operacao | Código da operação (CFOP) |
| nome_operacao | Tipo de operação (VENDA, BONIFICAÇÃO, DEVOLUÇÃO etc.) |
| cod_produto | Código do produto |
| quantidade | Quantidade de itens |
| valor_unitario | Valor unitário |
| valor_total | Valor total |
| markup_percentual | Percentual de markup |
| margem_lucro_percentual | Percentual de margem de lucro |
| valor_desconto | Valor de desconto |
| status | Status da nota (EMITIDA ou CANCELADA) |
| ean | Código EAN do produto |
4. bi_interno_view_produto — Consulta de Produtos
| Campo | Descrição |
| cod_produto | Código do produto |
| descricao | Descrição do produto |
| cod_grupo | Código do grupo de produtos |
| nome_grupo | Nome do grupo de produtos |
| cod_familia | Código da família |
| nome_familia | Nome da família |
| cod_fornecedor | Código do fornecedor |
| nome_fornecedor | Nome do fornecedor |
| situacao | Situação do produto (ativo/inativo) |
| unidade_de_medida | Unidade de medida |
| ean | Código EAN |
Código de Retorno HTTP
| Código | Descrição |
| 200 | Requisição bem-sucedida |
| 400 | Parâmetros inválidos (ex: nome da view incorreto) |
| 500 | Erro interno no servidor ou falha na consulta |
Segurança
- A API valida o parâmetro view com expressão regular, aceitando apenas [a-zA-Z0-9_].
- A conexão é feita com base nas credenciais armazenadas na sessão PHP ($_SESSION).
- A chave key deve ser previamente configurada e validada no ERP.
Observações Técnicas
- O retorno é sempre em UTF-8, com JSON formatado.
- A resposta é padronizada com campos "status", "view", "rows" e "message".
- Caso a view não retorne resultados, o campo "rows" será omitido e "message" conterá "No records located".
- A execução das consultas depende das permissões do schema configurado em $_SESSION['SEARCHPATH'].
Power BI
Uma alteração importante no Power BI é no editor avançado adicionar o código para a fonte de dados: