![Multiplus Card [Docs]](https://docs.multipluscard.com.br/images/logo.png){kind=logo}
Title here
Summary here
Venda Expressa
Transações iniciadas diretamente no Smart POS pelo operador, sem envolvimento do sistema no momento da venda. Com este módulo, seu sistema captura dados de pagamentos que ele mesmo não originou — tudo o que foi cobrado no Smart POS fica disponível para consulta.
É o caminho ideal para:
- Conciliação de cartões — cruzar o que foi capturado no terminal com os recebíveis do adquirente
- Validações gerenciais — auditar vendas, conferir totais por Smart POS e acompanhar a operação
- Vinculação de pagamentos — associar transações avulsas a pedidos, comandas ou documentos fiscais no seu sistema
Impressão de documentos
A Venda Expressa não suporta impressão via sistema (webhook ou PUT /comprovante) — o operador digita o valor direto no Smart POS, sem janela para o sistema injetar o documento. Para impressão gerenciada pelo sistema, use o TEF Mobile, a Pré-venda ou a Venda Avulsa — veja Impressão.
Sem criação via API
Não existe endpoint para criar uma Venda Expressa. Ela é iniciada exclusivamente pelo operador no Smart POS — seu sistema apenas consulta as vendas realizadas.
Endpoints
| Método | Endpoint | Descrição |
|---|---|---|
GET | /venda?FiltroTipoVenda=Expressa | Consultar vendas expressas |
Consultando vendas
curl --request GET \
--url 'https://api.pinpdv.com.br/venda?DataInicial=2024-12-12T00:00:00&DataFinal=2024-12-12T23:59:59&FiltroTipoVenda=Expressa' \
--header 'Authorization: Bearer {SEU_TOKEN}'Filtros disponíveis:
| Parâmetro | Valores | Descrição |
|---|---|---|
FiltroTipoVenda | Expressa | Obrigatório para este módulo |
DataInicial | YYYY-MM-DDTHH:MM:SS | Início do período |
DataFinal | YYYY-MM-DDTHH:MM:SS | Fim do período |
FiltroStatus | Realizada, Cancelada, Error | Status da venda |
FiltroTipoPagamento | Credito, Debito, Pix, Crediario | Meio de pagamento |
FiltroPinPdv | Código do dispositivo | Smart POS específico |
PaginaNumero | Inteiro | Página (padrão: 1) |
QtdRegistro | Inteiro | Registros por página (padrão: 100) |
OrdenarPor | Id, Valor, Status, CadastradoEm, AtualizadoEm | Campo de ordenação |
OrdenarTipo | ASC, DESC | Direção da ordenação |
Os valores de status de venda, status de pagamento e tipos de pagamento estão em Referência.
Exemplo de resposta
Cada item é uma venda iniciada no Smart POS. O traço que distingue a Venda Expressa: preVenda e posVenda são null — ela nasce no terminal, sem vínculo com uma solicitação do seu sistema.
200 - OK
{
"paginaAtual": 1,
"quantidadeTotalDeItens": 1,
"data": [
{
"id": 517146,
"identificador": "e7e1fe6698214d2f8c74f5d4f4c3a711",
"tipoVenda": { "key": 1, "value": "Expressa" },
"valor": 99.99,
"isDocumento": false,
"cadastradoEm": "2026-07-02T19:08:28.736",
"status": { "key": 0, "value": "Realizada" },
"transacoes": [
{
"valor": 99.99,
"parcelas": 1,
"status": { "key": 0, "value": "Aprovada" },
"tipoPagamento": 3,
"pagamentoTipo": { "key": 3, "value": "Debito" },
"dados": {
"dataHora": "2026-07-02T19:08:38.814",
"nsu": "000000360",
"autorizacao": "164550",
"bandeira": "MASTERCARD",
"adquirente": "Getnet"
}
}
],
"produtos": [],
"preVenda": null,
"posVenda": null,
"pinPdv": { "id": 1, "codigo": "526989", "nome": "CAIXA 01" },
"isCancelamento": false
}
]
}Anterior
Pré-venda ⭐Próximo
Webhook