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


Endpoint responsável por receber, validar e persistir dados complementares do pagamento de cartão posterior ao envio do pedido.

Para algumas integrações de pedido, existe o cenário onde o envio do pedido ocorre antes de ter os dados do pagamento do cartão, como por exemplo, um pedido de e-commerce onde é efetuado uma pré autorização do cartão e a consolidação da transação só ocorrerá após o faturamento do pedido. Nesse cenário, é possível enviar apenas os dados complementares do cartão como NSU mesmo que o pedido já esteja faturado no ERP.



EXEMPLO DO CORPO DA REQUISIÇÃO

{
  "seqPedido": 324,
  "idPagtoCanalVenda": "1A",
  "nsu": "123",
  "nroCartao": "456",
  "codRede": "789",
  "codBandeira": "1011",
  "codBin": "1213",
  "nroAutorizacao": "1415"
}


EXEMPLO DA RESPOSTA RECEBIDA

{
    "seqPedido": 422,
    "seqCanalVenda": 21,
    "idPedidoCanalVenda": "68",
    "dtaHorPedidoCanalVenda": "2022-08-09T09:59:06.149Z",
    "nroEmpresa": 1,
    "nroSegmento": 1,
    "codGeralOper": 518,
    "nroRepresentante": 1,
    "nroTabVenda": "1"
}


PARÂMETROS DO CORPO

Nome

seqPedido Inteiro Obrigatório

idPagtoCanalVenda Texto 

Identificação do Pagamento do canal de venda

O valor da propriedade IdPagtoCanalVenda possui o tamanho máximo de 60 caracteres

nsu Texto Obrigatório

NSU é a sigla para Número Sequencial Único. É um número único gerado para identificar uma transação ou uma nota fiscal.

O valor da propriedade Nsu possui o tamanho máximo de 50 caracteres

nroCartao Texto Obrigatório

Número do cartão utilizado no pagamento

O valor da propriedade NroCartao possui o tamanho máximo de 20 caracteres

codRede Texto

Código da rede utilizada no pagamento

O valor da propriedade CodRede possui o tamanho máximo de 12 caracteres

codBandeira Texto

Código da bandeira utilizada no pagamento

O valor da propriedade CodBandeira possui o tamanho máximo de 12 caracteres

codBin Texto

Código BIN é o Número de Identificação Bancária (na sigla em inglês) e corresponde aos 6 primeiros dígitos de um cartão de crédito. 

O valor da propriedade CodBin possui o tamanho máximo de 12 caracteres

nroAutorizacao Texto 

Um código que é gerado a partir de cinco ou seis números por um banco emissor, o código usado para validar um cartão de crédito e aprová-lo quando uma compra ou venda é feita

O valor da propriedade NroAutorizacao possui o tamanho máximo de 15 caracteres


CABEÇALHOS


RESPOSTA


200

ok




400

Falha

{
    "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": "Informações de pagamento não encontradas para o NSU. Verifique IdPagtoCanalVenda e SeqPedido.",
            "detailedMessage": "SeqPagamentoNaoEncontrado"
        }
    ]
}



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.07.999