01. DADOS GERAIS

Produto:

TOTVS Varejo Supermercados




Linha de Produto:

Supermercados - Linha Consinco

Segmento:

Varejo

Tipo de Documento:

Inovação

Módulo:VENDAS
Caminho: SMPedidoVendaApi
Função:API PEDIDO DE VENDAS - SMPEDIDOSVENDASAPI - SMAPIVDA02
País:Brasil
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :DSUPXOMNI-3544

02. SITUAÇÃO/REQUISITO

Para integração com iFood Merchant notou-se, que o controle do pedido é um GUID, mas nas aplicações/módulos do iFood, é exibido é um número mais amigável, chamado de ShortId, faz-se necessário receber essa informação e tê-la no campo nroPedidoAfv ao integrar no ERP, para que haja a possibilidade de utilizar em pesquisas no ERP.

03. PRÉ-REQUISITOS

         Necessário possuir a API SMPedidoVendaAPI instalada, para realizar transações referentes ao endpoint POST /api/v1/PedidoVenda conforme a documentação POST - Pedido de Venda.

Alterações ou parametrizações incorretas podem comprometer o desempenho e causar falhas no sistema. Sempre que necessário, consulte um especialista ou a equipe responsável para garantir a configuração correta.

03. SOLUÇÃO

Implementado, o campo idPedidoCanalVendaCurto na API SMPedidoVendaAPI no endpoint /api/v1/PedidoVenda (POST), para que na integração de pedidos vindos de plataformas de e-commerce, seja possível enviar ao pedido que integrará ao ERP, um número de pedido curto e amigável, para facilitar a pesquisa do Pedido vindo do e-commerce no ERP. Ao integrar ao ERP, o campo nroPedidoAfv no Pedido de Venda receberá o idPedidoCanalVendaCurto vindo da API.
Tipo do Campo idPedidoCanalVendaCurto : Long.

EXEMPLO UTILIZANDO O NOVO CAMPO IDPEDIDOCANALVENDACURTO NO CORPO DA REQUISIÇÃO

{
  "seqCanalVenda":21,
  "idPedidoCanalVenda": "208",
  "dtaHorPedidoCanalVenda": "2025-05-30T14:35:00.000Z",
  "nroEmpresa": 1,
  "codGeralOper": 518,
  "nroRepresentante": 1,
  "nroTabVenda": "1",
  "seqTransportador": 0,
  "tipoEntrega": "E",
  "obsPedido": "TESTE POST PEDIDO",
  "obsNotaFiscal": "TESTE API PEDIDO",
  "vlrTotFrete": 5.00,
  "tipoRateioFretePedido": "V",
  "tipoFreteDocAuxiliar": 0,
  "indIntermediador": "N",
  "dtaHorIniPrevEntrega": "2025-06-05T08:00:00.000Z",
  "dtaHorFimPrevEntrega": "2025-06-06T18:00:00.000Z",
  "idPedidoCanalVendaCurto": 1234,
  "clienteDto": {
    "cpfCnpj": "99999999999",
    "inscEstadualRg": "123456789",
    "nomeRazaoSocial": "Matheus",
    "nomeFantasia": "Matheus",
    "sexo": "M",
    "cidade": "Ribeirão Preto",
    "uf": "SP",
    "pais": "BRASIL",
    "bairro": "Jardim",
    "logradouro": "Rotatória",
    "nroLogradouro": "999",
    "complementoLogradouro": "TEST 1",
    "cep": "14079077",
    "foneDdd1": "16",
    "foneNro1": "38800263",
    "dtaNascFund": "1987-06-13T13:34:15",
    "email": "xxxxxxxxxxx@net.com.br",
    "emailNfe": "xxxxxxxxxxxx@net.com.br",
    "estadoCivil": "S",
    "inscMunicipal": "",
    "inscProdutor": "",
    "indContribIcms": "N",
    "fisicaJuridica": "F"
  },
  "itemDto": [
    {
      "codAcesso": "17",
      "seqProduto": 21,
      "qtdPedida": 10,
      "qtdEmbalagem": 1,
      "vlrEmbTabPreco": 5.00,
      "vlrEmbInformado": 4.59,
      "vlrEmbTabPromoc": 0,
      "vlrEmbDesconto": 0.41,
      "observacaoItem": "PRODUTO TESTE",
      "qtdVolume": 0,
      "indSimilarEcommerce": "N",
      "indKit": "N",
      "vlrTotComissao": 0,
      "fatorMultiplicador": 0,
      "seqItemCanalVenda": 0,
      "indBonificado": "N"
    }
  ],
  "pagamentoDto": [
    {
      "nroFormaPagto": 6,
      "nroCondPagto": 30,
      "valorPagto": 45.90,
      "nroGiftCard": 0,
      "nroParcela": 0,
      "cpfCnpjCartao": "99999999999",
      "cnpjInstituicaoPagto": "",
      "idCarteira": "1",
      "tipoCarteira": "01",
      "idPagtoCanalVenda": "1",
      "nsuDto": {
        "nsu": "123456789000",
        "nroCartao": "5180#########8115",
        "codRede": "125",
        "codBandeira": "1",
        "codBin": "123",
        "nroAutorizacao": "123"
      }
    }
  ]
}

04. DEMAIS INFORMAÇÕES

Se estiver na versão 25.01, atualizar o sistema para o service pack 25.01.xxx ou release superior.

05. ASSUNTOS RELACIONADOS