logo
facebook   instagram   linkedin   youtube

Diretório de Web Services

Somente para materiais gráficos. Use sempre conexões seguras (https/tls).

Integração de login

Arquivo Modelo

auth.html

Descrição

O arquivo em anexo é um exemplo de como é possível fazer a autenticação no nosso sistema diretamente do seu site. Basta fazer um post do formulário para a URL de login no nosso portal, os nomes dos campos devem ser respeitados.

O login será feito no portal personalizado (www.w2p.net.br), você pode configurar esse site com seu logo, fundo e um padrão de cores que represente melhor sua identidade visual.

Dados de todas as unidades
sUnidades

Exemplo

sUnidades?usr=1160&tkn=3FD1081984F9

CDN disponível para esse método, utilize: https://cdn.ipressnet.com.br/.

Parâmetros
Variável Descrição Exemplo
usr código da empresa 1160
tkn token da empresa 3FD1081984F9
Descrição

Esse método retorna todas as unidades cadastradas como franquias.

Dados de uma unidade
sUnidade

Exemplo

sUnidade?usr=1160&tkn=3FD1081984F9&id=1257

CDN disponível para esse método, utilize: https://cdn.ipressnet.com.br/.

Parâmetros
Variável Descrição Exemplo
usr código da empresa 1160
tkn token da empresa 3FD1081984F9
id código da unidade 1257
Descrição

Esse método retorna todas as unidades cadastradas como franquias.

Dados de todos os materiais
sMateriais

Exemplo

sMateriais?usr=1160&tkn=3FD1081984F9

CDN disponível para esse método, utilize: https://cdn.ipressnet.com.br/.

Parâmetros
Variável Descrição Exemplo
usr código da empresa 1160
tkn token da empresa 3FD1081984F9
Descrição

Esse método retorna uma lista de todos os materiais próprios cadastrados na sua área de cliente.

Dados de um material
sMaterial

Exemplo

sMaterial?usr=1160&tkn=3FD1081984F9&id=12133

CDN disponível para esse método, utilize: https://cdn.ipressnet.com.br/.

Parâmetros
Variável Descrição Exemplo
usr código da empresa 1160
tkn token da empresa 3FD1081984F9
id código do material 12133
Descrição

Esse método retorna uma lista de todos os materiais próprios cadastrados na sua área de cliente.

Consulta de frete
cFretes

Exemplo

retorno sem transportadoras

retorno com transportadoras

CDN disponível para esse método, utilize: https://cdn.ipressnet.com.br/.

Parâmetros
Variável Descrição Exemplo
cep cep de destino sem hífen 05095000
peso peso em quilos com vírgula separando decimais 1,530
valor valor total do pedido é necessário para consultas de fretes em transportadoras (opcional) 123,45
Descrição

Esse método consulta os fretes disponíveis para determinada região, basta informar o CEP de destino, o peso do material e opcionalmente o valor do pedido.

Se o cliente for uma Pessoa Física e o valor total do pedido for enviado nos parâmetros do método, será possível consultar o frete em transportadoras também.

A área de cobertura é de inteira responsabilidade dos operadores logísticos, não temos nenhuma influência sobre ela, ou sobre os produtos oferecidos, ou suas limitações para cada destino.

Códigos dos Tipos de Frete
Código Tipo Disponibilidade
B2B - iPedido B2C - iPedidoRev
22 Sedex
23 PAC
26 Impresso
3 Sua transportadora (FOB) CNPJ
31 Braspress (se enviado valor na consulta) CNPJ CPF
– TDB Transporte
– JadLog Expresso
– JadLog Econômico
– Jamef Terrestre
4 Cliente retira

Nem sempre todas as opções estão disponíveis, é importante sempre consultar as opções disponíveis para o CEP de destino, os Correios e transportadoras podem exibir produtos diferentes dependendo do destino e peso do pedido, podendo mudar seus critérios a qualquer momento.

Inserir pedido B2B
iPedido

Arquivo Modelo

iPedido.html

URL do Post

https://www.ipressnet.com.br/ws/iPedido

Parâmetros
Input Descrição Tipo
csr
 usuário (não o código) de um contato da unidade alfanumérico
