![Multiplus Card [Docs]](https://docs.multipluscard.com.br/images/logo.png){kind=logo}
Title here
Summary here
Coleção do Postman
Disponibilizamos uma coleção Postman com todos os endpoints do PINPDV já configurados para acelerar seus testes e a integração.
Comece por aqui — Coleção do Postman
Importe a coleção no Postman e comece a integrar em minutos. Todas as requisições já vêm prontas — basta informar seu token.
Como usar
- Faça o download da coleção pelo link acima.
- No Postman, vá em Import e selecione o arquivo
PinPDV.postman_collection.json. - Abra as variáveis da coleção e preencha
tokencom o token gerado no Portal do Cliente PINPDV. O headerAuthorization: Bearerpassa a ser enviado sozinho em todas as requisições. - Comece pelos endpoints de consulta — Listar Dispositivos é o mais rápido para validar o acesso.
O que vem dentro
| Pasta | Cobre |
|---|---|
| Informações Comuns | empresas, dispositivos e atualização do documento |
| Cadastro de Categorias | ver Produtos |
| Cadastro de Marcas | ver Produtos |
| Cadastro de Produtos | ver Produtos |
| Pré-venda | criação, consulta e interrupção — ver Pré-venda |
| TEF MOBILE | venda no POS — ver POS TEF |
| Venda Expressa | consulta das vendas iniciadas no Smart POS |
| Consulta de Transações | histórico por período |
Variáveis
| Variável | Para que serve |
|---|---|
baseUrl | endereço da API — já preenchido com produção |
token | token de acesso, gerado no Portal do Cliente |
categoriaIdentificador, marcaIdentificador, produtoIdentificador | identificadores de exemplo usados nos cadastros |
vendaIdentificador | identificador de uma venda, para atualizar o documento |
pinPdvId | código do dispositivo — preencha com o id que Listar Dispositivos devolve |
Ordem de cadastro
As três pastas de cadastro estão na ordem da dependência: um produto só aponta para categoria e marca já cadastradas. Na hora de excluir, o caminho é o inverso — produto primeiro, depois marca e categoria.
Cada requisição traz na sua descrição os campos aceitos, as regras de validação e o formato da resposta.
As pastas de venda não são para execução em série
Pré-venda e TEF MOBILE disparam operações reais no Smart POS. Execute essas requisições uma a uma, conscientemente.
Onde gerar o token
O token é criado exclusivamente pelo Portal do Cliente PINPDV. Veja o passo a passo em Primeiros Passos.
Anterior
Primeiros PassosPróximo
Referência