Home TOTVS Varejo Supermercados

Árvore de páginas

POST  {urlbase}:{porta}/smpedidovendaapi/api/v1/PedidoVenda/corte


Endpoint responsável por receber, validar e persistir cortes e trocas de produtos no pedido de venda.

Este endpoint possibilita a realização de:

  • Corte total de um produto;
  • Corte parcial de um produto;
  • Troca de um produto por um ou mais produtos;
  • Corte parcial de um produto com adição de um ou mais produtos.



EXEMPLO DO CORPO DA REQUISIÇÃO

{
	"nroPedVenda": 147137,
  	"nroEmpresa": 1,
  	"seqPedVendaItem": 2,
  	"seqCanalVenda": 21,
  	"usuarioInclusao": "Teste",
  	"itemSubstitutoDto": [
    	{
      		"seqProduto": 138924,
      		"qtdPedida": 600,
      		"qtdEmbalagem": 6,
      		"vlrEmbInformado": 2195.45
    	},
    	{
      		"seqProduto": 105491,
      		"qtdPedida": 60,
      		"qtdEmbalagem": 6,
      		"vlrEmbInformado": 25
    	}
  ] 
}


PARÂMETROS DO CORPO

Nome

nroPedVenda Numérico *Obrigatório

Número identificador do Pedido de Venda no ERP.

O valor máximo permitido para o Número do Pedido de Venda é de 9999999999.

nroEmpresa Numérico Obrigatório

Número identificador da Empresa do Pedido de Venda.

O valor máximo permitido para a Empresa é de 999999.

seqPedVendaItem Numérico Obrigatório

Sequencial identificador do Produto no Pedido de Venda.

O valor máximo permitido para o Sequencial do Produto no Pedido de Venda é de 9999999999.

O produto informado sempre será cancelado. Caso seja necessário realizar um corte parcial do produto, este produto deve ser enviado no objeto itemSubstitutoDto com as respectivas quantidades e valores restantes.

seqCanalVenda Numérico Obrigatório

Sequencial do Canal de Venda.

Manutenção de Canal de Venda

usuarioInclusao Texto Obrigatório

Usuário responsável pela inclusão do corte ou troca de produto.

O tamanho máximo permitido para o Usuário de Inclusão é de 12 caracteres.

Objeto itemSubstitutoDto 

Coleção de dados dos itens substitutos 

Nomes

seqProduto  Inteiro Obrigatório

Sequencial identificador do Produto no ERP.

qtdPedida Decimal Obrigatório

Quantidade total Pedida do produto.

O valor máximo permitido para a Quantidade Pedida é de 99999999.999.

qtdEmbalagem Decimal Obrigatório

Quantidade da Embalagem do produto.

O valor máximo permitido para a Quantidade da Embalagem é de 99999.999999.

vlrEmbInformado Decimal Obrigatório 

Valor da Embalagem informada para o produto.

O valor máximo permitido para o Valor da Embalagem é de 9999999999.999999.


RESPOSTA

Importação realizada com sucesso e integrado.

{
    "seqCorte": 49,
    "nroPedVenda": 147137,
    "nroEmpresa": 1,
    "seqPedVendaItem": 2,
    "seqCanalVenda": 21,
    "statusIntegracao": "Finalizado"
}



Importação realizada com sucesso mas não integrado.

{
    "seqCorte": 49,
    "nroPedVenda": 147137,
    "nroEmpresa": 1,
    "seqPedVendaItem": 2,
    "seqCanalVenda": 21,
    "statusIntegracao": "Rejeitado",
	"critica": [
		{
			"descricao": "Valor total dos itens substitutos é maior que o valor do item cortado.",
			"detalhe": "Total itens substitutos: 219795,00. Total item cortado: 93651,63.",
			"tipoCritica": "Corte"
		}
	]
}



Resposta de Erro

{
    "code": "Zvpebfbsg.NfcArgPber.Zip.GasPbagebyyre+Reebe.2",
    "message": "Erro ao salvar 'PedidoVenda'",
    "detailedMessage": "AspNetCoreOnPostError",
    "helpUrl": "",
    "details": [
        {
            "guid": "7203b9e5-9cf5-4816-9c1b-3a5ae5a81e41",
            "code": "400",
            "message": "O valor da propriedade UsuarioInclusao excede o tamanho máximo de caracteres (12).",
            "detailedMessage": "UsuarioInclusaoExtenso"
        }
    ]
}



INSTALAÇÃO

Para instalação do módulo de API Pedido de Venda deve ser feito via PublicaWeb > ConsincoWeb

Pacote: Pedido de Venda API

Versão a partir de: 23.01.010

  • Sem rótulos