100
tkn
 token de um contato da unidade alfanumérico
12
controle identificação para controle do cliente alfanumérico
14
setor para controle do cliente alfanumérico
10
fone
 telefone com DDD do destinatário alfanumérico
15
destinatario
 nome do destinatário alfanumérico
40
endereco
 endereço do destinatário alfanumérico
60
numero
 número do endereço do destinatário alfanumérico
10
complemento complemento do endereço alfanumérico
20
bairro
 bairro do destinatário alfanumérico
18
cidade
 cidade do destinatário alfanumérico
28
estado
 sigla do estado do destinatário alfa
2
cep
 CEP do destinatário numérico
8
obs observações pertinentes ao pedido alfanumérico
500
entrega
 tipo de entrega (consultar cFretes) numérico
2
ambiente
 tipo de ambiente (produção/homologação) numérico
1
— dados da transportadora (obrigatório se entrega = 3) —
tNome
 Razão Social da transportadora alfanumérico
60
tCnpj
 CNPJ da transportadora numérico
18
tEndereco
 endereço completo da transportadora alfanumérico
60
tBairro bairro da transportadora alfanumérico
20
tCidade
 cidade da transportadora alfanumérico
20
tEstado
 sigla do estado da transportadora alfa
2
tCep
 CEP da transportadora numérico
8
tEmail
 Email da transportadora alfanumérico
100
tDDDFone
 DDD do telefone da transportadora numérico
2
tFone
 Telefone da transportadora numérico
9
— início do loop de produtos (máximo 50 produtos) —
materialN
 código do material numérico
6
qtdN
 quantidade do material numérico
4
— início do loop de kits (máximo 50 kits) —
kit-materialN
 código do kit numérico
6
kit-qtdN
 quantidade do kit numérico
4
XML de Retorno
Tag Descrição Tipo
retorno código de retorno numérico
msg mensagem de retorno alfanumérico
pedido código do pedido gerado no SIG numérico
peso peso calculado pelo sistema decimal
valor valor do pedido calculado pelo sistema decimal
trace detalhes da transação alfanumérico
Descrição

O arquivo em anexo é um exemplo de como é possível inserir um pedido no nosso sistema diretamente do seu site ou loja virtual. Basta fazer um post do formulário para a URL do método, os nomes dos campos devem ser respeitados.

Lembrando que antes deve ser consultado os tipos de fretes disponíveis para o endereço de destino com o método cFretes.

Esse método não funciona para redes, apenas para cadastros únicos. O retorno será em XML, veja o modelo para mais informações.

Observações
  • Enviar os dados via POST para https://www.ipressnet.com.br/ws/iPedidoRev, usando encode Windows-1252, similar a ISO 8859-1. UTF causará problemas nas palavras acentuadas.
  • Pedidos enviados para o ambiente de testes são excluídos pelo sistema após 3 dias úteis.

Inserir pedido B2C
iPedidoRev

Arquivo Modelo

iPedidoRev.html

URL do Post

https://www.ipressnet.com.br/ws/iPedidoRev

Parâmetros
Input Descrição Tipo
cpf
 cpf ou cnpj do cliente da revenda numérico
14
cupom
 cupom da unidade alfanumérico
19
controle identificação para controle do cliente alfanumérico
14
setor para controle do cliente alfanumérico
10
fone
 telefone com DDD do destinatário alfanumérico
15
destinatario
 nome do destinatário alfanumérico
40
email
 e-mail do destinatário alfanumérico
100
endereco
 endereço do destinatário alfanumérico
60
numero
 número do endereço do destinatário alfanumérico
10
complemento complemento do endereço alfanumérico
20
bairro
 bairro do destinatário alfanumérico
18
cidade
 cidade do destinatário alfanumérico
28
estado
 sigla do estado do destinatário alfa
2
cep
 CEP do destinatário numérico
8
obs observações pertinentes ao pedido alfanumérico
500
entrega
 tipo de entrega (consultar cFretes) numérico
2
ambiente
 tipo de ambiente (produção/homologação) numérico
1
— início do loop de produtos (máximo 50 produtos) —
materialN
 código do material numérico
6
qtdN
 quantidade do material numérico
