Apresentação
O EPC é um software desenvolvido para auxiliar o processo de venda de peças Toyota.
O EPC tem como objetivo apoiar o processo de vendas de peças Toyota, permitindo a integração entre o catálogo eletrônico e o ERP Sisdia, com intuito de facilitar a geração de orçamentos de peças.
Objetivo dos serviços
Os serviços do EPC têm como objetivo efetuar a integração entre o software de catálogo eletrônico e o ERP Sisdia. Estes serviços visam efetuar a consulta dos dados de peças (quantidade, estoque) e a criação de "cestas de compras", que posteriormente se transformarão em orçamentos.
Se algum erro ocorrer durante a execução dos serviços, estes erros serão retornados em um campo específico.
SERVICOS
SERVIÇO DE CONSULTA DE PEÇAS
Este serviço tem como objetivo retornar a quantidade em estoque e o preço de venda de peças cadastradas no ERP Sisdia. Para a execução deste serviço, é necessário que seja passado um usuário cadastrado na base de dados Sisdia e ativo além dos códigos de peças que se deseja consultar. Abaixo temos os dados que devem ser enviados e os dados que serão retornados pelo EPC.
DADOS DE ENTRADA
Os dados necessários para o serviço de consulta de peças são:
Estrutura de ConsultaEstoque |
|
|
|
Campo | Descrição | Tipo | |
Login | Login do usuário sisdia | Char (8) | |
Pecas | Coleção de peças consultadas | Pecas |
Estrutura de Pecas |
|
|
|
Campo | Descrição | Tipo | |
Codigo | Código da peça consultada | Char (21) |
DADOS DE SAÍDA
Os dados retornados pelo serviço de consulta de peças são:
Estrutura Estoque |
|
|
|
Campo | Descrição | Tipo | |
Login | Login do usuário sisdia | Char (8) | |
Pecas | Coleção de peças retornadas | ConsultaPecas | |
Erros | Coleção de erros encontrados | Erros |
Estrutura ConsultaPecas |
|
|
|
Campo | Descrição | Tipo | |
Normal | Dados da peça consultada | Peca | |
Substituta | Dados da peça substituta (se existir) | Peca | |
Intercambiaveis | Coleção de peças intercambiáveis (se existir) | Intercambiaveis |
Estrutura Intercambiaveis |
|
|
|
Campo | Descrição | Tipo | |
Intercambiavel | Peça intercambiável | Peca |
Estrutura Peca |
|
|
|
Campo | Descrição | Tipo | |
Codigo | Código da peça | Char (21) | |
Estoque | Dados do estoque da peça | QuantidadeValor | |
Promoção | Dados de promoção da peça | QuantidadeValor | |
Status | Status da peça (1- Normal, 2- Substituída, 3- Desativada, 4- Substituta, 5- Intercambiável) | Numérico (1) |
Estrutura QuantidadeValor |
|
|
|
Campo | Descrição | Tipo | |
Quantidade | Quantidade da peça | Numérico (7.2) | |
Valor | Valor de venda da peça | Numérico (7.2) |
Estrutura Erros |
|
|
|
Campo | Descrição | Tipo | |
Erro | Erro encontrado | Erro |
Estrutura Erro |
|
|
|
Campo | Descrição | Tipo | |
Descricao | Descrição do erro encontrado | Char (256) |
EXEMPLO DE XML DE ENTRADA
Abaixo um exemplo de XML de entrada do serviço de Consulta de Peças:
<ConsultaEstoque xmlns="EPC">
<Login>LOGIN</Login>
<Pecas>
<Pecas.Item xmlns="EPC">
<Codigo>CODIGO_DA_PEÇA</Codigo>
</Pecas.Item>
</Pecas>
</ConsultaEstoque>
EXEMPLO DE XML DE SAÍDA
Abaixo um exemplo de XML de saída do serviço de Consulta de Peças:
<Estoque xmlns="EPC">
<Login>LOGIN</Login>
<Pecas>
<ConsultaPecas.ConsultaPeca xmlns="EPC">
<Normal>
<Codigo>CODIGO_DA_PEÇA</Codigo>
<Estoque>
<Quantidade>12345.67</Quantidade>
<Valor>12345.67</Valor>
</Estoque>
<Promocao>
<Quantidade>12345.67</Quantidade>
<Valor>12345.67</Valor>
</Promocao>
<Status>0</Status>
</Normal>
<Substituta>
<Codigo>CODIGO_DA_PEÇA</Codigo>
<Estoque>
<Quantidade>12345.67</Quantidade>
<Valor>12345.67</Valor>
</Estoque>
<Promocao>
<Quantidade>12345.67</Quantidade>
<Valor>12345.67</Valor>
</Promocao>
<Status>0</Status>
</Substituta>
</ConsultaPecas.ConsultaPeca>
</Pecas>
<Erros>
<Erros.Erro xmlns="EPC">
<Descricao>Atenção.</Descricao>
</Erros.Erro>
<Erros.Erro xmlns="EPC">
<Descricao> - A peça de código A não existe.</Descricao>
</Erros.Erro>
</Erros>
</Estoque>
SERVIÇO DE GERAÇÃO E MANUTENÇÃO DE CESTA PARA ORÇAMENTO
Este serviço tem como objetivo cadastrar e dar manutenção em uma cesta de peças para geração de um posterior orçamento, através do ERP Sisdia. Para a execução deste serviço, é necessário que seja passado um usuário cadastrado na base de dados Sisdia e ativo, um número de cesta e um conjunto de peças que formam a cesta. Abaixo temos os dados que devem ser enviados e os dados que serão retornados pelo EPC.
DADOS DE ENTRADA
Os dados necessários para o serviço de Geração de Cesta:
Estrutura de Cesta |
|
|
|
Campo | Descrição | Tipo | |
Código | Numero de Cesta | Numérico (9) | |
Versão | Versão da Cesta | Numérico (4) | |
Filial | Filial da Consulta | Numérico (2) | |
Usuário | Login do usuário Sisdia | Char (8) | |
Data | Data corrente | DateTime | |
Descrição | Descrição da Cesta | Char (70) | |
Produtos | Coleção de peças | Produto |
Estrutura de Produto |
|
|
|
Campo | Descrição | Tipo | |
Codigo | Código da peça | Char (21) | |
Quantidade | Quantidade de Peçãs | Numérico (4) |
DADOS DE SAIDA
Os dados de saída do serviço de Geração de Cesta:
Estrutura de CestaRetorno |
|
|
|
Campo | Descrição | Tipo | |
Código | Numero de Cesta | Numérico(9) | |
Usuário | Login do usuário sisdia | Char (8) | |
Filial | Filial da Consulta | Numérico(2) | |
Erro | Erro encontrado | Erro |
Estrutura Erro |
|
|
|
Campo | Descrição | Tipo | |
Descricao | Descrição do erro encontrado | VarChar (256) |
EXEMPLO DE XML DE ENTRADA
Abaixo um exemplo de XML de entrada do serviço de Geração de Cesta
<Cesta xmlns="EPC">
<Codigo>CODIGO_DA_CESTA</Codigo>
<Versao>0</Versao>
<Filial>0</Filial>
<Usuario>LOGIN</Usuario>
<Data>2009-03-27T11:12:12</Data>
<Descricao>Orçamento para Cliente</Descricao>
<Produtos>
<Produtos.Produto>
<Codigo> CODIGO_DA_PEÇA </Codigo>
<Quantidade>12345.67</Quantidade>
</Produtos.Produto>
<Produtos.Produto>
<Codigo> CODIGO_DA_PEÇA </Codigo>
<Quantidade>12345.67</Quantidade>
</Produtos.Produto>
</Produtos>
</Cesta>
EXEMPLO DE XML DE SAIDA
Abaixo um exemplo de XML de saída do serviço de Geração de Cesta
<CestaRetorno xmlns="EPC">
<Codigo>1</Codigo>
<Usuario>LOGIN</Usuario>
<Filial>1</Filial>
<Erros>
<Erros.Erro>
<Descricao>Atenção.</Descricao>
</Erros.Erro>
<Erros.Erro>
<Descricao>Erro ao salvar o produto: CODIGO_DA_PEÇA da Cesta: 1, não consta no cadastro de produtos.</Descricao>
</Erros.Erro>
</Erros>
</CestaRetorno>
SERVIÇO DE CONSULTA DE STATUS DA CESTA
Este serviço tem como objetivo consultar o status de uma determinada cesta, para que se possa saber se um orçamento já foi gerado. Em caso positivo, o número do orçamento será retornado, caso contrário, será retornado o número 0. Para a execução deste serviço, é necessário que seja passado um usuário ativo, cadastrado na base de dados Sisdia e o numero de Cesta a consultar. Abaixo temos os dados que devem ser enviados e os dados que serão retornados pelo EPC.
DADOS DE ENTRADA
Os dados necessários para o serviço de Consulta Status de Cesta:
Estrutura de CestaConsultada |
|
|
|
Campo | Descrição | Tipo | |
Código | Numero de Cesta | Numérico(9) | |
Usuário | Login do usuário sisdia | Char (8) |
DADOS DE SAIDA
Os dados de saída do serviço de Consulta Status de Cesta:
Estrutura de StatusCesta |
|
|
|
Campo | Descrição | Tipo | |
Código | Numero de Cesta | Numérico(9) | |
Usuário | Login do usuário sisdia | Char (8) | |
Orçamento | Numero do Orçamento do ERP | Numérico(9) | |
Erro | Erro encontrado | Erro |
Estrutura Erro |
|
|
|
Campo | Descrição | Tipo | |
Descricao | Descrição do erro encontrado | VarChar (256) |
EXEMPLO DE XML DE ENTRADA
Abaixo um exemplo de XML de entrada do serviço de Consulta Status de Cesta
<CestaConsultada xmlns="EPC">
<Codigo>CODIGO_DA_CESTA</Codigo>
<Usuario>LOGIN</Usuario>
</CestaConsultada>
EXEMPLO DE XML DE SAIDA
Abaixo um exemplo de XML de saída do serviço de Consulta Status de Cesta
<StatusCesta xmlns="EPC">
<Codigo> CODIGO_DA_CESTA </Codigo>
<Usuario>LOGIN</Usuario>
<Orcamento>NUMERO_DO_ORCAMENTO</Orcamento>
<Erros>
</Erros>
</StatusCesta>
LISTA DE PARÂMETROS DO SISTEMA
Código | Nome | Valores Possíveis | Utilidade |
EP1 | Diretório | "/usr/local/tomcat/webaaps/epc/logs" | Diretório onde os logs dos serviços serão gerados. |
EP2 | Log Ativo | "S", "N" | Indica se o log está ativo ("S") ou não ("N"). |