# Gototem · API Gototem PDV (v1)

> Lojas, eventos e recebimentos por método de pagamento de uma conta, em JSON. O acesso é por uma chave que o dono da conta cria no painel da Gototem.

Endereço base: https://api.gototem.com.br. De onde vem a chave: a chave vem do lojista.
Idioma da documentação: português do Brasil.

## Documentação

- [Contrato OpenAPI em JSON](https://developers.gototem.com.br/pdv/openapi.json): a fonte mais completa para um agente; rotas, parâmetros, respostas e erros
- [Contrato OpenAPI em YAML](https://developers.gototem.com.br/pdv/openapi.yaml): o mesmo contrato
- [Guia do desenvolvedor](https://developers.gototem.com.br/pdv/): passo a passo, erros e exemplos
- [Coleção do Postman](https://developers.gototem.com.br/pdv/postman.json): também abre no Insomnia

## Rotas no ar

- `GET /v1/api-public/ping`: Quem é esta chave
- `GET /v1/api-public/sales/by-payment-method`: Recebimentos por método de pagamento
- `GET /v1/api-public/places`: As lojas da chave
- `GET /v1/api-public/events`: Os eventos de uma loja

## Rotas previstas (ainda não disponíveis)

- `GET /v1/api-public/sales/summary`: Totais de vendas do período
- `GET /v1/api-public/sales/by-day`: Vendas por dia
- `GET /v1/api-public/sales/by-product`: Vendas por produto
- `GET /v1/api-public/sales/by-place`: Vendas por loja
- `GET /v1/api-public/orders`: Pedidos
- `GET /v1/api-public/orders/{order_id}`: Um pedido
- `GET /v1/api-public/products`: Produtos

Contrato de 12/10/2026 · versão 1.0.0.
Suporte: integracao@gototem.com.br