Páginas filhas
  • DT Integração de pré-lista de postagem do TOTVS Moda com os Correios

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Produto:

Solucoes_totvs
SolucaoTOTVS Moda

Linha de Produto:

Virtual Age

Segmento:

Segmentos_totvs
Segmento Varejo

Módulo:

Modulos_totvs_manufatura
ModulosTOTVSManufaturaModa - Faturamento

Função:Realizar a integração de PLP (pré-lista de postagem) do TOTVS Moda com os Correios
País:Brasil
Ticket:15688025
Requisito/Story/Issue (informe o requisito relacionado) :

DVAARM-7886 , DVAARM-8223 DVAARM-8312DVAARM-8388DVAARM-8733, DVACOM-14347



02. SITUAÇÃO/REQUISITO

Foi solicitada a possibilidade de registrar via integração o PLP (pré-lista de postagem) do TOTVS Moda com os correios com o objetivo de dar mais agilidade no processo de expedição.

...

  • No componente INTFM010 foi adicionada a nova função "Geração de PLP", onde o mesmo deverá ter os seguintes campos configurados:
    • DS_URL → URL para geração de PLP informação disponível no manual dos correios;
    • NR_IDENTIFICADOR → CNPJ da empresa;
    • NR_IDPLPCLIENTE → Código gerado pelo cliente para identificação da PLP;
    • DS_USUARIO → Usuário para autentificarão;
    • DS_SENHA → Senha para autentificarão.
  • Foi criado o componente GERFM283, para  para cadastro do cartão postal dos correios utilizado no envio da PLP, onde:
    • "Cartão postagem" → Número do cartão de postagem vinculado ao contrato;
    • "Descrição" → Descrição desejada do cartão postagem;
    • "Pessoa" → Cadastro da pessoa vinculada ao cartão;
    • "Código administrativo" → Código administrativo do contrato;
    • "Contrato" → Número do contrato da empresa;
    • "Identificador serviço" → Serviço disponível no contrato dos correios;
    • "Diretoria regional" → Número da diretoria regional do contrato do cliente;
    • "Serviço de postagem" → Código do serviço de postagem;
    • "Data emissão" → Data de emissão do cartão postal dos correios.
  • No componente PEDFM111 foram adicionados os seguintes campos: "Forma pagamento PLP", "Tipo objeto PLP" e "ID PLP" sendo os dois primeiros para configurações e o terceiro será preenchido quando a integração for efetuada;
  • No componente PEDFP158 foi incluída a opção "Gerar PLP" e quando a mesma for selecionada juntamente com o pedido de venda desejado, o PLP será gerado caso o pedido selecionado tenha uma embalagem vinculada na contagem para extrair as suas dimensões. Caso o mesmo não possua será apresentado componente GERFP008 informando que não é possível continuar.
  • No componente PEDFP158 foi incluída foram incluídas também as opções: "Tipo objeto", "Imprimir" e "Nr. vias". A opção "Tipo objeto" é utilizada para que ao buscar os pedidos no PEDFP158, filtrar os pedidos pelo "Tipo objeto PLP" do PEDFM111ser informado no XML do PLP (tag "tipo_objeto"), caso não seja configurado no pedido. Já o "Imprimir" será utilizado para indicar que no final do processo de envio da PLP seja impresso um relatório com os itens enviados e o campo "Nr. vias" para indicar o número de vias que será impresso o relatório (quando o "Imprimir" for selecionado e o campo "Nr. vias" não for preenchido, será considerado que é para ser impresso apenas uma via do relatório).

Observação: O código de serviço utilizado para gerar o PLP é de acordo com a configuração do ID de serviço realizado através do componente GERFM283, se referindo a um cadastro oriundo dos correios.


Totvs custom tabs box
tabsConfiguração,Emissão da PLP,Emissão da PLP com impressão,Filtrar pedidos por Geração do tipo de objeto no Xml do PLP
idspasso1,passo2,passo3,passo4
Totvs custom tabs box items
defaultyes
referenciapasso1

Imagem 01 - Demonstra o componente INTFM010, onde está realizada a configuração para a geração de PLP.


Image RemovedImage Added

Imagem 02 - Demonstra o GERFM283, onde é configurado são configurados os cartões de postagem do Correios, que deverão ser selecionados no PEDFP158 e utilizados na geração da PLP. 

Image Removed


Image Added

Imagem 03 - Caso seja informada uma data de emissão maior que a data atual do sistema, a mensagem acima é apresentada não permitindo o cadastro do cartão postagem.


Image Added

Imagem 04 Imagem 03 - Após configurado o cartão de postagem do Correios, ao enviar uma PLP, deverá ser selecionado o cartão de postagem que deverá ser utilizado no envio, no filtro "Cartão postagem" do PEDFP158

Totvs custom tabs box items
defaultno
referenciapasso2

Abaixo será demonstrado um exemplo onde o pedido de venda utilizado possui embalagem vinculada para a geração do PLP.

Imagem 01  - Demonstra o componente PEDFM001, onde está sendo consultado o pedido de venda "18722". Em seguida está sendo acionado o botão "Opção adicional...", então o componente PEDFM103 é apresentado e o botão "Dados adicionais..." acionado.


Imagem 02 - Ao acionar o botão mencionado anteriormente, o componente PEDFM111 é apresentado, onde está sendo selecionado no campo "Tipo objeto PLP" a opção "Envelope". 


Observação: Considerar que o pedido demonstrado anteriormente, teve uma contagem criada e que o mesmo foi faturado e sua transação encerrada e que a contagem do mesmo possui a embalagem "1013" vinculada.