4
— início do loop de kits (máximo 50 kits) —
kit-materialN
 código do kit numérico
6
kit-qtdN
 quantidade do kit numérico
4
XML de Retorno
Tag Descrição Tipo
retorno código de retorno numérico
msg mensagem de retorno alfanumérico
pedido código do pedido gerado no SIG numérico
peso peso calculado pelo sistema decimal
valor valor do pedido calculado pelo sistema decimal
pix url para pagamento via pix alfanumérico
boleto url para pagamento via boleto alfanumérico
cartao url para pagamento via cartão de crédito alfanumérico
trace detalhes da transação alfanumérico
Descrição

O arquivo em anexo é um exemplo de como é possível inserir um pedido no nosso sistema de revenda diretamente do seu site ou loja virtual. Basta fazer um post do formulário para a URL do método, os nomes dos campos devem ser respeitados.

Atualmente este método funciona apenas para os cadastros das unidades e não para o escritório central. O escritório central pode usá-lo para inserir o pedido em nome da unidade.

Lembrando que antes deve ser consultado os tipos de fretes disponíveis para o endereço de destino com o método cFretes.

O retorno será em XML, veja o modelo para mais informações.

Observações
  • Enviar os dados via POST para https://www.ipressnet.com.br/ws/iPedidoRev, usando encode Windows-1252, similar a ISO 8859-1. UTF causará problemas nas palavras acentuadas.
  • Pedidos enviados para o ambiente de testes são excluídos pelo sistema após 3 dias úteis.

Selecionar pedidos pela data
sPedidos

Exemplo

sPedidos?usr=1160&tkn=3FD1081984F9&di=1/1/2013&df=31/12/2013

CDN disponível para esse método, utilize: https://cdn.ipressnet.com.br/.

Parâmetros
Variável Descrição Exemplo
usr código da empresa 1160
tkn token da empresa 3FD1081984F9
di data inicial 1/1/2013
df data final 31/12/2013
inf 1: informações completas; 0: sem dados sobre seriais e trackings (opcional). 1
Descrição

Para obter os dados de um ou mais pedidos de materiais gráficos dentro de uma faixa de data, basta fornecer a data inicial e final para a pesquisa.

Se o parâmetro inf não for enviado, será considerado inf=1.

Status de Pedido
Na fila Produção Acabamento Expedição Coleta/Retirada Enviado

Selecionar pedido pelo código
sPedido

Exemplo

sPedido?usr=1160&tkn=3FD1081984F9&id=9183

CDN disponível para esse método, utilize: https://cdn.ipressnet.com.br/.

Parâmetros
Variável Descrição Exemplo
usr código da empresa 1160
tkn token da empresa 3FD1081984F9
id código do pedido (OS) 9183
Descrição

Para obter os dados de um pedido de materiais gráficos.

Status de Pedido
Na fila Produção Acabamento Expedição Coleta/Retirada Enviado

Validar serial de um material
vSerial

Exemplo

apenas validação

válido com info

inválido

CDN disponível para esse método, utilize: https://cdn.ipressnet.com.br/.

Franqueadoras podem usar seu código de usuário para validar seriais de suas unidades, não é necessário usar o código da unidade que fez o pedido.

Parâmetros
Variável Descrição Exemplo
usr código da empresa (opcional) 3779
id código do serial 12000000053
Descrição

Os materiais produzidos na iPressnet são serializados. Além de aprimorar o nosso controle de qualidade, essa ferramenta permite que os Franqueadores e Licenciadores gerenciem e controlem o uso desses materiais. Clientes que possuem o sistema de gestão SIG W2Pf podem, através do serial, diminuir a evasão de materiais e também incorporar práticas de CRM (marketing) em seus clientes.

Cada material segue com dois QRcodes que identificam o título da apostila (Photoshop, Internet, Word, Excel etc) e um número serial que o torna único.

O número serial é composto por dois dígitos verificadores calculados com Módulo de 11, mesmo padrão do CPF. Fazendo o cálculo é possível identificar se o serial é válido mesmo sem Internet, esse método não identificará o material.

De forma mais eficiente, os dados podem ser capturados por um sistema de gestão através do nosso webservice, obtendo mais detalhes desse material, até mesmo quantas validações daquele número já foram feitas.

