Home TOTVS Varejo Supermercados

Árvore de páginas

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": 464,
        "IdPagtoCanalVenda": "1A",
        "nsu": "123456789000",
        "nroCartao": "5180#########8115",
        "codRede": "125",
        "codBandeira": "1",
        "codBin": "123",
        "nroAutorizacao": "123"
}


PARÂMETROS DO CORPO

Nome

seqPedido Inteiro *Obrigatório

Sequencial do pedido recebido ao cadastrar um pedido pelo endpoint POST - Pedido de Venda. 

idPagtoCanalVenda Texto  Obrigatório

Identificação do Pagamento do canal de venda. Mesmo valor que foi informado para esta propriedade no objeto pagamentoDto na inserção do Pedido de Venda no endpoint POST - Pedido 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 

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


Resposta Recebida

{
    "seqPedido": 464,
    "idPagtoCanalVenda": "1A",
    "nsu": "123456789000",
    "nroCartao": "5180#########8115",
    "codRede": "125",
    "codBandeira": "1",
    "codBin": "123",
    "nroAutorizacao": "123"
}




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": "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

  • Sem rótulos