Imagem 03 - Demonstra o componente PEDFP158,onde está sendo selecionada a opção "Gerar PLP", selecionado o pedido "18722" e acionado o botão "Processar".


Imagem 04 Ao acionar o botão mencionado anteriormente, a mensagem acima é apresentada onde está sendo selecionada a opção "Sim".

Imagem 05 - Ao selecionar a opção mencionada anteriormente, a mensagem acima é apresentada informando que o processo foi concluído com sucesso.


Imagem 06 - Ao consultar novamente os dados adicionais do pedido de venda "18722" através do componente PEDFM111, pode ser visto que o mesmo está apresentado o número de objeto transporte e que o ID PLP foi gerado corretamente, demonstrado assim que a integração foi realizada com sucesso.


Abaixo será demonstrado um exemplo onde o pedido de venda utilizado não possui uma embalagem vinculada para a geração do PLP.

Imagem 07  - Demonstra o componente PEDFM001, onde está sendo consultado o pedido de venda "18723". Em seguida está sendo acionado o botão "Opção adicional...", então o componente PEDFM103 é apresentado e o botão "Dados adicionais..." acionado.


Imagem 08  - Ao acionar o botão mencionado anteriormente, o componente PEDFM111 é apresentado, onde está sendo selecionado no campo "Tipo objeto PLP" a opção "Envelope". 


Observação: Considerar que o pedido demonstrado anteriormente, teve uma contagem criada e que o mesmo foi faturado e sua transação encerrada e que a contagem do mesmo não possui nenhuma embalagem vinculada.

Imagem 09  - Demonstra o componente PEDFP158,onde está sendo selecionada a opção "Gerar PLP", selecionado o pedido "18723" e acionado o botão "Processar".


Imagem 10 - Ao acionar o botão mencionado anteriormente, a mensagem acima é apresentada onde está sendo selecionada a opção "Sim".


Imagem 11 - Pelo fato da contagem do pedido de venda selecionado não possuir nenhuma embalagem vinculada ao mesmo, o componente GERFP008 é apresentado informando que não é possível gerar o PLP dos correios.


Image Added

Imagem 12 - Na imagem acima é demonstrado as dimensões exigidas para cada tipo de pacote ou caixa, caso estejam foram de padrão, o XML enviado não será aceito.


Imagem 1213 - Demonstra o componente GERFM047, onde está sendo informada a contagem "127122" referente ao pedido de venda "11804" e está sendo adicionado o tipo de embalagem "1013" e realizada a gravação.


Imagem 13 14 - Está sendo acessado novamente o componente PEDFP158, selecionado novamente o pedido de venda "18723"e acionado o botão "Processar".


Imagem 14 15 - Pelo fato da contagem referente ao pedido ter tido um tipo de embalagem vinculado, o processo é concluído com sucesso.


Imagem 15 16 - Ao acessar o componente PEDFM111, pode ser visto que a integração do PLP foi realizada com sucesso.

Totvs custom tabs box items
defaultno
referenciapasso3

No PEDFP158 foi implementado para que ao realizar o envio da PLP, seja impresso um relatório com os itens enviados, para isto foi criado foram criadas as opções "Imprimir" e "Nr. vias".

A opção "Imprimir" será utilizada para indicar se será impresso ou não o relatório dos itens enviados e o campo "Nr. vias" será utilizado para indicar a quantidade de vias que será impresso o relatório (quando o "Imprimir" for selecionado e o campo "Nr. vias" não for preenchido, será considerado que é para ser impresso apenas uma via do relatório).

Imagem 01 - Demonstração do envio da PLP realizando a impressão do relatório dos itens enviados em duas vias. 

Totvs custom tabs box items
defaultno
referenciapasso4

A tag "tipo_objeto" no xml do PLP poderá ser definida no pedido ao informar o campo "Tipo objeto PLP" no PEDFM111.

No PEDFP158 foi adicionado o filtro "Tipo objeto", para que caso o pedido não tenha o tipo de objeto definido no campo "Tipo objeto PLP" no PEDFM111, ao ser processado a PLP no PEDFP158, o tipo informado no filtro será utilizado para a geração do xml para os pedidos que não possua esta informação e nestes pedidos serão gravados o tipo informado no filtro "Tipo objeto" do PEDFP158 no campo Foi adicionado no PEDFP158 o filtro "Tipo objeto", onde ao selecionar um tipo será listado os pedidos com este tipo, conforme gerado no "Tipo objeto PLP" do PEDFM111 do pedido.Image Removed

Imagem 01 - Demonstração do funcionamento do filtro "Tipo objeto" do PEDFP158:

Image Added

Imagem 01 - Pedido 18733 lançado com campo "Tipo objeto PLP" no PEDFM111 como "Envelope".


Image Added

Imagem 02 - Pedido 18734 lançado sem o tipo de objeto no campo "Tipo objeto PLP" no PEDFM111.


Image Added

Imagem 03 - No PEDFP158 foi gerado a PLP dos dois pedidos informando o filtro "Tipo objeto" como "Pacote/Caixa". Este tipo neste filtro somente será gerado para o pedido 18734 que não possui um tipo configurado no pedido.


Image Added

Imagem 04 - No pedido 18733 foi gravado os dados da PLP e manteve o tipo de objeto que estava configurado antes do envio no PEDFP158. 


Image Added

Imagem 05 -  No pedido 18734 foi gravado os dados da PLP, e como não possuía o tipo de objeto gravado no pedido ( filtro irá buscar os pedidos conforme o "Tipo objeto PLP" do PEDFM111), foi utilizado e gravado o tipo informado no filtro "Tipo objeto" do PEDFP158. 




Templatedocumentos