Histórico da Página

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.

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 24.07, atualizar o sistema para o service pack 24.07.xxx ou release superior.

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

05. ASSUNTOS RELACIONADOS

API Pedido de Venda

Templatedocumentos

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 2

Nova versão 3

Chave