Exibir origem

01. DADOS GERAIS

Produto:
Linha de Produto:	Virtual Age
Segmento:
Módulo:
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-8312

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.

03. SOLUÇÃO

Foram realizadas as implementações necessárias para que a integração do PLP do TOTVS Moda com os correios possa ser utilizada, são elas:

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 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;
- "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 foram incluídas também as opções: "Tipo objeto", "Imprimir" e "Nr. vias". A opção "Tipo objeto" é utilizada para ser 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).

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-2-14_9-4-26.png

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

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-2-14_9-9-0.png

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

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.

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

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-2-14_12-2-7.png

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.

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-2-14_12-3-32.png

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.

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-2-14_13-54-11.png

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".

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-1-25_9-46-18.png

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

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-1-25_9-47-26.png

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

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-2-14_12-13-37.png

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.

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-2-14_13-48-16.png

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.

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-2-14_13-49-53.png

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.

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-2-14_13-55-40.png

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".

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-1-25_10-36-2.png

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

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-2-14_13-56-41.png

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.

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-2-14_13-58-22.png

Imagem 12 - 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.

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-2-14_13-59-39.png

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

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-1-26_11-48-45.png

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

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > image2023-2-14_14-1-34.png

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

No PEDFP158 foi implementado para que ao realizar o envio da PLP, seja impresso um relatório com os itens enviados, para isto 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).

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > pedfp158 envio com impressao.gif

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

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.

TOTVS Moda > DT Integração de pré-lista de postagem do TOTVS Moda com os Correios > pedfp158 filtro tipo objeto.gif

Imagem 01 - Demonstração do funcionamento do filtro "Tipo objeto" do PEDFP158. Este filtro irá buscar os pedidos conforme o "Tipo objeto PLP" do PEDFM111.