01. DADOS GERAIS
Produto: | TOTVS Moda |
---|---|
Linha de Produto: | Virtual Age |
Segmento: | Varejo |
Módulo: | Integração |
Função: | Processamento de pacote geral - Pacote 7011 |
País: | Brasil |
Ticket: | 11701388 |
Requisito/Story/Issue (informe o requisito relacionado) : |
02. SITUAÇÃO/REQUISITO
Foi solicitado a possibilidade de gerar o financeiro ao processar o pacote 7011 (Transação com finalização).
03. SOLUÇÃO
Implementado para caso a operação enviada no pacote estiver marcada para gerar financeiro, validar uma nova opção no pacote que irá indicar se o pacote deve ou não gerar financeiro.
Para realizar os testes demonstrados nessa documentação, todos os pacotes foram gerados através da API V2 data-package pelo endpoint de inclusão de pacote.
As próximas imagens irão exemplificar o funcionamento com operação configurada para gerar financeiro.
Imagem 1 - Demonstra a configuração da operação 7012 configurada para gerar financeiro.
Imagem 2 - Demonstra que o conteúdo do pacote 14521 foi gerado com a operação 7012 (demonstrada na imagem 1) e a nova opção "payments" enviado com o valor "F" que indica para não gerar os dados de pagamento.
Imagem 3 - Ao processar o pacote 14521 que foi demonstrado na imagem 2, pode ser observado que o mesmo foi processado com erro, pois a operação enviada no pacote indica para gerar financeiro, porém a nova opção do pacote "payments" indica para não gerar dados de pagamento. Assim a transação não foi gerada para este pacote.
Observação: Caso a nova opção "payments" não seja enviada no pacote, será realizada a mesma validação demonstrada na imagem 3.
Imagem 4 - Já para o pacote 14520 também é utilizado a operação 7012 e a nova opção "payments" está com o valor "T" que indica para gerar o financeiro, pode ser observado que o mesmo foi processado normalmente, gerando a transação 3772 do dia 16/06/2021 na empresa 1.
Imagem 5 - Ao consultar os dados de liquidação para a transação gerada (demonstrada na imagem 4), pode ser observado que foi gerado duas faturas. Foi utilizado a condição de pagamento recebido no pacote para saber quantas parcelas devem ser geradas, a imagem 6 demonstrada abaixo mostra a condição de pagamento 1 recebido no pacote configurada com 2 parcelas.
Imagem 6 - Demonstra a condição de pagamento utilizada no pacote.
Observação: Também é possível enviar os dados de centro de custo para a fatura, ou seja, caso a tag "payments" estiver como "T" e a operação indicar para gerar financeiro, é possível enviar uma lista de centro de custo que será gravado os dados na fatura gerada. No final da documentação existe um exemplo do como ser enviado.
As próximas imagens irão exemplificar o funcionamento com operação configurada para não gerar financeiro.
Imagem 7 - Demonstra a configuração da operação 7011 configurada para não gerar financeiro.
Imagem 8 - Demonstra que o pacote 14518 foi gerado com a operação 7011 (demonstrada na imagem 7), e a nova opção de "payments" foi enviado "T". O pacote foi processado normalmente, gerando a transação 3770 do dia 16/06/2021 na empresa 1.
Imagem 9 - Ao realizar a consulta de liquidação da transação, pode ser observado que para a transação demonstrada na imagem 8, não foi gerado dados de pagamento, pois a operação não está configurada para isto.
Observação: Se a operação não estiver configurada para gerar financeiro, o processamento do pacote 7011 irá ignorar a nova opção "payments", ou seja, é interessante que seja enviada a tag como "F" para respeitar um padrão, porém se não enviar ou enviar a mesma como "T" o sistema irá ignorar a mesma e respeitar apenas a operação que está indicando para não gerar financeiro.
04. DEMAIS INFORMAÇÕES
A nova opção de "payments" deve ser enviado no conteúdo do pacote, junto as demais informações já enviadas. Exemplo:
Lembrando que caso seja utilizado a API data-package para inclusão do pacote, este conteúdo exemplificado deve estar em base64.
05. ASSUNTOS RELACIONADOS
- Caso necessário consultar a documentação da API data-package, pode ser utilizado o link: https://www30.bhan.com.br:9443/api/totvsmoda/data-package/v2/swagger/index.html
- Caso necessário consultar um melhor detalhamento de como montar o conteúdo do pacote, pode ser utilizado o link: https://tdn.totvs.com/x/rcjvI