Exibir origem

Objetivo

A finalidade deste método é realizar a inclusão de acordos promocionais no ERP TOTVS Varejo Supermercados - Linha Consinco.

Chamada

POST [URLAPI]/

Informações para Requisição (Request Information)

Parâmetros URI (URI Parameters)

Não há.

Parâmetros do Corpo (Body Parameters)

	Nome (Name)	Descrição (Description)	Tipo (Type)	Informações Adicionais (Adittional Information)
acordos		Obrigatório - Por acordo
	nroEmpresa	Número da empresa	integer	A API valida se a empresa existe e está ativa
	codTipoAcordo	Código do tipo do acordo	integer	A API valida se o tipo acordo existe
	seqComprador	Código do comprador	integer	A API valida se o comprador existe e está ativo
	seqFornecedor	Código do fornecedor	integer	A API valida se o fornecedor existe
	descricao	Descrição do acordo	string
	referencia	Referência do acordo	string
parcelas		Obrigatório - Deve conter no mínimo uma parcela
	dataVencimento	Data de vencimento da parcela	date	A data de vencimento deve ser maior que a data atual Não é permitido parcelas com a mesma data de vencimento
	valorParcela	Valor da parcela	number
acordos		Opcional - Por acordo
	nomeRepresentante	Nome do representante	string
	doctoRepresentante	Documento do representante	string
	cpfRepresentante	CPF do representante	string
	cargoRepresentante	Cargo do representante	string
	nroFormaPagamento	Número da forma de pagamento	integer
	observacao	Observação do acordo	string

Formatos da Requisição (Request Formats)

Exemplo (Sample):

{
  "acordos": [
    {
      "nroEmpresa": 1,
      "codTipoAcordo": 1,
      "seqComprador": 1,
      "seqFornecedor": 1,
      "descricao": "Descrição",
      "referencia": "Referência",
      "parcelas": [
        {
          "dataVencimento": "2025-03-08",
          "valorParcela": 10
        }
      ],
      "nomeRepresentante": "Teste",
      "doctoRepresentante": "123456789",
      "cpfRepresentante": "123.456.789-01",
      "cargoRepresentante": "Representante",
      "nroFormaPagamento": 1,
      "observacao": "Observação"
    }
  ]
}

Formatos da Resposta (Response Formats)

Code 200
Response Body
{
"mensagem": "Acordos inseridos com sucesso",
"mensagemDetalhada": "Alguns acordos não foram gerados. Verifique o Log para mais detalhes",
"totalAcordosGenerados": 1,
"totalAcordosNaoGenerados": 1,
"seqLoteProcesso": 1
}

Code 400 - Error
Response Body
[
{
"guid": "Código de guia",
"code": "400",
"message": "Erro ao inserir os acordos promocionais",
"detailedMessage": "Não é permitido inserir mais de 500 acordos."
}
]

Código (Code)	Nome (Name)	Descrição (Description)	Tipo (Type)
200		*Sucesso (Seccess)*
	mensagem	Mensagem de retorno	string
	mensagemDetalhada	Detalhe da mensagem	string
	totalAcordosGenerados	Número total de acordos gerados	integer
	totalAcordosNaoGenerados	Número total de acordos não gerados	integer
	seqLoteProcesso	Código do Lote do Processo	integer
400		*Erro (Error)*
	guid	Código de guia	string
	code	Código de retorno	string
	message	Mensagem de retorno	string
	detailedMessage	Detalhe da mensagem	string

Observações (Observations)

A API NÃO trata os seguintes processos do Acordo:

Acordo Genérico
Acordo de Acréscimo
Conta Corrente
Integração com TOTVS Assinatura Eletrônica

A API NÃO trata os seguintes processos do Tipo Acordo:

Desconto%
Exige Grupo Contábil
Exige Informar Período de Validade
Utiliza Prazo Pagamento Fornecedor
Vencimento último dia do mês

A API NÃO considera as regras dos seguintes Parâmetros Dinâmicos:

BLOQ_USU_OUTRO_COMPR
UTIL_PARCELA_ACORDO
ACORDO_PROMOC.UTIL_CONC_DIV_EMP
UTIL_GRUPOCONT_ACORDO

Outras regras:

Não será possível visualizar as parcelas na aplicação caso o PD ACORDO_PROMOC.UTIL_CONC_DIV_EMP = ‘S’
Será possível visualizar as parcelas na aplicação somente se o PD UTIL_PARCELA_ACORDO = S
Diferente da aplicação, na API não é permitido inserir um acordo com a data atual na Data de Vencimento.
Não é permitido informar a mesma Data de Vencimento para mais de uma parcela do acordo.
A Data de Emissão será configurada pela API, considerando a data de inclusão do acordo.
O Valor Total do acordo será calculado pela API somando os valores informados nas parcelas.
O Valor Total do acordo não pode ser maior que R$ 99999999999,99.
A cada requisição, será possível inserir no máximo 500 acordos.
Todos os acordos inseridos na mesma requisição serão do mesmo Código de Processo.