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": 50,
  "idPagtoCanalVenda": "123",
  "nsu": "135790",
  "nroCartao": "5536########0648",
  "codRede": "0001",
  "codBandeira": "0002",
  "codBin": "5536",
  "nroAutorizacao": "569288"
}


EXEMPLO DA RESPOSTA RECEBIDA

{
    "seqPedido": 50,
    "idPagtoCanalVenda": "123",
    "nsu": "135790",
    "nroCartao": "5536########0648",
    "codRede": "0001",
    "codBandeira": "0002",
    "codBin": "5536",
    "nroAutorizacao": "569288"
}


PARÂMETROS DO CORPO

Nome

seqPedido Inteiro *Obrigatório

Sequencial do pedido recebido ao cadastrar um pedido pelo endpoint POST /smpedidovendaapi/api/v1/PedidoVenda

Caso deseje pesquisar pelo seqCanalVenda e IdPedidoCanalVenda o seqPedido não precisa ser preenchido.

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


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