Mudanças entre as edições de "InteliPost"

De Tek-System Wiki
Ir para navegação Ir para pesquisar
 
(20 revisões intermediárias por um outro usuário não estão sendo mostradas)
Linha 1: Linha 1:
Intelipost é uma empresa responsável pela logística com rastreamento e monitoramento de produtos.
Intelipost é uma empresa responsável pela logística com rastreamento e monitoramento de mercadorias.


== Cadastro do Transportador para InteliPost ==
== Transportador para InteliPost ==


Deve cadastrar um Transportador para InteliPost e defini-lo como '''Agenciador de Carga'''.
Deve cadastrar um Transportador para InteliPost e defini-lo como '''Agenciador de Carga'''.
Linha 10: Linha 10:




== Cadastro do Transportador - Transportadores pedido de venda ==
== Transportador - Transportadores pedido de venda ==


Deve acessar os transportadores configurados nos canais de venda e informar o '''ID p/ Integração''' disponível no painel da InteliPost conforme imagem acima.
Deve acessar os cadastros de transportadores configurados nos canais de venda e informar o '''ID p/ Integração''' disponível no painel da InteliPost conforme imagem acima.


[[Arquivo:Intelispost_transportador.png]]
[[Arquivo:Intelispost_transportador.png]]
== Tags ==
Criar tag característica do '''item''' para determinar se permite agrupar produtos na cotação de frete.
A tag é do tipo lógico.
[[Arquivo:Unit_config_intelipost_tags.png]]
Criar tag característica do '''item''' para informar o tempo de crossdoking, ou seja, tempo em dias que é gasto para preparar ou adquirir um produto para ser despachado, esse tempo será acrescido na previsão de entrega.
[[Arquivo:Unit_config_intelipost_tags_2.png]]
Criar tag caraterística da '''pessoa''' para diferenciar cotação de frete.
O valor da tag precisa ser exatamente o configuração nas regras de cotação no painel administrativo da InteliPost. Veja como realizar essa configuração na InteliPost clicando [http://faq.intelipost.com.br/artigos/regra-de-cotacao-por-tipo-de-cliente/ Aqui].
[[Arquivo:Unit_config_intelipost_tags_3.png]]
== Volumes/Produto ==
Atentar-se as dimensões e peso bruto para obter o cálculo correto do frete.
Está informação é enviada ao sincronizar os dados do pedido com a InteliPost.
== Órgão ==
Criar órgão para InteliPost.
[[Arquivo:Orgao_intelipost.png]]
== Status ==
Criar os seguintes status:
* Pedido Criado (InteliPost)
* Pedido Pronto para Envio (InteliPost)
[[Arquivo:Status_intelipost.png]]
== Unit de Configuração ==
Deve executar processamento específico chamado TEK-> INTELIPOST: INICIALIZAR CONFIGURAÇÃO para criar a unit e realizar as configurações.
Segue orientações para cada campo disponível para configuração:
* '''Token:''' A InteliPost envia essa informação ao cliente. Caso o cliente não tenha, solicite a ele entrar em contato com a InteliPost e solicitar o token.
* '''Url:''' Informar '''https://api.intelipost.com.br/api/v1/'''.
* '''idIntelipost:'''
Acessar o painel administrativo da InteliPost, ao lado do nome do usuário é exibido o código da ID. Veja na imagem abaixo:
[[Arquivo:Unit_config_intelipost_id.png|1200px]]
* '''codigoPessoaIntelipost:''' Código do Transportador da InteliPost cadastrado no menu '''Transportador para InteliPost'''.
* '''urlRastreio:''' Manter valor '''http://status.intelipost.com.br/tracking/'''.
* '''codOrgao:''' Código do órgão da InteliPost.
* '''emailsnotificacao:''' E-mails para receber notificações de erro.
* '''naturezaProduto:''' Natureza de produtos transportados. Exemplo: Móveis.
* '''statusEntregue:''' Manter valor '''DELIVERED'''.
* '''fusoHorario:''' Manter valor '''-03:00'''.
* '''tipoEmbalagem:''' Informar conforme imagem abaixo.
[[Arquivo:Unit_config_intelipost_tipoEmbalagem.png]]
* '''statusPedidoCriadoIntelipost:''' Código do status Pedido Criado (InteliPost).
* '''statusPedidoProntoEnvio:''' Código do status Pedido Pronto para Envio (InteliPost).
* '''tagPermiteAgruparProduto:''' Código da tag característica do item que irá determinar se pode agrupar produtos em uma mesma caixa ao cotar valor do frete.
* '''tagCrossdocking:''' Código da tag característica do item do crossdocking que irá determinar o tempo de entrega do produto.
* '''tagTipoCliente:''' Código da tag característica da pessoa que possibilitará diferenciar cotação de frete.
* '''TempoEntreRequisicoesCotacao:''' Manter o valor em '''610'''.
Todas as configurações acima podem ser empresa. A configuração por empresa deve seguir o modelo abaixo:
  "config_empresa": [
    {
        "empresa": 1,
        <informe aqui os atributos>
    }
  ]
Onde está escrito '''<informe aqui os atributos>''' pode ser substituído por exemplo o token, ficando da seguinte forma.
  "config_empresa": [
    {
        "empresa": 1,
        "token": "964dc1f53..."
    }
  ]
Todos os atributos que não estivem dentro da configuração da empresa, serão considerados como padrão para todas as empresas.
== Usar Redespacho no lugar do Tranportador ==
Criado Tag ''' EnviaDadosRedespachoIntelipost ''' para indicar se quer enviar a ID do Redespacho ao invés de enviar a ID do Transportador ao '''Criar Pedido na Intelipost'''.
* ''' "EnviaDadosRedespachoIntelipost": true,'''  Verifica se existe redespacho no pedido e envia a ID correspondente ao serviço de frete atribuído como padrão no cadastro do redespacho. Se não possuir redespacho vinculado ao pedido, usa o transportador vinculado ao pedido.
* ''' "EnviaDadosRedespachoIntelipost": false,''' irá sempre usar o transportador atribuído ao pedido.
* '''Observação''' Para os clientes que usam a Intelipost não precisa enviar a tag, pois se não existir usará o transportador como padrão.
== Processamentos ==
A integração com InteliPost consiste em alguns processamentos específicos, são:
* '''TEK-> INTELIPOST: CRIAR COTAÇÃO DE FRETE'''
O processamento consiste em permitir o usuário selecionar pedidos de venda e assistências e criar na Intelipost uma cotação de frete. A intelipost irá retornar as opções de frete, constando o transportador, serviço, dias para entrega e valor de frete.
Dependendo que o usuário selecionar, o processamento irá escolher uma opção de frete obedecendo o critério de menor preço ou menor prazo de entrega.
Após definida a opção de frete, o processamento irá atualizar o pedido com os dados do transportador, do serviço de frete, anexar o arquivo Json no documento, preencher valor de frete e observação.
* '''TEK-> INTELIPOST: CRIAR PEDIDO DE ENVIO'''
Este processamento é responsável por enviar dados dos pedidos de venda para a Intelipost.
O sistema irá exibir para o usuário os pedidos faturados que ainda não foram enviados para a Intelipost.
* '''TEK-> INTELIPOST: ATUALIZAR STATUS DOS PEDIDOS'''
Este processamento irá notificar que o pedido está pronto para ser enviado, notificar que o pedido foi despacaho e irá consultar na Intelipost se o pedido está com status de entregue. Caso positivo, o sistema irá trocar o status do pedido para entregue e vai atribuir data de entrega ao documento.
Pode-se automatizar sua execução.
* '''TEK_INTELIPOST_PROCESSAMENTOS.ImportarHistoricoStatus'''
Este processamento só pode ser agendado. É responsável por buscar o histórico de mudança de status na InteliPost. Cada mudança de status é registrada no histórico de status do pedido.
== Documentos (pedido/assistência) ==
Empresas que possuem integrações com ecommerces/lojas virtuais, os documentos serão importados com a informação do transportador e serviço de frete conforme configurado dentro do ERP e também no painel administrativo do canal de venda.
[[Arquivo:Unit_config_intelipost_pedido.png]]
Em seguida, deve-se faturar este documento.
Próximo passo é executar o processamento '''TEK-> INTELIPOST: CRIAR PEDIDO DE ENVIO''' para criar o pedido na InteliPost.
Após criar o pedido na InteliPost, quando os produtos estiverem prontos para serem enviados, executar o processamento '''TEK-> INTELIPOST: ATUALIZAR STATUS DOS PEDIDOS''' selecionando a finalidade '''Pronto para Envio'''.
[[Arquivo:Intelipost_pronto_envio.png]]
Após coleta da mercadoria, execute o processamento '''TEK-> INTELIPOST: ATUALIZAR STATUS DOS PEDIDOS''' selecionando a finalidade '''Pedido Despachado''' para atribuir aos documentos da carga a data de postagem, código de rastreio e url de rastreio.
[[Arquivo:Intelipost_despacho.png]]
Por fim, execute o processamento '''TEK-> INTELIPOST: ATUALIZAR STATUS DOS PEDIDOS''' selecionando a finalidade '''Atribuir Entrega no ERP''' para consultar o status do pedido na InteliPost, e se caso esteja como entregue, atribuir essa data ao pedido.
Lembrando que este processamento pode ser agendado. Consulte descrição do processamento para ver as orientações.
[[Arquivo:Intelipost_atribuirEntrega.png]]
== Indicadores ==
Utilize o indicador '''INTELIPOST: RASTREAMENTO DE PEDIDOS''' para acompanhar o processo de entrega das mercadorias.
[[Arquivo:Intelipost_Indicadores_1.png]]
[[Arquivo:Intelipost_Indicadores_2.png]]

Edição atual tal como às 16h51min de 24 de novembro de 2023

Intelipost é uma empresa responsável pela logística com rastreamento e monitoramento de mercadorias.

Transportador para InteliPost

Deve cadastrar um Transportador para InteliPost e defini-lo como Agenciador de Carga.

Na grade Serviços Prestados, cadastre todos os serviços suportados pela InteliPost.

Intelispost transportador intelipost.png Intelispost transportador intelipost site.png


Transportador - Transportadores pedido de venda

Deve acessar os cadastros de transportadores configurados nos canais de venda e informar o ID p/ Integração disponível no painel da InteliPost conforme imagem acima.

Intelispost transportador.png


Tags

Criar tag característica do item para determinar se permite agrupar produtos na cotação de frete.

A tag é do tipo lógico.

Unit config intelipost tags.png

Criar tag característica do item para informar o tempo de crossdoking, ou seja, tempo em dias que é gasto para preparar ou adquirir um produto para ser despachado, esse tempo será acrescido na previsão de entrega.

Unit config intelipost tags 2.png

Criar tag caraterística da pessoa para diferenciar cotação de frete.

O valor da tag precisa ser exatamente o configuração nas regras de cotação no painel administrativo da InteliPost. Veja como realizar essa configuração na InteliPost clicando Aqui.

Unit config intelipost tags 3.png


Volumes/Produto

Atentar-se as dimensões e peso bruto para obter o cálculo correto do frete.

Está informação é enviada ao sincronizar os dados do pedido com a InteliPost.


Órgão

Criar órgão para InteliPost.

Orgao intelipost.png


Status

Criar os seguintes status:

  • Pedido Criado (InteliPost)
  • Pedido Pronto para Envio (InteliPost)

Status intelipost.png


Unit de Configuração

Deve executar processamento específico chamado TEK-> INTELIPOST: INICIALIZAR CONFIGURAÇÃO para criar a unit e realizar as configurações.

Segue orientações para cada campo disponível para configuração:

  • Token: A InteliPost envia essa informação ao cliente. Caso o cliente não tenha, solicite a ele entrar em contato com a InteliPost e solicitar o token.
  • Url: Informar https://api.intelipost.com.br/api/v1/.
  • idIntelipost:

Acessar o painel administrativo da InteliPost, ao lado do nome do usuário é exibido o código da ID. Veja na imagem abaixo:

Unit config intelipost id.png

  • codigoPessoaIntelipost: Código do Transportador da InteliPost cadastrado no menu Transportador para InteliPost.
  • urlRastreio: Manter valor http://status.intelipost.com.br/tracking/.
  • codOrgao: Código do órgão da InteliPost.
  • emailsnotificacao: E-mails para receber notificações de erro.
  • naturezaProduto: Natureza de produtos transportados. Exemplo: Móveis.
  • statusEntregue: Manter valor DELIVERED.
  • fusoHorario: Manter valor -03:00.
  • tipoEmbalagem: Informar conforme imagem abaixo.

Unit config intelipost tipoEmbalagem.png

  • statusPedidoCriadoIntelipost: Código do status Pedido Criado (InteliPost).
  • statusPedidoProntoEnvio: Código do status Pedido Pronto para Envio (InteliPost).
  • tagPermiteAgruparProduto: Código da tag característica do item que irá determinar se pode agrupar produtos em uma mesma caixa ao cotar valor do frete.
  • tagCrossdocking: Código da tag característica do item do crossdocking que irá determinar o tempo de entrega do produto.
  • tagTipoCliente: Código da tag característica da pessoa que possibilitará diferenciar cotação de frete.
  • TempoEntreRequisicoesCotacao: Manter o valor em 610.


Todas as configurações acima podem ser empresa. A configuração por empresa deve seguir o modelo abaixo:

 "config_empresa": [
    {
       "empresa": 1,
       <informe aqui os atributos>
    }
  ]

Onde está escrito <informe aqui os atributos> pode ser substituído por exemplo o token, ficando da seguinte forma.

 "config_empresa": [
    {
       "empresa": 1,
       "token": "964dc1f53..."
    }
  ]

Todos os atributos que não estivem dentro da configuração da empresa, serão considerados como padrão para todas as empresas.

Usar Redespacho no lugar do Tranportador

Criado Tag EnviaDadosRedespachoIntelipost para indicar se quer enviar a ID do Redespacho ao invés de enviar a ID do Transportador ao Criar Pedido na Intelipost.

  • "EnviaDadosRedespachoIntelipost": true, Verifica se existe redespacho no pedido e envia a ID correspondente ao serviço de frete atribuído como padrão no cadastro do redespacho. Se não possuir redespacho vinculado ao pedido, usa o transportador vinculado ao pedido.
  • "EnviaDadosRedespachoIntelipost": false, irá sempre usar o transportador atribuído ao pedido.
  • Observação Para os clientes que usam a Intelipost não precisa enviar a tag, pois se não existir usará o transportador como padrão.

Processamentos

A integração com InteliPost consiste em alguns processamentos específicos, são:

  • TEK-> INTELIPOST: CRIAR COTAÇÃO DE FRETE

O processamento consiste em permitir o usuário selecionar pedidos de venda e assistências e criar na Intelipost uma cotação de frete. A intelipost irá retornar as opções de frete, constando o transportador, serviço, dias para entrega e valor de frete.

Dependendo que o usuário selecionar, o processamento irá escolher uma opção de frete obedecendo o critério de menor preço ou menor prazo de entrega.

Após definida a opção de frete, o processamento irá atualizar o pedido com os dados do transportador, do serviço de frete, anexar o arquivo Json no documento, preencher valor de frete e observação.

  • TEK-> INTELIPOST: CRIAR PEDIDO DE ENVIO

Este processamento é responsável por enviar dados dos pedidos de venda para a Intelipost.

O sistema irá exibir para o usuário os pedidos faturados que ainda não foram enviados para a Intelipost.

  • TEK-> INTELIPOST: ATUALIZAR STATUS DOS PEDIDOS

Este processamento irá notificar que o pedido está pronto para ser enviado, notificar que o pedido foi despacaho e irá consultar na Intelipost se o pedido está com status de entregue. Caso positivo, o sistema irá trocar o status do pedido para entregue e vai atribuir data de entrega ao documento.

Pode-se automatizar sua execução.

  • TEK_INTELIPOST_PROCESSAMENTOS.ImportarHistoricoStatus

Este processamento só pode ser agendado. É responsável por buscar o histórico de mudança de status na InteliPost. Cada mudança de status é registrada no histórico de status do pedido.

Documentos (pedido/assistência)

Empresas que possuem integrações com ecommerces/lojas virtuais, os documentos serão importados com a informação do transportador e serviço de frete conforme configurado dentro do ERP e também no painel administrativo do canal de venda.

Unit config intelipost pedido.png

Em seguida, deve-se faturar este documento.

Próximo passo é executar o processamento TEK-> INTELIPOST: CRIAR PEDIDO DE ENVIO para criar o pedido na InteliPost.

Após criar o pedido na InteliPost, quando os produtos estiverem prontos para serem enviados, executar o processamento TEK-> INTELIPOST: ATUALIZAR STATUS DOS PEDIDOS selecionando a finalidade Pronto para Envio.

Intelipost pronto envio.png

Após coleta da mercadoria, execute o processamento TEK-> INTELIPOST: ATUALIZAR STATUS DOS PEDIDOS selecionando a finalidade Pedido Despachado para atribuir aos documentos da carga a data de postagem, código de rastreio e url de rastreio.

Intelipost despacho.png

Por fim, execute o processamento TEK-> INTELIPOST: ATUALIZAR STATUS DOS PEDIDOS selecionando a finalidade Atribuir Entrega no ERP para consultar o status do pedido na InteliPost, e se caso esteja como entregue, atribuir essa data ao pedido.

Lembrando que este processamento pode ser agendado. Consulte descrição do processamento para ver as orientações.

Intelipost atribuirEntrega.png


Indicadores

Utilize o indicador INTELIPOST: RASTREAMENTO DE PEDIDOS para acompanhar o processo de entrega das mercadorias.

Intelipost Indicadores 1.png

Intelipost Indicadores 2.png