Extrato de venda de direitos autorais por data
eDireitos

Exemplo

eDireitos?usr=1160&tkn=3FD1081984F9&di=1/1/2013&df=31/12/2013

Esse exemplo retornará vazio, não temos dados para simular essa requisição.

Parâmetros
Variável Descrição Exemplo
usr código da empresa 1160
tkn token da empresa 3FD1081984F9
di data inicial 1/1/2013
df data final 31/12/2013
Descrição

Para obter o extrato com o volume de vendas referente aos direitos autorais de materiais gráficos, os dados são agrupados por cliente e material.

Lista de materiais concedidos
sConcessoes

Exemplo

sConcessoes?usr=1160&tkn=3FD1081984F9

Esse exemplo retornará vazio, não temos dados para simular essa requisição.

Parâmetros
Variável Descrição Exemplo
usr código da empresa 1160
tkn token da empresa 3FD1081984F9
Descrição

Esse método retorna uma lista de todos os materiais cadastrados que tiveram seus direitos de reprodução concedidos para outros clientes.

Atalhos da revenda

Todos os atalhos da revenda usam como base a URL de entrada da loja, exemplo: https://www.b2w.net.br/?id=1160, adicione os parâmetros no final da URL. Veja mais informações sobre a revenda.

Use o código e token da empresa nos parâmetro ID e TK, não os dados de um contato.

Inserir um material no carrinho

Envie no parâmetro CO, o código do material a ser adicionado no carrinho. Podem ser enviados vários materiais separados por vírgula.

Exemplo: https://www.b2w.net.br/?id=1160&co=43942

Inserir um kit no carrinho

Envie no parâmetro KT, o código do kit a ser adicionado no carrinho. Podem ser enviados vários kits separados por vírgula.

Exemplo: https://www.b2w.net.br/?id=1160&kt=124

Abrir a loja direto em uma categoria específica

Envie no parâmetro CT, o código da categoria que será aberta automaticamente.

Exemplo: https://www.b2w.net.br/?id=1160&ct=814
Observações

Os pagamentos são processados por nós para controle dos Royalties, não é possível usar gateways ou outros meios de cobrança externos.

Há um limite de 5.000 requisições por hora, essa medida é para proteger os serviços de uma sobrecarga de requisições que poderia prejudicar a perfomance do ambiente.

Otimize seu sistema para fazer somente requisições necessárias, seguem algumas boas práticas:

  • O uso do endpoint sPedido pode ser feito duas vezes por dia, o status do pedido não muda frequentemente durante o dia, dessa forma, duas ou três requisições por dia é o suficiente para manter o status do pedido atualizado. O mesmo vale para o endpoint sPedidos.
  • Os endpoints sMaterial e sMateriais também podem ter o uso otimizado. Tanto os dados de um material como de todos, podem ser armazenados em cache, com isso será necessário menos requisições e a performance melhorará já que não será necessário esperar a resposta do endpoint para prosseguir com a navegação do cliente, aumentando a velocidade do site.
  • A consulta de frete pelo endpoint cFretes também pode ser menos frequente, normalmente os Correios ou as Transportadoras mudam os valores dos fretes apenas um vez por mês, então consultas para o mesmo destino e com o mesmo peso podem ser armazenadas localmente.
  • Use nossa CDN (Content Delivery Network) para os métodos que possuem essa opção.

É importante ressaltar que essa não é apenas uma medida para não sobrecarregar o ambiente mas também para melhorar a performance do site que está sendo integrado ao SIG. Fazendo menos requisições, irá impedir que a navegação do cliente seja paralisada até se obter a resposta dos endpoints e irá melhorar a experiência de navegação. Também poupará o consumo excessivo de tráfego no seu provedor de hospedagem, economizando banda.

Use sempre conexões seguras (https/tls)
Use nossa CDN (Content Delivery Network) quando disponível
Última atualização: 30/08/2022
Endereço
R. Camacam, 399 – Vila Anastácio
São Paulo – SP – 05095-000
Contato
(11) 3644-5596
www.ipressnet.com.br
facebook Curta nossa fanpage
Soluções inteligentes em gestão de materiais