TOTVS Moda

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


01. DADOS GERAIS

Produto:

TOTVS Moda

Linha de Produto:

Virtual Age

Segmento:

Varejo

Módulo:

Moda - 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-8312, DVAARM-8388, DVAARM-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.

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;
    • "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 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).

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.


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


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


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

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.


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 13 - 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 14 - Está sendo acessado novamente o componente PEDFP158, selecionado novamente o pedido de venda "18723"e acionado o botão "Processar".


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


Imagem 16 - 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).

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

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 "Tipo objeto PLP" do PEDFM111 do pedido.

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

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


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


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.


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. 


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