01. DADOS GERAIS

Produto:

Linha de Produto:

Segmento:

Tipo de Documento:Inovação
Módulo:AcordosPromocionais
Caminho:POST [URLAPI]/v2/AcordosPromocionais/inserir-acordos-promocionais
Função:inserir-acordos-promocionais
País:Brasil
Requisito/Story/Issue (informe o requisito relacionado) :DSUPCONTR-8511


02. SITUAÇÃO/REQUISITO

Identificada necessidade de um novo método para realizar a inclusão de acordos promocionais no ERP TOTVS Varejo Supermercados - Linha Consinco utilizando sistemas de terceiros.

03. PRÉ-REQUISITOS

Permissão para incluir Acordo Promocional pela API

Para usuários com nível abaixo de Administrador será necessário configurar a permissão para realizar a inclusão de acordos promocionais.

Caminho: Módulo Segurança Web > Menu Permissões > Aplicação Associação de Permissão Usuário/Grupo - GLO_00006

Imagem 1 - Configurar permissão para inserir na API

Integração com o Financeiro na Inclusão do Acordo Promocional

Caminho: Módulo Parâmetros > Menu Parâmetros > Aplicação Tipos de Acordo com Fornecedores - MAC0001

É possível configurar no Tipo Acordo para integrar com o financeiro ao realizar a inclusão do Acordo Promocional pela API.

Imagem 2 - Manutenção Tipo Acordo

Aprovação dos Acordos Promocionais

Caminho: Módulo Parâmetros > Menu Parâmetros > Aplicação Gerais - MAX5000

Imagem 3 - Parâmetros Gerais


Caso parametrizado para utilizar aprovação, os Acordos Promocionais inseridos pela API precisarão ser aprovados na aplicação Aprovação de Acordo Promocional e Verba de Bonificação sem Acordo - MAC0048.

Caminho: Módulo Acordos e Verbas > Menu Administração > Aplicação Aprovação de Acordo Prom. e Verba de Bonific. s/ Acordo - MAC0048.

Imagem 4 - Aprovação de Acordo Promocional

Visualizar Parcelas na aplicação

Caminho: Módulo Acordos e Verbas > Menu Administração > Aplicação Acordos Promocionais

Para visualizar as parcelas dos acordos gerados pela API é necessário configurar os PDs abaixo:

Imagem 5 - Visualizar parcelas

Visualizar Forma de Pagamento na aplicação

Caminho: Módulo Acordos e Verbas > Menu Administração > Aplicação Acordos Promocionais

Para visualizar a forma de pagamento dos acordos gerados pela API é necessário configurar o PD abaixo:

Imagem 6 - Visualizar Forma de Pagamento

04. SOLUÇÃO

Implementado na API de Acordos Promocionais um novo método que realiza a inclusão dos acordos promocionais.

Para saber mais sobre este método, acesse a documentação detalhada: Inclusão de Acordos Promocionais - POST

Swagger

URL: APIAcordosPromocionais/swagger/index.html

Imagem 7 - Swagger


05. REQUISITOS DE VERSÃO

        Se estiver na versão 24.07, atualize para o service pack 24.07.036 ou superior. 

        Se estiver na versão 25.01, atualize para o service pack 25.01.010 ou superior.

06. DOCUMENTOS RELACIONADOS

DOCUMENTO(S) DE REFERÊNCIA