É o que resolve o problema clássico de quem vende em dois lugares: o produto sai da prateleira pelo site e o Mais PDV não fica sabendo.
Como funciona na prática
Seu desenvolvedor manda a venda com os itens, os valores e as formas de pagamento. O Mais PDV registra na hora, já concluída, e ela aparece em Vendas com a origem "api".
O que você precisa saber:
- A venda precisa estar paga. O valor informado tem que fechar com o total. Se o cliente ficou devendo, o certo é lançar a venda com o que foi pago e criar a diferença em Financeiro → Contas a receber (a API também faz isso).
- Faltou estoque, a venda não entra. Nada é gravado e nada é baixado — você fica sabendo pelo erro, em vez de descobrir um estoque negativo depois.
- O preço é o que o outro sistema mandou. Promoções e cashback do Mais PDV não são aplicados nessas vendas: quem decidiu o preço foi o seu site.
- Nota fiscal não sai automática. A API não emite NFC-e nem NF-e. Se precisar de nota, a emissão continua sendo feita por você, dentro do sistema.
- A data importa. A venda entra no dia em que aconteceu de verdade, então o relatório do dia fecha certo mesmo que a integração só mande à noite.
E se a venda for cancelada no site? A API cancela também, e o estoque volta. Duas ressalvas: ela só cancela venda que ela mesma registrou (venda feita no caixa é cancelada no caixa) e não cancela venda que já tem nota autorizada — cancelamento de nota tem prazo legal e é feito por você, na tela do fiscal.
Pode entrar em duplicidade? Não, se o desenvolvedor mandar o número do pedido dele junto (o campo `external_id`). Se a conexão cair e ele reenviar, o Mais PDV reconhece que é o mesmo pedido e devolve a venda que já existe, em vez de criar outra.
Para ligar isso, a chave de API precisa ter a permissão "Registrar e cancelar vendas", marcada em Empresa → Integrações. Se ela não estiver marcada, o outro sistema recebe um aviso de permissão faltando — e ninguém registra venda por acidente.