PDV¶
APIs de integração com sistemas de PDV (Frente de Caixa). Esta seção reúne os diferentes conjuntos de APIs usados pelo ponto de venda para identificar clientes, autorizar descontos e registrar vendas.
Use a API Rock Conecta para novas integrações
A Rock Conecta (API REST) é a integração oficial e recomendada. A integração Bnex (WSDL/SOAP) está depreciada — mantida apenas para consulta de integrações existentes. Não implemente novas integrações sobre o Bnex.
Conjuntos de APIs disponíveis¶
-
Rock Conecta (API REST) · recomendada
Integração oficial REST/JSON. O PDV consome três operações — identificar cliente, autorizar descontos e registrar venda — usando Basic Auth por tenant.
-
Bnex (WSDL/SOAP) · legado / depreciada
Integração legada baseada em WebService SOAP (
GerenciaVendaWS). Mantida somente para consulta de integrações já existentes.
Qual integração usar?¶
| Aspecto | Rock Conecta (REST) | Bnex (SOAP) — legado |
|---|---|---|
| Status | Oficial / recomendada | Depreciada (só consulta) |
| Protocolo | REST / JSON | SOAP / WSDL |
| Autenticação | Basic Auth por tenant | token + Hash MD5 |
| Operações | Identificar cliente · Autorizar descontos · Registrar venda | setIdentificaCliente · setNotificaVenda · setCancelaVenda |
| Novas integrações | Sim | Não |
As três operações da Rock Conecta¶
| Ordem | Operação | Quando chamar |
|---|---|---|
| 1 | Identificar cliente | Ao informar o CPF/CNPJ no início da compra |
| 2 | Autorizar descontos | Com o carrinho montado, para obter descontos por item |
| 3 | Registrar venda | Ao fechar a compra |
Comece pela visão geral da Rock Conecta, que traz requisitos,
autenticação e um guia rápido com exemplos curl.